Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

8.5. 修剪镜像

要修剪系统因为年龄、状态或超过限值而不再需要的镜像，管理员可运行以下命令： 

$ oc adm prune images [<options>]
Copy to Clipboard Toggle word wrap

目前，若要修剪镜像，您必须先以具有访问令牌的用户身份登录到 CLI。用户还必须有集群角色 system:image-pruner 或更高级别的角色（如 cluster-admin）。

除非使用了 --prune-registry=false，否则修剪镜像会从集成 registry 中移除数据。

使用 --namespace 标志修剪镜像时不移除镜像，只移除镜像流。镜像是没有命名空间的资源。因此，将修剪限制到特定的命名空间会导致无法计算其当前使用量。

默认情况下，集成 registry 会缓存 blob 元数据来减少对存储的请求数量，并提高处理请求的速度。修剪不会更新集成 registry 缓存。在修剪后推送的镜像如果含有修剪的层，它们会被破坏，因为不会推送在缓存中有元数据的已修剪层。因此，修剪之后需要清除缓存。这可以通过重新部署 registry 来完成： 

# oc patch deployment image-registry -n openshift-image-registry --type=merge --patch="{\"spec\":{\"template\":{\"metadata\":{\"annotations\":{\"kubectl.kubernetes.io/restartedAt\": \"$(date '+%Y-%m-%dT%H:%M:%SZ' -u)\"}}}}}"
Copy to Clipboard Toggle word wrap

如果集成 registry 使用 Redis 缓存，您必须手动清理数据库。

oc adm prune images 操作需要 registry 的路由。默认不创建 registry 路由。请参阅 OpenShift Container Platform 中的 Image Registry Operator 来了解有关如何创建 registry 路由的信息，并参阅公开 registry来了解有关如何公开 registry 服务的详细信息。

Expand
表 8.4. 修剪镜像 CLI 配置选项
选项描述

--all

包括没有推送到 registry 但已通过 pullthrough 镜像的镜像。默认为开启。要将修剪限制为已被推送到集成 registry 的镜像，请传递 --all=false。

--certificate-authority

与 OpenShift Container Platform 管理的 registry 通信时使用的证书颁发机构文件的路径。默认为来自当前用户配置文件的证书颁发机构数据。如果提供，则发起安全连接。

--confirm

指明应该执行修剪，而不是空运行。这需要具有指向集成容器镜像 registry 的有效路由。如果此命令在集群网络外运行，则必须使用 --registry-url 来提供路由。

--force-insecure

谨慎使用这个选项。允许与通过 HTTP 托管或具有无效 HTTPS 证书的容器 registry 进行不安全连接。

--keep-tag-revisions=<N>

对于每个镜像流，每个标签最多保留 N 个镜像修订（默认值 3）。

--keep-younger-than=<duration>

不修剪相对于当前时间年龄不到 <duration> 的镜像。不修剪被相对于当前时间年龄不到 <duration> 的其他对象引用的镜像（默认值 60m）。

--prune-over-size-limit

修剪超过同一项目中定义的最小限值的每个镜像。此标志不能与 --keep-tag-revisions 或 --keep-younger-than 结合使用。

--registry-url

联系 registry 时使用的地址。此命令尝试使用由受管镜像和镜像流决定的集群内部 URL。如果失败（registry 无法解析或访问），则需要使用此标志提供一个替代路由。可以在 registry 主机名中加上前缀 https:// 或 http:// 来强制执行特定的连接协议。

--prune-registry

此选项与其他选项指定的条件结合，可以控制是否修剪 registry 中与 OpenShift Container Platform 镜像 API 对象对应的数据。默认情况下，镜像修剪同时处理镜像 API 对象和 registry 中对应的数据。当您只关注移除 etcd 内容时（可能要减少镜像对象的数量，但并不关心清理 registry）或要通过硬修剪 registry 来单独进行操作（可能在 registry 的适当维护窗口期间），此选项很有用处。

