更新代码库设置

您可以更新以下代码库设置:

  • 代码库说明。

  • 远程仓库上游身份验证详细信息。

  • Docker 代码库的不可更改的映像标记。如果您启用了此设置 映像标记始终指向同一映像摘要,包括 默认的 latest 标记。

    如需详细了解映像标记、映像摘要和不可更改的映像标记,请参阅容器映像版本

  • 代码库标签

所需的角色

如需获取更新代码库设置所需的权限, 请让管理员授予您 Google Cloud 项目的 Artifact Registry Administrator (roles/artifactregistry.admin) IAM 角色。 如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限

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

更新设置

您可以使用 Google Cloud 控制台或 Google Cloud CLI 更新设置。

控制台

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

    打开“代码库”页面

  2. 在代码库列表中,选择相应代码库,然后点击修改代码库

  3. 修改要更改的设置:

    • 更改代码库说明。
    • 更新远程仓库上游身份验证详细信息。
    • 启用停用 不可更改的映像标记部分。如果您启用此设置,则不允许执行以下操作:

      • 删除带标记的映像。
      • 从图片中移除链接。
      • 推送的映像使用了仓库中另一个映像版本已使用的标记。
      • 添加、移除或更新标签。
  4. 点击保存

gcloud

如需修改代码库说明,请运行以下命令:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --description="DESCRIPTION"

如需更新远程仓库上游身份验证详细信息,请运行 以下命令:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --remote-username=USERNAME \
    --remote-password-secret-version=projects/PROJECT_ID/secrets/SECRET_ID/versions/SECRET_VERSION

如需修改图片标记的可变性,请运行以下命令之一:

如需将映像标记设置为不可变,请执行以下操作:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --immutable-tags

如需将图片代码设为可变,请执行以下操作:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --no-immutable-tags

如需更新标签,请运行以下命令:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --update-labels="KEY=VALUE,..."

替换以下值:

  • REPOSITORY 替换为代码库的名称。如果您配置了默认代码库,则可以省略此标志以使用默认值。
  • PROJECT-ID 替换为 Google Cloud 项目 ID。如果省略此标志,则系统会使用当前项目或默认项目。
  • LOCATION 与单区域或多区域位置。使用此标志可查看特定位置的代码库。如果您配置了默认位置,则可以省略此标志以使用默认值。
  • DESCRIPTION 替换为代码库说明。
  • USERNAME 替换为您的上游代码库用户名。
  • SECRET_ID 替换为您的 Secret 名称。
  • SECRET_VERSION 替换为您要创建的 Secret 版本 。
  • TAG-SETTING 指示标记与版本的关联方式 图片。
  • --no-immutable-tags:标记指向的映像版本可能会发生变化。删除映像、移除标记和更改 标记指向的图片。
  • --immutable-tags:在代码库中,标记始终指向映像的同一版本。不允许进行以下操作:
    • 删除带链接的图片。
    • 从图片中移除链接。
    • 推送的映像使用了仓库中另一个映像版本已使用的标记。
  • KEY=VALUE,...,包含 以英文逗号分隔的标签,指定为键值对。例如 team=team-1,product=example_product,stage=development。更多信息 如需了解如何使用标签,请参阅标签库

后续步骤