ジェネリックパッケージの公開と使用

ジェネリックパッケージバージョンとそれに関連するアセットを公開するには、publish-package-version コマンドを使用します。list-package-version-asset コマンドを使用してジェネリックパッケージのアセットを一覧表示し、get-package-version-asset を使用してダウンロードします。次のトピックでは、これらのコマンドを使用してジェネリックパッケージを公開したり、ジェネリックパッケージアセットをダウンロードしたりする step-by-step 手順について説明します。

ジェネリックパッケージの公開

ジェネリックパッケージは、パッケージ名、名前空間、バージョン、および 1 つ以上のアセット (またはファイル) で構成されます。このトピックでは、my-package という名前のパッケージを、名前空間 my-ns、バージョン 1.0.0、asset.tar.gz という名前の 1 つのアセットを含むパッケージを公開する方法を示します。

前提条件:

• 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 を 1 回呼び出してアップロードします。最後のアセットをアップロードする場合を除き、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"
  }