kumahq/notary该镜像作为中央化的镜像签名仓库,专门用于集中管理和存储所有已生成的kuma Docker镜像的签名信息。其核心价值在于确保kuma系列镜像的完整性与真实性,提供统一的签名存储与验证机制,是kuma镜像安全分发和部署的关键组件。
bashdocker run -d \ --name kuma-signature-repo \ -p 8080:8080 \ -v /host/path/to/signatures:/var/lib/kuma-signatures \ --restart unless-stopped \ kuma/signature-repo:latest
| 参数名 | 描述 | 默认值 | 必须 |
|---|---|---|---|
-v /host/path/to/signatures:/var/lib/kuma-signatures | 本地目录挂载,用于持久化存储签名数据 | 无 | 是 |
-p 8080:8080 | 端口映射,暴露签名服务API端口 | 8080 | 否 |
--name kuma-signature-repo | 容器名称,便于管理和识别 | 随机生成 | 否 |
| 环境变量 | 描述 | 默认值 |
|---|---|---|
SIGNATURE_STORAGE_PATH | 容器内签名文件存储路径 | /var/lib/kuma-signatures |
API_PORT | 服务监听端口 | 8080 |
LOG_LEVEL | 日志输出级别(debug/info/warn/error) | info |
MAX_SIGNATURE_RETENTION_DAYS | 签名文件最大保留天数 | 90 |
bash# 假设已生成kuma镜像签名文件signature.json curl -X POST http://localhost:8080/api/v1/signatures \ -H "Content-Type: application/json" \ -d @signature.json
bashcurl http://localhost:8080/api/v1/signatures?image=kuma/control-plane:1.8.0
bashcurl -X POST http://localhost:8080/api/v1/verify \ -H "Content-Type: application/json" \ -d '{"image": "kuma/control-plane:1.8.0", "signature": "<signature-content>"}'
为确保签名数据不丢失,必须通过-v参数挂载本地目录到容器内/var/lib/kuma-signatures路径。建议使用分布式存储(如NFS、Ceph)挂载该目录,以支持多实例部署和高可用性。
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务