프로젝트 소개

# 🟡 커뮤니티 브라우저 CDN 빌드 – JavaScript SDK 클라이언트 패키지 이 저장소는 npm 모듈 `@aws-sdk/lib-storage`의 **커뮤니티에서 유지 관리하는 브라우저 지원 배포판**을 제공합니다. 이는 다양한 AWS SDK for JavaScript v3 패키지의 사전 빌드된 버전을 제공하는 더 큰 컬렉션(`cloud-sdk-builds`)의 일부입니다. ## 주요 기능 - **빌드 단계 불필요**: 패키지는 자동으로 빌드되어 CDN에 게시됩니다. 개발자는 Webpack, Vite 또는 기타 번들러 없이 브라우저에서 SDK 클라이언트를 직접 사용할 수 있습니다. - **CDN 호스팅**: jsDelivr에 호스팅되어 HTML `<script type="importmap">`을 통해 쉽게 통합할 수 있습니다. - **버전 고정**: 프로덕션 환경에서 안정성을 보장하기 위해 특정 버전 URL을 지원합니다. - **SRI 무결성**: 안전한 로딩을 위한 Subresource Integrity(SRI) 해시를 제공합니다. ## 사용법 ### Import Map 설정 패키지를 사용하려면 HTML에서 import map을 정의하세요: ```html <script type="importmap"> { "imports": { "@aws-sdk/lib-storage": "https://cdn.jsdelivr.net/gh/cloud-sdk-builds/lib-storage@3.1131.0/index.min.mjs" }, "integrity": { "https://cdn.jsdelivr.net/gh/cloud-sdk-builds/lib-storage@3.1131.0/index.min.mjs": "sha384-nNlqFhRJ+qNESYQLM/aNxDE11EPiRpG+tqDNwmLQJ5AZuG6ZdxFUCm5mEXj/9F5a" } } </script> ``` ### 직접 가져오기 설정이 완료되면 JavaScript에서 모듈을 가져올 수 있습니다: ```javascript import { ... } from "@aws-sdk/lib-storage"; ``` ## 사용 가능한 패키지 npm에 게시된 모든 공식 `@aws-sdk/*` 모듈은 브라우저 CDN 사용을 위해 빌드될 수 있습니다. URL 패턴은 다음과 같습니다: - **최신 버전**: `https://cdn.jsdelivr.net/gh/cloud-sdk-builds/{aws_service_name}/index.min.mjs` - **특정 버전**: `https://cdn.jsdelivr.net/gh/cloud-sdk-builds/{aws_service_name}@{aws_version}/index.min.mjs` `{aws_service_name}`을 서비스 이름(예: `client-s3`, `lib-storage`)으로, `{aws_version}`을 원하는 버전 태그로 바꾸세요. ## 보안 및 모범 사례 - **버전 고정**: 프로덕션에서는 항상 특정 버전(예: `@3.1131.0`)으로 고정하여 업데이트로 인한 예기치 않은 호환성 문제를 방지하세요. - **최신 버전 사용 금지**: 프로덕션 환경에서는 `latest` URL을 사용하지 마세요. - **SRI 확인**: 제공된 SHA 무결성 해시를 사용하여 콘텐츠가 변조되지 않았는지 확인하세요. ## 면책 조항 이 프로젝트는 **커뮤니티에서 운영하는 배포판**이며, Amazon Web Services 또는 공식 SDK 유지 관리자와 **제휴, 보증 또는 후원 관계가 없습니다**. 모든 원본 SDK 소스 코드는 해당 업스트림 라이선스에 따라 라이선스가 유지됩니다. ## 기여 추가 브라우저 지원 SDK 패키지에 대한 지원이 필요하면 기본 조직의 이슈 트래커(`https://github.com/cloud-sdk-builds/.github/issues`)에 이슈를 열어주세요.