Skip to content


kustomizer pull artifact

Pull downloads Kubernetes manifests from a container registry.


The pull command downloads the specified OCI artifact and writes the Kubernetes manifests to stdout. For private registries, the pull command uses the credentials from '~/.docker/config.json'.

kustomizer pull artifact [flags]


  kustomizer pull artifact <oci url>

  # Pull Kubernetes manifests from an OCI artifact hosted on Docker Hub
  kustomizer pull artifact oci:// > manifests.yaml

  # Pull an OCI artifact using the digest and write the Kubernetes manifests to stdout
  kustomizer pull artifact oci://<digest>

  # Pull the latest artifact from a local registry
  kustomizer pull artifact oci://localhost:5000/repo

  # Pull and verify artifact with cosign
  kustomizer pull artifact oci:// --verify --cosign-key ./keys/

  # Pull encrypted artifact
  kustomizer pull artifact oci:// --age-identities ./keys/id.txt


      --age-identities string   Path to a file containing one or more age identities (private keys generated by age-keygen).
      --cosign-key string       Path to the consign public key file, KMS URI or Kubernetes Secret. When not specified, cosign will try to verify the signature using Rekor.
  -h, --help                    help for artifact
      --verify                  Verify the artifact signature with cosign.

Options inherited from parent commands

      --as string                      Username to impersonate for the operation. User could be a regular user or a service account in a namespace.
      --as-group stringArray           Group to impersonate for the operation, this flag can be repeated to specify multiple groups.
      --as-uid string                  UID to impersonate for the operation.
      --cache-dir string               Default cache directory (default "/home/runner/.kube/cache")
      --certificate-authority string   Path to a cert file for the certificate authority
      --client-certificate string      Path to a client certificate file for TLS
      --client-key string              Path to a client key file for TLS
      --cluster string                 The name of the kubeconfig cluster to use
      --context string                 The name of the kubeconfig context to use
      --insecure-skip-tls-verify       If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure
      --kubeconfig string              Path to the kubeconfig file to use for CLI requests.
  -n, --namespace string               The inventory namespace. (default "default")
  -s, --server string                  The address and port of the Kubernetes API server
      --timeout duration               The length of time to wait before giving up on the current operation. (default 1m0s)
      --tls-server-name string         Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used
      --token string                   Bearer token for authentication to the API server
      --user string                    The name of the kubeconfig user to use