Skip to content
Zarf

zarf component publish

zarf component publish

Publishes a v1beta1 Zarf component to a remote registry

zarf component publish COMPONENT_FILE OCI_REPOSITORY [flags]

Examples

# Publish a v1beta1 component config to a remote registry
$ zarf component publish monitoring.yaml oci://ghcr.io/my-org/components

Options

      --confirm                   Skip the interactive confirmation prompt before uploading to the Rekor transparency log (equivalent to cosign --yes).
      --fulcio-auth-flow string   Fulcio OAuth flow: normal (browser), device (device code), token, client_credentials
      --fulcio-url string         Fulcio certificate authority URL. Override for private Sigstore deployments. (default "https://fulcio.sigstore.dev")
  -h, --help                      help for publish
      --identity-token string     Pre-acquired OIDC identity token (or path to a file containing one) for non-interactive keyless signing
      --keyless                   Sign without a private key using Sigstore's keyless flow (Fulcio/OIDC)
      --oci-concurrency int       Number of concurrent layer operations when pulling or pushing images or packages to/from OCI registries. (default 6)
      --oidc-client-id string     OIDC client ID used when requesting an identity token. Override for private Sigstore deployments. (default "sigstore")
      --oidc-issuer string        OIDC issuer URL used to obtain an identity token for keyless signing. Override for private Sigstore deployments. (default "https://oauth2.sigstore.dev/auth")
      --rekor-url string          Rekor transparency log URL. Override for private Sigstore deployments. (default "https://rekor.sigstore.dev")
      --retries int               Maximum attempts for retryable Zarf operations, including image, Git, and transient Helm failures (default 1)
      --signing-key string        Private key for signing packages. Accepts either a local file path or a Cosign-supported key provider (awskms://, gcpkms://, azurekms://, hashivault://)
      --signing-key-pass string   Password for encrypted private key
      --tlog-upload               Upload the signature to the Rekor transparency log. Auto-enabled when --keyless is set (allows for keyless signatures to remain verifiable past the ~10 minute Fulcio certificate validity window).
      --tsa-server-url string     RFC3161 timestamp authority URL (e.g. https://timestamp.sigstore.dev/api/v1/timestamp). When set, a signed timestamp is embedded in the bundle as an alternative or complement to --tlog-upload for proving the signature was made while the Fulcio certificate was valid.

Options inherited from parent commands

  -a, --architecture string        Architecture for OCI images and Zarf packages
      --cache string               Specify the location of the Zarf cache directory (default "~/.zarf-cache")
      --features stringToString    Provide a comma-separated list of feature names to bools to enable or disable. Ex. --features "foo=true,bar=false,baz=true" (default [])
      --insecure-skip-tls-verify   Skip checking server's certificate for validity. This flag should only be used if you have a specific reason and accept the reduced security posture.
      --log-format string          Select a logging format. Defaults to 'console'. Valid options are: 'console', 'json', 'dev'. (default "console")
  -l, --log-level string           Log level when running Zarf. Valid options are: warn, info, debug, trace (default "info")
      --no-color                   Disable terminal color codes in logging and stdout prints.
      --plain-http                 Allow OCI registry connections over HTTP instead of HTTPS. This flag should only be used if you have a specific reason and accept the reduced security posture.
      --tmpdir string              Specify the temporary directory to use for intermediate files

SEE ALSO