在 Artifact Registry 中存储其他格式

在 Artifact Registry 中存储其他格式

预览

此功能须遵守服务专用条款的“通用服务条款”部分中的“非正式版产品条款”。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

了解如何设置 Artifact Registry 通用格式代码库并上传 YAML 文件。

准备工作

1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. 确保您的 Google Cloud 项目已启用结算功能。

4. Enable the Artifact Registry API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. 确保您的 Google Cloud 项目已启用结算功能。

7. Enable the Artifact Registry API.

   Enable the API

启动 Cloud Shell

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

在本快速入门中，您将使用 Cloud Shell 运行 gcloud 命令。

创建通用代码库

1. 如需在以下位置创建一个名为 quickstart-generic-repo 的通用格式仓库： 位置 us-central1（说明为 Generic repository），请运行 以下命令：

   gcloud artifacts repositories create quickstart-generic-repo \
       --repository-format=generic \
       --location=us-central1 \
       --description="Generic repository"
   

2. 如需验证您的代码库是否已创建，请运行以下命令：

   gcloud artifacts repositories list
   

3. 如需简化 gcloud 命令，请运行以下命令以设置默认值 存储到 quickstart-generic-repo，并将默认位置存储到 us-central1。

   1. 如需将默认代码库设置为 quickstart-generic-repo，请运行 以下命令：

      gcloud config set artifacts/repository quickstart-generic-repo
      

   2. 如需将默认位置设置为 us-central1，请运行以下命令：

      gcloud config set artifacts/location us-central1
      

   设置值后，您无需在 gcloud 中指定它们 需要使用代码库或位置的命令

将制品上传到代码库

1. 在您的主目录中，创建一个要上传到代码库的文件：

   echo "hello world" > hello.yaml
   

2. 如需将文件作为工件上传到代码库，请运行以下命令 命令：

   gcloud artifacts generic upload \
       --source=hello.yaml \
       --package=my-package \
       --version=1.0.0
   

   其中：

   • hello.yaml 是要上传的文件的路径。
   • my-package 是要上传的软件包。
   • 1.0.0 是工件的版本。您无法覆盖代码库中的现有版本。

查看代码库中的制品

要验证工件是否已添加到代码库，您可以 来创建工件

gcloud artifacts files list

响应包含采用 PACKAGE:VERSION:FILE_NAME 格式的文件详细信息。

在以下示例中，hello.yaml 为 FILE_NAME：

FILE: my-package:1.0.0:hello.yaml
CREATE_TIME: 2023-03-09T20:55:07
UPDATE_TIME: 2023-03-09T20:55:07
SIZE (MB): 0.000
OWNER: projects/my-project/locations/us-central1/repositories/quickstart-generic-repo/packages/my-package/versions/1.0.0

下载通用工件

如需从代码库下载通用工件，请运行以下命令：

gcloud artifacts generic download \
    --name=hello.yaml \
    --package=my-package \
    --version=1.0.0 \
    --destination=DESTINATION

其中：

• hello.yaml 是要下载的文件的名称。
• my-package 是要下载的软件包。
• 1.0.0 是工件的版本。

将 DESTINATION 替换为您要在本地文件系统中保存下载内容的目录。目标文件夹必须 已存在，否则该命令将失败。

清理

为避免系统因资源向您的 Google Cloud 账号收取费用 您可以删除包含这些资源的项目，也可以删除 或者保留项目并删除代码库。

删除项目

注意：删除项目会产生以下影响：

• 项目中的所有内容都会被删除。如果您将现有项目用于本文档中的任务，则删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。要保留使用该项目 ID 的网址（例如 appspot.com 网址），请删除项目内的所选资源，而不是删除整个项目。

如果您打算探索多个架构、教程或快速入门，则重复使用项目可以帮助您避免超出项目配额限制。

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

删除代码库

在移除代码库之前，请确保要保留的任何软件包在其他位置提供。

1. 如需删除 quickstart-generic-repo 代码库，请运行以下命令：

   gcloud artifacts repositories delete quickstart-generic-repo
   

2. 如果要移除您为活跃 gcloud 配置配置的默认代码库和位置设置，请运行以下命令：

   gcloud config unset artifacts/repository
   gcloud config unset artifacts/location
   

后续步骤

• 详细了解通用工件