下載檔案

本頁說明如何從 Artifact Registry 標準存放區和遠端存放區下載個別檔案。存放區可以是任何構件格式。

如果您想將檔案匯入本機環境，但不想使用特定格式的工具，下載檔案會很有幫助。請注意，您仍須先向 Artifact Registry 進行驗證，才能下載檔案。

可下載的檔案

您可以下載存放區中的任何個別資料或中繼資料檔案。 舉例來說，Maven 存放區會將 Java 套件儲存為構件。Java 套件中的所有檔案 (例如 jar 檔案和 pom.xml 檔案) 都可以個別下載。

如果構件在下載作業中高度依賴用戶端工具，例如 Docker 映像檔，則不建議使用這項功能。

事前準備

必要的角色

如要取得下載存放區中儲存檔案所需的權限，請要求管理員授予您存放區的 Artifact Registry 讀取者 (roles/artifactregistry.reader) 身分與存取權管理角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

您或許還可透過自訂角色或其他預先定義的角色取得必要權限。

可列出檔案

您可以列出存放區中的檔案，查看可供下載的項目。

主控台

  1. 在 Google Cloud 控制台中開啟「Repositories」(存放區) 頁面。

    開啟「存放區」頁面

  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 artifacts files list。

下載檔案

如要從存放區下載個別檔案，請執行下列指令：

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：經過網址編碼的檔案名稱。您可以執行 gcloud artifacts files list 指令，然後複製 FILE 的值，即可找到這個值。必須轉換為網址編碼格式，才能使用這項指令。舉例來說，path/to/file.jar必須輸入為 path%2Fto%2Ffile.jar。

HTTP 方法和網址：

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

如要傳送要求，請展開以下其中一個選項：

下載作業應該會立即開始。

後續步驟