// Generated by conforma CLI documentation tooling. DO NOT EDIT.
= ec track bundle

Record tracking information about Tekton bundles

== Synopsis

Record tracking information about Tekton bundles

Each Tekton Bundle is expected to be a proper OCI image reference. They
may contain a tag, a digest, or both. If a digest is not provided, this
command will query the registry to determine its value. Either a tag
or a digest is required.

The output is meant to assist enforcement of policies that ensure the
most recent Tekton Bundle is used. Each entry contains an "expires_on"
date which indicates when that specific bundle version should no longer
be used. When a new entry is introduced, an expiration date is added to
the previous newest entry.

If --prune is set, on by default, expired entries are removed.
Any entry with an expires_on date in the future (or no expires_on date)
is considered current and will not be pruned.

[source,shell]
----
ec track bundle [flags]
----

== Examples
Track multiple bundles:

  ec track bundle --bundle <IMAGE1> --bundle <IMAGE2>

Save tracking information into a new tracking file:

  ec track bundle --bundle <IMAGE1> --output <path/to/new/file>

Save tracking information into an image registry:

  ec track bundle --bundle <IMAGE1> --output <oci:registry.io/repository/image:tag>

Extend an existing tracking file with a new bundle:

  ec track bundle --bundle <IMAGE1> --input <path/to/input/file>

Extend an existing tracking file with a new bundle and save changes:

  ec track bundle --bundle <IMAGE1> --input <path/to/input/file> --replace

Extend an existing tracking image with a new bundle and push to an image registry:

  ec track bundle --bundle <IMAGE1> --input <oci:registry.io/repository/image:tag> --replace

Skip pruning for unacceptable entries:

  ec track bundle --bundle <IMAGE1> --input <path/to/input/file> --prune=false

Update existing acceptable bundles:

  ec track bundle --input <path/to/input/file> --output <path/to/input/file> --freshen

== Options

-b, --bundle:: bundle image reference to track - may be used multiple times (Default: [])
--freshen:: resolve image tags to catch updates and use the latest image for the tag (Default: false)
-g, --git:: git references to track - may be used multiple times (Default: [])
-h, --help:: help for bundle (Default: false)
--in-effect-days:: number of days after which older bundle entries expire when a new bundle entry is added (most recent entry stays valid until replaced) (Default: 60)
-i, --input:: existing tracking file
-o, --output:: write modified tracking file to a file. Use empty string for stdout, default behavior
-p, --prune:: remove entries that are no longer acceptable, i.e. a newer entry already effective exists (Default: true)
-r, --replace:: write changes to input file (Default: false)

== Options inherited from parent commands

--debug:: same as verbose but also show function names and line numbers (Default: false)
--kubeconfig:: path to the Kubernetes config file to use
--logfile:: file to write the logging output. If not specified logging output will be written to stderr
--quiet:: less verbose output (Default: false)
--retry-duration:: base duration for exponential backoff calculation (Default: 1s)
--retry-factor:: exponential backoff multiplier (Default: 2)
--retry-jitter:: randomness factor for backoff calculation (0.0-1.0) (Default: 0.1)
--retry-max-retry:: maximum number of retry attempts (Default: 3)
--retry-max-wait:: maximum wait time between retries (Default: 3s)
--timeout:: max overall execution duration (Default: 5m0s)
--trace:: enable trace logging, set one or more comma separated values: none,all,perf,cpu,mem,opa,log (Default: none)
--verbose:: more verbose output (Default: false)

== See also

 * xref:ec_track.adoc[ec track - Record resource references for tracking purposes]
