Helmchart v1 — source.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

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, Revision

sourceRef 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, notation

secretRef 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: 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.

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.