本页面介绍如何管理 Docker 代码库中的容器映像。管理映像包括列出代码库中的映像、添加标记、删除标记、将映像复制到新代码库以及删除映像。
如需了解如何推送和拉取映像,请参阅推送和拉取映像。
准备工作
- 如果目标代码库不存在,请创建新代码库。
- 验证您是否拥有访问代码库所需的权限。
- (可选)为 gcloud 命令配置默认值。
列出映像
您可以使用 Google Cloud Console 或命令行列出映像。
代码库列表同时包括 Artifact Registry 和 Container Registry 代码库。如需使用 Container Registry 代码库中的映像,请参阅 Container Registry 文档中的管理映像。
控制台
如需查看映像或映像版本的列表,请执行以下操作:
在 Cloud Console 中打开 代码库页面。
点击包含映像的代码库。
点击映像即可查看映像的版本,包括摘要和标记。
gcloud
如需在配置默认值时列出默认项目、代码库和位置中的所有映像,请运行以下命令:
gcloud artifacts docker images list [--include-tags]
如需列出特定位置的代码库中的所有映像,请运行以下命令:
gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY [--include-tags]
如需列出特定映像的所有摘要和标记,请运行以下命令:
gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE [--include-tags]
其中
- LOCATION 是代码库的单区域或多区域位置。
- PROJECT 是您的 Google Cloud Console 项目 ID。如果您的项目 ID 包含英文冒号 (
:
),请参阅网域级项目。 - REPOSITORY 是存储了映像的代码库的名称。
- IMAGE 是代码库中的映像名称。
--include-tags
会显示映像的所有版本,包括摘要和标记。如果省略此标志,则返回的列表仅包含顶级容器映像。
例如,假设一个映像具有以下特征:
- 代码库位置:
us
- 代码库名称:
my-repo
- 项目 ID:
my-project
- 映像名称:
my-image
完整的代码库名称为:
us-docker.pkg.dev/my-project/my-repo
完整的映像名称为:
us-docker.pkg.dev/my-project/my-repo/my-image
如需详细了解映像名称格式(包括如何处理网域级项目),请参阅代码库和映像名称。
标记映像
您可以在 Artifact Registry 代码库中标记现有映像,也可以先标记这些映像,然后再将其推送到代码库。
标记代码库中的映像
您可以使用 Google Cloud Console 或命令行为 Artifact Registry 代码库中的映像添加标记。在代码库中,每个映像版本的标记各不相同。因此,如果某个映像存在多个版本,则每个标记仅适用于其中一个版本。如果使用已被占用的标记来标记映像,则该标记将从原始版本迁移到新标记的版本。
控制台
如需标记代码库中的现有映像,请执行以下操作:
在 Cloud Console 中打开 代码库页面。
点击映像以查看映像的版本。
选择要标记的映像版本。
在所选版本的行中,点击更多操作 (
),然后点击修改标记。
在字段中输入新标记,然后点击保存。
gcloud
如需标记代码库中的现有映像,请使用映像摘要或标记指定映像版本,然后指定要添加的标记。运行下列其中一个命令:
gcloud artifacts docker tags add IMAGE-VERSION TAG
其中
例如,假设一个映像具有以下特征:
- 代码库位置:
us
- 代码库名称:
my-repo
- 项目 ID:
my-project
- 映像名称:
my-image
- 现有标记:
iteration6-final
- 要添加的标签:
release-candidate
如需向带有标记 iteration6-final
的映像版本添加标记 release-candidate
,请运行以下命令:
gcloud artifacts docker tags add \
us-docker.pkg.dev/my-project/my-repo/my-image:iteration6-final \
us-docker.pkg.dev/my-project/my-repo/my-image:release-candidate
如需详细了解映像名称格式(包括如何处理网域级项目),请参阅代码库和映像名称。
标记本地映像
如需将任何本地映像推送到 Artifact Registry,您首先需要使用代码库名称标记该映像,然后再进行推送。如需查看相关说明,请参阅推送和拉取。
取消对映像的标记
您可以使用 Google Cloud Console 或命令行移除 Artifact egistry 映像的标记。
控制台
在 Cloud Console 中打开 代码库页面。
点击映像以查看映像的版本。
选择要取消标记的映像版本。
在所选版本的行中,点击更多操作 (
),然后点击修改标记。
删除标记,然后点击保存。
gcloud
如需删除标记并将其从映像中移除,请运行以下命令:
gcloud artifacts docker tags delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG
其中
删除映像
您可以删除整个容器映像,也可以删除与标记或摘要关联的特定映像版本。删除映像后,您便无法撤消此操作。
还有其他工具可帮助您管理未使用的映像。例如,gcr-cleaner 工具可以根据不同的标准查找并删除旧映像。移除未使用的映像有助于降低存储费用。gcr-cleaner
工具不是 Google 官方产品。
如需从 Google Cloud Console 或 gcloud
工具删除映像,请执行以下操作:
控制台
在 Cloud Console 中打开 代码库页面。
点击映像名称即可查看该映像的版本。
选择您要删除的版本。
点击删除。
在确认对话框中,点击删除。
gcloud
如需删除映像及其所有标记,请运行以下命令:
gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE --delete-tags
如需删除特定映像版本,请使用以下命令之一。
gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG [--delete-tags]或
gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE@DIGEST [--delete-tags]
其中
- LOCATION 是代码库的单区域或多区域位置。
- PROJECT 是您的 Google Cloud Console 项目 ID。如果您的项目 ID 包含英文冒号 (
:
),请参阅网域级项目。 - REPOSITORY 是存储了映像的代码库的名称。
- IMAGE 是代码库中的映像名称。
- TAG 是您要删除的版本的标记。如果多个标记与同一映像版本相关联,则您必须添加
--delete-tags
才能删除映像版本,而无需先移除标记。 - IMAGE-DIGEST 是您要删除的版本的 sha256 哈希值。如果某个标记与映像摘要相关联,则您必须添加
--delete-tags
才能删除映像版本,而无需先移除标记。 --delete-tags
会移除应用于映像版本的所有标记。借助此标志,您可以在以下情况下强制删除映像版本:- 您指定了一个标记,但有其他标记与映像版本相关联。
- 您指定的映像摘要至少具有一个标记。