下载文件

本页面介绍了如何从 Artifact Registry 下载各个文件 标准代码库和远程代码库。 代码库可以是任何工件格式。

当您将文件保存到本地时，下载文件会非常有用 环境。请注意，您必须仍然 在下载文件之前向 Artifact Registry 进行身份验证。

可下载的文件

您可以下载代码库中的任何单个数据或元数据文件。 例如，Maven 制品库会将 Java 软件包存储为制品。任何文件 （如 jar 文件和 pom.xml 文件）中， 可供下载。

对于严重依赖 用于下载操作的客户端工具，例如 Docker 映像。

准备工作

所需的角色

如需获取下载存储在代码库中的文件所需的权限， 请让管理员向您授予 代码库的 Artifact Registry Reader (roles/artifactregistry.reader) IAM 角色。 如需详细了解如何授予角色，请参阅管理访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

列出文件

您可以列出代码库中的文件，以查看可供下载的文件。

控制台

  1. 打开 Google Cloud 控制台中的制品库页面。

    打开“代码库”页面

  2. 在代码库列表中，选择该��码库。

  3. 点击软件包的名称。

  4. 如需查看所有软件包版本的可下载文件，请点击 Files（文件） 标签页。

  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

如需发送您的请求，请展开以下选项之一：

您应该会看到系统立即开始下载。

后续步骤