跳到主要内容

从清单列表或镜像索引中移除镜像

概述

podman manifest remove 命令用于从指定的清单列表或镜像索引中移除具有特定摘要的镜像。通过该命令,用户可以轻松地管理多平台镜像分发,删除不再需要的镜像或替换为新的镜像版本。

用法

podman manifest remove [OPTIONS] NAME[:TAG|@DIGEST] IMAGE[:TAG|@DIGEST]

参数

  • NAME[:TAG|@DIGEST]:指定要从中移除镜像的清单列表或镜像索引的名称。可以包含标签(TAG)或摘要(DIGEST)。
  • IMAGE[:TAG|@DIGEST]:指定要移除的镜像的名称,可以包含标签或摘要。该镜像的摘要必须与清单列表或索引中已存在的摘要匹配。

选项

  • --all, -a:移除清单列表中所有匹配的镜像。
  • --format, -f:指定输出格式,例如 JSON。
  • --quiet, -q:静默模式,只输出移除的镜像摘要。

返回值

执行成功后,该命令将返回已移除镜像的摘要以及与之关联的清单镜像的 ID。如果发生错误,将返回相应的错误消息。

示例

示例 1:从清单列表中移除指定摘要的镜像

podman manifest remove mylist:v1.11 sha256:cb8a924afdf0229ef7515d9e5b3024e23b3eb03ddbba287f4a19c6ac90b8d221

在上面的示例中,mylist:v1.11 是清单列表的名称,sha256:cb8a924afdf0229ef7515d9e5b3024e23b3eb03ddbba287f4a19c6ac90b8d221 是要移除的镜像的摘要。

示例 2:静默模式移除镜像并只输出摘要

podman manifest remove --quiet mylist:v1.11 sha256:cb8a924afdf0229ef7515d9e5b3024e23b3eb03ddbba287f4a19c6ac90b8d221

使用 --quiet 选项,命令将只输出已移除镜像的摘要,而不会显示其他详细信息。

注意事项

  • 在执行 podman manifest remove 命令之前,请确保已经安装了 Podman 工具,并且具有足够的权限来访问和修改清单列表或镜像索引。
  • 如果指定的清单列表或镜像索引不存在,或者指定的镜像摘要不存在于清单中,该命令将返回错误。
  • 移除镜像后,清单列表或镜像索引中将不再包含该镜像的引用,但镜像本身并不会被删除。如果需要删除镜像,请使用 podman rmi 命令来执行删除操作。

另请参阅

  • podman(1):Podman 的主命令手册页,提供了关于 Podman 的概述、安装、配置和使用方法的详细信息。
  • podman-manifest(1):Podman manifest 子命令的手册页,提供了关于清单列表和镜像索引的创建、查看、修改和删除等操作的详细信息。

这些手册页是 Podman 文档的重要组成部分,提供了关于 Podman 及其子命令的深入解释和用法示例。建议在使用 Podman 时经常查阅这些手册页,以获取最新的功能、用法和最佳实践。