8.5.1. 镜像修剪条件
复制链接

  • 对于“由 OenShift Container Platform 管理”的镜像（带有注解 openshift.io/image.managed 的镜像），请移除创建时间为至少 --keep-younger-than 分钟前，且目前没有被以下对象引用的镜像：

    • 任何 --keep-younger-than 分钟前之后创建的 Pod。
    • 任何 --keep-younger-than 分钟前之后创建的镜像流。
    • 任何正在运行的 Pod。
    • 任何待处理的 Pod。
    • 任何 ReplicationController。
    • 任何部署。
    • 任何 DeploymentConfig。
    • 任何 ReplicaSets。
    • 任何构建配置。
    • 任何构建。
    • stream.status.tags[].items 中 --keep-tag-revisions 个最新项。

  • 对于“由 OpenShift Container Platform 管理”的镜像（带有注解 openshift.io/image.managed 的镜像），请移除超过同一项目中定义的最小限值，并且目前没有被以下对象引用的镜像：

    • 任何正在运行的 Pod。
    • 任何待处理的 Pod。
    • 任何 ReplicationController。
    • 任何部署。
    • 任何 DeploymentConfig。
    • 任何 ReplicaSets。
    • 任何构建配置。
    • 任何构建。
  • 不支持从外部 registry 进行修剪。
  • 镜像被修剪后，会从在 status.tags 引用了该镜像的所有镜像流中移除对该镜像的所有引用。
  • 移除不再被任何镜像引用的镜像层。
注意

--prune-over-size-limit 标志无法与 --keep-tag-revisions 或 --keep-younger-than 标志结合使用。这样做会返回不允许操作的信息。

若要分开移除 OpenShift Container Platform 镜像 API 对象和 registry 中的数据，可以使用 --prune-registry=false 选项再硬修剪 registry；这可以缩减一些计时窗口，与尝试通过一个命令同时修剪这两者相比也更为安全。但是，计时窗口不会完全剔除。

例如，您仍然可在创建引用某一镜像的 Pod，因为修剪会将该镜像标识为需要修剪。您仍应追踪在修剪操作期间创建的可能会引用镜像的 API 对象，从而避免引用已删除的内容。

另请注意，重做修剪时如果不带 --prune-registry 选项或带有 --prune-registry=true 选项，不会造成修剪之前通过 --prune-registry=false 修剪的镜像的镜像 registry 中关联的存储。对于任何使用 --prune-registry=false 修剪的镜像，只能通过硬修剪注册表将其从 registry 存储中删除。

8.5.2. 运行镜像修剪操作
复制链接

流程

  1. 查看修剪操作要删除的对象：

    1. 最多保留三个标签修订，并且保留年龄不足 60 分钟的资源（镜像、镜像流和 Pod）： 

      $ oc adm prune images --keep-tag-revisions=3 --keep-younger-than=60m
      Copy to Clipboard Toggle word wrap

    2. 修剪超过定义的限值的所有镜像： 

      $ oc adm prune images --prune-over-size-limit
      Copy to Clipboard Toggle word wrap

  2. 使用上一步中的选项真正执行修剪操作： 

    $ oc adm prune images --keep-tag-revisions=3 --keep-younger-than=60m --confirm
    Copy to Clipboard Toggle word wrap 
    $ oc adm prune images --prune-over-size-limit --confirm
    Copy to Clipboard Toggle word wrap

8.5.3. 使用安全或不安全连接
复制链接

安全连接是首选和推荐的方法。它通过 HTTPS 协议来进行，并且会强制验证证书。若有可能，prune 命令始终会尝试使用这种连接。如果不可能，某些情况下会回退到不安全连接，而这存在危险。这时，会跳过证书验证或使用普通 HTTP 协议。

除非指定了 --certificate-authority，否则以下情形中允许回退到不安全连接：

  1. 使用 --force-insecure 选项运行 prune 命令。
  2. 提供的 registry-url 带有 http:// 架构前缀。
  3. 提供的 registry-url 是本地链路地址或 localhost。
  4. 当前用户的配置允许不安全连接。造成的原因可能是用户使用 --insecure-skip-tls-verify 登录或在提示时选择不安全连接。
重要

如果 registry 使用有别于 OpenShift Container Platform 所用的证书颁发机构进行保护，则必须通过 --certificate-authority 标志来指定。否则，prune 命令会出错。

