如何使用 docker manifest rm 命令删除清单列表

介绍

在本次实验里，大家要学习的是Docker清单列表（manifest list）的管理方法，这可是创建多架构镜像的关键所在。我们会详细讲解通过合并不同平台的镜像来创建清单列表的具体步骤，用CODE0命令来验证其是否存在，最后再给大家演示一下如何使用CODE1命令删除清单列表。通过这个实践练习，各位能在Docker工作流程中切实获得处理清单列表的经验。

创建一个清单列表

在这一步中，你将学习如何在 Docker 中创建清单列表（manifest list）。清单列表是一个镜像清单（image manifest）的列表，它允许你使用单个镜像名称来引用不同架构和操作系统的镜像。这对于构建多架构镜像特别有用。

首先，让我们拉取两个不同的镜像，用于创建清单列表。我们将使用 CODE0 和 CODE1 架构的 CODE_2 镜像。

docker pull alpine:latest
docker pull --platform arm64 alpine:latest

第一条命令会为你当前的架构（可能是 CODE0）拉取 CODE1 镜像。第二条命令则会明确为 CODE2 架构拉取 CODE3 镜像。

现在，你可以使用 CODE0 命令来创建清单列表。其语法为 CODE1。我们将创建一个名为 CODE2 的清单列表，其中包含 CODE3 和 CODE4 架构的 CODE5 镜像。

docker manifest create my-alpine:latest alpine:latest alpine:latest --amend alpine:latest --platform arm64

在这个命令中：

• CODE_0 是你要创建的新清单列表的名称。
• CODE_0 是第一个源镜像（针对默认架构）。
• CODE0 将 CODE1 平台的 CODE_2 镜像添加到清单列表中。

运行此命令后，你已经在本地创建了一个清单列表。不过，它尚未推送到镜像仓库（registry）。我们将在后续步骤中进行推送。

验证清单列表是否存在

在上一步中，我们创建了一个名为 CODE_0 的清单列表（manifest list）。现在，我们将验证这个清单列表是否已成功创建并存在于本地。

你可以使用 CODE_0 命令来查看清单列表的详细信息。如果清单列表存在，该命令将以 JSON 格式输出其内容。

docker manifest inspect my-alpine:latest

如果 CODE_0 清单列表已成功创建，你将看到一个描述该清单列表的 JSON 输出，其中包括它为不同架构引用的不同镜像。如果清单列表不存在，该命令将返回错误。

输出将显示有关清单列表的信息，例如架构版本（schema version）、媒体类型（media type）以及包含的每个架构的清单列表。你应该会看到 CODE0 和 CODE1 架构的条目，这证实了清单列表已正确创建，并引用了这些平台的镜像。

删除清单列表

在前面的步骤中，我们创建并验证了名为 CODE_0 的清单列表（manifest list）的存在。现在，我们将学习如何删除这个清单列表。

要删除清单列表，你可以使用 CODE_0 命令，后面跟上清单列表的名称。

docker manifest rm my-alpine:latest

此命令将删除对 CODE0 清单列表的本地引用。请注意，该命令仅删除清单列表本身，而不会删除清单列表所引用的各个镜像。我们之前拉取的 CODE1 和 CODE2 架构的 CODE3 镜像仍将保留在你的系统中。

执行该命令后，你应该会看到表明清单列表已被取消标签（untagged）的输出。

验证清单列表是否已删除

在上一步中，我们删除了名为 CODE_0 的清单列表（manifest list）。现在，我们将验证该清单列表是否已成功删除，并且不再存在于本地。

你可以再次使用 CODE_0 命令来尝试检查该清单列表。如果清单列表已成功删除，此命令应返回一条错误信息，表明未找到该清单列表。

docker manifest inspect my-alpine:latest

在删除清单列表后运行此命令，你应该会看到类似于 CODE_0 的错误消息。这证实了该清单列表已从你的本地 Docker 环境中移除。

总结

在本次实验（Lab）中，我们学习了如何创建和管理 Docker 清单列表（manifest list）。首先，我们拉取了不同架构的镜像，然后使用 CODE_0 命令将它们合并为一个清单列表，展示了如何构建多架构镜像。

创建完成后，我们使用 CODE0 命令验证了清单列表的存在。最后，我们学习了如何使用 CODE1 命令删除清单列表，并确认其已被移除，涵盖了 Docker 中清单列表的基本生命周期管理。