You are viewing documentation for Flux version: 2.3
Version 2.3 of the documentation is no longer actively maintained. The site that you are currently viewing is an archived snapshot. For up-to-date documentation, see the latest version.
Image reflector API reference v1beta2
Packages:
image.toolkit.fluxcd.io/v1beta2
Package v1beta2 contains API types for the image API group, version v1beta2. These types are concerned with reflecting metadata from OCI image repositories into a cluster, so they can be consulted for e.g., automation.
Resource Types:AlphabeticalPolicy
(Appears on: ImagePolicyChoice)
AlphabeticalPolicy specifies a alphabetical ordering policy.
| Field | Description |
|---|---|
orderstring | (Optional) 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. |
ImagePolicy
ImagePolicy is the Schema for the imagepolicies API
| Field | Description | ||||||
|---|---|---|---|---|---|---|---|
metadataKubernetes meta/v1.ObjectMeta | Refer to the Kubernetes API documentation for the fields of the
metadata field. | ||||||
specImagePolicySpec |
| ||||||
statusImagePolicyStatus |
ImagePolicyChoice
(Appears on: ImagePolicySpec)
ImagePolicyChoice is a union of all the types of policy that can be supplied.
| Field | Description |
|---|---|
semverSemVerPolicy | (Optional) SemVer gives a semantic version range to check against the tags available. |
alphabeticalAlphabeticalPolicy | (Optional) Alphabetical set of rules to use for alphabetical ordering of the tags. |
numericalNumericalPolicy | (Optional) Numerical set of rules to use for numerical ordering of the tags. |
ImagePolicySpec
(Appears on: ImagePolicy)
ImagePolicySpec defines the parameters for calculating the ImagePolicy.
| Field | Description |
|---|---|
imageRepositoryRefgithub.com/fluxcd/pkg/apis/meta.NamespacedObjectReference | ImageRepositoryRef points at the object specifying the image being scanned |
policyImagePolicyChoice | Policy gives the particulars of the policy to be followed in selecting the most recent image |
filterTagsTagFilter | (Optional) 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. |
ImagePolicyStatus
(Appears on: ImagePolicy)
ImagePolicyStatus defines the observed state of ImagePolicy
| Field | Description |
|---|---|
latestImagestring | LatestImage gives the first in the list of images scanned by the image repository, when filtered and ordered according to the policy. |
observedPreviousImagestring | (Optional) ObservedPreviousImage is the observed previous LatestImage. It is used to keep track of the previous and current images. |
observedGenerationint64 | (Optional) |
conditions[]Kubernetes meta/v1.Condition | (Optional) |
ImageRepository
ImageRepository is the Schema for the imagerepositories API
| Field | Description | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
metadataKubernetes meta/v1.ObjectMeta | Refer to the Kubernetes API documentation for the fields of the
metadata field. | ||||||||||||||||||||||
specImageRepositorySpec |
| ||||||||||||||||||||||
statusImageRepositoryStatus |
ImageRepositorySpec
(Appears on: ImageRepository)
ImageRepositorySpec defines the parameters for scanning an image
repository, e.g., fluxcd/flux.
| Field | Description |
|---|---|
imagestring | Image is the name of the image repository |
intervalKubernetes meta/v1.Duration | Interval is the length of time to wait between scans of the image repository. |
timeoutKubernetes meta/v1.Duration | (Optional) Timeout for image scanning. Defaults to ‘Interval’ duration. |
secretRefgithub.com/fluxcd/pkg/apis/meta.LocalObjectReference | (Optional) SecretRef can be given the name of a secret containing
credentials to use for the image registry. The secret should be
created with |
serviceAccountNamestring | (Optional) ServiceAccountName is the name of the Kubernetes ServiceAccount used to authenticate the image pull if the service account has attached pull secrets. |
certSecretRefgithub.com/fluxcd/pkg/apis/meta.LocalObjectReference | (Optional) CertSecretRef can be given the name of a Secret containing either or both of
and whichever are supplied, will be used for connecting to the
registry. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Note: Support for the |
suspendbool | (Optional) This flag tells the controller to suspend subsequent image scans. It does not apply to already started scans. Defaults to false. |
accessFromgithub.com/fluxcd/pkg/apis/acl.AccessFrom | (Optional) AccessFrom defines an ACL for allowing cross-namespace references to the ImageRepository object based on the caller’s namespace labels. |
exclusionList[]string | (Optional) ExclusionList is a list of regex strings used to exclude certain tags from being stored in the database. |
providerstring | (Optional) The provider used for authentication, can be ‘aws’, ‘azure’, ‘gcp’ or ‘generic’. When not specified, defaults to ‘generic’. |
insecurebool | (Optional) Insecure allows connecting to a non-TLS HTTP container registry. |
ImageRepositoryStatus
(Appears on: ImageRepository)
ImageRepositoryStatus defines the observed state of ImageRepository
| Field | Description |
|---|---|
conditions[]Kubernetes meta/v1.Condition | (Optional) |
observedGenerationint64 | (Optional) ObservedGeneration is the last reconciled generation. |
canonicalImageNamestring | (Optional) CanonicalName is the name of the image repository with all the
implied bits made explicit; e.g., |
lastScanResultScanResult | (Optional) LastScanResult contains the number of fetched tags. |
observedExclusionList[]string | ObservedExclusionList is a list of observed exclusion list. It reflects the exclusion rules used for the observed scan result in spec.lastScanResult. |
ReconcileRequestStatusgithub.com/fluxcd/pkg/apis/meta.ReconcileRequestStatus | (Members of |
NumericalPolicy
(Appears on: ImagePolicyChoice)
NumericalPolicy specifies a numerical ordering policy.
| Field | Description |
|---|---|
orderstring | (Optional) 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. |
ScanResult
(Appears on: ImageRepositoryStatus)
| Field | Description |
|---|---|
tagCountint | |
scanTimeKubernetes meta/v1.Time | |
latestTags[]string |
SemVerPolicy
(Appears on: ImagePolicyChoice)
SemVerPolicy specifies a semantic version policy.
| Field | Description |
|---|---|
rangestring | Range gives a semver range for the image tag; the highest version within the range that’s a tag yields the latest image. |
TagFilter
(Appears on: ImagePolicySpec)
TagFilter enables filtering tags based on a set of defined rules
| Field | Description |
|---|---|
patternstring | (Optional) Pattern specifies a regular expression pattern used to filter for image tags. |
extractstring | (Optional) Extract allows a capture group to be extracted from the specified regular expression pattern, useful before tag evaluation. |
This page was automatically generated with gen-crd-api-reference-docs