8.5.4. 镜像修剪问题
复制链接

镜像没有被修剪

如果您的镜像不断积累，且 prune 命令只移除您的预期的少许部分，请确保清楚镜像视为修剪候选者时必须要满足的镜像修剪条件。

确保您要移除的镜像在每个标签历史记录中所处的位置高于您选择的标签修订阈值。例如，有一个名为 sha:abz 的陈旧镜像。在标记镜像的密码空间 N 中运行以下命令，会造成在一个名为 myapp 的镜像流对该镜像标记三次： 

$ image_name="sha:abz"
$ oc get is -n N -o go-template='{{range $isi, $is := .items}}{{range $ti, $tag := $is.status.tags}}'\
  '{{range $ii, $item := $tag.items}}{{if eq $item.image "'"${image_name}"\
  $'"}}{{$is.metadata.name}}:{{$tag.tag}} at position {{$ii}} out of {{len $tag.items}}\n'\
  '{{end}}{{end}}{{end}}{{end}}'
myapp:v2 at position 4 out of 5
myapp:v2.1 at position 2 out of 2
myapp:v2.1-may-2016 at position 0 out of 1
Copy to Clipboard Toggle word wrap

使用默认选项时，不会修剪该镜像，因为它出现在 myapp:v2.1-may-2016 标签历史记录中的位置 0 上。要将镜像视为需要修剪，管理员必须：

  • 在运行 oc adm prune images 命令时指定 --keep-tag-revisions=0。

    Important

    此操作实际上从所有含有基础镜像的命名空间中移除所有标签，除非它们比指定阈值年轻，或者有比指定阈值年轻的对象引用它们。

  • 删除所有位置低于修订阈值的 istag，即 myapp:v2.1 和 myapp:v2.1-may-2016。
  • 在历史记录中进一步移动镜像，可以通过运行新构建并推送到同一 istag 或者标记其他镜像。遗憾的是，这对旧版标签可能并不始终适合。

应该避免在标签的名称中包含某个特定镜像的构建日期或时间，除非镜像必须保留不定的时长。这样的标签通常在历史记录中只有一个镜像，实际上会永久阻止它们被修剪。

对不安全 registry 使用安全连接

如果您在 oc adm prune images 命令的输出中看到类似于如下的消息，这表示您的 registry 未受保护，并且 oc adm prune images 客户端尝试使用安全连接： 

error: error communicating with registry: Get https://172.30.30.30:5000/healthz: http: server gave HTTP response to HTTPS client
Copy to Clipboard Toggle word wrap
  1. 建议的解决方案是保护 registry 的安全。否则，您需要强制客户端使用不安全连接，方法是在命令中附加 --force-insecure，但并不建议这样做。
对受保护 registry 使用不安全连接

如果您在 oc adm prune images 命令中看到以下错误之一，这表示您的 registry 已设有保护，但签署其证书的证书颁发机构与 oc adm prune images 客户端用于连接验证的不同： 

error: error communicating with registry: Get http://172.30.30.30:5000/healthz: malformed HTTP response "\x15\x03\x01\x00\x02\x02"
error: error communicating with registry: [Get https://172.30.30.30:5000/healthz: x509: certificate signed by unknown authority, Get http://172.30.30.30:5000/healthz: malformed HTTP response "\x15\x03\x01\x00\x02\x02"]
Copy to Clipboard Toggle word wrap

默认情况下，使用存储在用户配置文件中的证书颁发机构数据；与主 API 通信时也是如此。

使用 --certificate-authority 选项为容器镜像 registry 服务器提供正确的证书颁发机构。

使用错误的证书颁发机构

以下错误表示用来为受保护容器镜像 registry 的证书签名的证书颁发机构与客户端使用的不同： 

error: error communicating with registry: Get https://172.30.30.30:5000/: x509: certificate signed by unknown authority
Copy to Clipboard Toggle word wrap

务必通过 --certificate-authority 提供正确的证书颁发机构。

作为一种临时解决方案，您可以添加 --force-insecure 标签。不过，我们不建议这样做。

其他资源

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat