quay.io/jetstack/cert-manager-ctl:v1.10.2

cert-manager-ctl 容器镜像说明

技术定位

quay.io/jetstack/cert-manager-ctl 是 Jetstack 官方提供的 cert-manager 配套命令行工具（CLI）容器镜像。cert-manager 是 Kubernetes 生态中主流的证书自动化管理工具，而 cert-manager-ctl 通常用于辅助管理、调试和操作 cert-manager 相关资源，如证书签发、续期、状态查询等。

版本说明

镜像 tag 遵循语义化版本（SemVer），主要包含以下版本系列：

• v1.12.x：长期支持版本，包含多个修订版（如 v1.12.8 至 v1.12.17）
• v1.13.x：包含 alpha、beta 测试版（如 v1.13.0-alpha.0）及正式版（如 v1.13.0 至 v1.13.6）
• v1.14.x：最新稳定版本系列，涵盖 alpha、beta 预览版（如 v1.14.0-alpha.0）及正式修订版（如 v1.14.0 至 v1.14.7）

建议根据集群中 cert-manager 的部署版本选择匹配的 tag，以确保兼容性。

典型使用场景

• 日常运维：查询证书状态、手动触发证书续期或吊销
• 问题调试：排查证书签发失败、Issuer/ClusterIssuer 配置错误等问题
• 自动化集成：在 CI/CD 流程中嵌入证书管理操作，如证书备份或配置校验
• 资源管理：批量操作 cert-manager 自定义资源（CR），如 Certificate、Order 等

与 Kubernetes 生态的关系

• 依赖 Kubernetes：需连接 Kubernetes 集群 API 以操作 cert-manager 资源，通常通过挂载 kubeconfig 或使用集群内 ServiceAccount 认证
• cert-manager 配套工具：与 cert-manager 主组件（如 controller、webhook）版本需保持一致，避免因 API 版本差异导致功能异常
• 容器化部署：可通过 Docker 或 Kubernetes Job 运行，示例命令：

# 本地运行（需挂载 kubeconfig）
  docker run --rm -v $HOME/.kube/config:/kubeconfig \
    quay.io/jetstack/cert-manager-ctl:v1.14.7 \
    --kubeconfig /kubeconfig [command]

注意事项

• 具体命令及参数需参考 cert-manager 官方文档（镜像本身未包含文档）
• 生产环境建议使用正式版 tag（不含 alpha/beta 标识），并定期更新以获取安全补丁
• 操作前需确保对 cert-manager 资源有足够的 RBAC 权限（如 certificates.cert-manager.io 资源的读写权限）