HelmChart
source.toolkit.fluxcd.io / v1
apiVersion: source.toolkit.fluxcd.io/v1
kind: HelmChart
metadata:
name: example
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
HelmChartSpec specifies the desired state of a Helm chart.
chart
string required
Chart is the name or path the Helm chart is available at in the
SourceRef.
ignoreMissingValuesFiles
boolean
IgnoreMissingValuesFiles controls whether to silently ignore missing values
files rather than failing.
interval
string required
Interval at which the HelmChart SourceRef is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources.
pattern:
^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
reconcileStrategy
string
ReconcileStrategy determines what enables the creation of a new artifact.
Valid values are ('ChartVersion', 'Revision').
See the documentation of the values for an explanation on their behavior.
Defaults to ChartVersion when omitted.
enum:
ChartVersion, RevisionsourceRef object required
SourceRef is the reference to the Source the chart is available at.
apiVersion
string
APIVersion of the referent.
kind
string required
Kind of the referent, valid values are ('HelmRepository', 'GitRepository',
'Bucket').
enum:
HelmRepository, GitRepository, Bucket
name
string required
Name of the referent.
suspend
boolean
Suspend tells the controller to suspend the reconciliation of this
source.
valuesFiles
[]string
ValuesFiles is an alternative list of values files to use as the chart
values (values.yaml is not included by default), expected to be a
relative path in the SourceRef.
Values files are merged in the order of this list with the last file
overriding the first. Ignored when omitted.
verify object
Verify contains the secret name containing the trusted public keys
used to verify the signature and specifies which provider to use to check
whether OCI image is authentic.
This field is only supported when using HelmRepository source with spec.type 'oci'.
Chart dependencies, which are not bundled in the umbrella chart artifact, are not verified.
matchOIDCIdentity []object
MatchOIDCIdentity specifies the identity matching criteria to use
while verifying an OCI artifact which was signed using Cosign keyless
signing. The artifact's identity is deemed to be verified if any of the
specified matchers match against the identity.
issuer
string required
Issuer specifies the regex pattern to match against to verify
the OIDC issuer in the Fulcio certificate. The pattern must be a
valid Go regular expression.
subject
string required
Subject specifies the regex pattern to match against to verify
the identity subject in the Fulcio certificate. The pattern must
be a valid Go regular expression.
provider
string required
Provider specifies the technology used to sign the OCI Artifact.
enum:
cosign, notationsecretRef object
SecretRef specifies the Kubernetes Secret containing the
trusted public keys.
name
string required
Name of the referent.
version
string
Version is the chart version semver expression, ignored for charts from
GitRepository and Bucket sources. Defaults to latest when omitted.
status object
HelmChartStatus records the observed state of the HelmChart.
artifact object
Artifact represents the output of the last successful reconciliation.
digest
string required
Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
pattern:
^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
lastUpdateTime
string required
LastUpdateTime is the timestamp corresponding to the last update of the
Artifact.
format:
date-time
metadata
object
Metadata holds upstream information such as OCI annotations.
path
string required
Path is the relative file path of the Artifact. It can be used to locate
the file in the root of the Artifact storage on the local file system of
the controller managing the Source.
revision
string required
Revision is a human-readable identifier traceable in the origin source
system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
size
integer
Size is the number of bytes in the file.
format:
int64
url
string required
URL is the HTTP address of the Artifact as exposed by the controller
managing the Source. It can be used to retrieve the Artifact for
consumption, e.g. by another controller applying the Artifact contents.
conditions []object
Conditions holds the conditions for the HelmChart.
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:
int64minimum:
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:
1maxLength:
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.
observedChartName
string
ObservedChartName is the last observed chart name as specified by the
resolved chart reference.
observedGeneration
integer
ObservedGeneration is the last observed generation of the HelmChart
object.
format:
int64
observedSourceArtifactRevision
string
ObservedSourceArtifactRevision is the last observed Artifact.Revision
of the HelmChartSpec.SourceRef.
observedValuesFiles
[]string
ObservedValuesFiles are the observed value files of the last successful
reconciliation.
It matches the chart in the last successfully reconciled artifact.
url
string
URL is the dynamic fetch link for the latest Artifact.
It is provided on a "best effort" basis, and using the precise
BucketStatus.Artifact data is recommended.
No matches. Try .spec.chart for an exact path