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

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

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

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

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

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

始める前に

必要なロール

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

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

ファイルの一覧表示

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

次のすべてのコマンドについては、コマンドに --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

次の値を置き換えます。

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

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

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

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

gcloud

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

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

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

Linux、macOS、Cloud Shell

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

Windows（PowerShell）

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

Windows（cmd.exe）

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

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

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

次のステップ