ko create

ko create

Create the input files with image references resolved to built/pushed image digests.

Synopsis

This sub-command finds import path references within the provided files, builds them into Go binaries, containerizes them, publishes them, and then feeds the resulting yaml into “kubectl create”.

  1. ko create -f FILENAME [flags]

Examples

  2.   # Build and publish import path references to a Docker
  3.   # Registry as:
  4.   #   ${KO_DOCKER_REPO}/<package name>-<hash of import path>
  5.   # Then, feed the resulting yaml into "kubectl create".
  6.   # When KO_DOCKER_REPO is ko.local, it is the same as if
  7.   # --local was passed.
  8.   ko create -f config/
  10.   # Build and publish import path references to a Docker
  11.   # Registry preserving import path names as:
  12.   #   ${KO_DOCKER_REPO}/<import path>
  13.   # Then, feed the resulting yaml into "kubectl create".
  14.   ko create --preserve-import-paths -f config/
  16.   # Build and publish import path references to a Docker
  17.   # daemon as:
  18.   #   ko.local/<import path>
  19.   # Then, feed the resulting yaml into "kubectl create".
  20.   ko create --local -f config/
  22.   # Create from stdin:
  23.   cat config.yaml | ko create -f -
  25.   # Any flags passed after '--' are passed to 'kubectl apply' directly:
  26.   ko apply -f config -- --namespace=foo --kubeconfig=cfg.yaml

Options

  1.       --bare                     Whether to just use KO_DOCKER_REPO without additional context (may not work properly with --tags).
  2.   -B, --base-import-paths        Whether to use the base path without MD5 hash after KO_DOCKER_REPO (may not work properly with --tags).
  3.       --disable-optimizations    Disable optimizations when building Go code. Useful when you want to interactively debug the created container.
  4.   -f, --filename strings         Filename, directory, or URL to files to use to create the resource
  5.   -h, --help                     help for create
  6.       --image-label strings      Which labels (key=value) to add to the image.
  7.       --image-refs string        Path to file where a list of the published image references will be written.
  8.       --insecure-registry        Whether to skip TLS verification on the registry
  9.   -j, --jobs int                 The maximum number of concurrent builds (default GOMAXPROCS)
  10.   -L, --local                    Load into images to local docker daemon.
  11.       --oci-layout-path string   Path to save the OCI image layout of the built images
  12.       --platform strings         Which platform to use when pulling a multi-platform base. Format: all | <os>[/<arch>[/<variant>]][,platform]*
  13.   -P, --preserve-import-paths    Whether to preserve the full import path after KO_DOCKER_REPO.
  14.       --push                     Push images to KO_DOCKER_REPO (default true)
  15.   -R, --recursive                Process the directory used in -f, --filename recursively. Useful when you want to manage related manifests organized within the same directory.
  16.       --sbom string              The SBOM media type to use (none will disable SBOM synthesis and upload, also supports: spdx, cyclonedx, go.version-m). (default "spdx")
  17.       --sbom-dir string          Path to file where the SBOM will be written.
  18.   -l, --selector string          Selector (label query) to filter on, supports '=', '==', and '!='.(e.g. -l key1=value1,key2=value2)
  19.       --tag-only                 Include tags but not digests in resolved image references. Useful when digests are not preserved when images are repopulated.
  20.   -t, --tags strings             Which tags to use for the produced image instead of the default 'latest' tag (may not work properly with --base-import-paths or --bare). (default [latest])
  21.       --tarball string           File to save images tarballs

Options inherited from parent commands

  1.   -v, --verbose   Enable debug logs

SEE ALSO

  • ko - Rapidly iterate with Go, Containers, and Kubernetes.