ファイルのダウンロード

このページでは、Artifact Registry の標準リポジトリとリモート リポジトリから個別のファイルをダウンロードする方法について説明します。リポジトリは、任意のアーティファクト形式にできます。

ファイルのダウンロードは、形式固有のツールを使用せずに、ファイルをローカル環境に取り込む場合に便利です。ファイルをダウンロードする前に、Artifact Registry に対して認証を行う必要がまだあることに留意してください。

ダウンロード可能なファイル

リポジトリ内の個々のデータまたはメタデータのファイルをダウンロードできます。たとえば、Maven リポジトリには、Java パッケージをアーティファクトとして保存します。jar ファイルや pom.xml ファイルなど、Java パッケージ内のファイルは個別にダウンロードできます。

Docker イメージなど、ダウンロード操作のためにクライアント ツールの使用に大きく依存するアーティファクトについては、この機能の使用はおすすめしません。

始める前に

• （省略可）gcloud CLI コマンドのデフォルトを設定します。

必要なロール

リポジトリに保存されているファイルをダウンロードするために必要な権限を取得するには、リポジトリに対する Artifact Registry 読み取り（roles/artifactregistry.reader）IAM ロールを付与するよう管理者に依頼してください。ロールの付与の詳細については、アクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

ファイルの一覧表示

リポジトリ内のファイルを一覧表示して、ダウンロード可能なものを確認できます。

Console

1. Google Cloud コンソールで [リポジトリ] ページを開きます。

   [リポジトリ] ページを開く

2. リポジトリ リストで、リポジトリを選択します。

3. パッケージの名前をクリックします。

4. すべてのパッケージ バージョンのダウンロード可能なファイルを表示するには、[ファイル] タブをクリックします。

5. 特定のバージョンのパッケージのダウンロード可能なファイルを表示するには、バージョン名をクリックしてから [ファイル] タブをクリックします。

gcloud

次のすべてのコマンドについては、コマンドに --limit フラグを追加することで、返されるファイルの最大数を設定できます。

デフォルト値が構成されている場合にデフォルトのプロジェクト、リポジトリ、ロケーションのすべてのファイルを一覧表示するには次のようにします。

gcloud artifacts files list

指定したプロジェクト、リポジトリ、ロケーション内のファイルを一覧表示するには、次のコマンドを実行します。

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

特定のパッケージのすべてのバージョン内のファイルを一覧表示するには:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

特定のパッケージ バージョンのファイルを一覧表示するには:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

次の値を置き換えます。

• LOCATION: リポジトリのリージョンまたはマルチリージョンロケーション。
• PROJECT: Google Cloud プロジェクト ID。 プロジェクト ID にコロン（：）が含まれている場合は、ドメインをスコープとするプロジェクトをご覧ください。
• REPOSITORY: イメージが保存されるリポジトリの名前。
• PACKAGE: パッケージの名前。
• VERSION: パッケージのバージョン

Docker リポジトリの場合は、コマンドに --tag フラグを追加することで、特定のコンテナ イメージタグのファイルを一覧表示できます。

詳細については、gcloud アーティファクト ファイルのリストをご覧ください。

ファイルをダウンロードする

リポジトリから個々のファイルをダウンロードするには、次のコマンドを実行します。

gcloud

後述のコマンドデータを使用する前に、次のように置き換えます。

• PROJECT: Google Cloud プロジェクト ID。プロジェクト ID にコロン（:）が含まれている場合は、ドメインをスコープとするプロジェクトをご覧ください。
• LOCATION: リポジトリのリージョンまたはマルチリージョンのロケーション。
• REPOSITORY: アーティファクトが保存されるリポジトリの名前。
• DESTINATION: ローカル ファイル システム内の移行先フォルダのパス。移行先フォルダがすでに存在している必要があります。そうでない場合、コマンドは失敗します。
• FILE: 完全なファイル名。この値を確認するには、gcloud artifacts files list コマンドを実行して FILE の値をコピーします。

次のコマンドを実行します。

Linux、macOS、Cloud Shell

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。

gcloud artifacts files download \
    --project=PROJECT \
    --location=LOCATION \
    --repository=REPOSITORY \
    --destination=DESTINATION \
    FILE

Windows（PowerShell）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。

gcloud artifacts files download `
    --project=PROJECT `
    --location=LOCATION `
    --repository=REPOSITORY `
    --destination=DESTINATION `
    FILE

Windows（cmd.exe）

注: 認証とプロジェクトを使用して Google Cloud CLI を初期化するには、gcloud init、gcloud auth login、または gcloud config set project のいずれかを実行します。

gcloud artifacts files download ^
    --project=PROJECT ^
    --location=LOCATION ^
    --repository=REPOSITORY ^
    --destination=DESTINATION ^
    FILE

ダウンロードがすぐに開始されます。

API

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT: Google Cloud プロジェクト ID。プロジェクト ID にコロン（:）が含まれている場合は、ドメインをスコープとするプロジェクトをご覧ください。
• LOCATION: リポジトリのリージョンまたはマルチリージョンのロケーション。
• REPOSITORY: アーティファクトが保存されるリポジトリの名前。
• DESTINATION: ローカル ファイル システム内の移行先フォルダのパス。移行先フォルダがすでに存在している必要があります。そうでない場合、コマンドは失敗します。
• FILE: URL エンコードされたファイル名。この値を確認するには、gcloud artifacts files list コマンドを実行して FILE の値をコピーします。このコマンドでは URL エンコード形式に変換する必要があります。たとえば、path/to/file.jar は path%2Fto%2Ffile.jar として入力する必要があります。

HTTP メソッドと URL:

GET https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、または Cloud Shell）

次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     --output DESTINATION \
     "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -OutFile DESTINATION `
    -Uri "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

すぐにダウンロードが開始します。

次のステップ

• リポジトリを表示してリストにする
• リポジトリのラベル付け
• タグリポジトリ
• リポジトリの削除