在附件中存储工件元数据

gcloud（所有格式）

在使用下面的命令数据之前，请先进行以下替换：

• ATTACHMENT：附件的完全限定名称，例如 projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment。 或者，仅提供附件 ID，并使用 --location 和 --repository 标志。
• TARGET：完全限定的版本名称。 对于 Docker 映像，您还可以使用附件所指工件的 Artifact Registry URI。在 URI 中，您可以使用摘要，也可以使用标记（对于 Docker 映像而言），例如 us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1。
• TYPE：附件的 type 属性。对于 Docker 映像，type 必须符合 OCI 关于 artifactType 属性的规范。
• ATTACHMENT_NAMESPACE：附件特有的变量，用于标识附件数据源，例如 example.com。
• FILES：要包含在附件中的本地文件的英文逗号分隔列表。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud artifacts attachments create ATTACHMENT \
    --target=TARGET \
    --attachment-type=TYPE \
    --attachment-namespace=ATTACHMENT_NAMESPACE \
    --files=FILES

Windows (PowerShell)

gcloud artifacts attachments create ATTACHMENT `
    --target=TARGET `
    --attachment-type=TYPE `
    --attachment-namespace=ATTACHMENT_NAMESPACE `
    --files=FILES

Windows (cmd.exe)

gcloud artifacts attachments create ATTACHMENT ^
    --target=TARGET ^
    --attachment-type=TYPE ^
    --attachment-namespace=ATTACHMENT_NAMESPACE ^
    --files=FILES

如需了解详情，请参阅 gcloud artifacts attachments create 命令。

Oras（仅限 Docker）

使用 Oras 创建附件时，Artifact Registry 会生成一个随机 UUID 用作附件名称。

在使用 Oras 之前，请完成以下步骤：

1. 安装 Oras 1.2 或更高版本。如需验证版本，请运行 oras version 命令。

2. 配置 Oras 以通过 Artifact Registry 进行身份验证。

在运行命令之前，请先进行以下替换：

• ARTIFACT_TYPE：附件的 artifactType。

• IMAGE_URI：附件所指的图片容器的 URI。

• FILE：要作为附件中的元数据包含在内的本地文件。

• MEDIA_TYPE：层的 mediaType。

  oras attach --artifact-type ARTIFACT_TYPE IMAGE_URI FILE:MEDIA_TYPE

以下示例创建了一个附件，其中包含一个文件 (hello-world.txt)，该文件引用了一个容器映像 (my-image)，该容器映像由其 URI 和标记标识：

  oras attach --artifact-type doc/example \
  us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1 \
  hello-world.txt:application/vnd.me.hi

其中：

• doc/example 用于定义附件的 artifactType 属性。

• us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1 是 URI，包含附件将引用的容器映像版本标记。

• hello-world.txt 是附件将作为其数据保存的本地文件。

• application/vnd.me.hi 定义图层的 mediaType。

如需查看完整指南和更多示例，请参阅 oras attach 文档。