在 Artifact Registry 中存储其他格式

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

准备工作

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Artifact Registry API.

    Enable the API

    5.

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Artifact Registry API.

    Enable the API

    8.

启动 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. 如需在位置 us-central1 中创建一个名为 quickstart-generic-repo 且带有说明 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 账号产生费用，请删除包含这些资源的项目，或者保留项目但删除代码库。

删除项目

    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

后续步骤