下載檔案

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

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

可下載的檔案

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

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

事前準備

• (選用) 設定 gcloud CLI 指令的預設值。

必要的角色

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

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

可列出檔案

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

主控台

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

注意： 請務必執行下列任一指令，透過驗證和專案初始化 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：經過網址編碼的檔案名稱。如要找出這個值，請執行 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

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

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"

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

後續步驟

• 查看及列出存放區
• 標籤存放區
• 代碼存放區
• 刪除存放區