Об этом проекте

Этот репозиторий поддерживается AWS и содержит примеры кода, показывающие, как использовать AWS SDK для взаимодействия с сервисами AWS. Многие примеры напрямую встраиваются в официальную документацию AWS и руководства разработчика SDK. Организация выполнена по языкам и версиям SDK. У каждого языка есть собственный подкаталог, а в некоторых языках есть отдельные папки для старых и новых поколений SDK: - .NET: dotnetv3 (SDK 3.5+) и dotnet (ниже 3.5) - C++: cpp (SDK 1) - Go: gov2 (SDK 2) и go (SDK 1) - Java: javav2 (SDK 2) и java (SDK 1) - JavaScript: javascriptv3 (SDK 3) и javascript (SDK 2) - Kotlin: kotlin (SDK 1) - PHP: php (SDK 3) - Python: pythonv4 (SDK 4) и python (SDK 3) - Ruby: ruby (SDK 3) - Rust: rustv1 (SDK 1) - Swift: swift (preview) Каждый каталог содержит инструкции, специфичные для SDK, по пониманию и запуску примеров. В README отмечается, что AWS SDK для Java v1.x перешёл в режим сопровождения 31 июля 2024 года и достигает окончания поддержки 31 декабря 2025 года. Помимо папок по языкам, есть дополнительные каталоги: - applications: не зависящие от языка компоненты примеров приложений, показывающих использование SDK в сценариях, близких к production. Части, специфичные для языка, находятся в папке cross-service соответствующего языка. - test: компоненты, поддерживающие собственную среду автоматизации тестирования, которая регулярно тестирует код репозитория, развёрнутую в AWS как полиглотное решение интеграционного тестирования на основе контейнеров. В README указано, что по состоянию на 2023 год этот раздел всё ещё находится в активной разработке. - resources: общие компоненты, используемые многими примерами, развёртываемые как фронтенд-клиенты или бэкенд-компоненты CDK/CloudFormation. Для запуска примеров требуется учётная запись AWS и настроенные учётные данные AWS, например через AWS CLI. В README есть предупреждение об использовании: примеры взаимодействуют с сервисами, которые могут повлечь расходы, и могут создавать или удалять ресурсы AWS. Пользователям рекомендуется учитывать создаваемые или удаляемые ресурсы, возможные затраты и создавать резервные копии важных данных. Вклад приветствуется через руководство CONTRIBUTING.md. Запросы на примеры можно подавать через трекер задач с использованием шаблона enhancement. Команда оценивает запросы на предмет ясности, релевантности и осуществимости и просит подавать запросы как можно раньше, в идеале не менее чем за два месяца для крупных примеров. Исправления ошибок и вопросы безопасности имеют приоритет над новыми примерами, а сопроводительный высококачественный pull request повышает шансы на то, что запрос будет рассмотрен. В README также упоминаются «tributaries»: дополнительные источники, примеры кода которых попадают в документацию AWS, включая этот репозиторий, aws-samples/serverless-snippets и aws/aws-tools-for-powershell. Лицензирование: содержимое защищено авторским правом Amazon Web Services, Inc. или её аффилированных лиц. Если не указано иное, примеры лицензированы по Apache License 2.0, полный текст находится в файле LICENSE. В README авторов просят по возможности добавлять в начало файлов комментарий с copyright и SPDX-License-Identifier: Apache-2.0.