您可以更新以下代码库设置:
代码库说明。
远程仓库上游身份验证详细信息。
Docker 代码库的不可变映像标记。启用此设置后,映像标记将始终指向同一映像摘要,包括默认的
latest
标记。如需详细了解映像标记、映像摘要和不可更改的映像标记,请参阅容器映像版本。
代码库标签。
所需的角色
如需获取更新代码库设置所需的权限,请让管理员授予您 Google Cloud 项目的 Artifact Registry Administrator (roles/artifactregistry.admin
) IAM 角色。如需详细了解如何授予角色,请参阅管理访问权限。
更新设置
您可以使用 Google Cloud 控制台或 Google Cloud CLI 更新设置。
控制台
打开 Google Cloud 控制台中的制品库页面。
在代码库列表中,选择相应代码库,然后点击修改代码库。
修改您想要更改的设置:
- 更改代码库说明。
- 更新远程代码库上游身份验证详细信息。
在不可变的映像标记部分中启用或停用不可更改的映像标记。如果您启用此设置,则不允许执行以下操作:
- 删除带标记的映像。
- 从映像中移除标记。
- 推送一个带有标记的映像,该标记已被代码库中的另一个映像版本使用。
- 添加、移除或更新标签。
点击保存。
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
。如需详细了解如何使用标签,请参阅为代码库添加标签。