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 中进行核算和限制,但这一情况可能会发生变化
相关推荐
逐流人3 小时前
Ceph分布式存储集群配置与池管理:从配置优先级到PG、复本池与纠删码池
运维·分布式·ceph·云原生·云计算·rados
分布式存储与RustFS7 小时前
图床搬到自己的对象存储:PicGo 加 S3 插件的完整配置
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
分布式存储与RustFS9 小时前
在 Kubernetes 里跑对象存储的三个方案:Helm、Operator、以及什么时候别用 K8s
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
旋生万物12 小时前
素数螺旋映射 $z_n=n^{1+i}$ 的角分布统计检验与零模型对比
大数据·前端·人工智能·算法·云原生·螺旋生成论·螺旋相位
A.说学逗唱的Coke14 小时前
【云原生专题】Kubernetes 备份完全实战:用 Velero 搞定集群备份、恢复与跨集群迁移(附完整命令与踩坑记录)
云原生·容器·kubernetes
分布式存储与RustFS1 天前
模型 checkpoint 放对象存储:分片上传、断点续传与残留清理
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
分布式存储与RustFS1 天前
用RustFS给Harbor当S3存储后端
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
分布式存储与RustFS1 天前
DPU卸载纠删码与加密:解决AI对象存储的CPU瓶颈
云原生·开源·对象存储·分布式存储·s3·rustfs·性能基准
kuroomi1 天前
非云原生应用监控
云原生
分布式存储与RustFS1 天前
自托管对象存储的三种 TLS 签发:自签、Let‘s Encrypt、内网 CA 的选择与轮换
运维·云原生·开源·对象存储·分布式存储·s3·性能基准