更新代码库设置

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

  • 代码库说明。

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

  • 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。如需详细了解如何使用标签,请参阅为代码库添加标签