Edit icon Edit This Page

Download docker artifacts

Download a Docker image into an OCI image layout directory, <image>-<tag> under –dir (for example team_app-1.0), without a Docker daemon. The image is read from the repository: GET /v2/, the token exchange, the manifest, then the config and every layer. Every blob is checked against the digest of the manifest before it is stored.

The tag comes from the name (team/app:1.0) or from –version; without either it is latest. A digest (team/app@sha256:…) pins the manifest. When the tag is a multi-platform image the platform of this machine is chosen by rp (the registry does not do it); –platform picks another one, and the layout holds only that platform. Read the layout with skopeo, crane or ‘rp push docker’.

rp download docker <image>[:<tag>|@<digest>] [flags]

Options

      --dir string        Directory to store the file in (created when missing) (default ".")
      --force             Replace the file when it already exists
      --platform string   Platform to pull from a multi-platform image, os/arch[/variant] (default: the platform of this machine)
      --repo string       Repository to download from (required)
      --version string    Version to download (default: the newest the format knows)

Options inherited from parent commands

      --api-url string           Panel API URL of the profile, overrides the stored value
      --ca-file string           PEM file with extra trusted CA certificates
      --debug                    Print debug output with secrets redacted
      --hostname string          Repsy host to use instead of the current profile
      --insecure                 Do not verify TLS certificates (unsafe; plain http is chosen with the URL, not with this flag)
      --insecure-storage         Keep credentials in a plain 0600 file instead of the OS keyring (unsafe; a warning is printed once per command)
      --jq string                Filter JSON output with a jq expression (implies --output json)
      --no-color                 Disable colored output
      --no-input                 Never prompt; fail when input is needed
      --output table|json|yaml   Output format: table, json or yaml (default table; json when --jq is given)
      --owner string             Owner segment of Cloud protocol URLs; --owner= means none
      --registry-url string      Protocol host URL of the profile, overrides the stored value
      --type os|cloud            Product of the host, overrides detection
      --web-url string           Panel UI URL of the profile (where /cli/auth lives), overrides the stored value
      --yes                      Answer yes to confirmation prompts

See also

Found a problem with this page?