프로젝트 소개
# 🟡 커뮤니티 브라우저 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`)에 이슈를 열어주세요.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.