ImagePolicy v1 — image.toolkit.fluxcd.io

apiVersion string

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 string

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

metadata object

spec object

ImagePolicySpec defines the parameters for calculating the ImagePolicy.

digestReflectionPolicy string

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.

enum: Always, IfNotPresent, Never

filterTags object

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 string

Extract allows a capture group to be extracted from the specified regular expression pattern, useful before tag evaluation.

pattern string

Pattern specifies a regular expression pattern used to filter for image tags.

imageRepositoryRef object required

ImageRepositoryRef points at the object specifying the image being scanned

name string required

Name of the referent.

namespace string

Namespace of the referent, when not specified it acts as LocalObjectReference.

interval string

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.

pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$

policy object required

Policy gives the particulars of the policy to be followed in selecting the most recent image

alphabetical object

Alphabetical set of rules to use for alphabetical ordering of the tags.

order string

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.

enum: asc, desc

numerical object

Numerical set of rules to use for numerical ordering of the tags.

order string

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.

enum: asc, desc

semver object

SemVer gives a semantic version range to check against the tags available.

range string required

Range gives a semver range for the image tag; the highest version within the range that's a tag yields the latest image.

suspend boolean

This flag tells the controller to suspend subsequent policy reconciliations. It does not apply to already started reconciliations. Defaults to false.

status object

ImagePolicyStatus defines the observed state of ImagePolicy

conditions []object

lastTransitionTime string required

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.

format: date-time

message string required

message is a human readable message indicating details about the transition. This may be an empty string.

maxLength: 32768

observedGeneration integer

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.

format: int64

minimum: 0

reason string required

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.

pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$

minLength: 1

maxLength: 1024

status string required

status of the condition, one of True, False, Unknown.

enum: True, False, Unknown

type string required

type of condition in CamelCase or in foo.example.com/CamelCase.

pattern: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$

maxLength: 316

lastHandledReconcileAt string

LastHandledReconcileAt holds the value of the most recent reconcile request value, so a change of the annotation value can be detected.

latestRef object

LatestRef gives the first in the list of images scanned by the image repository, when filtered and ordered according to the policy.

digest string

Digest is the image's digest.

name string required

Name is the bare image's name.

tag string required

Tag is the image's tag.

observedGeneration integer

format: int64

observedPreviousRef object

ObservedPreviousRef is the observed previous LatestRef. It is used to keep track of the previous and current images.

digest string

Digest is the image's digest.

name string required

Name is the bare image's name.

tag string required

Tag is the image's tag.