跳到主要内容
版本:4.0.0

push 上传镜像

sealos push 是 Sealos 命令行工具中的一个命令,用于将镜像推送到指定的位置。这个命令在你需要将本地 Docker 镜像推送到远程镜像仓库的时候特别有用。本指南将详细介绍其使用方法。

基本用法

基本的 sealos push 命令格式如下:

sealos push IMAGE_ID DESTINATION

在上述命令中,IMAGE_ID 是你想要推送的镜像的 ID,而 DESTINATION 是你想要推送到的位置。 DESTINATION 使用 "transport:details" 格式,如果未指定,将复用源 IMAGE 作为 DESTINATION。

在 Sealos 中,传输方式定义了源镜像和目标镜像在复制过程中的格式和位置。以下是 Sealos 支持的各种传输方式:

  1. containers-storage: 此传输方式用于存储和管理在本地运行的容器。例如,使用 Podman 或 CRI-O 创建的容器的镜像。

  2. dir: 这种传输方式将镜像存储在本地文件系统的一个目录中,该目录结构符合 OCI 布局。

  3. docker: 这种传输方式用于与 Docker 注册表进行交互,如 Docker Hub 或任何其他兼容的私有注册表。

  4. docker-archive: 此传输方式将镜像存储为一个本地的 Docker tar 文件(.tar),这是 Docker 的原生格式。

  5. docker-daemon: 这种传输方式用于与本地 Docker 守护程序交互,可以从 Docker 守护程序中提取镜像,或者将镜像推送到 Docker 守护程序。

  6. oci: 该传输方式将镜像存储在一个符合 OCI 布局的目录中,它是一种开放的容器镜像格式。

  7. oci-archive: 这种传输方式将镜像存储为一个本地的 OCI tar 文件(.tar)。

  8. ostree: 这种传输方式将镜像存储在 OSTree 存储库中,这是一种支持原子升级和回滚的文件系统。

  9. sif: 这是 Singularity SIF 格式,主要用于高性能计算和数据密集型应用。

示例:

  • 将一个镜像推送到 Docker 注册表:sealos push my-image:latest docker://my-registry.example.com/my-image:latest

  • 将一个镜像从 Docker 守护程序导出:sealos push docker-daemon:my-image:latest dir:/path/to/save/

  • 将一个镜像推送到本地的容器存储:sealos push my-image:latest containers-storage:my-new-image:latest

示例

例如,你可以使用以下命令将一个镜像推送到 registry.example.com 的仓库:

sealos push my_image_id docker://registry.example.com/my_repository:my_tag

可选参数

  • --all: 该参数用于推送清单列表引用的所有镜像。

  • --authfile: 该参数用于指定身份验证文件的路径。 可以使用 REGISTRY_AUTH_FILE 环境变量进行覆盖。

  • --cert-dir: 该参数用于指定访问注册表所需的证书的路径。

  • --compression-format: 该参数用于指定要使用的压缩格式。

  • --compression-level: 该参数用于指定要使用的压缩级别。

  • --cr-option 参数是用于控制是否将镜像的自定义资源(Custom Resource,简称 CR)推送到目标镜像仓库的。

    具体来说,这个参数的可选值包括:

    • "yes": 将会把镜像以及其关联的 CR 都推送到目标镜像仓库。

    • "no": 仅推送镜像,而不推送任何 CR。

    • "only": 仅推送 CR,不推送镜像本身。

    • "auto": 根据镜像和 CR 的实际状态自动决定是否推送。例如,如果 CR 有更改或者不存在于目标仓库,就会被推送。

    请注意,这个参数主要在处理包含自定义资源(如 Kubernetes CRD 对象)的镜像时使用,它能够让你更加灵活地控制镜像和 CR 的推送过程。

  • --creds: 该参数用于访问注册表,使用 [username[:password]] 形式。

  • --digestfile: 该参数在复制图像后,将结果图像的摘要写入文件。

  • -D, --disable-compression: 该参数用于不压缩层。

  • --encrypt-layer: 该参数用于指定要加密的层,0 索引层索引支持负索引(例如,0 是第一层,-1 是最后一层)。 如果未定义,则在指定 encryption-key 标志时将加密所有层。

  • --encryption-key: 该参数用于指定加密图像所需的密钥,与加密协议一起使用(例如,jwe:/path/to/key.pem)。

  • -f, --format: 该参数用于指定目标中要使用的清单类型(oci, v2s1, 或 v2s2)(默认是源的清单类型,带回退)。

  • -q, --quiet: 该参数用于在推送图像时不输出进度信息。

  • --remove-signatures: 该参数用于在推送图像时不复制签名。

  • `--retry

`: 该参数用于指定在推送/拉取失败时的重试次数。

  • --retry-delay: 该参数用于指定在推送/拉取失败时重试之间的延迟。

  • --rm: 该参数用于在推送成功后删除清单列表。

  • --sign-by: 该参数用于使用指定的 FINGERPRINT 的 GPG 密钥签名图像。

以上就是 sealos push 命令的使用指南,希望对你有所帮助。如果你在使用过程中遇到任何问题,欢迎向我们提问。