프로젝트 소개
이 저장소는 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(프리뷰)
각 디렉터리에는 예제를 이해하고 실행하기 위한 SDK별 지침이 있습니다. README는 AWS SDK for Java v1.x가 2024년 7월 31일 유지 관리 모드에 들어갔고 2025년 12월 31일 지원 종료에 도달한다고 명시합니다.
언어별 폴더 외에도 추가 디렉터리가 있습니다:
- applications: 프로덕션과 유사한 시나리오에서 SDK 사용을 보여주는 예제 애플리케이션의 비언어 특정 구성 요소입니다. 언어별 부분은 각 언어의 cross-service 폴더에 있습니다.
- test: 저장소 코드를 정기적으로 테스트하는 사용자 지정 테스트 자동화 프레임워크를 지원하는 구성 요소로, 다중 언어 컨테이너 기반 통합 테스트 솔루션으로 AWS에 배포됩니다. README는 2023년 기준으로 아직 활발히 구축 중이라고 표시합니다.
- resources: 많은 예제에서 사용하는 공유 구성 요소로, 프런트엔드 클라이언트 또는 백엔드 CDK/CloudFormation 구성 요소로 배포됩니다.
예제를 실행하려면 AWS 계정과 구성된 AWS 자격 증명이 필요하며, 예를 들어 AWS CLI를 통해 설정할 수 있습니다. README에는 사용 면책 조항이 있습니다: 예제는 요금이 발생할 수 있는 서비스와 상호 작용하며 AWS 리소스를 생성하거나 삭제할 수 있습니다. 사용자에게 생성 또는 삭제된 리소스, 잠재적 비용을 인지하고 중요한 데이터를 백업하라고 권고합니다.
기여는 CONTRIBUTING.md 가이드를 통해 환영합니다. 예제 요청은 개선 템플릿을 사용해 이슈 트래커를 통해 제출할 수 있습니다. 팀은 요청의 명확성, 관련성, 실현 가능성을 평가하며, 요청은 가능한 한 이르게, 이상적으로는 더 큰 예제의 경우 최소 두 달 전에 할 것을 요청합니다. 버그 수정과 보안 문제는 새 예제보다 우선하며, 함께 제공되는 고품질 풀 리퀘스트는 요청이 처리될 가능성을 높입니다.
README는 또한 "tributaries"를 언급합니다: 코드 예제가 AWS 문서로 흘러 들어가는 추가 소스로, 이 저장소, aws-samples/serverless-snippets, aws/aws-tools-for-powershell이 포함됩니다.
라이선스: 콘텐츠는 Amazon Web Services, Inc. 또는 그 계열사의 저작권입니다. 별도로 명시되지 않는 한 예제는 Apache License 2.0에 따라 라이선스되며, 전체 텍스트는 LICENSE 파일에 있습니다. README는 기여자에게 가능한 경우 파일 상단에 저작권 및 SPDX-License-Identifier: Apache-2.0 주석을 포함하도록 요청합니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.