本页面介绍如何管理 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会移除应用于映像版本的所有标记。借助此标志，您可以在以下情况下强制删除映像版本：- 您指定了一个标记，但有其他标记与映像版本相关联。
- 您指定的映像摘要至少具有一个标记。