기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 일반 패키지 게시 및 사용
일반 패키지 버전과 관련 자산을 게시하려면 `publish-package-version` 명령을 사용합니다. `list-package-version-asset` 명령을 사용하여 일반 패키지의 자산을 나열하고 `get-package-version-asset`를 사용하여 이를 다운로드할 수 있습니다. 다음 항목에는 이러한 명령을 사용하여 일반 패키지를 게시하거나 일반 패키지 자산을 다운로드하는 방법에 대한 단계별 지침이 포함되어 있습니다.
## 일반 패키지 게시
일반 패키지는 패키지 이름, 네임스페이스, 버전 및 하나 이상의 자산(또는 파일)으로 구성됩니다. 이 항목에서는 `my-ns` 네임스페이스와 버전 `1.0.0`을 사용하고 `asset.tar.gz` 이름이 지정된 자산 하나를 포함하는 `my-package` 이름이 지정된 패키지를 게시하는 방법을 보여줍니다.
**사전 조건**:
+ CodeArtifact를 AWS Command Line Interface 사용하여 설정 및 구성( 참조[with AWS CodeArtifact 설정](get-set-up-for-codeartifact.md))
+ CodeArtifact 도메인 및 리포지토리 보유([AWS CLI를 사용하여 시작하기](getting-started-cli.md) 참조)
**일반 패키지를 게시하려면**
1. 다음 명령을 사용하여 패키지 버전에 업로드할 각 파일의 SHA256 해시를 생성하고 환경 변수에 값을 입력합니다. 이 값은 파일 내용이 처음 전송된 후 변경되지 않았는지 확인하기 위한 무결성 검사로 사용됩니다.
------
#### [ Linux ]
```
export ASSET_SHA256=$(sha256sum asset.tar.gz | awk '{print $1;}')
```
------
#### [ macOS ]
```
export ASSET_SHA256=$(shasum -a 256 asset.tar.gz | awk '{print $1;}')
```
------
#### [ Windows ]
```
for /f "tokens=*" %G IN ('certUtil -hashfile asset.tar.gz SHA256 ^| findstr /v "hash"') DO SET "ASSET_SHA256=%G"
```
------
1. `publish-package-version`를 호출하여 자산을 업로드하고 새 패키지 버전을 생성합니다.
**참고**
패키지에 자산이 두 개 이상 포함된 경우 업로드할 자산마다 한 번씩 `publish-package-version`를 호출할 수 있습니다. 최종 자산을 업로드하는 경우를 제외하고 각 `publish-package-version` 호출에 대한 `--unfinished` 인수를 포함합니다. `--unfinished`를 생략하면 패키지 버전의 상태가 `Published`로 설정되고 추가 자산이 업로드되지 않습니다.
또는 `publish-package-version`를 호출할 때마다 `--unfinished`를 포함하여 실행한 다음 `update-package-versions-status` 명령을 사용하여 패키지 버전의 상태를 `Published`로 설정하도록 할 수도 있습니다.
------
#### [ Linux/macOS ]
```
aws codeartifact publish-package-version --domain my_domain --repository my_repo \
--format generic --namespace my-ns --package my-package --package-version 1.0.0 \
--asset-content asset.tar.gz --asset-name asset.tar.gz \
--asset-sha256 $ASSET_SHA256
```
------
#### [ Windows ]
```
aws codeartifact publish-package-version --domain my_domain --repository my_repo ^
--format generic --namespace my-ns --package my-package --package-version 1.0.0 ^
--asset-content asset.tar.gz --asset-name asset.tar.gz ^
--asset-sha256 %ASSET_SHA256%
```
------
다음은 출력값을 보여줍니다.
```
{
"format": "generic",
"namespace": "my-ns",
"package": "my-package",
"version": "1.0.0",
"versionRevision": "REVISION-SAMPLE-1-C7F4S5E9B772FC",
"status": "Published",
"asset": {
"name": "asset.tar.gz",
"size": 11,
"hashes": {
"MD5": "41bba98d5b9219c43089eEXAMPLE-MD5",
"SHA-1": "69b215c25dd4cda1d997a786ec6EXAMPLE-SHA-1",
"SHA-256": "43f24850b7b7b7d79c5fa652418518fbdf427e602b1edabe6EXAMPLE-SHA-256",
"SHA-512": "3947382ac2c180ee3f2aba4f8788241527c8db9dfe9f4b039abe9fc560aaf5a1fced7bd1e80a0dca9ce320d95f0864e0dec3ac4f2f7b2b2cbEXAMPLE-SHA-512"
}
}
}
```
## 일반 패키지 자산 목록
일반 패키지에 포함된 자산을 나열하려면 `list-package-version-assets` 명령을 사용합니다. 자세한 내용은 [패키지 버전 자산 나열](list-assets.md) 단원을 참조하십시오.
다음 예제는 `my-package` 패키지 버전 `1.0.0`의 자산을 나열합니다.
**패키지 버전 자산을 나열하려면**
+ 일반 패키지에 포함된 자산을 나열하려면 `list-package-version-assets`을 호출합니다.
------
#### [ Linux/macOS ]
```
aws codeartifact list-package-version-assets --domain my_domain \
--repository my_repo --format generic --namespace my-ns \
--package my-package --package-version 1.0.0
```
------
#### [ Windows ]
```
aws codeartifact list-package-version-assets --domain my_domain ^
--repository my_repo --format generic --namespace my-ns ^
--package my-package --package-version 1.0.0
```
------
다음은 출력값을 보여줍니다.
```
{
"assets": [
{
"name": "asset.tar.gz",
"size": 11,
"hashes": {
"MD5": "41bba98d5b9219c43089eEXAMPLE-MD5",
"SHA-1": "69b215c25dd4cda1d997a786ec6EXAMPLE-SHA-1",
"SHA-256": "43f24850b7b7b7d79c5fa652418518fbdf427e602b1edabe6EXAMPLE-SHA-256",
"SHA-512": "3947382ac2c180ee3f2aba4f8788241527c8db9dfe9f4b039abe9fc560aaf5a1fced7bd1e80a0dca9ce320d95f0864e0dec3ac4f2f7b2b2cbEXAMPLE-SHA-512"
}
}
],
"package": "my-package",
"format": "generic",
"namespace": "my-ns",
"version": "1.0.0",
"versionRevision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"
}
```
## 일반 패키지 자산 다운로드
일반 패키지에서 자산을 다운로드하려면 `get-package-version-asset` 명령을 사용합니다. 자세한 내용은 [패키지 버전 자산 다운로드](download-assets.md) 단원을 참조하십시오.
다음 예제에서는 `my-package` 패키지 버전 `1.0.0`의 `asset.tar.gz` 자산을 현재 작업 디렉터리의 `asset.tar.gz` 이름이 지정된 파일로 다운로드합니다.
**패키지 버전 자산을 다운로드하려면**
+ `get-package-version-asset`를 호출하여 일반 패키지에서 자산을 다운로드합니다.
------
#### [ Linux/macOS ]
```
aws codeartifact get-package-version-asset --domain my_domain \
--repository my_repo --format generic --namespace my-ns --package my-package \
--package-version 1.0.0 --asset asset.tar.gz \
asset.tar.gz
```
------
#### [ Windows ]
```
aws codeartifact get-package-version-asset --domain my_domain ^
--repository my_repo --format generic --namespace my-ns --package my-package ^
--package-version 1.0.0 --asset asset.tar.gz ^
asset.tar.gz
```
------
다음은 출력값을 보여줍니다.
```
{
"assetName": "asset.tar.gz",
"packageVersion": "1.0.0",
"packageVersionRevision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"
}
```