Skip to main content

uc image push

Upload a local Docker image to the cluster.

Synopsis​

Upload a local Docker image to the cluster transferring only the missing layers. The image is uploaded to all cluster machines (default) or the specified machine(s).

uc image push IMAGE [flags]

Examples​

  # Push image to all machines in the cluster.
  uc image push myapp:latest

  # Push image to specific machine.
  uc image push myapp:latest -m machine1

  # Push image to multiple machines.
  uc image push myapp:latest -m machine1,machine2,machine3

  # Push a specific platform of a multi-platform image.
  uc image push myapp:latest --platform linux/amd64

Options​

  -h, --help              help for push
  -m, --machine strings   Machine names or IDs to push the image to. Can be specified multiple times or as a comma-separated list. (default is all machines)
      --platform string   Push a specific platform of a multi-platform image (e.g., linux/amd64, linux/arm64).
                          Local Docker must be configured to use containerd image store to support multi-platform images.

Options inherited from parent commands​

      --connect string          Connect to a remote cluster machine without using the Uncloud configuration file. [$UNCLOUD_CONNECT]
                                Format: [ssh://]user@host[:port], ssh+cli://user@host[:port], or tcp://host:port
  -c, --context string          Name of the cluster context to use (default is the current context). [$UNCLOUD_CONTEXT]
      --uncloud-config string   Path to the Uncloud configuration file. [$UNCLOUD_CONFIG] (default "~/.config/uncloud/config.yaml")

See also​

  • uc image - Manage images on machines in the cluster.