일반 패키지 게시 및 사용

일반 패키지 버전과 관련 자산을 게시하려면 publish-package-version 명령을 사용합니다. list-package-version-asset 명령을 사용하여 일반 패키지의 자산을 나열하고 get-package-version-asset를 사용하여 이를 다운로드할 수 있습니다. 다음 항목에는 이러한 명령을 사용하여 일반 패키지를 게시하거나 일반 패키지 자산을 다운로드하는 방법에 대한 step-by-step 지침이 포함되어 있습니다.

일반 패키지 게시

일반 패키지는 패키지 이름, 네임스페이스, 버전 및 하나 이상의 자산(또는 파일)으로 구성됩니다. 이 항목에서는 my-ns 네임스페이스와 버전 1.0.0을 사용하고 asset.tar.gz 이름이 지정된 자산 하나를 포함하는 my-package 이름이 지정된 패키지를 게시하는 방법을 보여줍니다.

사전 조건:

• 를 AWS Command Line Interface 사용하여 설정 및 구성합니다 CodeArtifact (참조를 사용하여 설정하기 AWS CodeArtifact).

• CodeArtifact 도메인 및 리포지토리 보유 (참조AWS CLI를 사용하여 시작하기)

일반 패키지를 게시하려면

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"

2. 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 명령을 사용합니다. 자세한 정보는 패키지 버전 자산 나열을 참조하세요.

다음 예제는 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 명령을 사용합니다. 자세한 정보는 패키지 버전 자산 다운로드을 참조하세요.

다음 예제에서는 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"
  }