ImagePolicy is the Schema for the imagepolicies API
5 top-level fields · unchanged since Flux v2.7.0
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
ImagePolicySpec defines the parameters for calculating the ImagePolicy.
DigestReflectionPolicy governs the setting of the `.status.latestRef.digest` field. Never: The digest field will always be set to the empty string. IfNotPresent: The digest field will be set to the digest of the elected latest image if the field is empty and the image did not change. Always: The digest field will always be set to the digest of the elected latest image. Default: Never.
FilterTags enables filtering for only a subset of tags based on a set of rules. If no rules are provided, all the tags from the repository will be ordered and compared.
Extract allows a capture group to be extracted from the specified regular expression pattern, useful before tag evaluation.
Pattern specifies a regular expression pattern used to filter for image tags.
ImageRepositoryRef points at the object specifying the image being scanned
Name of the referent.
Namespace of the referent, when not specified it acts as LocalObjectReference.
Interval is the length of time to wait between refreshing the digest of the latest tag when the reflection policy is set to "Always". Defaults to 10m.
Policy gives the particulars of the policy to be followed in selecting the most recent image
Alphabetical set of rules to use for alphabetical ordering of the tags.
Order specifies the sorting order of the tags. Given the letters of the alphabet as tags, ascending order would select Z, and descending order would select A.
Numerical set of rules to use for numerical ordering of the tags.
Order specifies the sorting order of the tags. Given the integer values from 0 to 9 as tags, ascending order would select 9, and descending order would select 0.
SemVer gives a semantic version range to check against the tags available.
Range gives a semver range for the image tag; the highest version within the range that's a tag yields the latest image.
This flag tells the controller to suspend subsequent policy reconciliations. It does not apply to already started reconciliations. Defaults to false.
ImagePolicyStatus defines the observed state of ImagePolicy
lastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
message is a human readable message indicating details about the transition. This may be an empty string.
observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.
reason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.
status of the condition, one of True, False, Unknown.
type of condition in CamelCase or in foo.example.com/CamelCase.
LastHandledReconcileAt holds the value of the most recent reconcile request value, so a change of the annotation value can be detected.
LatestRef gives the first in the list of images scanned by the image repository, when filtered and ordered according to the policy.
Digest is the image's digest.
Name is the bare image's name.
Tag is the image's tag.
ObservedPreviousRef is the observed previous LatestRef. It is used to keep track of the previous and current images.
Digest is the image's digest.
Name is the bare image's name.
Tag is the image's tag.
Source: install.yaml
Changes to ImagePolicy (image.toolkit.fluxcd.io/v1) in each Flux version, compared to the version before it.
ImagePolicy was first seen on this version of Flux
Released · View ImagePolicy in v2.7.0
No examples of ImagePolicy yet. Contribute one on GitHub.