Skip to content
说明将 Kit 制品推送到 OCI 镜像仓库
用法sbx kit push DIRECTORY REFERENCE [flags]

实验性

此命令为实验性功能。

实验性功能仅用于测试和反馈,其功能或设计可能在不同版本之间无预警地发生变化,也可能在未来的版本中被完全移除。

描述 ​

将包含 spec.yaml 的 Kit 目录打包并推送到 OCI 镜像仓库。 使用 registry/repo:tag 形式的引用。Kit 的 schema 决定所用的制品格式。

每次推送都会附带溯源信息。使用 --sign 还可以对清单和溯源信息签名; 除非提供 --key,否则签名是无密钥(keyless)的。

对于 Docker Hub,优先使用 sbx login 会话。其他镜像仓库使用通过 sbx secret set --registry 设置的密钥。两者都可以回退到 Docker 凭据。镜像仓库必须支持 HTTPS。

选项 ​

选项默认值说明
--identity-token用于无密钥签名的 OIDC 身份令牌;默认使用当前环境中的 CI 提供方,然后是交互式浏览器登录
--identity-token-file存放 OIDC 身份令牌的文件;避免令牌出现在进程参数中
--key基于密钥签名所用的私钥(PEM);省略则使用无密钥签名
--sign为推送的 Kit 签名,并将签名作为 OCI referrer 附加
--tlog-uploadtrue将无密钥签名上传到 Rekor 透明日志;私有 Kit 请设为 false

全局选项 ​

选项默认值说明
--cloud改为调用 Docker Cloud Sandboxes API,而不是本地 sandboxd(支持的动词正在逐步增加,运行 sbx --cloud --help 查看当前列表)
-D, --debug启用调试日志
--no-input从不提示;需要应答的命令会直接失败,并给出应当运行的命令

示例 ​

console
sbx kit push ./my-kit ghcr.io/myorg/my-kit:1.0

# 为推送的 Kit 签名(无密钥)
sbx kit push ./my-kit ghcr.io/myorg/my-kit:1.0 --sign

参见 ​

  • sbx kit — (实验性)管理 Kit 制品