containerd中文翻译系列(十)镜像验证

下面将介绍默认的 "bindir"ImageVerifier插件实现。

要启用图像验证,请在 containerd 配置中添加类似下面的一段:

yaml 复制代码
[plugins]
  [plugins."io.containerd.image-verifier.v1.bindir"]
    bin_dir = "/opt/containerd/image-verifier/bin"
    max_verifiers = 10
    per_verifier_timeout = "10s"

如果存在,bin_dir中的所有文件都必须是符合以下 API 的验证器可执行文件。

镜像校验器二进制 API

CLI 参数

  • -name: 可提取的镜像的给定引用。
  • -digest: 可提取镜像的解析摘要。
  • -stdin-media-type: 传入 stdin 的 JSON 数据的媒体类型。

标准输入

经过 JSON 编码的有效载体会传入验证程序二进制文件的标准输入。该有效载体的

媒体类型由 -stdin-media-type CLI参数指定,并可能在 containerd 的未来版本中发生变化。目前有效载体的媒体类型是 application/vnd.oci.descriptor.v1+json代表可能被提取的镜像的 OCI 内容描述符。参见OCI 规范了解更多详情。

镜像提取判断

向标准输出端打印镜像提取判断的原因。

返回 0 的退出代码表示允许调出镜像,返回任何其他退出代码表示阻止调出镜像。

镜像校验器调用者合约

  • 如果 bin_dir 不存在或不包含任何文件,则镜像校验器不会阻止镜像提取。
  • 只有当所有被调用的校验器都返回 ok判断(以状态代码 0 退出)时,才会提取镜像。换句话说,镜像提取判断是由 AND运算符组合而成的。
  • 如果任何验证器超过了 per_verifier_timeout 或执行失败,则验证失败并显示错误,同时返回 nil 判断。
  • 如果 max_verifiers < 0,则对调用的镜像校验器数量没有限制。
  • 如果 max_verifiers >= 0,则对调用的镜像校验器数量有限制。bin_dir中的条目按名称的词序排序,第一个 n=max_verifiers 的校验器将被调用,其余的将被跳过。
  • 无法保证验证程序二进制文件的执行顺序。
  • 验证程序二进制文件的标准错误输出会被 containerd 记录在调试级别,但会被截断。
  • 校验二进制文件的标准输出(判断的 "reason")会被截断。
  • 验证程序二进制文件使用的系统资源目前在 containerd 自己的 cgroup 中进行核算和限制,但这一情况可能会发生变化
相关推荐
张忠琳13 小时前
【NVIDIA】 NVIDIA Container Toolkit v1.19.1 — OCI 模块超深度分析之三
云原生·容器·架构·kubernetes·nvidia
阿里云云原生14 小时前
让 AI Agent 看见正在发生的业务,阿里云 EventHouse 正式商业化
云原生
AOwhisky15 小时前
Python 学习笔记(第十五期)——运维自动化(下·后篇):堡垒机实战——paramiko高阶篇
运维·python·学习·云原生·自动化·运维开发
微三云 - 廖会灵 (私域系统开发)18 小时前
电商系统从单体到微服务拆分实践:拆什么、怎么拆、拆完后怎么办
微服务·云原生·架构
前端Baymax20 小时前
K8s PodCrashLoopBackOff假阳性排查
云原生·容器·kubernetes
guslegend21 小时前
领域驱动设计,微服务设计为什么要选择DDD?
微服务·云原生·架构
AOwhisky1 天前
云原生 DevOps 工具链从入门到实战(第一期)——DevOps概述与GitLab部署——从理念到工具落地
运维·ci/cd·云原生·gitlab·开发·devops
BIGmustang1 天前
ACK的集群日志接入及ARMS的应用性能监控及主机监控(云监控)
阿里云·云原生
VortMall1 天前
全维度打磨细节体验,赋能商城稳定有序运营|VortMall 微服务商城 v1.3.11 版本发布
java·微服务·云原生·架构·商城系统·开源商城·vortmall
MicrosoftReactor1 天前
技术速递|智能体测试智能体:基于 Foundry Hosted Agents 构建云原生 Skill-Eval Harness
ai·云原生·agent·ai-agent·skill