À propos du projet

Ce dépôt est maintenu par AWS et rassemble des exemples de code montrant comment utiliser les SDK AWS pour interagir avec les services AWS. Beaucoup de ces exemples sont injectés directement dans la documentation officielle AWS et les guides développeurs des SDK. L'organisation se fait par langage et par version de SDK. Chaque langage dispose de son propre sous-répertoire, et certains langages ont des dossiers séparés pour les anciennes et les nouvelles générations de SDK : - .NET : dotnetv3 (SDK 3.5+) et dotnet (antérieur à 3.5) - C++ : cpp (SDK 1) - Go : gov2 (SDK 2) et go (SDK 1) - Java : javav2 (SDK 2) et java (SDK 1) - JavaScript : javascriptv3 (SDK 3) et javascript (SDK 2) - Kotlin : kotlin (SDK 1) - PHP : php (SDK 3) - Python : pythonv4 (SDK 4) et python (SDK 3) - Ruby : ruby (SDK 3) - Rust : rustv1 (SDK 1) - Swift : swift (aperçu) Chaque répertoire contient des instructions spécifiques au SDK pour comprendre et exécuter les exemples. Le README indique que le SDK AWS pour Java v1.x est entré en mode maintenance le 31 juillet 2024 et atteindra la fin de support le 31 décembre 2025. Au-delà des dossiers par langage, il existe des répertoires supplémentaires : - applications : composants non spécifiques à un langage d'applications d'exemple qui montrent l'usage du SDK dans des scénarios proches de la production. Les parties spécifiques à un langage se trouvent dans le dossier cross-service de chaque langage. - test : composants prenant en charge un framework d'automatisation de tests personnalisé qui teste régulièrement le code du dépôt, déployé sur AWS comme solution d'intégration polyglotte basée sur des conteneurs. Le README indique que cela est encore en construction active en 2023. - resources : composants partagés utilisés par de nombreux exemples, déployés comme clients frontend ou composants backend CDK/CloudFormation. L'exécution des exemples nécessite un compte AWS et des identifiants AWS configurés, par exemple via l'AWS CLI. Le README inclut un avertissement d'usage : les exemples interagissent avec des services pouvant entraîner des frais et peuvent créer ou supprimer des ressources AWS. Il conseille aux utilisateurs d'être conscients des ressources créées ou supprimées, des coûts potentiels, et de sauvegarder les données importantes. Les contributions sont bienvenues via le guide CONTRIBUTING.md. Les demandes d'exemples peuvent être déposées via le système de suivi des tickets à l'aide d'un modèle d'amélioration. L'équipe évalue les demandes selon leur clarté, leur pertinence et leur faisabilité, et demande que les demandes soient faites le plus tôt possible, idéalement au moins deux mois à l'avance pour les exemples plus importants. Les corrections de bugs et les problèmes de sécurité sont prioritaires sur les nouveaux exemples, et une pull request de haute qualité accompagnant la demande améliore les chances qu'elle soit traitée. Le README mentionne également les « tributaries » : des sources supplémentaires dont les exemples de code alimentent la documentation AWS, notamment ce dépôt, aws-samples/serverless-snippets et aws/aws-tools-for-powershell. Licence : le contenu est protégé par le copyright d'Amazon Web Services, Inc. ou de ses affiliés. Sauf indication contraire, les exemples sont sous licence Apache License 2.0, avec le texte complet dans le fichier LICENSE. Le README demande aux contributeurs d'inclure un commentaire de copyright et SPDX-License-Identifier: Apache-2.0 en haut des fichiers lorsque c'est possible.