···9898999911. **Convert Helmfile Releases To Flux HelmReleases**
100100 - Convert releases layer-by-layer.
101101+ - Store Flux `HelmRelease` objects in `flux-system` and set
102102+ `spec.targetNamespace` to the workload namespace. This keeps shared
103103+ `valuesFrom` objects such as `cute-haus-global` in one namespace.
101104 - External charts use `HelmRepository`.
102105 - In-tree charts use `GitRepository` and `chart: ./k8s/charts/<name>`.
103106 - Inline non-secret values in `spec.values`.
···156159 ```
157160158161 - Scope: local in-tree charts only where release name equals `k8s/charts/<release>`.
162162+ - Flux `HelmRelease` objects live in `flux-system`; the optional namespace
163163+ argument remains the Helm target namespace.
159164 - `apply` suspends Flux first, then runs `helm upgrade --install`.
160165 - `diff` uses `helm diff upgrade --allow-unreleased`.
161166 - External charts are managed through Flux only.
···2424 namespace: flux-system
2525spec:
2626 egress:
2727- - {}
2727+ - {}
2828 ingress:
2929- - from:
3030- - podSelector: {}
2929+ - from:
3030+ - podSelector: {}
3131 podSelector: {}
3232 policyTypes:
3333- - Ingress
3434- - Egress
3333+ - Ingress
3434+ - Egress
3535---
3636apiVersion: networking.k8s.io/v1
3737kind: NetworkPolicy
···4444 namespace: flux-system
4545spec:
4646 ingress:
4747- - from:
4848- - namespaceSelector: {}
4949- ports:
5050- - port: 8080
5151- protocol: TCP
4747+ - from:
4848+ - namespaceSelector: {}
4949+ ports:
5050+ - port: 8080
5151+ protocol: TCP
5252 podSelector: {}
5353 policyTypes:
5454- - Ingress
5454+ - Ingress
5555---
5656apiVersion: networking.k8s.io/v1
5757kind: NetworkPolicy
···6464 namespace: flux-system
6565spec:
6666 ingress:
6767- - from:
6868- - namespaceSelector: {}
6767+ - from:
6868+ - namespaceSelector: {}
6969 podSelector:
7070 matchLabels:
7171 app: notification-controller
7272 policyTypes:
7373- - Ingress
7373+ - Ingress
7474---
7575apiVersion: v1
7676kind: ResourceQuota
···8686 pods: "1000"
8787 scopeSelector:
8888 matchExpressions:
8989- - operator: In
9090- scopeName: PriorityClass
9191- values:
9292- - system-node-critical
9393- - system-cluster-critical
8989+ - operator: In
9090+ scopeName: PriorityClass
9191+ values:
9292+ - system-node-critical
9393+ - system-cluster-critical
9494---
9595apiVersion: rbac.authorization.k8s.io/v1
9696kind: ClusterRole
···101101 app.kubernetes.io/version: v2.8.8
102102 name: crd-controller-flux-system
103103rules:
104104-- apiGroups:
105105- - source.toolkit.fluxcd.io
106106- resources:
107107- - '*'
108108- verbs:
109109- - '*'
110110-- apiGroups:
111111- - kustomize.toolkit.fluxcd.io
112112- resources:
113113- - '*'
114114- verbs:
115115- - '*'
116116-- apiGroups:
117117- - helm.toolkit.fluxcd.io
118118- resources:
119119- - '*'
120120- verbs:
121121- - '*'
122122-- apiGroups:
123123- - notification.toolkit.fluxcd.io
124124- resources:
125125- - '*'
126126- verbs:
127127- - '*'
128128-- apiGroups:
129129- - image.toolkit.fluxcd.io
130130- resources:
131131- - '*'
132132- verbs:
133133- - '*'
134134-- apiGroups:
135135- - source.extensions.fluxcd.io
136136- resources:
137137- - '*'
138138- verbs:
139139- - '*'
140140-- apiGroups:
141141- - ""
142142- resources:
143143- - namespaces
144144- - secrets
145145- - configmaps
146146- - serviceaccounts
147147- verbs:
148148- - get
149149- - list
150150- - watch
151151-- apiGroups:
152152- - ""
153153- resources:
154154- - events
155155- verbs:
156156- - create
157157- - patch
158158-- apiGroups:
159159- - ""
160160- resources:
161161- - configmaps
162162- verbs:
163163- - get
164164- - list
165165- - watch
166166- - create
167167- - update
168168- - patch
169169- - delete
170170-- apiGroups:
171171- - ""
172172- resources:
173173- - configmaps/status
174174- verbs:
175175- - get
176176- - update
177177- - patch
178178-- apiGroups:
179179- - coordination.k8s.io
180180- resources:
181181- - leases
182182- verbs:
183183- - get
184184- - list
185185- - watch
186186- - create
187187- - update
188188- - patch
189189- - delete
190190-- apiGroups:
191191- - ""
192192- resources:
193193- - serviceaccounts/token
194194- verbs:
195195- - create
196196-- nonResourceURLs:
197197- - /livez/ping
198198- verbs:
199199- - head
104104+ - apiGroups:
105105+ - source.toolkit.fluxcd.io
106106+ resources:
107107+ - "*"
108108+ verbs:
109109+ - "*"
110110+ - apiGroups:
111111+ - kustomize.toolkit.fluxcd.io
112112+ resources:
113113+ - "*"
114114+ verbs:
115115+ - "*"
116116+ - apiGroups:
117117+ - helm.toolkit.fluxcd.io
118118+ resources:
119119+ - "*"
120120+ verbs:
121121+ - "*"
122122+ - apiGroups:
123123+ - notification.toolkit.fluxcd.io
124124+ resources:
125125+ - "*"
126126+ verbs:
127127+ - "*"
128128+ - apiGroups:
129129+ - image.toolkit.fluxcd.io
130130+ resources:
131131+ - "*"
132132+ verbs:
133133+ - "*"
134134+ - apiGroups:
135135+ - source.extensions.fluxcd.io
136136+ resources:
137137+ - "*"
138138+ verbs:
139139+ - "*"
140140+ - apiGroups:
141141+ - ""
142142+ resources:
143143+ - namespaces
144144+ - secrets
145145+ - configmaps
146146+ - serviceaccounts
147147+ verbs:
148148+ - get
149149+ - list
150150+ - watch
151151+ - apiGroups:
152152+ - ""
153153+ resources:
154154+ - events
155155+ verbs:
156156+ - create
157157+ - patch
158158+ - apiGroups:
159159+ - ""
160160+ resources:
161161+ - configmaps
162162+ verbs:
163163+ - get
164164+ - list
165165+ - watch
166166+ - create
167167+ - update
168168+ - patch
169169+ - delete
170170+ - apiGroups:
171171+ - ""
172172+ resources:
173173+ - configmaps/status
174174+ verbs:
175175+ - get
176176+ - update
177177+ - patch
178178+ - apiGroups:
179179+ - coordination.k8s.io
180180+ resources:
181181+ - leases
182182+ verbs:
183183+ - get
184184+ - list
185185+ - watch
186186+ - create
187187+ - update
188188+ - patch
189189+ - delete
190190+ - apiGroups:
191191+ - ""
192192+ resources:
193193+ - serviceaccounts/token
194194+ verbs:
195195+ - create
196196+ - nonResourceURLs:
197197+ - /livez/ping
198198+ verbs:
199199+ - head
200200---
201201apiVersion: rbac.authorization.k8s.io/v1
202202kind: ClusterRole
···209209 rbac.authorization.k8s.io/aggregate-to-edit: "true"
210210 name: flux-edit-flux-system
211211rules:
212212-- apiGroups:
213213- - notification.toolkit.fluxcd.io
214214- - source.toolkit.fluxcd.io
215215- - source.extensions.fluxcd.io
216216- - helm.toolkit.fluxcd.io
217217- - image.toolkit.fluxcd.io
218218- - kustomize.toolkit.fluxcd.io
219219- resources:
220220- - '*'
221221- verbs:
222222- - create
223223- - delete
224224- - deletecollection
225225- - patch
226226- - update
212212+ - apiGroups:
213213+ - notification.toolkit.fluxcd.io
214214+ - source.toolkit.fluxcd.io
215215+ - source.extensions.fluxcd.io
216216+ - helm.toolkit.fluxcd.io
217217+ - image.toolkit.fluxcd.io
218218+ - kustomize.toolkit.fluxcd.io
219219+ resources:
220220+ - "*"
221221+ verbs:
222222+ - create
223223+ - delete
224224+ - deletecollection
225225+ - patch
226226+ - update
227227---
228228apiVersion: rbac.authorization.k8s.io/v1
229229kind: ClusterRole
···237237 rbac.authorization.k8s.io/aggregate-to-view: "true"
238238 name: flux-view-flux-system
239239rules:
240240-- apiGroups:
241241- - notification.toolkit.fluxcd.io
242242- - source.toolkit.fluxcd.io
243243- - source.extensions.fluxcd.io
244244- - helm.toolkit.fluxcd.io
245245- - image.toolkit.fluxcd.io
246246- - kustomize.toolkit.fluxcd.io
247247- resources:
248248- - '*'
249249- verbs:
250250- - get
251251- - list
252252- - watch
240240+ - apiGroups:
241241+ - notification.toolkit.fluxcd.io
242242+ - source.toolkit.fluxcd.io
243243+ - source.extensions.fluxcd.io
244244+ - helm.toolkit.fluxcd.io
245245+ - image.toolkit.fluxcd.io
246246+ - kustomize.toolkit.fluxcd.io
247247+ resources:
248248+ - "*"
249249+ verbs:
250250+ - get
251251+ - list
252252+ - watch
253253---
254254apiVersion: rbac.authorization.k8s.io/v1
255255kind: ClusterRoleBinding
···264264 kind: ClusterRole
265265 name: cluster-admin
266266subjects:
267267-- kind: ServiceAccount
268268- name: kustomize-controller
269269- namespace: flux-system
270270-- kind: ServiceAccount
271271- name: helm-controller
272272- namespace: flux-system
267267+ - kind: ServiceAccount
268268+ name: kustomize-controller
269269+ namespace: flux-system
270270+ - kind: ServiceAccount
271271+ name: helm-controller
272272+ namespace: flux-system
273273---
274274apiVersion: rbac.authorization.k8s.io/v1
275275kind: ClusterRoleBinding
···284284 kind: ClusterRole
285285 name: crd-controller-flux-system
286286subjects:
287287-- kind: ServiceAccount
288288- name: kustomize-controller
289289- namespace: flux-system
290290-- kind: ServiceAccount
291291- name: helm-controller
292292- namespace: flux-system
293293-- kind: ServiceAccount
294294- name: source-controller
295295- namespace: flux-system
296296-- kind: ServiceAccount
297297- name: notification-controller
298298- namespace: flux-system
299299-- kind: ServiceAccount
300300- name: image-reflector-controller
301301- namespace: flux-system
302302-- kind: ServiceAccount
303303- name: image-automation-controller
304304- namespace: flux-system
305305-- kind: ServiceAccount
306306- name: source-watcher
307307- namespace: flux-system
287287+ - kind: ServiceAccount
288288+ name: kustomize-controller
289289+ namespace: flux-system
290290+ - kind: ServiceAccount
291291+ name: helm-controller
292292+ namespace: flux-system
293293+ - kind: ServiceAccount
294294+ name: source-controller
295295+ namespace: flux-system
296296+ - kind: ServiceAccount
297297+ name: notification-controller
298298+ namespace: flux-system
299299+ - kind: ServiceAccount
300300+ name: image-reflector-controller
301301+ namespace: flux-system
302302+ - kind: ServiceAccount
303303+ name: image-automation-controller
304304+ namespace: flux-system
305305+ - kind: ServiceAccount
306306+ name: source-watcher
307307+ namespace: flux-system
308308---
309309apiVersion: apiextensions.k8s.io/v1
310310kind: CustomResourceDefinition
···326326 singular: bucket
327327 scope: Namespaced
328328 versions:
329329- - additionalPrinterColumns:
330330- - jsonPath: .spec.endpoint
331331- name: Endpoint
332332- type: string
333333- - jsonPath: .metadata.creationTimestamp
334334- name: Age
335335- type: date
336336- - jsonPath: .status.conditions[?(@.type=="Ready")].status
337337- name: Ready
338338- type: string
339339- - jsonPath: .status.conditions[?(@.type=="Ready")].message
340340- name: Status
341341- type: string
342342- name: v1
343343- schema:
344344- openAPIV3Schema:
345345- description: Bucket is the Schema for the buckets API.
346346- properties:
347347- apiVersion:
348348- description: |-
349349- APIVersion defines the versioned schema of this representation of an object.
350350- Servers should convert recognized schemas to the latest internal value, and
351351- may reject unrecognized values.
352352- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
353353- type: string
354354- kind:
355355- description: |-
356356- Kind is a string value representing the REST resource this object represents.
357357- Servers may infer this from the endpoint the client submits requests to.
358358- Cannot be updated.
359359- In CamelCase.
360360- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
361361- type: string
362362- metadata:
363363- type: object
364364- spec:
365365- description: |-
366366- BucketSpec specifies the required configuration to produce an Artifact for
367367- an object storage bucket.
368368- properties:
369369- bucketName:
370370- description: BucketName is the name of the object storage bucket.
371371- type: string
372372- certSecretRef:
373373- description: |-
374374- CertSecretRef can be given the name of a Secret containing
375375- either or both of
329329+ - additionalPrinterColumns:
330330+ - jsonPath: .spec.endpoint
331331+ name: Endpoint
332332+ type: string
333333+ - jsonPath: .metadata.creationTimestamp
334334+ name: Age
335335+ type: date
336336+ - jsonPath: .status.conditions[?(@.type=="Ready")].status
337337+ name: Ready
338338+ type: string
339339+ - jsonPath: .status.conditions[?(@.type=="Ready")].message
340340+ name: Status
341341+ type: string
342342+ name: v1
343343+ schema:
344344+ openAPIV3Schema:
345345+ description: Bucket is the Schema for the buckets API.
346346+ properties:
347347+ apiVersion:
348348+ description: |-
349349+ APIVersion defines the versioned schema of this representation of an object.
350350+ Servers should convert recognized schemas to the latest internal value, and
351351+ may reject unrecognized values.
352352+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
353353+ type: string
354354+ kind:
355355+ description: |-
356356+ Kind is a string value representing the REST resource this object represents.
357357+ Servers may infer this from the endpoint the client submits requests to.
358358+ Cannot be updated.
359359+ In CamelCase.
360360+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
361361+ type: string
362362+ metadata:
363363+ type: object
364364+ spec:
365365+ description: |-
366366+ BucketSpec specifies the required configuration to produce an Artifact for
367367+ an object storage bucket.
368368+ properties:
369369+ bucketName:
370370+ description: BucketName is the name of the object storage bucket.
371371+ type: string
372372+ certSecretRef:
373373+ description: |-
374374+ CertSecretRef can be given the name of a Secret containing
375375+ either or both of
376376377377- - a PEM-encoded client certificate (`tls.crt`) and private
378378- key (`tls.key`);
379379- - a PEM-encoded CA certificate (`ca.crt`)
377377+ - a PEM-encoded client certificate (`tls.crt`) and private
378378+ key (`tls.key`);
379379+ - a PEM-encoded CA certificate (`ca.crt`)
380380381381- and whichever are supplied, will be used for connecting to the
382382- bucket. The client cert and key are useful if you are
383383- authenticating with a certificate; the CA cert is useful if
384384- you are using a self-signed server certificate. The Secret must
385385- be of type `Opaque` or `kubernetes.io/tls`.
381381+ and whichever are supplied, will be used for connecting to the
382382+ bucket. The client cert and key are useful if you are
383383+ authenticating with a certificate; the CA cert is useful if
384384+ you are using a self-signed server certificate. The Secret must
385385+ be of type `Opaque` or `kubernetes.io/tls`.
386386387387- This field is only supported for the `generic` provider.
388388- properties:
389389- name:
390390- description: Name of the referent.
391391- type: string
392392- required:
393393- - name
394394- type: object
395395- endpoint:
396396- description: Endpoint is the object storage address the BucketName
397397- is located at.
398398- type: string
399399- ignore:
400400- description: |-
401401- Ignore overrides the set of excluded patterns in the .sourceignore format
402402- (which is the same as .gitignore). If not provided, a default will be used,
403403- consult the documentation for your version to find out what those are.
404404- type: string
405405- insecure:
406406- description: Insecure allows connecting to a non-TLS HTTP Endpoint.
407407- type: boolean
408408- interval:
409409- description: |-
410410- Interval at which the Bucket Endpoint is checked for updates.
411411- This interval is approximate and may be subject to jitter to ensure
412412- efficient use of resources.
413413- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
414414- type: string
415415- prefix:
416416- description: Prefix to use for server-side filtering of files in the
417417- Bucket.
418418- type: string
419419- provider:
420420- default: generic
421421- description: |-
422422- Provider of the object storage bucket.
423423- Defaults to 'generic', which expects an S3 (API) compatible object
424424- storage.
425425- enum:
426426- - generic
427427- - aws
428428- - gcp
429429- - azure
430430- type: string
431431- proxySecretRef:
432432- description: |-
433433- ProxySecretRef specifies the Secret containing the proxy configuration
434434- to use while communicating with the Bucket server.
435435- properties:
436436- name:
437437- description: Name of the referent.
438438- type: string
439439- required:
440440- - name
441441- type: object
442442- region:
443443- description: Region of the Endpoint where the BucketName is located
444444- in.
445445- type: string
446446- secretRef:
447447- description: |-
448448- SecretRef specifies the Secret containing authentication credentials
449449- for the Bucket.
450450- properties:
451451- name:
452452- description: Name of the referent.
453453- type: string
454454- required:
455455- - name
456456- type: object
457457- serviceAccountName:
458458- description: |-
459459- ServiceAccountName is the name of the Kubernetes ServiceAccount used to authenticate
460460- the bucket. This field is only supported for the 'gcp' and 'aws' providers.
461461- For more information about workload identity:
462462- https://fluxcd.io/flux/components/source/buckets/#workload-identity
463463- type: string
464464- sts:
465465- description: |-
466466- STS specifies the required configuration to use a Security Token
467467- Service for fetching temporary credentials to authenticate in a
468468- Bucket provider.
387387+ This field is only supported for the `generic` provider.
388388+ properties:
389389+ name:
390390+ description: Name of the referent.
391391+ type: string
392392+ required:
393393+ - name
394394+ type: object
395395+ endpoint:
396396+ description:
397397+ Endpoint is the object storage address the BucketName
398398+ is located at.
399399+ type: string
400400+ ignore:
401401+ description: |-
402402+ Ignore overrides the set of excluded patterns in the .sourceignore format
403403+ (which is the same as .gitignore). If not provided, a default will be used,
404404+ consult the documentation for your version to find out what those are.
405405+ type: string
406406+ insecure:
407407+ description: Insecure allows connecting to a non-TLS HTTP Endpoint.
408408+ type: boolean
409409+ interval:
410410+ description: |-
411411+ Interval at which the Bucket Endpoint is checked for updates.
412412+ This interval is approximate and may be subject to jitter to ensure
413413+ efficient use of resources.
414414+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
415415+ type: string
416416+ prefix:
417417+ description:
418418+ Prefix to use for server-side filtering of files in the
419419+ Bucket.
420420+ type: string
421421+ provider:
422422+ default: generic
423423+ description: |-
424424+ Provider of the object storage bucket.
425425+ Defaults to 'generic', which expects an S3 (API) compatible object
426426+ storage.
427427+ enum:
428428+ - generic
429429+ - aws
430430+ - gcp
431431+ - azure
432432+ type: string
433433+ proxySecretRef:
434434+ description: |-
435435+ ProxySecretRef specifies the Secret containing the proxy configuration
436436+ to use while communicating with the Bucket server.
437437+ properties:
438438+ name:
439439+ description: Name of the referent.
440440+ type: string
441441+ required:
442442+ - name
443443+ type: object
444444+ region:
445445+ description:
446446+ Region of the Endpoint where the BucketName is located
447447+ in.
448448+ type: string
449449+ secretRef:
450450+ description: |-
451451+ SecretRef specifies the Secret containing authentication credentials
452452+ for the Bucket.
453453+ properties:
454454+ name:
455455+ description: Name of the referent.
456456+ type: string
457457+ required:
458458+ - name
459459+ type: object
460460+ serviceAccountName:
461461+ description: |-
462462+ ServiceAccountName is the name of the Kubernetes ServiceAccount used to authenticate
463463+ the bucket. This field is only supported for the 'gcp' and 'aws' providers.
464464+ For more information about workload identity:
465465+ https://fluxcd.io/flux/components/source/buckets/#workload-identity
466466+ type: string
467467+ sts:
468468+ description: |-
469469+ STS specifies the required configuration to use a Security Token
470470+ Service for fetching temporary credentials to authenticate in a
471471+ Bucket provider.
469472470470- This field is only supported for the `aws` and `generic` providers.
471471- properties:
472472- certSecretRef:
473473- description: |-
474474- CertSecretRef can be given the name of a Secret containing
475475- either or both of
473473+ This field is only supported for the `aws` and `generic` providers.
474474+ properties:
475475+ certSecretRef:
476476+ description: |-
477477+ CertSecretRef can be given the name of a Secret containing
478478+ either or both of
476479477477- - a PEM-encoded client certificate (`tls.crt`) and private
478478- key (`tls.key`);
479479- - a PEM-encoded CA certificate (`ca.crt`)
480480+ - a PEM-encoded client certificate (`tls.crt`) and private
481481+ key (`tls.key`);
482482+ - a PEM-encoded CA certificate (`ca.crt`)
480483481481- and whichever are supplied, will be used for connecting to the
482482- STS endpoint. The client cert and key are useful if you are
483483- authenticating with a certificate; the CA cert is useful if
484484- you are using a self-signed server certificate. The Secret must
485485- be of type `Opaque` or `kubernetes.io/tls`.
484484+ and whichever are supplied, will be used for connecting to the
485485+ STS endpoint. The client cert and key are useful if you are
486486+ authenticating with a certificate; the CA cert is useful if
487487+ you are using a self-signed server certificate. The Secret must
488488+ be of type `Opaque` or `kubernetes.io/tls`.
486489487487- This field is only supported for the `ldap` provider.
488488- properties:
489489- name:
490490- description: Name of the referent.
491491- type: string
492492- required:
493493- - name
494494- type: object
495495- endpoint:
496496- description: |-
497497- Endpoint is the HTTP/S endpoint of the Security Token Service from
498498- where temporary credentials will be fetched.
499499- pattern: ^(http|https)://.*$
500500- type: string
501501- provider:
502502- description: Provider of the Security Token Service.
503503- enum:
504504- - aws
505505- - ldap
506506- type: string
507507- secretRef:
508508- description: |-
509509- SecretRef specifies the Secret containing authentication credentials
510510- for the STS endpoint. This Secret must contain the fields `username`
511511- and `password` and is supported only for the `ldap` provider.
512512- properties:
513513- name:
514514- description: Name of the referent.
515515- type: string
516516- required:
517517- - name
518518- type: object
519519- required:
520520- - endpoint
521521- - provider
522522- type: object
523523- suspend:
524524- description: |-
525525- Suspend tells the controller to suspend the reconciliation of this
526526- Bucket.
527527- type: boolean
528528- timeout:
529529- default: 60s
530530- description: Timeout for fetch operations, defaults to 60s.
531531- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m))+$
532532- type: string
533533- required:
534534- - bucketName
535535- - endpoint
536536- - interval
537537- type: object
538538- x-kubernetes-validations:
539539- - message: STS configuration is only supported for the 'aws' and 'generic'
540540- Bucket providers
541541- rule: self.provider == 'aws' || self.provider == 'generic' || !has(self.sts)
542542- - message: '''aws'' is the only supported STS provider for the ''aws''
543543- Bucket provider'
544544- rule: self.provider != 'aws' || !has(self.sts) || self.sts.provider
545545- == 'aws'
546546- - message: '''ldap'' is the only supported STS provider for the ''generic''
547547- Bucket provider'
548548- rule: self.provider != 'generic' || !has(self.sts) || self.sts.provider
549549- == 'ldap'
550550- - message: spec.sts.secretRef is not required for the 'aws' STS provider
551551- rule: '!has(self.sts) || self.sts.provider != ''aws'' || !has(self.sts.secretRef)'
552552- - message: spec.sts.certSecretRef is not required for the 'aws' STS provider
553553- rule: '!has(self.sts) || self.sts.provider != ''aws'' || !has(self.sts.certSecretRef)'
554554- - message: ServiceAccountName is not supported for the 'generic' Bucket
555555- provider
556556- rule: self.provider != 'generic' || !has(self.serviceAccountName)
557557- - message: cannot set both .spec.secretRef and .spec.serviceAccountName
558558- rule: '!has(self.secretRef) || !has(self.serviceAccountName)'
559559- status:
560560- default:
561561- observedGeneration: -1
562562- description: BucketStatus records the observed state of a Bucket.
563563- properties:
564564- artifact:
565565- description: Artifact represents the last successful Bucket reconciliation.
566566- properties:
567567- digest:
568568- description: Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
569569- pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
570570- type: string
571571- lastUpdateTime:
572572- description: |-
573573- LastUpdateTime is the timestamp corresponding to the last update of the
574574- Artifact.
575575- format: date-time
576576- type: string
577577- metadata:
578578- additionalProperties:
490490+ This field is only supported for the `ldap` provider.
491491+ properties:
492492+ name:
493493+ description: Name of the referent.
494494+ type: string
495495+ required:
496496+ - name
497497+ type: object
498498+ endpoint:
499499+ description: |-
500500+ Endpoint is the HTTP/S endpoint of the Security Token Service from
501501+ where temporary credentials will be fetched.
502502+ pattern: ^(http|https)://.*$
503503+ type: string
504504+ provider:
505505+ description: Provider of the Security Token Service.
506506+ enum:
507507+ - aws
508508+ - ldap
579509 type: string
580580- description: Metadata holds upstream information such as OCI annotations.
581581- type: object
582582- path:
583583- description: |-
584584- Path is the relative file path of the Artifact. It can be used to locate
585585- the file in the root of the Artifact storage on the local file system of
586586- the controller managing the Source.
587587- type: string
588588- revision:
589589- description: |-
590590- Revision is a human-readable identifier traceable in the origin source
591591- system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
592592- type: string
593593- size:
594594- description: Size is the number of bytes in the file.
595595- format: int64
596596- type: integer
597597- url:
598598- description: |-
599599- URL is the HTTP address of the Artifact as exposed by the controller
600600- managing the Source. It can be used to retrieve the Artifact for
601601- consumption, e.g. by another controller applying the Artifact contents.
602602- type: string
603603- required:
604604- - digest
605605- - lastUpdateTime
606606- - path
607607- - revision
608608- - url
609609- type: object
610610- conditions:
611611- description: Conditions holds the conditions for the Bucket.
612612- items:
613613- description: Condition contains details for one aspect of the current
614614- state of this API Resource.
510510+ secretRef:
511511+ description: |-
512512+ SecretRef specifies the Secret containing authentication credentials
513513+ for the STS endpoint. This Secret must contain the fields `username`
514514+ and `password` and is supported only for the `ldap` provider.
515515+ properties:
516516+ name:
517517+ description: Name of the referent.
518518+ type: string
519519+ required:
520520+ - name
521521+ type: object
522522+ required:
523523+ - endpoint
524524+ - provider
525525+ type: object
526526+ suspend:
527527+ description: |-
528528+ Suspend tells the controller to suspend the reconciliation of this
529529+ Bucket.
530530+ type: boolean
531531+ timeout:
532532+ default: 60s
533533+ description: Timeout for fetch operations, defaults to 60s.
534534+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m))+$
535535+ type: string
536536+ required:
537537+ - bucketName
538538+ - endpoint
539539+ - interval
540540+ type: object
541541+ x-kubernetes-validations:
542542+ - message:
543543+ STS configuration is only supported for the 'aws' and 'generic'
544544+ Bucket providers
545545+ rule: self.provider == 'aws' || self.provider == 'generic' || !has(self.sts)
546546+ - message:
547547+ "'aws' is the only supported STS provider for the 'aws'
548548+ Bucket provider"
549549+ rule:
550550+ self.provider != 'aws' || !has(self.sts) || self.sts.provider
551551+ == 'aws'
552552+ - message:
553553+ "'ldap' is the only supported STS provider for the 'generic'
554554+ Bucket provider"
555555+ rule:
556556+ self.provider != 'generic' || !has(self.sts) || self.sts.provider
557557+ == 'ldap'
558558+ - message: spec.sts.secretRef is not required for the 'aws' STS provider
559559+ rule: "!has(self.sts) || self.sts.provider != 'aws' || !has(self.sts.secretRef)"
560560+ - message: spec.sts.certSecretRef is not required for the 'aws' STS provider
561561+ rule: "!has(self.sts) || self.sts.provider != 'aws' || !has(self.sts.certSecretRef)"
562562+ - message:
563563+ ServiceAccountName is not supported for the 'generic' Bucket
564564+ provider
565565+ rule: self.provider != 'generic' || !has(self.serviceAccountName)
566566+ - message: cannot set both .spec.secretRef and .spec.serviceAccountName
567567+ rule: "!has(self.secretRef) || !has(self.serviceAccountName)"
568568+ status:
569569+ default:
570570+ observedGeneration: -1
571571+ description: BucketStatus records the observed state of a Bucket.
572572+ properties:
573573+ artifact:
574574+ description: Artifact represents the last successful Bucket reconciliation.
615575 properties:
616616- lastTransitionTime:
576576+ digest:
577577+ description: Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
578578+ pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
579579+ type: string
580580+ lastUpdateTime:
617581 description: |-
618618- lastTransitionTime is the last time the condition transitioned from one status to another.
619619- This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
582582+ LastUpdateTime is the timestamp corresponding to the last update of the
583583+ Artifact.
620584 format: date-time
621585 type: string
622622- message:
586586+ metadata:
587587+ additionalProperties:
588588+ type: string
589589+ description: Metadata holds upstream information such as OCI annotations.
590590+ type: object
591591+ path:
623592 description: |-
624624- message is a human readable message indicating details about the transition.
625625- This may be an empty string.
626626- maxLength: 32768
593593+ Path is the relative file path of the Artifact. It can be used to locate
594594+ the file in the root of the Artifact storage on the local file system of
595595+ the controller managing the Source.
627596 type: string
628628- observedGeneration:
597597+ revision:
629598 description: |-
630630- observedGeneration represents the .metadata.generation that the condition was set based upon.
631631- For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
632632- with respect to the current state of the instance.
599599+ Revision is a human-readable identifier traceable in the origin source
600600+ system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
601601+ type: string
602602+ size:
603603+ description: Size is the number of bytes in the file.
633604 format: int64
634634- minimum: 0
635605 type: integer
636636- reason:
606606+ url:
637607 description: |-
638638- reason contains a programmatic identifier indicating the reason for the condition's last transition.
639639- Producers of specific condition types may define expected values and meanings for this field,
640640- and whether the values are considered a guaranteed API.
641641- The value should be a CamelCase string.
642642- This field may not be empty.
643643- maxLength: 1024
644644- minLength: 1
645645- pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
646646- type: string
647647- status:
648648- description: status of the condition, one of True, False, Unknown.
649649- enum:
650650- - "True"
651651- - "False"
652652- - Unknown
653653- type: string
654654- type:
655655- description: type of condition in CamelCase or in foo.example.com/CamelCase.
656656- maxLength: 316
657657- 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])$
608608+ URL is the HTTP address of the Artifact as exposed by the controller
609609+ managing the Source. It can be used to retrieve the Artifact for
610610+ consumption, e.g. by another controller applying the Artifact contents.
658611 type: string
659612 required:
660660- - lastTransitionTime
661661- - message
662662- - reason
663663- - status
664664- - type
613613+ - digest
614614+ - lastUpdateTime
615615+ - path
616616+ - revision
617617+ - url
665618 type: object
666666- type: array
667667- lastHandledReconcileAt:
668668- description: |-
669669- LastHandledReconcileAt holds the value of the most recent
670670- reconcile request value, so a change of the annotation value
671671- can be detected.
672672- type: string
673673- observedGeneration:
674674- description: ObservedGeneration is the last observed generation of
675675- the Bucket object.
676676- format: int64
677677- type: integer
678678- observedIgnore:
679679- description: |-
680680- ObservedIgnore is the observed exclusion patterns used for constructing
681681- the source artifact.
682682- type: string
683683- url:
684684- description: |-
685685- URL is the dynamic fetch link for the latest Artifact.
686686- It is provided on a "best effort" basis, and using the precise
687687- BucketStatus.Artifact data is recommended.
688688- type: string
689689- type: object
690690- type: object
691691- served: true
692692- storage: true
693693- subresources:
694694- status: {}
619619+ conditions:
620620+ description: Conditions holds the conditions for the Bucket.
621621+ items:
622622+ description:
623623+ Condition contains details for one aspect of the current
624624+ state of this API Resource.
625625+ properties:
626626+ lastTransitionTime:
627627+ description: |-
628628+ lastTransitionTime is the last time the condition transitioned from one status to another.
629629+ This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
630630+ format: date-time
631631+ type: string
632632+ message:
633633+ description: |-
634634+ message is a human readable message indicating details about the transition.
635635+ This may be an empty string.
636636+ maxLength: 32768
637637+ type: string
638638+ observedGeneration:
639639+ description: |-
640640+ observedGeneration represents the .metadata.generation that the condition was set based upon.
641641+ For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
642642+ with respect to the current state of the instance.
643643+ format: int64
644644+ minimum: 0
645645+ type: integer
646646+ reason:
647647+ description: |-
648648+ reason contains a programmatic identifier indicating the reason for the condition's last transition.
649649+ Producers of specific condition types may define expected values and meanings for this field,
650650+ and whether the values are considered a guaranteed API.
651651+ The value should be a CamelCase string.
652652+ This field may not be empty.
653653+ maxLength: 1024
654654+ minLength: 1
655655+ pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
656656+ type: string
657657+ status:
658658+ description: status of the condition, one of True, False, Unknown.
659659+ enum:
660660+ - "True"
661661+ - "False"
662662+ - Unknown
663663+ type: string
664664+ type:
665665+ description: type of condition in CamelCase or in foo.example.com/CamelCase.
666666+ maxLength: 316
667667+ 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])$
668668+ type: string
669669+ required:
670670+ - lastTransitionTime
671671+ - message
672672+ - reason
673673+ - status
674674+ - type
675675+ type: object
676676+ type: array
677677+ lastHandledReconcileAt:
678678+ description: |-
679679+ LastHandledReconcileAt holds the value of the most recent
680680+ reconcile request value, so a change of the annotation value
681681+ can be detected.
682682+ type: string
683683+ observedGeneration:
684684+ description:
685685+ ObservedGeneration is the last observed generation of
686686+ the Bucket object.
687687+ format: int64
688688+ type: integer
689689+ observedIgnore:
690690+ description: |-
691691+ ObservedIgnore is the observed exclusion patterns used for constructing
692692+ the source artifact.
693693+ type: string
694694+ url:
695695+ description: |-
696696+ URL is the dynamic fetch link for the latest Artifact.
697697+ It is provided on a "best effort" basis, and using the precise
698698+ BucketStatus.Artifact data is recommended.
699699+ type: string
700700+ type: object
701701+ type: object
702702+ served: true
703703+ storage: true
704704+ subresources:
705705+ status: {}
695706---
696707apiVersion: apiextensions.k8s.io/v1
697708kind: CustomResourceDefinition
···713724 singular: externalartifact
714725 scope: Namespaced
715726 versions:
716716- - additionalPrinterColumns:
717717- - jsonPath: .metadata.creationTimestamp
718718- name: Age
719719- type: date
720720- - jsonPath: .status.conditions[?(@.type=="Ready")].status
721721- name: Ready
722722- type: string
723723- - jsonPath: .status.conditions[?(@.type=="Ready")].message
724724- name: Status
725725- type: string
726726- - jsonPath: .spec.sourceRef.name
727727- name: Source
728728- type: string
729729- name: v1
730730- schema:
731731- openAPIV3Schema:
732732- description: ExternalArtifact is the Schema for the external artifacts API
733733- properties:
734734- apiVersion:
735735- description: |-
736736- APIVersion defines the versioned schema of this representation of an object.
737737- Servers should convert recognized schemas to the latest internal value, and
738738- may reject unrecognized values.
739739- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
740740- type: string
741741- kind:
742742- description: |-
743743- Kind is a string value representing the REST resource this object represents.
744744- Servers may infer this from the endpoint the client submits requests to.
745745- Cannot be updated.
746746- In CamelCase.
747747- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
748748- type: string
749749- metadata:
750750- type: object
751751- spec:
752752- description: ExternalArtifactSpec defines the desired state of ExternalArtifact
753753- properties:
754754- sourceRef:
755755- description: |-
756756- SourceRef points to the Kubernetes custom resource for
757757- which the artifact is generated.
758758- properties:
759759- apiVersion:
760760- description: API version of the referent, if not specified the
761761- Kubernetes preferred version will be used.
762762- type: string
763763- kind:
764764- description: Kind of the referent.
765765- type: string
766766- name:
767767- description: Name of the referent.
768768- type: string
769769- namespace:
770770- description: Namespace of the referent, when not specified it
771771- acts as LocalObjectReference.
772772- type: string
773773- required:
774774- - kind
775775- - name
776776- type: object
777777- type: object
778778- status:
779779- description: ExternalArtifactStatus defines the observed state of ExternalArtifact
780780- properties:
781781- artifact:
782782- description: Artifact represents the output of an ExternalArtifact
783783- reconciliation.
784784- properties:
785785- digest:
786786- description: Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
787787- pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
788788- type: string
789789- lastUpdateTime:
790790- description: |-
791791- LastUpdateTime is the timestamp corresponding to the last update of the
792792- Artifact.
793793- format: date-time
794794- type: string
795795- metadata:
796796- additionalProperties:
727727+ - additionalPrinterColumns:
728728+ - jsonPath: .metadata.creationTimestamp
729729+ name: Age
730730+ type: date
731731+ - jsonPath: .status.conditions[?(@.type=="Ready")].status
732732+ name: Ready
733733+ type: string
734734+ - jsonPath: .status.conditions[?(@.type=="Ready")].message
735735+ name: Status
736736+ type: string
737737+ - jsonPath: .spec.sourceRef.name
738738+ name: Source
739739+ type: string
740740+ name: v1
741741+ schema:
742742+ openAPIV3Schema:
743743+ description: ExternalArtifact is the Schema for the external artifacts API
744744+ properties:
745745+ apiVersion:
746746+ description: |-
747747+ APIVersion defines the versioned schema of this representation of an object.
748748+ Servers should convert recognized schemas to the latest internal value, and
749749+ may reject unrecognized values.
750750+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
751751+ type: string
752752+ kind:
753753+ description: |-
754754+ Kind is a string value representing the REST resource this object represents.
755755+ Servers may infer this from the endpoint the client submits requests to.
756756+ Cannot be updated.
757757+ In CamelCase.
758758+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
759759+ type: string
760760+ metadata:
761761+ type: object
762762+ spec:
763763+ description: ExternalArtifactSpec defines the desired state of ExternalArtifact
764764+ properties:
765765+ sourceRef:
766766+ description: |-
767767+ SourceRef points to the Kubernetes custom resource for
768768+ which the artifact is generated.
769769+ properties:
770770+ apiVersion:
771771+ description:
772772+ API version of the referent, if not specified the
773773+ Kubernetes preferred version will be used.
774774+ type: string
775775+ kind:
776776+ description: Kind of the referent.
777777+ type: string
778778+ name:
779779+ description: Name of the referent.
780780+ type: string
781781+ namespace:
782782+ description:
783783+ Namespace of the referent, when not specified it
784784+ acts as LocalObjectReference.
797785 type: string
798798- description: Metadata holds upstream information such as OCI annotations.
799799- type: object
800800- path:
801801- description: |-
802802- Path is the relative file path of the Artifact. It can be used to locate
803803- the file in the root of the Artifact storage on the local file system of
804804- the controller managing the Source.
805805- type: string
806806- revision:
807807- description: |-
808808- Revision is a human-readable identifier traceable in the origin source
809809- system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
810810- type: string
811811- size:
812812- description: Size is the number of bytes in the file.
813813- format: int64
814814- type: integer
815815- url:
816816- description: |-
817817- URL is the HTTP address of the Artifact as exposed by the controller
818818- managing the Source. It can be used to retrieve the Artifact for
819819- consumption, e.g. by another controller applying the Artifact contents.
820820- type: string
821821- required:
822822- - digest
823823- - lastUpdateTime
824824- - path
825825- - revision
826826- - url
827827- type: object
828828- conditions:
829829- description: Conditions holds the conditions for the ExternalArtifact.
830830- items:
831831- description: Condition contains details for one aspect of the current
832832- state of this API Resource.
786786+ required:
787787+ - kind
788788+ - name
789789+ type: object
790790+ type: object
791791+ status:
792792+ description: ExternalArtifactStatus defines the observed state of ExternalArtifact
793793+ properties:
794794+ artifact:
795795+ description:
796796+ Artifact represents the output of an ExternalArtifact
797797+ reconciliation.
833798 properties:
834834- lastTransitionTime:
799799+ digest:
800800+ description: Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
801801+ pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
802802+ type: string
803803+ lastUpdateTime:
835804 description: |-
836836- lastTransitionTime is the last time the condition transitioned from one status to another.
837837- This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
805805+ LastUpdateTime is the timestamp corresponding to the last update of the
806806+ Artifact.
838807 format: date-time
839808 type: string
840840- message:
809809+ metadata:
810810+ additionalProperties:
811811+ type: string
812812+ description: Metadata holds upstream information such as OCI annotations.
813813+ type: object
814814+ path:
841815 description: |-
842842- message is a human readable message indicating details about the transition.
843843- This may be an empty string.
844844- maxLength: 32768
816816+ Path is the relative file path of the Artifact. It can be used to locate
817817+ the file in the root of the Artifact storage on the local file system of
818818+ the controller managing the Source.
845819 type: string
846846- observedGeneration:
820820+ revision:
847821 description: |-
848848- observedGeneration represents the .metadata.generation that the condition was set based upon.
849849- For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
850850- with respect to the current state of the instance.
822822+ Revision is a human-readable identifier traceable in the origin source
823823+ system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
824824+ type: string
825825+ size:
826826+ description: Size is the number of bytes in the file.
851827 format: int64
852852- minimum: 0
853828 type: integer
854854- reason:
829829+ url:
855830 description: |-
856856- reason contains a programmatic identifier indicating the reason for the condition's last transition.
857857- Producers of specific condition types may define expected values and meanings for this field,
858858- and whether the values are considered a guaranteed API.
859859- The value should be a CamelCase string.
860860- This field may not be empty.
861861- maxLength: 1024
862862- minLength: 1
863863- pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
864864- type: string
865865- status:
866866- description: status of the condition, one of True, False, Unknown.
867867- enum:
868868- - "True"
869869- - "False"
870870- - Unknown
871871- type: string
872872- type:
873873- description: type of condition in CamelCase or in foo.example.com/CamelCase.
874874- maxLength: 316
875875- 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])$
831831+ URL is the HTTP address of the Artifact as exposed by the controller
832832+ managing the Source. It can be used to retrieve the Artifact for
833833+ consumption, e.g. by another controller applying the Artifact contents.
876834 type: string
877835 required:
878878- - lastTransitionTime
879879- - message
880880- - reason
881881- - status
882882- - type
836836+ - digest
837837+ - lastUpdateTime
838838+ - path
839839+ - revision
840840+ - url
883841 type: object
884884- type: array
885885- type: object
886886- type: object
887887- served: true
888888- storage: true
889889- subresources:
890890- status: {}
842842+ conditions:
843843+ description: Conditions holds the conditions for the ExternalArtifact.
844844+ items:
845845+ description:
846846+ Condition contains details for one aspect of the current
847847+ state of this API Resource.
848848+ properties:
849849+ lastTransitionTime:
850850+ description: |-
851851+ lastTransitionTime is the last time the condition transitioned from one status to another.
852852+ This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
853853+ format: date-time
854854+ type: string
855855+ message:
856856+ description: |-
857857+ message is a human readable message indicating details about the transition.
858858+ This may be an empty string.
859859+ maxLength: 32768
860860+ type: string
861861+ observedGeneration:
862862+ description: |-
863863+ observedGeneration represents the .metadata.generation that the condition was set based upon.
864864+ For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
865865+ with respect to the current state of the instance.
866866+ format: int64
867867+ minimum: 0
868868+ type: integer
869869+ reason:
870870+ description: |-
871871+ reason contains a programmatic identifier indicating the reason for the condition's last transition.
872872+ Producers of specific condition types may define expected values and meanings for this field,
873873+ and whether the values are considered a guaranteed API.
874874+ The value should be a CamelCase string.
875875+ This field may not be empty.
876876+ maxLength: 1024
877877+ minLength: 1
878878+ pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
879879+ type: string
880880+ status:
881881+ description: status of the condition, one of True, False, Unknown.
882882+ enum:
883883+ - "True"
884884+ - "False"
885885+ - Unknown
886886+ type: string
887887+ type:
888888+ description: type of condition in CamelCase or in foo.example.com/CamelCase.
889889+ maxLength: 316
890890+ 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])$
891891+ type: string
892892+ required:
893893+ - lastTransitionTime
894894+ - message
895895+ - reason
896896+ - status
897897+ - type
898898+ type: object
899899+ type: array
900900+ type: object
901901+ type: object
902902+ served: true
903903+ storage: true
904904+ subresources:
905905+ status: {}
891906---
892907apiVersion: apiextensions.k8s.io/v1
893908kind: CustomResourceDefinition
···907922 listKind: GitRepositoryList
908923 plural: gitrepositories
909924 shortNames:
910910- - gitrepo
925925+ - gitrepo
911926 singular: gitrepository
912927 scope: Namespaced
913928 versions:
914914- - additionalPrinterColumns:
915915- - jsonPath: .spec.url
916916- name: URL
917917- type: string
918918- - jsonPath: .metadata.creationTimestamp
919919- name: Age
920920- type: date
921921- - jsonPath: .status.conditions[?(@.type=="Ready")].status
922922- name: Ready
923923- type: string
924924- - jsonPath: .status.conditions[?(@.type=="Ready")].message
925925- name: Status
926926- type: string
927927- name: v1
928928- schema:
929929- openAPIV3Schema:
930930- description: GitRepository is the Schema for the gitrepositories API.
931931- properties:
932932- apiVersion:
933933- description: |-
934934- APIVersion defines the versioned schema of this representation of an object.
935935- Servers should convert recognized schemas to the latest internal value, and
936936- may reject unrecognized values.
937937- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
938938- type: string
939939- kind:
940940- description: |-
941941- Kind is a string value representing the REST resource this object represents.
942942- Servers may infer this from the endpoint the client submits requests to.
943943- Cannot be updated.
944944- In CamelCase.
945945- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
946946- type: string
947947- metadata:
948948- type: object
949949- spec:
950950- description: |-
951951- GitRepositorySpec specifies the required configuration to produce an
952952- Artifact for a Git repository.
953953- properties:
954954- ignore:
955955- description: |-
956956- Ignore overrides the set of excluded patterns in the .sourceignore format
957957- (which is the same as .gitignore). If not provided, a default will be used,
958958- consult the documentation for your version to find out what those are.
959959- type: string
960960- include:
961961- description: |-
962962- Include specifies a list of GitRepository resources which Artifacts
963963- should be included in the Artifact produced for this GitRepository.
964964- items:
929929+ - additionalPrinterColumns:
930930+ - jsonPath: .spec.url
931931+ name: URL
932932+ type: string
933933+ - jsonPath: .metadata.creationTimestamp
934934+ name: Age
935935+ type: date
936936+ - jsonPath: .status.conditions[?(@.type=="Ready")].status
937937+ name: Ready
938938+ type: string
939939+ - jsonPath: .status.conditions[?(@.type=="Ready")].message
940940+ name: Status
941941+ type: string
942942+ name: v1
943943+ schema:
944944+ openAPIV3Schema:
945945+ description: GitRepository is the Schema for the gitrepositories API.
946946+ properties:
947947+ apiVersion:
948948+ description: |-
949949+ APIVersion defines the versioned schema of this representation of an object.
950950+ Servers should convert recognized schemas to the latest internal value, and
951951+ may reject unrecognized values.
952952+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
953953+ type: string
954954+ kind:
955955+ description: |-
956956+ Kind is a string value representing the REST resource this object represents.
957957+ Servers may infer this from the endpoint the client submits requests to.
958958+ Cannot be updated.
959959+ In CamelCase.
960960+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
961961+ type: string
962962+ metadata:
963963+ type: object
964964+ spec:
965965+ description: |-
966966+ GitRepositorySpec specifies the required configuration to produce an
967967+ Artifact for a Git repository.
968968+ properties:
969969+ ignore:
965970 description: |-
966966- GitRepositoryInclude specifies a local reference to a GitRepository which
967967- Artifact (sub-)contents must be included, and where they should be placed.
968968- properties:
969969- fromPath:
970970- description: |-
971971- FromPath specifies the path to copy contents from, defaults to the root
972972- of the Artifact.
973973- type: string
974974- repository:
975975- description: |-
976976- GitRepositoryRef specifies the GitRepository which Artifact contents
977977- must be included.
978978- properties:
979979- name:
980980- description: Name of the referent.
981981- type: string
982982- required:
983983- - name
984984- type: object
985985- toPath:
986986- description: |-
987987- ToPath specifies the path to copy contents to, defaults to the name of
988988- the GitRepositoryRef.
989989- type: string
990990- required:
991991- - repository
992992- type: object
993993- type: array
994994- interval:
995995- description: |-
996996- Interval at which the GitRepository URL is checked for updates.
997997- This interval is approximate and may be subject to jitter to ensure
998998- efficient use of resources.
999999- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
10001000- type: string
10011001- provider:
10021002- description: |-
10031003- Provider used for authentication, can be 'azure', 'github', 'generic'.
10041004- When not specified, defaults to 'generic'.
10051005- enum:
10061006- - generic
10071007- - azure
10081008- - github
10091009- type: string
10101010- proxySecretRef:
10111011- description: |-
10121012- ProxySecretRef specifies the Secret containing the proxy configuration
10131013- to use while communicating with the Git server.
10141014- properties:
10151015- name:
10161016- description: Name of the referent.
10171017- type: string
10181018- required:
10191019- - name
10201020- type: object
10211021- recurseSubmodules:
10221022- description: |-
10231023- RecurseSubmodules enables the initialization of all submodules within
10241024- the GitRepository as cloned from the URL, using their default settings.
10251025- type: boolean
10261026- ref:
10271027- description: |-
10281028- Reference specifies the Git reference to resolve and monitor for
10291029- changes, defaults to the 'master' branch.
10301030- properties:
10311031- branch:
10321032- description: Branch to check out, defaults to 'master' if no other
10331033- field is defined.
10341034- type: string
10351035- commit:
10361036- description: |-
10371037- Commit SHA to check out, takes precedence over all reference fields.
10381038-10391039- This can be combined with Branch to shallow clone the branch, in which
10401040- the commit is expected to exist.
10411041- type: string
10421042- name:
10431043- description: |-
10441044- Name of the reference to check out; takes precedence over Branch, Tag and SemVer.
10451045-10461046- It must be a valid Git reference: https://git-scm.com/docs/git-check-ref-format#_description
10471047- Examples: "refs/heads/main", "refs/tags/v0.1.0", "refs/pull/420/head", "refs/merge-requests/1/head"
10481048- type: string
10491049- semver:
10501050- description: SemVer tag expression to check out, takes precedence
10511051- over Tag.
10521052- type: string
10531053- tag:
10541054- description: Tag to check out, takes precedence over Branch.
10551055- type: string
10561056- type: object
10571057- secretRef:
10581058- description: |-
10591059- SecretRef specifies the Secret containing authentication credentials for
10601060- the GitRepository.
10611061- For HTTPS repositories the Secret must contain 'username' and 'password'
10621062- fields for basic auth or 'bearerToken' field for token auth.
10631063- For SSH repositories the Secret must contain 'identity'
10641064- and 'known_hosts' fields.
10651065- properties:
10661066- name:
10671067- description: Name of the referent.
10681068- type: string
10691069- required:
10701070- - name
10711071- type: object
10721072- serviceAccountName:
10731073- description: |-
10741074- ServiceAccountName is the name of the Kubernetes ServiceAccount used to
10751075- authenticate to the GitRepository. This field is only supported for 'azure' provider.
10761076- type: string
10771077- sparseCheckout:
10781078- description: |-
10791079- SparseCheckout specifies a list of directories to checkout when cloning
10801080- the repository. If specified, only these directories are included in the
10811081- Artifact produced for this GitRepository.
10821082- items:
971971+ Ignore overrides the set of excluded patterns in the .sourceignore format
972972+ (which is the same as .gitignore). If not provided, a default will be used,
973973+ consult the documentation for your version to find out what those are.
1083974 type: string
10841084- type: array
10851085- suspend:
10861086- description: |-
10871087- Suspend tells the controller to suspend the reconciliation of this
10881088- GitRepository.
10891089- type: boolean
10901090- timeout:
10911091- default: 60s
10921092- description: Timeout for Git operations like cloning, defaults to
10931093- 60s.
10941094- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m))+$
10951095- type: string
10961096- url:
10971097- description: URL specifies the Git repository URL, it can be an HTTP/S
10981098- or SSH address.
10991099- pattern: ^(http|https|ssh)://.*$
11001100- type: string
11011101- verify:
11021102- description: |-
11031103- Verification specifies the configuration to verify the Git commit
11041104- signature(s).
11051105- properties:
11061106- mode:
11071107- default: HEAD
975975+ include:
976976+ description: |-
977977+ Include specifies a list of GitRepository resources which Artifacts
978978+ should be included in the Artifact produced for this GitRepository.
979979+ items:
1108980 description: |-
11091109- Mode specifies which Git object(s) should be verified.
11101110-11111111- The variants "head" and "HEAD" both imply the same thing, i.e. verify
11121112- the commit that the HEAD of the Git repository points to. The variant
11131113- "head" solely exists to ensure backwards compatibility.
11141114- enum:
11151115- - head
11161116- - HEAD
11171117- - Tag
11181118- - TagAndHEAD
11191119- type: string
11201120- secretRef:
11211121- description: |-
11221122- SecretRef specifies the Secret containing the public keys of trusted Git
11231123- authors.
981981+ GitRepositoryInclude specifies a local reference to a GitRepository which
982982+ Artifact (sub-)contents must be included, and where they should be placed.
1124983 properties:
11251125- name:
11261126- description: Name of the referent.
984984+ fromPath:
985985+ description: |-
986986+ FromPath specifies the path to copy contents from, defaults to the root
987987+ of the Artifact.
988988+ type: string
989989+ repository:
990990+ description: |-
991991+ GitRepositoryRef specifies the GitRepository which Artifact contents
992992+ must be included.
993993+ properties:
994994+ name:
995995+ description: Name of the referent.
996996+ type: string
997997+ required:
998998+ - name
999999+ type: object
10001000+ toPath:
10011001+ description: |-
10021002+ ToPath specifies the path to copy contents to, defaults to the name of
10031003+ the GitRepositoryRef.
11271004 type: string
11281005 required:
11291129- - name
10061006+ - repository
11301007 type: object
11311131- required:
11321132- - secretRef
11331133- type: object
11341134- required:
11351135- - interval
11361136- - url
11371137- type: object
11381138- x-kubernetes-validations:
11391139- - message: serviceAccountName can only be set when provider is 'azure'
11401140- rule: '!has(self.serviceAccountName) || (has(self.provider) && self.provider
11411141- == ''azure'')'
11421142- status:
11431143- default:
11441144- observedGeneration: -1
11451145- description: GitRepositoryStatus records the observed state of a Git repository.
11461146- properties:
11471147- artifact:
11481148- description: Artifact represents the last successful GitRepository
11491149- reconciliation.
11501150- properties:
11511151- digest:
11521152- description: Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
11531153- pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
11541154- type: string
11551155- lastUpdateTime:
11561156- description: |-
11571157- LastUpdateTime is the timestamp corresponding to the last update of the
11581158- Artifact.
11591159- format: date-time
11601160- type: string
11611161- metadata:
11621162- additionalProperties:
10081008+ type: array
10091009+ interval:
10101010+ description: |-
10111011+ Interval at which the GitRepository URL is checked for updates.
10121012+ This interval is approximate and may be subject to jitter to ensure
10131013+ efficient use of resources.
10141014+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
10151015+ type: string
10161016+ provider:
10171017+ description: |-
10181018+ Provider used for authentication, can be 'azure', 'github', 'generic'.
10191019+ When not specified, defaults to 'generic'.
10201020+ enum:
10211021+ - generic
10221022+ - azure
10231023+ - github
10241024+ type: string
10251025+ proxySecretRef:
10261026+ description: |-
10271027+ ProxySecretRef specifies the Secret containing the proxy configuration
10281028+ to use while communicating with the Git server.
10291029+ properties:
10301030+ name:
10311031+ description: Name of the referent.
11631032 type: string
11641164- description: Metadata holds upstream information such as OCI annotations.
11651165- type: object
11661166- path:
11671167- description: |-
11681168- Path is the relative file path of the Artifact. It can be used to locate
11691169- the file in the root of the Artifact storage on the local file system of
11701170- the controller managing the Source.
11711171- type: string
11721172- revision:
11731173- description: |-
11741174- Revision is a human-readable identifier traceable in the origin source
11751175- system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
11761176- type: string
11771177- size:
11781178- description: Size is the number of bytes in the file.
11791179- format: int64
11801180- type: integer
11811181- url:
11821182- description: |-
11831183- URL is the HTTP address of the Artifact as exposed by the controller
11841184- managing the Source. It can be used to retrieve the Artifact for
11851185- consumption, e.g. by another controller applying the Artifact contents.
11861186- type: string
11871187- required:
11881188- - digest
11891189- - lastUpdateTime
11901190- - path
11911191- - revision
11921192- - url
11931193- type: object
11941194- conditions:
11951195- description: Conditions holds the conditions for the GitRepository.
11961196- items:
11971197- description: Condition contains details for one aspect of the current
11981198- state of this API Resource.
10331033+ required:
10341034+ - name
10351035+ type: object
10361036+ recurseSubmodules:
10371037+ description: |-
10381038+ RecurseSubmodules enables the initialization of all submodules within
10391039+ the GitRepository as cloned from the URL, using their default settings.
10401040+ type: boolean
10411041+ ref:
10421042+ description: |-
10431043+ Reference specifies the Git reference to resolve and monitor for
10441044+ changes, defaults to the 'master' branch.
11991045 properties:
12001200- lastTransitionTime:
10461046+ branch:
10471047+ description:
10481048+ Branch to check out, defaults to 'master' if no other
10491049+ field is defined.
10501050+ type: string
10511051+ commit:
12011052 description: |-
12021202- lastTransitionTime is the last time the condition transitioned from one status to another.
12031203- This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
12041204- format: date-time
10531053+ Commit SHA to check out, takes precedence over all reference fields.
10541054+10551055+ This can be combined with Branch to shallow clone the branch, in which
10561056+ the commit is expected to exist.
12051057 type: string
12061206- message:
10581058+ name:
12071059 description: |-
12081208- message is a human readable message indicating details about the transition.
12091209- This may be an empty string.
12101210- maxLength: 32768
10601060+ Name of the reference to check out; takes precedence over Branch, Tag and SemVer.
10611061+10621062+ It must be a valid Git reference: https://git-scm.com/docs/git-check-ref-format#_description
10631063+ Examples: "refs/heads/main", "refs/tags/v0.1.0", "refs/pull/420/head", "refs/merge-requests/1/head"
10641064+ type: string
10651065+ semver:
10661066+ description:
10671067+ SemVer tag expression to check out, takes precedence
10681068+ over Tag.
10691069+ type: string
10701070+ tag:
10711071+ description: Tag to check out, takes precedence over Branch.
10721072+ type: string
10731073+ type: object
10741074+ secretRef:
10751075+ description: |-
10761076+ SecretRef specifies the Secret containing authentication credentials for
10771077+ the GitRepository.
10781078+ For HTTPS repositories the Secret must contain 'username' and 'password'
10791079+ fields for basic auth or 'bearerToken' field for token auth.
10801080+ For SSH repositories the Secret must contain 'identity'
10811081+ and 'known_hosts' fields.
10821082+ properties:
10831083+ name:
10841084+ description: Name of the referent.
12111085 type: string
12121212- observedGeneration:
12131213- description: |-
12141214- observedGeneration represents the .metadata.generation that the condition was set based upon.
12151215- For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
12161216- with respect to the current state of the instance.
12171217- format: int64
12181218- minimum: 0
12191219- type: integer
12201220- reason:
10861086+ required:
10871087+ - name
10881088+ type: object
10891089+ serviceAccountName:
10901090+ description: |-
10911091+ ServiceAccountName is the name of the Kubernetes ServiceAccount used to
10921092+ authenticate to the GitRepository. This field is only supported for 'azure' provider.
10931093+ type: string
10941094+ sparseCheckout:
10951095+ description: |-
10961096+ SparseCheckout specifies a list of directories to checkout when cloning
10971097+ the repository. If specified, only these directories are included in the
10981098+ Artifact produced for this GitRepository.
10991099+ items:
11001100+ type: string
11011101+ type: array
11021102+ suspend:
11031103+ description: |-
11041104+ Suspend tells the controller to suspend the reconciliation of this
11051105+ GitRepository.
11061106+ type: boolean
11071107+ timeout:
11081108+ default: 60s
11091109+ description:
11101110+ Timeout for Git operations like cloning, defaults to
11111111+ 60s.
11121112+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m))+$
11131113+ type: string
11141114+ url:
11151115+ description:
11161116+ URL specifies the Git repository URL, it can be an HTTP/S
11171117+ or SSH address.
11181118+ pattern: ^(http|https|ssh)://.*$
11191119+ type: string
11201120+ verify:
11211121+ description: |-
11221122+ Verification specifies the configuration to verify the Git commit
11231123+ signature(s).
11241124+ properties:
11251125+ mode:
11261126+ default: HEAD
12211127 description: |-
12221222- reason contains a programmatic identifier indicating the reason for the condition's last transition.
12231223- Producers of specific condition types may define expected values and meanings for this field,
12241224- and whether the values are considered a guaranteed API.
12251225- The value should be a CamelCase string.
12261226- This field may not be empty.
12271227- maxLength: 1024
12281228- minLength: 1
12291229- pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
12301230- type: string
12311231- status:
12321232- description: status of the condition, one of True, False, Unknown.
11281128+ Mode specifies which Git object(s) should be verified.
11291129+11301130+ The variants "head" and "HEAD" both imply the same thing, i.e. verify
11311131+ the commit that the HEAD of the Git repository points to. The variant
11321132+ "head" solely exists to ensure backwards compatibility.
12331133 enum:
12341234- - "True"
12351235- - "False"
12361236- - Unknown
11341134+ - head
11351135+ - HEAD
11361136+ - Tag
11371137+ - TagAndHEAD
12371138 type: string
12381238- type:
12391239- description: type of condition in CamelCase or in foo.example.com/CamelCase.
12401240- maxLength: 316
12411241- 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])$
12421242- type: string
11391139+ secretRef:
11401140+ description: |-
11411141+ SecretRef specifies the Secret containing the public keys of trusted Git
11421142+ authors.
11431143+ properties:
11441144+ name:
11451145+ description: Name of the referent.
11461146+ type: string
11471147+ required:
11481148+ - name
11491149+ type: object
12431150 required:
12441244- - lastTransitionTime
12451245- - message
12461246- - reason
12471247- - status
12481248- - type
11511151+ - secretRef
12491152 type: object
12501250- type: array
12511251- includedArtifacts:
12521252- description: |-
12531253- IncludedArtifacts contains a list of the last successfully included
12541254- Artifacts as instructed by GitRepositorySpec.Include.
12551255- items:
12561256- description: Artifact represents the output of a Source reconciliation.
11531153+ required:
11541154+ - interval
11551155+ - url
11561156+ type: object
11571157+ x-kubernetes-validations:
11581158+ - message: serviceAccountName can only be set when provider is 'azure'
11591159+ rule:
11601160+ "!has(self.serviceAccountName) || (has(self.provider) && self.provider
11611161+ == 'azure')"
11621162+ status:
11631163+ default:
11641164+ observedGeneration: -1
11651165+ description: GitRepositoryStatus records the observed state of a Git repository.
11661166+ properties:
11671167+ artifact:
11681168+ description:
11691169+ Artifact represents the last successful GitRepository
11701170+ reconciliation.
12571171 properties:
12581172 digest:
12591259- description: Digest is the digest of the file in the form of
12601260- '<algorithm>:<checksum>'.
11731173+ description: Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
12611174 pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
12621175 type: string
12631176 lastUpdateTime:
···12691182 metadata:
12701183 additionalProperties:
12711184 type: string
12721272- description: Metadata holds upstream information such as OCI
12731273- annotations.
11851185+ description: Metadata holds upstream information such as OCI annotations.
12741186 type: object
12751187 path:
12761188 description: |-
···12941206 consumption, e.g. by another controller applying the Artifact contents.
12951207 type: string
12961208 required:
12971297- - digest
12981298- - lastUpdateTime
12991299- - path
13001300- - revision
13011301- - url
12091209+ - digest
12101210+ - lastUpdateTime
12111211+ - path
12121212+ - revision
12131213+ - url
13021214 type: object
13031303- type: array
13041304- lastHandledReconcileAt:
13051305- description: |-
13061306- LastHandledReconcileAt holds the value of the most recent
13071307- reconcile request value, so a change of the annotation value
13081308- can be detected.
13091309- type: string
13101310- observedGeneration:
13111311- description: |-
13121312- ObservedGeneration is the last observed generation of the GitRepository
13131313- object.
13141314- format: int64
13151315- type: integer
13161316- observedIgnore:
13171317- description: |-
13181318- ObservedIgnore is the observed exclusion patterns used for constructing
13191319- the source artifact.
13201320- type: string
13211321- observedInclude:
13221322- description: |-
13231323- ObservedInclude is the observed list of GitRepository resources used to
13241324- produce the current Artifact.
13251325- items:
12151215+ conditions:
12161216+ description: Conditions holds the conditions for the GitRepository.
12171217+ items:
12181218+ description:
12191219+ Condition contains details for one aspect of the current
12201220+ state of this API Resource.
12211221+ properties:
12221222+ lastTransitionTime:
12231223+ description: |-
12241224+ lastTransitionTime is the last time the condition transitioned from one status to another.
12251225+ This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
12261226+ format: date-time
12271227+ type: string
12281228+ message:
12291229+ description: |-
12301230+ message is a human readable message indicating details about the transition.
12311231+ This may be an empty string.
12321232+ maxLength: 32768
12331233+ type: string
12341234+ observedGeneration:
12351235+ description: |-
12361236+ observedGeneration represents the .metadata.generation that the condition was set based upon.
12371237+ For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
12381238+ with respect to the current state of the instance.
12391239+ format: int64
12401240+ minimum: 0
12411241+ type: integer
12421242+ reason:
12431243+ description: |-
12441244+ reason contains a programmatic identifier indicating the reason for the condition's last transition.
12451245+ Producers of specific condition types may define expected values and meanings for this field,
12461246+ and whether the values are considered a guaranteed API.
12471247+ The value should be a CamelCase string.
12481248+ This field may not be empty.
12491249+ maxLength: 1024
12501250+ minLength: 1
12511251+ pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
12521252+ type: string
12531253+ status:
12541254+ description: status of the condition, one of True, False, Unknown.
12551255+ enum:
12561256+ - "True"
12571257+ - "False"
12581258+ - Unknown
12591259+ type: string
12601260+ type:
12611261+ description: type of condition in CamelCase or in foo.example.com/CamelCase.
12621262+ maxLength: 316
12631263+ 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])$
12641264+ type: string
12651265+ required:
12661266+ - lastTransitionTime
12671267+ - message
12681268+ - reason
12691269+ - status
12701270+ - type
12711271+ type: object
12721272+ type: array
12731273+ includedArtifacts:
13261274 description: |-
13271327- GitRepositoryInclude specifies a local reference to a GitRepository which
13281328- Artifact (sub-)contents must be included, and where they should be placed.
13291329- properties:
13301330- fromPath:
13311331- description: |-
13321332- FromPath specifies the path to copy contents from, defaults to the root
13331333- of the Artifact.
13341334- type: string
13351335- repository:
13361336- description: |-
13371337- GitRepositoryRef specifies the GitRepository which Artifact contents
13381338- must be included.
13391339- properties:
13401340- name:
13411341- description: Name of the referent.
12751275+ IncludedArtifacts contains a list of the last successfully included
12761276+ Artifacts as instructed by GitRepositorySpec.Include.
12771277+ items:
12781278+ description: Artifact represents the output of a Source reconciliation.
12791279+ properties:
12801280+ digest:
12811281+ description:
12821282+ Digest is the digest of the file in the form of
12831283+ '<algorithm>:<checksum>'.
12841284+ pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
12851285+ type: string
12861286+ lastUpdateTime:
12871287+ description: |-
12881288+ LastUpdateTime is the timestamp corresponding to the last update of the
12891289+ Artifact.
12901290+ format: date-time
12911291+ type: string
12921292+ metadata:
12931293+ additionalProperties:
13421294 type: string
13431343- required:
13441344- - name
13451345- type: object
13461346- toPath:
13471347- description: |-
13481348- ToPath specifies the path to copy contents to, defaults to the name of
13491349- the GitRepositoryRef.
13501350- type: string
13511351- required:
13521352- - repository
13531353- type: object
13541354- type: array
13551355- observedRecurseSubmodules:
13561356- description: |-
13571357- ObservedRecurseSubmodules is the observed resource submodules
13581358- configuration used to produce the current Artifact.
13591359- type: boolean
13601360- observedSparseCheckout:
13611361- description: |-
13621362- ObservedSparseCheckout is the observed list of directories used to
13631363- produce the current Artifact.
13641364- items:
12951295+ description:
12961296+ Metadata holds upstream information such as OCI
12971297+ annotations.
12981298+ type: object
12991299+ path:
13001300+ description: |-
13011301+ Path is the relative file path of the Artifact. It can be used to locate
13021302+ the file in the root of the Artifact storage on the local file system of
13031303+ the controller managing the Source.
13041304+ type: string
13051305+ revision:
13061306+ description: |-
13071307+ Revision is a human-readable identifier traceable in the origin source
13081308+ system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
13091309+ type: string
13101310+ size:
13111311+ description: Size is the number of bytes in the file.
13121312+ format: int64
13131313+ type: integer
13141314+ url:
13151315+ description: |-
13161316+ URL is the HTTP address of the Artifact as exposed by the controller
13171317+ managing the Source. It can be used to retrieve the Artifact for
13181318+ consumption, e.g. by another controller applying the Artifact contents.
13191319+ type: string
13201320+ required:
13211321+ - digest
13221322+ - lastUpdateTime
13231323+ - path
13241324+ - revision
13251325+ - url
13261326+ type: object
13271327+ type: array
13281328+ lastHandledReconcileAt:
13291329+ description: |-
13301330+ LastHandledReconcileAt holds the value of the most recent
13311331+ reconcile request value, so a change of the annotation value
13321332+ can be detected.
13331333+ type: string
13341334+ observedGeneration:
13351335+ description: |-
13361336+ ObservedGeneration is the last observed generation of the GitRepository
13371337+ object.
13381338+ format: int64
13391339+ type: integer
13401340+ observedIgnore:
13411341+ description: |-
13421342+ ObservedIgnore is the observed exclusion patterns used for constructing
13431343+ the source artifact.
13441344+ type: string
13451345+ observedInclude:
13461346+ description: |-
13471347+ ObservedInclude is the observed list of GitRepository resources used to
13481348+ produce the current Artifact.
13491349+ items:
13501350+ description: |-
13511351+ GitRepositoryInclude specifies a local reference to a GitRepository which
13521352+ Artifact (sub-)contents must be included, and where they should be placed.
13531353+ properties:
13541354+ fromPath:
13551355+ description: |-
13561356+ FromPath specifies the path to copy contents from, defaults to the root
13571357+ of the Artifact.
13581358+ type: string
13591359+ repository:
13601360+ description: |-
13611361+ GitRepositoryRef specifies the GitRepository which Artifact contents
13621362+ must be included.
13631363+ properties:
13641364+ name:
13651365+ description: Name of the referent.
13661366+ type: string
13671367+ required:
13681368+ - name
13691369+ type: object
13701370+ toPath:
13711371+ description: |-
13721372+ ToPath specifies the path to copy contents to, defaults to the name of
13731373+ the GitRepositoryRef.
13741374+ type: string
13751375+ required:
13761376+ - repository
13771377+ type: object
13781378+ type: array
13791379+ observedRecurseSubmodules:
13801380+ description: |-
13811381+ ObservedRecurseSubmodules is the observed resource submodules
13821382+ configuration used to produce the current Artifact.
13831383+ type: boolean
13841384+ observedSparseCheckout:
13851385+ description: |-
13861386+ ObservedSparseCheckout is the observed list of directories used to
13871387+ produce the current Artifact.
13881388+ items:
13891389+ type: string
13901390+ type: array
13911391+ sourceVerificationMode:
13921392+ description: |-
13931393+ SourceVerificationMode is the last used verification mode indicating
13941394+ which Git object(s) have been verified.
13651395 type: string
13661366- type: array
13671367- sourceVerificationMode:
13681368- description: |-
13691369- SourceVerificationMode is the last used verification mode indicating
13701370- which Git object(s) have been verified.
13711371- type: string
13721372- type: object
13731373- type: object
13741374- served: true
13751375- storage: true
13761376- subresources:
13771377- status: {}
13961396+ type: object
13971397+ type: object
13981398+ served: true
13991399+ storage: true
14001400+ subresources:
14011401+ status: {}
13781402---
13791403apiVersion: apiextensions.k8s.io/v1
13801404kind: CustomResourceDefinition
···13941418 listKind: HelmChartList
13951419 plural: helmcharts
13961420 shortNames:
13971397- - hc
14211421+ - hc
13981422 singular: helmchart
13991423 scope: Namespaced
14001424 versions:
14011401- - additionalPrinterColumns:
14021402- - jsonPath: .spec.chart
14031403- name: Chart
14041404- type: string
14051405- - jsonPath: .spec.version
14061406- name: Version
14071407- type: string
14081408- - jsonPath: .spec.sourceRef.kind
14091409- name: Source Kind
14101410- type: string
14111411- - jsonPath: .spec.sourceRef.name
14121412- name: Source Name
14131413- type: string
14141414- - jsonPath: .metadata.creationTimestamp
14151415- name: Age
14161416- type: date
14171417- - jsonPath: .status.conditions[?(@.type=="Ready")].status
14181418- name: Ready
14191419- type: string
14201420- - jsonPath: .status.conditions[?(@.type=="Ready")].message
14211421- name: Status
14221422- type: string
14231423- name: v1
14241424- schema:
14251425- openAPIV3Schema:
14261426- description: HelmChart is the Schema for the helmcharts API.
14271427- properties:
14281428- apiVersion:
14291429- description: |-
14301430- APIVersion defines the versioned schema of this representation of an object.
14311431- Servers should convert recognized schemas to the latest internal value, and
14321432- may reject unrecognized values.
14331433- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
14341434- type: string
14351435- kind:
14361436- description: |-
14371437- Kind is a string value representing the REST resource this object represents.
14381438- Servers may infer this from the endpoint the client submits requests to.
14391439- Cannot be updated.
14401440- In CamelCase.
14411441- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
14421442- type: string
14431443- metadata:
14441444- type: object
14451445- spec:
14461446- description: HelmChartSpec specifies the desired state of a Helm chart.
14471447- properties:
14481448- chart:
14491449- description: |-
14501450- Chart is the name or path the Helm chart is available at in the
14511451- SourceRef.
14521452- type: string
14531453- ignoreMissingValuesFiles:
14541454- description: |-
14551455- IgnoreMissingValuesFiles controls whether to silently ignore missing values
14561456- files rather than failing.
14571457- type: boolean
14581458- interval:
14591459- description: |-
14601460- Interval at which the HelmChart SourceRef is checked for updates.
14611461- This interval is approximate and may be subject to jitter to ensure
14621462- efficient use of resources.
14631463- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
14641464- type: string
14651465- reconcileStrategy:
14661466- default: ChartVersion
14671467- description: |-
14681468- ReconcileStrategy determines what enables the creation of a new artifact.
14691469- Valid values are ('ChartVersion', 'Revision').
14701470- See the documentation of the values for an explanation on their behavior.
14711471- Defaults to ChartVersion when omitted.
14721472- enum:
14731473- - ChartVersion
14741474- - Revision
14751475- type: string
14761476- sourceRef:
14771477- description: SourceRef is the reference to the Source the chart is
14781478- available at.
14791479- properties:
14801480- apiVersion:
14811481- description: APIVersion of the referent.
14821482- type: string
14831483- kind:
14841484- description: |-
14851485- Kind of the referent, valid values are ('HelmRepository', 'GitRepository',
14861486- 'Bucket').
14871487- enum:
14881488- - HelmRepository
14891489- - GitRepository
14901490- - Bucket
14911491- type: string
14921492- name:
14931493- description: Name of the referent.
14941494- type: string
14951495- required:
14961496- - kind
14971497- - name
14981498- type: object
14991499- suspend:
15001500- description: |-
15011501- Suspend tells the controller to suspend the reconciliation of this
15021502- source.
15031503- type: boolean
15041504- valuesFiles:
15051505- description: |-
15061506- ValuesFiles is an alternative list of values files to use as the chart
15071507- values (values.yaml is not included by default), expected to be a
15081508- relative path in the SourceRef.
15091509- Values files are merged in the order of this list with the last file
15101510- overriding the first. Ignored when omitted.
15111511- items:
14251425+ - additionalPrinterColumns:
14261426+ - jsonPath: .spec.chart
14271427+ name: Chart
14281428+ type: string
14291429+ - jsonPath: .spec.version
14301430+ name: Version
14311431+ type: string
14321432+ - jsonPath: .spec.sourceRef.kind
14331433+ name: Source Kind
14341434+ type: string
14351435+ - jsonPath: .spec.sourceRef.name
14361436+ name: Source Name
14371437+ type: string
14381438+ - jsonPath: .metadata.creationTimestamp
14391439+ name: Age
14401440+ type: date
14411441+ - jsonPath: .status.conditions[?(@.type=="Ready")].status
14421442+ name: Ready
14431443+ type: string
14441444+ - jsonPath: .status.conditions[?(@.type=="Ready")].message
14451445+ name: Status
14461446+ type: string
14471447+ name: v1
14481448+ schema:
14491449+ openAPIV3Schema:
14501450+ description: HelmChart is the Schema for the helmcharts API.
14511451+ properties:
14521452+ apiVersion:
14531453+ description: |-
14541454+ APIVersion defines the versioned schema of this representation of an object.
14551455+ Servers should convert recognized schemas to the latest internal value, and
14561456+ may reject unrecognized values.
14571457+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
14581458+ type: string
14591459+ kind:
14601460+ description: |-
14611461+ Kind is a string value representing the REST resource this object represents.
14621462+ Servers may infer this from the endpoint the client submits requests to.
14631463+ Cannot be updated.
14641464+ In CamelCase.
14651465+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
14661466+ type: string
14671467+ metadata:
14681468+ type: object
14691469+ spec:
14701470+ description: HelmChartSpec specifies the desired state of a Helm chart.
14711471+ properties:
14721472+ chart:
14731473+ description: |-
14741474+ Chart is the name or path the Helm chart is available at in the
14751475+ SourceRef.
14761476+ type: string
14771477+ ignoreMissingValuesFiles:
14781478+ description: |-
14791479+ IgnoreMissingValuesFiles controls whether to silently ignore missing values
14801480+ files rather than failing.
14811481+ type: boolean
14821482+ interval:
14831483+ description: |-
14841484+ Interval at which the HelmChart SourceRef is checked for updates.
14851485+ This interval is approximate and may be subject to jitter to ensure
14861486+ efficient use of resources.
14871487+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
15121488 type: string
15131513- type: array
15141514- verify:
15151515- description: |-
15161516- Verify contains the secret name containing the trusted public keys
15171517- used to verify the signature and specifies which provider to use to check
15181518- whether OCI image is authentic.
15191519- This field is only supported when using HelmRepository source with spec.type 'oci'.
15201520- Chart dependencies, which are not bundled in the umbrella chart artifact, are not verified.
15211521- properties:
15221522- matchOIDCIdentity:
15231523- description: |-
15241524- MatchOIDCIdentity specifies the identity matching criteria to use
15251525- while verifying an OCI artifact which was signed using Cosign keyless
15261526- signing. The artifact's identity is deemed to be verified if any of the
15271527- specified matchers match against the identity.
15281528- items:
14891489+ reconcileStrategy:
14901490+ default: ChartVersion
14911491+ description: |-
14921492+ ReconcileStrategy determines what enables the creation of a new artifact.
14931493+ Valid values are ('ChartVersion', 'Revision').
14941494+ See the documentation of the values for an explanation on their behavior.
14951495+ Defaults to ChartVersion when omitted.
14961496+ enum:
14971497+ - ChartVersion
14981498+ - Revision
14991499+ type: string
15001500+ sourceRef:
15011501+ description:
15021502+ SourceRef is the reference to the Source the chart is
15031503+ available at.
15041504+ properties:
15051505+ apiVersion:
15061506+ description: APIVersion of the referent.
15071507+ type: string
15081508+ kind:
15291509 description: |-
15301530- OIDCIdentityMatch specifies options for verifying the certificate identity,
15311531- i.e. the issuer and the subject of the certificate.
15101510+ Kind of the referent, valid values are ('HelmRepository', 'GitRepository',
15111511+ 'Bucket').
15121512+ enum:
15131513+ - HelmRepository
15141514+ - GitRepository
15151515+ - Bucket
15161516+ type: string
15171517+ name:
15181518+ description: Name of the referent.
15191519+ type: string
15201520+ required:
15211521+ - kind
15221522+ - name
15231523+ type: object
15241524+ suspend:
15251525+ description: |-
15261526+ Suspend tells the controller to suspend the reconciliation of this
15271527+ source.
15281528+ type: boolean
15291529+ valuesFiles:
15301530+ description: |-
15311531+ ValuesFiles is an alternative list of values files to use as the chart
15321532+ values (values.yaml is not included by default), expected to be a
15331533+ relative path in the SourceRef.
15341534+ Values files are merged in the order of this list with the last file
15351535+ overriding the first. Ignored when omitted.
15361536+ items:
15371537+ type: string
15381538+ type: array
15391539+ verify:
15401540+ description: |-
15411541+ Verify contains the secret name containing the trusted public keys
15421542+ used to verify the signature and specifies which provider to use to check
15431543+ whether OCI image is authentic.
15441544+ This field is only supported when using HelmRepository source with spec.type 'oci'.
15451545+ Chart dependencies, which are not bundled in the umbrella chart artifact, are not verified.
15461546+ properties:
15471547+ matchOIDCIdentity:
15481548+ description: |-
15491549+ MatchOIDCIdentity specifies the identity matching criteria to use
15501550+ while verifying an OCI artifact which was signed using Cosign keyless
15511551+ signing. The artifact's identity is deemed to be verified if any of the
15521552+ specified matchers match against the identity.
15531553+ items:
15541554+ description: |-
15551555+ OIDCIdentityMatch specifies options for verifying the certificate identity,
15561556+ i.e. the issuer and the subject of the certificate.
15571557+ properties:
15581558+ issuer:
15591559+ description: |-
15601560+ Issuer specifies the regex pattern to match against to verify
15611561+ the OIDC issuer in the Fulcio certificate. The pattern must be a
15621562+ valid Go regular expression.
15631563+ type: string
15641564+ subject:
15651565+ description: |-
15661566+ Subject specifies the regex pattern to match against to verify
15671567+ the identity subject in the Fulcio certificate. The pattern must
15681568+ be a valid Go regular expression.
15691569+ type: string
15701570+ required:
15711571+ - issuer
15721572+ - subject
15731573+ type: object
15741574+ type: array
15751575+ provider:
15761576+ default: cosign
15771577+ description:
15781578+ Provider specifies the technology used to sign the
15791579+ OCI Artifact.
15801580+ enum:
15811581+ - cosign
15821582+ - notation
15831583+ type: string
15841584+ secretRef:
15851585+ description: |-
15861586+ SecretRef specifies the Kubernetes Secret containing the
15871587+ trusted public keys.
15321588 properties:
15331533- issuer:
15341534- description: |-
15351535- Issuer specifies the regex pattern to match against to verify
15361536- the OIDC issuer in the Fulcio certificate. The pattern must be a
15371537- valid Go regular expression.
15381538- type: string
15391539- subject:
15401540- description: |-
15411541- Subject specifies the regex pattern to match against to verify
15421542- the identity subject in the Fulcio certificate. The pattern must
15431543- be a valid Go regular expression.
15891589+ name:
15901590+ description: Name of the referent.
15441591 type: string
15451592 required:
15461546- - issuer
15471547- - subject
15931593+ - name
15481594 type: object
15491549- type: array
15501550- provider:
15511551- default: cosign
15521552- description: Provider specifies the technology used to sign the
15531553- OCI Artifact.
15541554- enum:
15551555- - cosign
15561556- - notation
15571557- type: string
15581558- secretRef:
15591559- description: |-
15601560- SecretRef specifies the Kubernetes Secret containing the
15611561- trusted public keys.
15621562- properties:
15631563- name:
15641564- description: Name of the referent.
15651565- type: string
15661566- required:
15671567- - name
15681568- type: object
15691569- required:
15701570- - provider
15711571- type: object
15721572- version:
15731573- default: '*'
15741574- description: |-
15751575- Version is the chart version semver expression, ignored for charts from
15761576- GitRepository and Bucket sources. Defaults to latest when omitted.
15771577- type: string
15781578- required:
15791579- - chart
15801580- - interval
15811581- - sourceRef
15821582- type: object
15831583- x-kubernetes-validations:
15841584- - message: spec.verify is only supported when spec.sourceRef.kind is 'HelmRepository'
15851585- rule: '!has(self.verify) || self.sourceRef.kind == ''HelmRepository'''
15861586- status:
15871587- default:
15881588- observedGeneration: -1
15891589- description: HelmChartStatus records the observed state of the HelmChart.
15901590- properties:
15911591- artifact:
15921592- description: Artifact represents the output of the last successful
15931593- reconciliation.
15941594- properties:
15951595- digest:
15961596- description: Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
15971597- pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
15981598- type: string
15991599- lastUpdateTime:
16001600- description: |-
16011601- LastUpdateTime is the timestamp corresponding to the last update of the
16021602- Artifact.
16031603- format: date-time
16041604- type: string
16051605- metadata:
16061606- additionalProperties:
15951595+ required:
15961596+ - provider
15971597+ type: object
15981598+ version:
15991599+ default: "*"
16001600+ description: |-
16011601+ Version is the chart version semver expression, ignored for charts from
16021602+ GitRepository and Bucket sources. Defaults to latest when omitted.
16031603+ type: string
16041604+ required:
16051605+ - chart
16061606+ - interval
16071607+ - sourceRef
16081608+ type: object
16091609+ x-kubernetes-validations:
16101610+ - message: spec.verify is only supported when spec.sourceRef.kind is 'HelmRepository'
16111611+ rule: "!has(self.verify) || self.sourceRef.kind == 'HelmRepository'"
16121612+ status:
16131613+ default:
16141614+ observedGeneration: -1
16151615+ description: HelmChartStatus records the observed state of the HelmChart.
16161616+ properties:
16171617+ artifact:
16181618+ description:
16191619+ Artifact represents the output of the last successful
16201620+ reconciliation.
16211621+ properties:
16221622+ digest:
16231623+ description: Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
16241624+ pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
16071625 type: string
16081608- description: Metadata holds upstream information such as OCI annotations.
16091609- type: object
16101610- path:
16111611- description: |-
16121612- Path is the relative file path of the Artifact. It can be used to locate
16131613- the file in the root of the Artifact storage on the local file system of
16141614- the controller managing the Source.
16151615- type: string
16161616- revision:
16171617- description: |-
16181618- Revision is a human-readable identifier traceable in the origin source
16191619- system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
16201620- type: string
16211621- size:
16221622- description: Size is the number of bytes in the file.
16231623- format: int64
16241624- type: integer
16251625- url:
16261626- description: |-
16271627- URL is the HTTP address of the Artifact as exposed by the controller
16281628- managing the Source. It can be used to retrieve the Artifact for
16291629- consumption, e.g. by another controller applying the Artifact contents.
16301630- type: string
16311631- required:
16321632- - digest
16331633- - lastUpdateTime
16341634- - path
16351635- - revision
16361636- - url
16371637- type: object
16381638- conditions:
16391639- description: Conditions holds the conditions for the HelmChart.
16401640- items:
16411641- description: Condition contains details for one aspect of the current
16421642- state of this API Resource.
16431643- properties:
16441644- lastTransitionTime:
16261626+ lastUpdateTime:
16451627 description: |-
16461646- lastTransitionTime is the last time the condition transitioned from one status to another.
16471647- This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
16281628+ LastUpdateTime is the timestamp corresponding to the last update of the
16291629+ Artifact.
16481630 format: date-time
16491631 type: string
16501650- message:
16321632+ metadata:
16331633+ additionalProperties:
16341634+ type: string
16351635+ description: Metadata holds upstream information such as OCI annotations.
16361636+ type: object
16371637+ path:
16511638 description: |-
16521652- message is a human readable message indicating details about the transition.
16531653- This may be an empty string.
16541654- maxLength: 32768
16391639+ Path is the relative file path of the Artifact. It can be used to locate
16401640+ the file in the root of the Artifact storage on the local file system of
16411641+ the controller managing the Source.
16551642 type: string
16561656- observedGeneration:
16431643+ revision:
16571644 description: |-
16581658- observedGeneration represents the .metadata.generation that the condition was set based upon.
16591659- For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
16601660- with respect to the current state of the instance.
16451645+ Revision is a human-readable identifier traceable in the origin source
16461646+ system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
16471647+ type: string
16481648+ size:
16491649+ description: Size is the number of bytes in the file.
16611650 format: int64
16621662- minimum: 0
16631651 type: integer
16641664- reason:
16521652+ url:
16651653 description: |-
16661666- reason contains a programmatic identifier indicating the reason for the condition's last transition.
16671667- Producers of specific condition types may define expected values and meanings for this field,
16681668- and whether the values are considered a guaranteed API.
16691669- The value should be a CamelCase string.
16701670- This field may not be empty.
16711671- maxLength: 1024
16721672- minLength: 1
16731673- pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
16741674- type: string
16751675- status:
16761676- description: status of the condition, one of True, False, Unknown.
16771677- enum:
16781678- - "True"
16791679- - "False"
16801680- - Unknown
16811681- type: string
16821682- type:
16831683- description: type of condition in CamelCase or in foo.example.com/CamelCase.
16841684- maxLength: 316
16851685- 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])$
16541654+ URL is the HTTP address of the Artifact as exposed by the controller
16551655+ managing the Source. It can be used to retrieve the Artifact for
16561656+ consumption, e.g. by another controller applying the Artifact contents.
16861657 type: string
16871658 required:
16881688- - lastTransitionTime
16891689- - message
16901690- - reason
16911691- - status
16921692- - type
16591659+ - digest
16601660+ - lastUpdateTime
16611661+ - path
16621662+ - revision
16631663+ - url
16931664 type: object
16941694- type: array
16951695- lastHandledReconcileAt:
16961696- description: |-
16971697- LastHandledReconcileAt holds the value of the most recent
16981698- reconcile request value, so a change of the annotation value
16991699- can be detected.
17001700- type: string
17011701- observedChartName:
17021702- description: |-
17031703- ObservedChartName is the last observed chart name as specified by the
17041704- resolved chart reference.
17051705- type: string
17061706- observedGeneration:
17071707- description: |-
17081708- ObservedGeneration is the last observed generation of the HelmChart
17091709- object.
17101710- format: int64
17111711- type: integer
17121712- observedSourceArtifactRevision:
17131713- description: |-
17141714- ObservedSourceArtifactRevision is the last observed Artifact.Revision
17151715- of the HelmChartSpec.SourceRef.
17161716- type: string
17171717- observedValuesFiles:
17181718- description: |-
17191719- ObservedValuesFiles are the observed value files of the last successful
17201720- reconciliation.
17211721- It matches the chart in the last successfully reconciled artifact.
17221722- items:
16651665+ conditions:
16661666+ description: Conditions holds the conditions for the HelmChart.
16671667+ items:
16681668+ description:
16691669+ Condition contains details for one aspect of the current
16701670+ state of this API Resource.
16711671+ properties:
16721672+ lastTransitionTime:
16731673+ description: |-
16741674+ lastTransitionTime is the last time the condition transitioned from one status to another.
16751675+ This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
16761676+ format: date-time
16771677+ type: string
16781678+ message:
16791679+ description: |-
16801680+ message is a human readable message indicating details about the transition.
16811681+ This may be an empty string.
16821682+ maxLength: 32768
16831683+ type: string
16841684+ observedGeneration:
16851685+ description: |-
16861686+ observedGeneration represents the .metadata.generation that the condition was set based upon.
16871687+ For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
16881688+ with respect to the current state of the instance.
16891689+ format: int64
16901690+ minimum: 0
16911691+ type: integer
16921692+ reason:
16931693+ description: |-
16941694+ reason contains a programmatic identifier indicating the reason for the condition's last transition.
16951695+ Producers of specific condition types may define expected values and meanings for this field,
16961696+ and whether the values are considered a guaranteed API.
16971697+ The value should be a CamelCase string.
16981698+ This field may not be empty.
16991699+ maxLength: 1024
17001700+ minLength: 1
17011701+ pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
17021702+ type: string
17031703+ status:
17041704+ description: status of the condition, one of True, False, Unknown.
17051705+ enum:
17061706+ - "True"
17071707+ - "False"
17081708+ - Unknown
17091709+ type: string
17101710+ type:
17111711+ description: type of condition in CamelCase or in foo.example.com/CamelCase.
17121712+ maxLength: 316
17131713+ 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])$
17141714+ type: string
17151715+ required:
17161716+ - lastTransitionTime
17171717+ - message
17181718+ - reason
17191719+ - status
17201720+ - type
17211721+ type: object
17221722+ type: array
17231723+ lastHandledReconcileAt:
17241724+ description: |-
17251725+ LastHandledReconcileAt holds the value of the most recent
17261726+ reconcile request value, so a change of the annotation value
17271727+ can be detected.
17281728+ type: string
17291729+ observedChartName:
17301730+ description: |-
17311731+ ObservedChartName is the last observed chart name as specified by the
17321732+ resolved chart reference.
17331733+ type: string
17341734+ observedGeneration:
17351735+ description: |-
17361736+ ObservedGeneration is the last observed generation of the HelmChart
17371737+ object.
17381738+ format: int64
17391739+ type: integer
17401740+ observedSourceArtifactRevision:
17411741+ description: |-
17421742+ ObservedSourceArtifactRevision is the last observed Artifact.Revision
17431743+ of the HelmChartSpec.SourceRef.
17441744+ type: string
17451745+ observedValuesFiles:
17461746+ description: |-
17471747+ ObservedValuesFiles are the observed value files of the last successful
17481748+ reconciliation.
17491749+ It matches the chart in the last successfully reconciled artifact.
17501750+ items:
17511751+ type: string
17521752+ type: array
17531753+ url:
17541754+ description: |-
17551755+ URL is the dynamic fetch link for the latest Artifact.
17561756+ It is provided on a "best effort" basis, and using the precise
17571757+ BucketStatus.Artifact data is recommended.
17231758 type: string
17241724- type: array
17251725- url:
17261726- description: |-
17271727- URL is the dynamic fetch link for the latest Artifact.
17281728- It is provided on a "best effort" basis, and using the precise
17291729- BucketStatus.Artifact data is recommended.
17301730- type: string
17311731- type: object
17321732- type: object
17331733- served: true
17341734- storage: true
17351735- subresources:
17361736- status: {}
17591759+ type: object
17601760+ type: object
17611761+ served: true
17621762+ storage: true
17631763+ subresources:
17641764+ status: {}
17371765---
17381766apiVersion: apiextensions.k8s.io/v1
17391767kind: CustomResourceDefinition
···17531781 listKind: HelmRepositoryList
17541782 plural: helmrepositories
17551783 shortNames:
17561756- - helmrepo
17841784+ - helmrepo
17571785 singular: helmrepository
17581786 scope: Namespaced
17591787 versions:
17601760- - additionalPrinterColumns:
17611761- - jsonPath: .spec.url
17621762- name: URL
17631763- type: string
17641764- - jsonPath: .metadata.creationTimestamp
17651765- name: Age
17661766- type: date
17671767- - jsonPath: .status.conditions[?(@.type=="Ready")].status
17681768- name: Ready
17691769- type: string
17701770- - jsonPath: .status.conditions[?(@.type=="Ready")].message
17711771- name: Status
17721772- type: string
17731773- name: v1
17741774- schema:
17751775- openAPIV3Schema:
17761776- description: HelmRepository is the Schema for the helmrepositories API.
17771777- properties:
17781778- apiVersion:
17791779- description: |-
17801780- APIVersion defines the versioned schema of this representation of an object.
17811781- Servers should convert recognized schemas to the latest internal value, and
17821782- may reject unrecognized values.
17831783- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
17841784- type: string
17851785- kind:
17861786- description: |-
17871787- Kind is a string value representing the REST resource this object represents.
17881788- Servers may infer this from the endpoint the client submits requests to.
17891789- Cannot be updated.
17901790- In CamelCase.
17911791- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
17921792- type: string
17931793- metadata:
17941794- type: object
17951795- spec:
17961796- description: |-
17971797- HelmRepositorySpec specifies the required configuration to produce an
17981798- Artifact for a Helm repository index YAML.
17991799- properties:
18001800- accessFrom:
18011801- description: |-
18021802- AccessFrom specifies an Access Control List for allowing cross-namespace
18031803- references to this object.
18041804- NOTE: Not implemented, provisional as of https://github.com/fluxcd/flux2/pull/2092
18051805- properties:
18061806- namespaceSelectors:
18071807- description: |-
18081808- NamespaceSelectors is the list of namespace selectors to which this ACL applies.
18091809- Items in this list are evaluated using a logical OR operation.
18101810- items:
17881788+ - additionalPrinterColumns:
17891789+ - jsonPath: .spec.url
17901790+ name: URL
17911791+ type: string
17921792+ - jsonPath: .metadata.creationTimestamp
17931793+ name: Age
17941794+ type: date
17951795+ - jsonPath: .status.conditions[?(@.type=="Ready")].status
17961796+ name: Ready
17971797+ type: string
17981798+ - jsonPath: .status.conditions[?(@.type=="Ready")].message
17991799+ name: Status
18001800+ type: string
18011801+ name: v1
18021802+ schema:
18031803+ openAPIV3Schema:
18041804+ description: HelmRepository is the Schema for the helmrepositories API.
18051805+ properties:
18061806+ apiVersion:
18071807+ description: |-
18081808+ APIVersion defines the versioned schema of this representation of an object.
18091809+ Servers should convert recognized schemas to the latest internal value, and
18101810+ may reject unrecognized values.
18111811+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
18121812+ type: string
18131813+ kind:
18141814+ description: |-
18151815+ Kind is a string value representing the REST resource this object represents.
18161816+ Servers may infer this from the endpoint the client submits requests to.
18171817+ Cannot be updated.
18181818+ In CamelCase.
18191819+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
18201820+ type: string
18211821+ metadata:
18221822+ type: object
18231823+ spec:
18241824+ description: |-
18251825+ HelmRepositorySpec specifies the required configuration to produce an
18261826+ Artifact for a Helm repository index YAML.
18271827+ properties:
18281828+ accessFrom:
18291829+ description: |-
18301830+ AccessFrom specifies an Access Control List for allowing cross-namespace
18311831+ references to this object.
18321832+ NOTE: Not implemented, provisional as of https://github.com/fluxcd/flux2/pull/2092
18331833+ properties:
18341834+ namespaceSelectors:
18111835 description: |-
18121812- NamespaceSelector selects the namespaces to which this ACL applies.
18131813- An empty map of MatchLabels matches all namespaces in a cluster.
18141814- properties:
18151815- matchLabels:
18161816- additionalProperties:
18171817- type: string
18181818- description: |-
18191819- MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
18201820- map is equivalent to an element of matchExpressions, whose key field is "key", the
18211821- operator is "In", and the values array contains only "value". The requirements are ANDed.
18221822- type: object
18231823- type: object
18241824- type: array
18251825- required:
18261826- - namespaceSelectors
18271827- type: object
18281828- certSecretRef:
18291829- description: |-
18301830- CertSecretRef can be given the name of a Secret containing
18311831- either or both of
18361836+ NamespaceSelectors is the list of namespace selectors to which this ACL applies.
18371837+ Items in this list are evaluated using a logical OR operation.
18381838+ items:
18391839+ description: |-
18401840+ NamespaceSelector selects the namespaces to which this ACL applies.
18411841+ An empty map of MatchLabels matches all namespaces in a cluster.
18421842+ properties:
18431843+ matchLabels:
18441844+ additionalProperties:
18451845+ type: string
18461846+ description: |-
18471847+ MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
18481848+ map is equivalent to an element of matchExpressions, whose key field is "key", the
18491849+ operator is "In", and the values array contains only "value". The requirements are ANDed.
18501850+ type: object
18511851+ type: object
18521852+ type: array
18531853+ required:
18541854+ - namespaceSelectors
18551855+ type: object
18561856+ certSecretRef:
18571857+ description: |-
18581858+ CertSecretRef can be given the name of a Secret containing
18591859+ either or both of
1832186018331833- - a PEM-encoded client certificate (`tls.crt`) and private
18341834- key (`tls.key`);
18351835- - a PEM-encoded CA certificate (`ca.crt`)
18611861+ - a PEM-encoded client certificate (`tls.crt`) and private
18621862+ key (`tls.key`);
18631863+ - a PEM-encoded CA certificate (`ca.crt`)
1836186418371837- and whichever are supplied, will be used for connecting to the
18381838- registry. The client cert and key are useful if you are
18391839- authenticating with a certificate; the CA cert is useful if
18401840- you are using a self-signed server certificate. The Secret must
18411841- be of type `Opaque` or `kubernetes.io/tls`.
18651865+ and whichever are supplied, will be used for connecting to the
18661866+ registry. The client cert and key are useful if you are
18671867+ authenticating with a certificate; the CA cert is useful if
18681868+ you are using a self-signed server certificate. The Secret must
18691869+ be of type `Opaque` or `kubernetes.io/tls`.
1842187018431843- It takes precedence over the values specified in the Secret referred
18441844- to by `.spec.secretRef`.
18451845- properties:
18461846- name:
18471847- description: Name of the referent.
18481848- type: string
18491849- required:
18501850- - name
18511851- type: object
18521852- insecure:
18531853- description: |-
18541854- Insecure allows connecting to a non-TLS HTTP container registry.
18551855- This field is only taken into account if the .spec.type field is set to 'oci'.
18561856- type: boolean
18571857- interval:
18581858- description: |-
18591859- Interval at which the HelmRepository URL is checked for updates.
18601860- This interval is approximate and may be subject to jitter to ensure
18611861- efficient use of resources.
18621862- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
18631863- type: string
18641864- passCredentials:
18651865- description: |-
18661866- PassCredentials allows the credentials from the SecretRef to be passed
18671867- on to a host that does not match the host as defined in URL.
18681868- This may be required if the host of the advertised chart URLs in the
18691869- index differ from the defined URL.
18701870- Enabling this should be done with caution, as it can potentially result
18711871- in credentials getting stolen in a MITM-attack.
18721872- type: boolean
18731873- provider:
18741874- default: generic
18751875- description: |-
18761876- Provider used for authentication, can be 'aws', 'azure', 'gcp' or 'generic'.
18771877- This field is optional, and only taken into account if the .spec.type field is set to 'oci'.
18781878- When not specified, defaults to 'generic'.
18791879- enum:
18801880- - generic
18811881- - aws
18821882- - azure
18831883- - gcp
18841884- type: string
18851885- secretRef:
18861886- description: |-
18871887- SecretRef specifies the Secret containing authentication credentials
18881888- for the HelmRepository.
18891889- For HTTP/S basic auth the secret must contain 'username' and 'password'
18901890- fields.
18911891- Support for TLS auth using the 'certFile' and 'keyFile', and/or 'caFile'
18921892- keys is deprecated. Please use `.spec.certSecretRef` instead.
18931893- properties:
18941894- name:
18951895- description: Name of the referent.
18961896- type: string
18971897- required:
18981898- - name
18991899- type: object
19001900- suspend:
19011901- description: |-
19021902- Suspend tells the controller to suspend the reconciliation of this
19031903- HelmRepository.
19041904- type: boolean
19051905- timeout:
19061906- description: |-
19071907- Timeout is used for the index fetch operation for an HTTPS helm repository,
19081908- and for remote OCI Repository operations like pulling for an OCI helm
19091909- chart by the associated HelmChart.
19101910- Its default value is 60s.
19111911- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m))+$
19121912- type: string
19131913- type:
19141914- description: |-
19151915- Type of the HelmRepository.
19161916- When this field is set to "oci", the URL field value must be prefixed with "oci://".
19171917- enum:
19181918- - default
19191919- - oci
19201920- type: string
19211921- url:
19221922- description: |-
19231923- URL of the Helm repository, a valid URL contains at least a protocol and
19241924- host.
19251925- pattern: ^(http|https|oci)://.*$
19261926- type: string
19271927- required:
19281928- - url
19291929- type: object
19301930- status:
19311931- default:
19321932- observedGeneration: -1
19331933- description: HelmRepositoryStatus records the observed state of the HelmRepository.
19341934- properties:
19351935- artifact:
19361936- description: Artifact represents the last successful HelmRepository
19371937- reconciliation.
19381938- properties:
19391939- digest:
19401940- description: Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
19411941- pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
19421942- type: string
19431943- lastUpdateTime:
19441944- description: |-
19451945- LastUpdateTime is the timestamp corresponding to the last update of the
19461946- Artifact.
19471947- format: date-time
19481948- type: string
19491949- metadata:
19501950- additionalProperties:
18711871+ It takes precedence over the values specified in the Secret referred
18721872+ to by `.spec.secretRef`.
18731873+ properties:
18741874+ name:
18751875+ description: Name of the referent.
18761876+ type: string
18771877+ required:
18781878+ - name
18791879+ type: object
18801880+ insecure:
18811881+ description: |-
18821882+ Insecure allows connecting to a non-TLS HTTP container registry.
18831883+ This field is only taken into account if the .spec.type field is set to 'oci'.
18841884+ type: boolean
18851885+ interval:
18861886+ description: |-
18871887+ Interval at which the HelmRepository URL is checked for updates.
18881888+ This interval is approximate and may be subject to jitter to ensure
18891889+ efficient use of resources.
18901890+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
18911891+ type: string
18921892+ passCredentials:
18931893+ description: |-
18941894+ PassCredentials allows the credentials from the SecretRef to be passed
18951895+ on to a host that does not match the host as defined in URL.
18961896+ This may be required if the host of the advertised chart URLs in the
18971897+ index differ from the defined URL.
18981898+ Enabling this should be done with caution, as it can potentially result
18991899+ in credentials getting stolen in a MITM-attack.
19001900+ type: boolean
19011901+ provider:
19021902+ default: generic
19031903+ description: |-
19041904+ Provider used for authentication, can be 'aws', 'azure', 'gcp' or 'generic'.
19051905+ This field is optional, and only taken into account if the .spec.type field is set to 'oci'.
19061906+ When not specified, defaults to 'generic'.
19071907+ enum:
19081908+ - generic
19091909+ - aws
19101910+ - azure
19111911+ - gcp
19121912+ type: string
19131913+ secretRef:
19141914+ description: |-
19151915+ SecretRef specifies the Secret containing authentication credentials
19161916+ for the HelmRepository.
19171917+ For HTTP/S basic auth the secret must contain 'username' and 'password'
19181918+ fields.
19191919+ Support for TLS auth using the 'certFile' and 'keyFile', and/or 'caFile'
19201920+ keys is deprecated. Please use `.spec.certSecretRef` instead.
19211921+ properties:
19221922+ name:
19231923+ description: Name of the referent.
19511924 type: string
19521952- description: Metadata holds upstream information such as OCI annotations.
19531953- type: object
19541954- path:
19551955- description: |-
19561956- Path is the relative file path of the Artifact. It can be used to locate
19571957- the file in the root of the Artifact storage on the local file system of
19581958- the controller managing the Source.
19591959- type: string
19601960- revision:
19611961- description: |-
19621962- Revision is a human-readable identifier traceable in the origin source
19631963- system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
19641964- type: string
19651965- size:
19661966- description: Size is the number of bytes in the file.
19671967- format: int64
19681968- type: integer
19691969- url:
19701970- description: |-
19711971- URL is the HTTP address of the Artifact as exposed by the controller
19721972- managing the Source. It can be used to retrieve the Artifact for
19731973- consumption, e.g. by another controller applying the Artifact contents.
19741974- type: string
19751975- required:
19761976- - digest
19771977- - lastUpdateTime
19781978- - path
19791979- - revision
19251925+ required:
19261926+ - name
19271927+ type: object
19281928+ suspend:
19291929+ description: |-
19301930+ Suspend tells the controller to suspend the reconciliation of this
19311931+ HelmRepository.
19321932+ type: boolean
19331933+ timeout:
19341934+ description: |-
19351935+ Timeout is used for the index fetch operation for an HTTPS helm repository,
19361936+ and for remote OCI Repository operations like pulling for an OCI helm
19371937+ chart by the associated HelmChart.
19381938+ Its default value is 60s.
19391939+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m))+$
19401940+ type: string
19411941+ type:
19421942+ description: |-
19431943+ Type of the HelmRepository.
19441944+ When this field is set to "oci", the URL field value must be prefixed with "oci://".
19451945+ enum:
19461946+ - default
19471947+ - oci
19481948+ type: string
19491949+ url:
19501950+ description: |-
19511951+ URL of the Helm repository, a valid URL contains at least a protocol and
19521952+ host.
19531953+ pattern: ^(http|https|oci)://.*$
19541954+ type: string
19551955+ required:
19801956 - url
19811981- type: object
19821982- conditions:
19831983- description: Conditions holds the conditions for the HelmRepository.
19841984- items:
19851985- description: Condition contains details for one aspect of the current
19861986- state of this API Resource.
19571957+ type: object
19581958+ status:
19591959+ default:
19601960+ observedGeneration: -1
19611961+ description: HelmRepositoryStatus records the observed state of the HelmRepository.
19621962+ properties:
19631963+ artifact:
19641964+ description:
19651965+ Artifact represents the last successful HelmRepository
19661966+ reconciliation.
19871967 properties:
19881988- lastTransitionTime:
19681968+ digest:
19691969+ description: Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
19701970+ pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
19711971+ type: string
19721972+ lastUpdateTime:
19891973 description: |-
19901990- lastTransitionTime is the last time the condition transitioned from one status to another.
19911991- This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
19741974+ LastUpdateTime is the timestamp corresponding to the last update of the
19751975+ Artifact.
19921976 format: date-time
19931977 type: string
19941994- message:
19781978+ metadata:
19791979+ additionalProperties:
19801980+ type: string
19811981+ description: Metadata holds upstream information such as OCI annotations.
19821982+ type: object
19831983+ path:
19951984 description: |-
19961996- message is a human readable message indicating details about the transition.
19971997- This may be an empty string.
19981998- maxLength: 32768
19851985+ Path is the relative file path of the Artifact. It can be used to locate
19861986+ the file in the root of the Artifact storage on the local file system of
19871987+ the controller managing the Source.
19991988 type: string
20002000- observedGeneration:
19891989+ revision:
20011990 description: |-
20022002- observedGeneration represents the .metadata.generation that the condition was set based upon.
20032003- For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
20042004- with respect to the current state of the instance.
19911991+ Revision is a human-readable identifier traceable in the origin source
19921992+ system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
19931993+ type: string
19941994+ size:
19951995+ description: Size is the number of bytes in the file.
20051996 format: int64
20062006- minimum: 0
20071997 type: integer
20082008- reason:
19981998+ url:
20091999 description: |-
20102010- reason contains a programmatic identifier indicating the reason for the condition's last transition.
20112011- Producers of specific condition types may define expected values and meanings for this field,
20122012- and whether the values are considered a guaranteed API.
20132013- The value should be a CamelCase string.
20142014- This field may not be empty.
20152015- maxLength: 1024
20162016- minLength: 1
20172017- pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
20182018- type: string
20192019- status:
20202020- description: status of the condition, one of True, False, Unknown.
20212021- enum:
20222022- - "True"
20232023- - "False"
20242024- - Unknown
20252025- type: string
20262026- type:
20272027- description: type of condition in CamelCase or in foo.example.com/CamelCase.
20282028- maxLength: 316
20292029- 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])$
20002000+ URL is the HTTP address of the Artifact as exposed by the controller
20012001+ managing the Source. It can be used to retrieve the Artifact for
20022002+ consumption, e.g. by another controller applying the Artifact contents.
20302003 type: string
20312004 required:
20322032- - lastTransitionTime
20332033- - message
20342034- - reason
20352035- - status
20362036- - type
20052005+ - digest
20062006+ - lastUpdateTime
20072007+ - path
20082008+ - revision
20092009+ - url
20372010 type: object
20382038- type: array
20392039- lastHandledReconcileAt:
20402040- description: |-
20412041- LastHandledReconcileAt holds the value of the most recent
20422042- reconcile request value, so a change of the annotation value
20432043- can be detected.
20442044- type: string
20452045- observedGeneration:
20462046- description: |-
20472047- ObservedGeneration is the last observed generation of the HelmRepository
20482048- object.
20492049- format: int64
20502050- type: integer
20512051- url:
20522052- description: |-
20532053- URL is the dynamic fetch link for the latest Artifact.
20542054- It is provided on a "best effort" basis, and using the precise
20552055- HelmRepositoryStatus.Artifact data is recommended.
20562056- type: string
20572057- type: object
20582058- type: object
20592059- served: true
20602060- storage: true
20612061- subresources:
20622062- status: {}
20112011+ conditions:
20122012+ description: Conditions holds the conditions for the HelmRepository.
20132013+ items:
20142014+ description:
20152015+ Condition contains details for one aspect of the current
20162016+ state of this API Resource.
20172017+ properties:
20182018+ lastTransitionTime:
20192019+ description: |-
20202020+ lastTransitionTime is the last time the condition transitioned from one status to another.
20212021+ This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
20222022+ format: date-time
20232023+ type: string
20242024+ message:
20252025+ description: |-
20262026+ message is a human readable message indicating details about the transition.
20272027+ This may be an empty string.
20282028+ maxLength: 32768
20292029+ type: string
20302030+ observedGeneration:
20312031+ description: |-
20322032+ observedGeneration represents the .metadata.generation that the condition was set based upon.
20332033+ For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
20342034+ with respect to the current state of the instance.
20352035+ format: int64
20362036+ minimum: 0
20372037+ type: integer
20382038+ reason:
20392039+ description: |-
20402040+ reason contains a programmatic identifier indicating the reason for the condition's last transition.
20412041+ Producers of specific condition types may define expected values and meanings for this field,
20422042+ and whether the values are considered a guaranteed API.
20432043+ The value should be a CamelCase string.
20442044+ This field may not be empty.
20452045+ maxLength: 1024
20462046+ minLength: 1
20472047+ pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
20482048+ type: string
20492049+ status:
20502050+ description: status of the condition, one of True, False, Unknown.
20512051+ enum:
20522052+ - "True"
20532053+ - "False"
20542054+ - Unknown
20552055+ type: string
20562056+ type:
20572057+ description: type of condition in CamelCase or in foo.example.com/CamelCase.
20582058+ maxLength: 316
20592059+ 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])$
20602060+ type: string
20612061+ required:
20622062+ - lastTransitionTime
20632063+ - message
20642064+ - reason
20652065+ - status
20662066+ - type
20672067+ type: object
20682068+ type: array
20692069+ lastHandledReconcileAt:
20702070+ description: |-
20712071+ LastHandledReconcileAt holds the value of the most recent
20722072+ reconcile request value, so a change of the annotation value
20732073+ can be detected.
20742074+ type: string
20752075+ observedGeneration:
20762076+ description: |-
20772077+ ObservedGeneration is the last observed generation of the HelmRepository
20782078+ object.
20792079+ format: int64
20802080+ type: integer
20812081+ url:
20822082+ description: |-
20832083+ URL is the dynamic fetch link for the latest Artifact.
20842084+ It is provided on a "best effort" basis, and using the precise
20852085+ HelmRepositoryStatus.Artifact data is recommended.
20862086+ type: string
20872087+ type: object
20882088+ type: object
20892089+ served: true
20902090+ storage: true
20912091+ subresources:
20922092+ status: {}
20632093---
20642094apiVersion: apiextensions.k8s.io/v1
20652095kind: CustomResourceDefinition
···20792109 listKind: OCIRepositoryList
20802110 plural: ocirepositories
20812111 shortNames:
20822082- - ocirepo
21122112+ - ocirepo
20832113 singular: ocirepository
20842114 scope: Namespaced
20852115 versions:
20862086- - additionalPrinterColumns:
20872087- - jsonPath: .spec.url
20882088- name: URL
20892089- type: string
20902090- - jsonPath: .status.conditions[?(@.type=="Ready")].status
20912091- name: Ready
20922092- type: string
20932093- - jsonPath: .status.conditions[?(@.type=="Ready")].message
20942094- name: Status
20952095- type: string
20962096- - jsonPath: .metadata.creationTimestamp
20972097- name: Age
20982098- type: date
20992099- name: v1
21002100- schema:
21012101- openAPIV3Schema:
21022102- description: OCIRepository is the Schema for the ocirepositories API
21032103- properties:
21042104- apiVersion:
21052105- description: |-
21062106- APIVersion defines the versioned schema of this representation of an object.
21072107- Servers should convert recognized schemas to the latest internal value, and
21082108- may reject unrecognized values.
21092109- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
21102110- type: string
21112111- kind:
21122112- description: |-
21132113- Kind is a string value representing the REST resource this object represents.
21142114- Servers may infer this from the endpoint the client submits requests to.
21152115- Cannot be updated.
21162116- In CamelCase.
21172117- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
21182118- type: string
21192119- metadata:
21202120- type: object
21212121- spec:
21222122- description: OCIRepositorySpec defines the desired state of OCIRepository
21232123- properties:
21242124- certSecretRef:
21252125- description: |-
21262126- CertSecretRef can be given the name of a Secret containing
21272127- either or both of
21162116+ - additionalPrinterColumns:
21172117+ - jsonPath: .spec.url
21182118+ name: URL
21192119+ type: string
21202120+ - jsonPath: .status.conditions[?(@.type=="Ready")].status
21212121+ name: Ready
21222122+ type: string
21232123+ - jsonPath: .status.conditions[?(@.type=="Ready")].message
21242124+ name: Status
21252125+ type: string
21262126+ - jsonPath: .metadata.creationTimestamp
21272127+ name: Age
21282128+ type: date
21292129+ name: v1
21302130+ schema:
21312131+ openAPIV3Schema:
21322132+ description: OCIRepository is the Schema for the ocirepositories API
21332133+ properties:
21342134+ apiVersion:
21352135+ description: |-
21362136+ APIVersion defines the versioned schema of this representation of an object.
21372137+ Servers should convert recognized schemas to the latest internal value, and
21382138+ may reject unrecognized values.
21392139+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
21402140+ type: string
21412141+ kind:
21422142+ description: |-
21432143+ Kind is a string value representing the REST resource this object represents.
21442144+ Servers may infer this from the endpoint the client submits requests to.
21452145+ Cannot be updated.
21462146+ In CamelCase.
21472147+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
21482148+ type: string
21492149+ metadata:
21502150+ type: object
21512151+ spec:
21522152+ description: OCIRepositorySpec defines the desired state of OCIRepository
21532153+ properties:
21542154+ certSecretRef:
21552155+ description: |-
21562156+ CertSecretRef can be given the name of a Secret containing
21572157+ either or both of
2128215821292129- - a PEM-encoded client certificate (`tls.crt`) and private
21302130- key (`tls.key`);
21312131- - a PEM-encoded CA certificate (`ca.crt`)
21592159+ - a PEM-encoded client certificate (`tls.crt`) and private
21602160+ key (`tls.key`);
21612161+ - a PEM-encoded CA certificate (`ca.crt`)
2132216221332133- and whichever are supplied, will be used for connecting to the
21342134- registry. The client cert and key are useful if you are
21352135- authenticating with a certificate; the CA cert is useful if
21362136- you are using a self-signed server certificate. The Secret must
21372137- be of type `Opaque` or `kubernetes.io/tls`.
21382138- properties:
21392139- name:
21402140- description: Name of the referent.
21412141- type: string
21422142- required:
21432143- - name
21442144- type: object
21452145- ignore:
21462146- description: |-
21472147- Ignore overrides the set of excluded patterns in the .sourceignore format
21482148- (which is the same as .gitignore). If not provided, a default will be used,
21492149- consult the documentation for your version to find out what those are.
21502150- type: string
21512151- insecure:
21522152- description: Insecure allows connecting to a non-TLS HTTP container
21532153- registry.
21542154- type: boolean
21552155- interval:
21562156- description: |-
21572157- Interval at which the OCIRepository URL is checked for updates.
21582158- This interval is approximate and may be subject to jitter to ensure
21592159- efficient use of resources.
21602160- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
21612161- type: string
21622162- layerSelector:
21632163- description: |-
21642164- LayerSelector specifies which layer should be extracted from the OCI artifact.
21652165- When not specified, the first layer found in the artifact is selected.
21662166- properties:
21672167- mediaType:
21682168- description: |-
21692169- MediaType specifies the OCI media type of the layer
21702170- which should be extracted from the OCI Artifact. The
21712171- first layer matching this type is selected.
21722172- type: string
21732173- operation:
21742174- description: |-
21752175- Operation specifies how the selected layer should be processed.
21762176- By default, the layer compressed content is extracted to storage.
21772177- When the operation is set to 'copy', the layer compressed content
21782178- is persisted to storage as it is.
21792179- enum:
21802180- - extract
21812181- - copy
21822182- type: string
21832183- type: object
21842184- provider:
21852185- default: generic
21862186- description: |-
21872187- The provider used for authentication, can be 'aws', 'azure', 'gcp' or 'generic'.
21882188- When not specified, defaults to 'generic'.
21892189- enum:
21902190- - generic
21912191- - aws
21922192- - azure
21932193- - gcp
21942194- type: string
21952195- proxySecretRef:
21962196- description: |-
21972197- ProxySecretRef specifies the Secret containing the proxy configuration
21982198- to use while communicating with the container registry.
21992199- properties:
22002200- name:
22012201- description: Name of the referent.
22022202- type: string
22032203- required:
22042204- - name
22052205- type: object
22062206- ref:
22072207- description: |-
22082208- The OCI reference to pull and monitor for changes,
22092209- defaults to the latest tag.
22102210- properties:
22112211- digest:
22122212- description: |-
22132213- Digest is the image digest to pull, takes precedence over SemVer.
22142214- The value should be in the format 'sha256:<HASH>'.
22152215- type: string
22162216- semver:
22172217- description: |-
22182218- SemVer is the range of tags to pull selecting the latest within
22192219- the range, takes precedence over Tag.
22202220- type: string
22212221- semverFilter:
22222222- description: SemverFilter is a regex pattern to filter the tags
22232223- within the SemVer range.
22242224- type: string
22252225- tag:
22262226- description: Tag is the image tag to pull, defaults to latest.
22272227- type: string
22282228- type: object
22292229- secretRef:
22302230- description: |-
22312231- SecretRef contains the secret name containing the registry login
22322232- credentials to resolve image metadata.
22332233- The secret must be of type kubernetes.io/dockerconfigjson.
22342234- properties:
22352235- name:
22362236- description: Name of the referent.
22372237- type: string
22382238- required:
22392239- - name
22402240- type: object
22412241- serviceAccountName:
22422242- description: |-
22432243- ServiceAccountName is the name of the Kubernetes ServiceAccount used to authenticate
22442244- the image pull if the service account has attached pull secrets. For more information:
22452245- https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#add-imagepullsecrets-to-a-service-account
22462246- type: string
22472247- suspend:
22482248- description: This flag tells the controller to suspend the reconciliation
22492249- of this source.
22502250- type: boolean
22512251- timeout:
22522252- default: 60s
22532253- description: The timeout for remote OCI Repository operations like
22542254- pulling, defaults to 60s.
22552255- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m))+$
22562256- type: string
22572257- url:
22582258- description: |-
22592259- URL is a reference to an OCI artifact repository hosted
22602260- on a remote container registry.
22612261- pattern: ^oci://.*$
22622262- type: string
22632263- verify:
22642264- description: |-
22652265- Verify contains the secret name containing the trusted public keys
22662266- used to verify the signature and specifies which provider to use to check
22672267- whether OCI image is authentic.
22682268- properties:
22692269- matchOIDCIdentity:
22702270- description: |-
22712271- MatchOIDCIdentity specifies the identity matching criteria to use
22722272- while verifying an OCI artifact which was signed using Cosign keyless
22732273- signing. The artifact's identity is deemed to be verified if any of the
22742274- specified matchers match against the identity.
22752275- items:
21632163+ and whichever are supplied, will be used for connecting to the
21642164+ registry. The client cert and key are useful if you are
21652165+ authenticating with a certificate; the CA cert is useful if
21662166+ you are using a self-signed server certificate. The Secret must
21672167+ be of type `Opaque` or `kubernetes.io/tls`.
21682168+ properties:
21692169+ name:
21702170+ description: Name of the referent.
21712171+ type: string
21722172+ required:
21732173+ - name
21742174+ type: object
21752175+ ignore:
21762176+ description: |-
21772177+ Ignore overrides the set of excluded patterns in the .sourceignore format
21782178+ (which is the same as .gitignore). If not provided, a default will be used,
21792179+ consult the documentation for your version to find out what those are.
21802180+ type: string
21812181+ insecure:
21822182+ description:
21832183+ Insecure allows connecting to a non-TLS HTTP container
21842184+ registry.
21852185+ type: boolean
21862186+ interval:
21872187+ description: |-
21882188+ Interval at which the OCIRepository URL is checked for updates.
21892189+ This interval is approximate and may be subject to jitter to ensure
21902190+ efficient use of resources.
21912191+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
21922192+ type: string
21932193+ layerSelector:
21942194+ description: |-
21952195+ LayerSelector specifies which layer should be extracted from the OCI artifact.
21962196+ When not specified, the first layer found in the artifact is selected.
21972197+ properties:
21982198+ mediaType:
21992199+ description: |-
22002200+ MediaType specifies the OCI media type of the layer
22012201+ which should be extracted from the OCI Artifact. The
22022202+ first layer matching this type is selected.
22032203+ type: string
22042204+ operation:
22052205+ description: |-
22062206+ Operation specifies how the selected layer should be processed.
22072207+ By default, the layer compressed content is extracted to storage.
22082208+ When the operation is set to 'copy', the layer compressed content
22092209+ is persisted to storage as it is.
22102210+ enum:
22112211+ - extract
22122212+ - copy
22132213+ type: string
22142214+ type: object
22152215+ provider:
22162216+ default: generic
22172217+ description: |-
22182218+ The provider used for authentication, can be 'aws', 'azure', 'gcp' or 'generic'.
22192219+ When not specified, defaults to 'generic'.
22202220+ enum:
22212221+ - generic
22222222+ - aws
22232223+ - azure
22242224+ - gcp
22252225+ type: string
22262226+ proxySecretRef:
22272227+ description: |-
22282228+ ProxySecretRef specifies the Secret containing the proxy configuration
22292229+ to use while communicating with the container registry.
22302230+ properties:
22312231+ name:
22322232+ description: Name of the referent.
22332233+ type: string
22342234+ required:
22352235+ - name
22362236+ type: object
22372237+ ref:
22382238+ description: |-
22392239+ The OCI reference to pull and monitor for changes,
22402240+ defaults to the latest tag.
22412241+ properties:
22422242+ digest:
22432243+ description: |-
22442244+ Digest is the image digest to pull, takes precedence over SemVer.
22452245+ The value should be in the format 'sha256:<HASH>'.
22462246+ type: string
22472247+ semver:
22482248+ description: |-
22492249+ SemVer is the range of tags to pull selecting the latest within
22502250+ the range, takes precedence over Tag.
22512251+ type: string
22522252+ semverFilter:
22532253+ description:
22542254+ SemverFilter is a regex pattern to filter the tags
22552255+ within the SemVer range.
22562256+ type: string
22572257+ tag:
22582258+ description: Tag is the image tag to pull, defaults to latest.
22592259+ type: string
22602260+ type: object
22612261+ secretRef:
22622262+ description: |-
22632263+ SecretRef contains the secret name containing the registry login
22642264+ credentials to resolve image metadata.
22652265+ The secret must be of type kubernetes.io/dockerconfigjson.
22662266+ properties:
22672267+ name:
22682268+ description: Name of the referent.
22692269+ type: string
22702270+ required:
22712271+ - name
22722272+ type: object
22732273+ serviceAccountName:
22742274+ description: |-
22752275+ ServiceAccountName is the name of the Kubernetes ServiceAccount used to authenticate
22762276+ the image pull if the service account has attached pull secrets. For more information:
22772277+ https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#add-imagepullsecrets-to-a-service-account
22782278+ type: string
22792279+ suspend:
22802280+ description:
22812281+ This flag tells the controller to suspend the reconciliation
22822282+ of this source.
22832283+ type: boolean
22842284+ timeout:
22852285+ default: 60s
22862286+ description:
22872287+ The timeout for remote OCI Repository operations like
22882288+ pulling, defaults to 60s.
22892289+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m))+$
22902290+ type: string
22912291+ url:
22922292+ description: |-
22932293+ URL is a reference to an OCI artifact repository hosted
22942294+ on a remote container registry.
22952295+ pattern: ^oci://.*$
22962296+ type: string
22972297+ verify:
22982298+ description: |-
22992299+ Verify contains the secret name containing the trusted public keys
23002300+ used to verify the signature and specifies which provider to use to check
23012301+ whether OCI image is authentic.
23022302+ properties:
23032303+ matchOIDCIdentity:
22762304 description: |-
22772277- OIDCIdentityMatch specifies options for verifying the certificate identity,
22782278- i.e. the issuer and the subject of the certificate.
23052305+ MatchOIDCIdentity specifies the identity matching criteria to use
23062306+ while verifying an OCI artifact which was signed using Cosign keyless
23072307+ signing. The artifact's identity is deemed to be verified if any of the
23082308+ specified matchers match against the identity.
23092309+ items:
23102310+ description: |-
23112311+ OIDCIdentityMatch specifies options for verifying the certificate identity,
23122312+ i.e. the issuer and the subject of the certificate.
23132313+ properties:
23142314+ issuer:
23152315+ description: |-
23162316+ Issuer specifies the regex pattern to match against to verify
23172317+ the OIDC issuer in the Fulcio certificate. The pattern must be a
23182318+ valid Go regular expression.
23192319+ type: string
23202320+ subject:
23212321+ description: |-
23222322+ Subject specifies the regex pattern to match against to verify
23232323+ the identity subject in the Fulcio certificate. The pattern must
23242324+ be a valid Go regular expression.
23252325+ type: string
23262326+ required:
23272327+ - issuer
23282328+ - subject
23292329+ type: object
23302330+ type: array
23312331+ provider:
23322332+ default: cosign
23332333+ description:
23342334+ Provider specifies the technology used to sign the
23352335+ OCI Artifact.
23362336+ enum:
23372337+ - cosign
23382338+ - notation
23392339+ type: string
23402340+ secretRef:
23412341+ description: |-
23422342+ SecretRef specifies the Kubernetes Secret containing the
23432343+ trusted public keys.
22792344 properties:
22802280- issuer:
22812281- description: |-
22822282- Issuer specifies the regex pattern to match against to verify
22832283- the OIDC issuer in the Fulcio certificate. The pattern must be a
22842284- valid Go regular expression.
22852285- type: string
22862286- subject:
22872287- description: |-
22882288- Subject specifies the regex pattern to match against to verify
22892289- the identity subject in the Fulcio certificate. The pattern must
22902290- be a valid Go regular expression.
23452345+ name:
23462346+ description: Name of the referent.
22912347 type: string
22922348 required:
22932293- - issuer
22942294- - subject
23492349+ - name
22952350 type: object
22962296- type: array
22972297- provider:
22982298- default: cosign
22992299- description: Provider specifies the technology used to sign the
23002300- OCI Artifact.
23012301- enum:
23022302- - cosign
23032303- - notation
23042304- type: string
23052305- secretRef:
23062306- description: |-
23072307- SecretRef specifies the Kubernetes Secret containing the
23082308- trusted public keys.
23092309- properties:
23102310- name:
23112311- description: Name of the referent.
23122312- type: string
23132313- required:
23142314- - name
23152315- type: object
23162316- required:
23172317- - provider
23182318- type: object
23192319- required:
23202320- - interval
23212321- - url
23222322- type: object
23232323- status:
23242324- default:
23252325- observedGeneration: -1
23262326- description: OCIRepositoryStatus defines the observed state of OCIRepository
23272327- properties:
23282328- artifact:
23292329- description: Artifact represents the output of the last successful
23302330- OCI Repository sync.
23312331- properties:
23322332- digest:
23332333- description: Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
23342334- pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
23352335- type: string
23362336- lastUpdateTime:
23372337- description: |-
23382338- LastUpdateTime is the timestamp corresponding to the last update of the
23392339- Artifact.
23402340- format: date-time
23412341- type: string
23422342- metadata:
23432343- additionalProperties:
23442344- type: string
23452345- description: Metadata holds upstream information such as OCI annotations.
23462346- type: object
23472347- path:
23482348- description: |-
23492349- Path is the relative file path of the Artifact. It can be used to locate
23502350- the file in the root of the Artifact storage on the local file system of
23512351- the controller managing the Source.
23522352- type: string
23532353- revision:
23542354- description: |-
23552355- Revision is a human-readable identifier traceable in the origin source
23562356- system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
23572357- type: string
23582358- size:
23592359- description: Size is the number of bytes in the file.
23602360- format: int64
23612361- type: integer
23622362- url:
23632363- description: |-
23642364- URL is the HTTP address of the Artifact as exposed by the controller
23652365- managing the Source. It can be used to retrieve the Artifact for
23662366- consumption, e.g. by another controller applying the Artifact contents.
23672367- type: string
23682368- required:
23692369- - digest
23702370- - lastUpdateTime
23712371- - path
23722372- - revision
23512351+ required:
23522352+ - provider
23532353+ type: object
23542354+ required:
23552355+ - interval
23732356 - url
23742374- type: object
23752375- conditions:
23762376- description: Conditions holds the conditions for the OCIRepository.
23772377- items:
23782378- description: Condition contains details for one aspect of the current
23792379- state of this API Resource.
23572357+ type: object
23582358+ status:
23592359+ default:
23602360+ observedGeneration: -1
23612361+ description: OCIRepositoryStatus defines the observed state of OCIRepository
23622362+ properties:
23632363+ artifact:
23642364+ description:
23652365+ Artifact represents the output of the last successful
23662366+ OCI Repository sync.
23802367 properties:
23812381- lastTransitionTime:
23682368+ digest:
23692369+ description: Digest is the digest of the file in the form of '<algorithm>:<checksum>'.
23702370+ pattern: ^[a-z0-9]+(?:[.+_-][a-z0-9]+)*:[a-zA-Z0-9=_-]+$
23712371+ type: string
23722372+ lastUpdateTime:
23822373 description: |-
23832383- lastTransitionTime is the last time the condition transitioned from one status to another.
23842384- This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
23742374+ LastUpdateTime is the timestamp corresponding to the last update of the
23752375+ Artifact.
23852376 format: date-time
23862377 type: string
23872387- message:
23782378+ metadata:
23792379+ additionalProperties:
23802380+ type: string
23812381+ description: Metadata holds upstream information such as OCI annotations.
23822382+ type: object
23832383+ path:
23882384 description: |-
23892389- message is a human readable message indicating details about the transition.
23902390- This may be an empty string.
23912391- maxLength: 32768
23852385+ Path is the relative file path of the Artifact. It can be used to locate
23862386+ the file in the root of the Artifact storage on the local file system of
23872387+ the controller managing the Source.
23922388 type: string
23932393- observedGeneration:
23892389+ revision:
23942390 description: |-
23952395- observedGeneration represents the .metadata.generation that the condition was set based upon.
23962396- For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
23972397- with respect to the current state of the instance.
23912391+ Revision is a human-readable identifier traceable in the origin source
23922392+ system. It can be a Git commit SHA, Git tag, a Helm chart version, etc.
23932393+ type: string
23942394+ size:
23952395+ description: Size is the number of bytes in the file.
23982396 format: int64
23992399- minimum: 0
24002397 type: integer
24012401- reason:
23982398+ url:
23992399+ description: |-
24002400+ URL is the HTTP address of the Artifact as exposed by the controller
24012401+ managing the Source. It can be used to retrieve the Artifact for
24022402+ consumption, e.g. by another controller applying the Artifact contents.
24032403+ type: string
24042404+ required:
24052405+ - digest
24062406+ - lastUpdateTime
24072407+ - path
24082408+ - revision
24092409+ - url
24102410+ type: object
24112411+ conditions:
24122412+ description: Conditions holds the conditions for the OCIRepository.
24132413+ items:
24142414+ description:
24152415+ Condition contains details for one aspect of the current
24162416+ state of this API Resource.
24172417+ properties:
24182418+ lastTransitionTime:
24192419+ description: |-
24202420+ lastTransitionTime is the last time the condition transitioned from one status to another.
24212421+ This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
24222422+ format: date-time
24232423+ type: string
24242424+ message:
24252425+ description: |-
24262426+ message is a human readable message indicating details about the transition.
24272427+ This may be an empty string.
24282428+ maxLength: 32768
24292429+ type: string
24302430+ observedGeneration:
24312431+ description: |-
24322432+ observedGeneration represents the .metadata.generation that the condition was set based upon.
24332433+ For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
24342434+ with respect to the current state of the instance.
24352435+ format: int64
24362436+ minimum: 0
24372437+ type: integer
24382438+ reason:
24392439+ description: |-
24402440+ reason contains a programmatic identifier indicating the reason for the condition's last transition.
24412441+ Producers of specific condition types may define expected values and meanings for this field,
24422442+ and whether the values are considered a guaranteed API.
24432443+ The value should be a CamelCase string.
24442444+ This field may not be empty.
24452445+ maxLength: 1024
24462446+ minLength: 1
24472447+ pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
24482448+ type: string
24492449+ status:
24502450+ description: status of the condition, one of True, False, Unknown.
24512451+ enum:
24522452+ - "True"
24532453+ - "False"
24542454+ - Unknown
24552455+ type: string
24562456+ type:
24572457+ description: type of condition in CamelCase or in foo.example.com/CamelCase.
24582458+ maxLength: 316
24592459+ 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])$
24602460+ type: string
24612461+ required:
24622462+ - lastTransitionTime
24632463+ - message
24642464+ - reason
24652465+ - status
24662466+ - type
24672467+ type: object
24682468+ type: array
24692469+ lastHandledReconcileAt:
24702470+ description: |-
24712471+ LastHandledReconcileAt holds the value of the most recent
24722472+ reconcile request value, so a change of the annotation value
24732473+ can be detected.
24742474+ type: string
24752475+ observedGeneration:
24762476+ description: ObservedGeneration is the last observed generation.
24772477+ format: int64
24782478+ type: integer
24792479+ observedIgnore:
24802480+ description: |-
24812481+ ObservedIgnore is the observed exclusion patterns used for constructing
24822482+ the source artifact.
24832483+ type: string
24842484+ observedLayerSelector:
24852485+ description: |-
24862486+ ObservedLayerSelector is the observed layer selector used for constructing
24872487+ the source artifact.
24882488+ properties:
24892489+ mediaType:
24022490 description: |-
24032403- reason contains a programmatic identifier indicating the reason for the condition's last transition.
24042404- Producers of specific condition types may define expected values and meanings for this field,
24052405- and whether the values are considered a guaranteed API.
24062406- The value should be a CamelCase string.
24072407- This field may not be empty.
24082408- maxLength: 1024
24092409- minLength: 1
24102410- pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
24912491+ MediaType specifies the OCI media type of the layer
24922492+ which should be extracted from the OCI Artifact. The
24932493+ first layer matching this type is selected.
24112494 type: string
24122412- status:
24132413- description: status of the condition, one of True, False, Unknown.
24952495+ operation:
24962496+ description: |-
24972497+ Operation specifies how the selected layer should be processed.
24982498+ By default, the layer compressed content is extracted to storage.
24992499+ When the operation is set to 'copy', the layer compressed content
25002500+ is persisted to storage as it is.
24142501 enum:
24152415- - "True"
24162416- - "False"
24172417- - Unknown
25022502+ - extract
25032503+ - copy
24182504 type: string
24192419- type:
24202420- description: type of condition in CamelCase or in foo.example.com/CamelCase.
24212421- maxLength: 316
24222422- 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])$
24232423- type: string
24242424- required:
24252425- - lastTransitionTime
24262426- - message
24272427- - reason
24282428- - status
24292429- - type
24302505 type: object
24312431- type: array
24322432- lastHandledReconcileAt:
24332433- description: |-
24342434- LastHandledReconcileAt holds the value of the most recent
24352435- reconcile request value, so a change of the annotation value
24362436- can be detected.
24372437- type: string
24382438- observedGeneration:
24392439- description: ObservedGeneration is the last observed generation.
24402440- format: int64
24412441- type: integer
24422442- observedIgnore:
24432443- description: |-
24442444- ObservedIgnore is the observed exclusion patterns used for constructing
24452445- the source artifact.
24462446- type: string
24472447- observedLayerSelector:
24482448- description: |-
24492449- ObservedLayerSelector is the observed layer selector used for constructing
24502450- the source artifact.
24512451- properties:
24522452- mediaType:
24532453- description: |-
24542454- MediaType specifies the OCI media type of the layer
24552455- which should be extracted from the OCI Artifact. The
24562456- first layer matching this type is selected.
24572457- type: string
24582458- operation:
24592459- description: |-
24602460- Operation specifies how the selected layer should be processed.
24612461- By default, the layer compressed content is extracted to storage.
24622462- When the operation is set to 'copy', the layer compressed content
24632463- is persisted to storage as it is.
24642464- enum:
24652465- - extract
24662466- - copy
24672467- type: string
24682468- type: object
24692469- url:
24702470- description: URL is the download link for the artifact output of the
24712471- last OCI Repository sync.
24722472- type: string
24732473- type: object
24742474- type: object
24752475- served: true
24762476- storage: true
24772477- subresources:
24782478- status: {}
25062506+ url:
25072507+ description:
25082508+ URL is the download link for the artifact output of the
25092509+ last OCI Repository sync.
25102510+ type: string
25112511+ type: object
25122512+ type: object
25132513+ served: true
25142514+ storage: true
25152515+ subresources:
25162516+ status: {}
24792517---
24802518apiVersion: v1
24812519kind: ServiceAccount
···25012539 namespace: flux-system
25022540spec:
25032541 ports:
25042504- - name: http
25052505- port: 80
25062506- protocol: TCP
25072507- targetPort: http
25422542+ - name: http
25432543+ port: 80
25442544+ protocol: TCP
25452545+ targetPort: http
25082546 selector:
25092547 app: source-controller
25102548 type: ClusterIP
···25402578 app.kubernetes.io/version: v2.8.8
25412579 spec:
25422580 containers:
25432543- - args:
25442544- - --events-addr=http://notification-controller.$(RUNTIME_NAMESPACE).svc.cluster.local./
25452545- - --watch-all-namespaces=true
25462546- - --log-level=info
25472547- - --log-encoding=json
25482548- - --enable-leader-election
25492549- - --storage-path=/data
25502550- - --storage-adv-addr=source-controller.$(RUNTIME_NAMESPACE).svc.cluster.local.
25512551- env:
25522552- - name: RUNTIME_NAMESPACE
25532553- valueFrom:
25542554- fieldRef:
25552555- fieldPath: metadata.namespace
25562556- - name: TUF_ROOT
25572557- value: /tmp/.sigstore
25582558- - name: GOMEMLIMIT
25592559- valueFrom:
25602560- resourceFieldRef:
25612561- containerName: manager
25622562- resource: limits.memory
25632563- image: ghcr.io/fluxcd/source-controller:v1.8.5
25642564- imagePullPolicy: IfNotPresent
25652565- livenessProbe:
25662566- httpGet:
25672567- path: /healthz
25682568- port: healthz
25692569- name: manager
25702570- ports:
25712571- - containerPort: 9090
25722572- name: http
25732573- protocol: TCP
25742574- - containerPort: 8080
25752575- name: http-prom
25762576- protocol: TCP
25772577- - containerPort: 9440
25782578- name: healthz
25792579- protocol: TCP
25802580- readinessProbe:
25812581- httpGet:
25822582- path: /
25832583- port: http
25842584- resources:
25852585- limits:
25862586- cpu: 1000m
25872587- memory: 1Gi
25882588- requests:
25892589- cpu: 50m
25902590- memory: 64Mi
25912591- securityContext:
25922592- allowPrivilegeEscalation: false
25932593- capabilities:
25942594- drop:
25952595- - ALL
25962596- readOnlyRootFilesystem: true
25972597- runAsNonRoot: true
25982598- seccompProfile:
25992599- type: RuntimeDefault
26002600- volumeMounts:
26012601- - mountPath: /data
26022602- name: data
26032603- - mountPath: /tmp
26042604- name: tmp
25812581+ - args:
25822582+ - --events-addr=http://notification-controller.$(RUNTIME_NAMESPACE).svc.cluster.local./
25832583+ - --watch-all-namespaces=true
25842584+ - --log-level=info
25852585+ - --log-encoding=json
25862586+ - --enable-leader-election
25872587+ - --storage-path=/data
25882588+ - --storage-adv-addr=source-controller.$(RUNTIME_NAMESPACE).svc.cluster.local.
25892589+ env:
25902590+ - name: RUNTIME_NAMESPACE
25912591+ valueFrom:
25922592+ fieldRef:
25932593+ fieldPath: metadata.namespace
25942594+ - name: TUF_ROOT
25952595+ value: /tmp/.sigstore
25962596+ - name: GOMEMLIMIT
25972597+ valueFrom:
25982598+ resourceFieldRef:
25992599+ containerName: manager
26002600+ resource: limits.memory
26012601+ image: ghcr.io/fluxcd/source-controller:v1.8.5
26022602+ imagePullPolicy: IfNotPresent
26032603+ livenessProbe:
26042604+ httpGet:
26052605+ path: /healthz
26062606+ port: healthz
26072607+ name: manager
26082608+ ports:
26092609+ - containerPort: 9090
26102610+ name: http
26112611+ protocol: TCP
26122612+ - containerPort: 8080
26132613+ name: http-prom
26142614+ protocol: TCP
26152615+ - containerPort: 9440
26162616+ name: healthz
26172617+ protocol: TCP
26182618+ readinessProbe:
26192619+ httpGet:
26202620+ path: /
26212621+ port: http
26222622+ resources:
26232623+ limits:
26242624+ cpu: 1000m
26252625+ memory: 1Gi
26262626+ requests:
26272627+ cpu: 50m
26282628+ memory: 64Mi
26292629+ securityContext:
26302630+ allowPrivilegeEscalation: false
26312631+ capabilities:
26322632+ drop:
26332633+ - ALL
26342634+ readOnlyRootFilesystem: true
26352635+ runAsNonRoot: true
26362636+ seccompProfile:
26372637+ type: RuntimeDefault
26382638+ volumeMounts:
26392639+ - mountPath: /data
26402640+ name: data
26412641+ - mountPath: /tmp
26422642+ name: tmp
26052643 nodeSelector:
26062644 kubernetes.io/os: linux
26072645 priorityClassName: system-cluster-critical
···26102648 serviceAccountName: source-controller
26112649 terminationGracePeriodSeconds: 10
26122650 volumes:
26132613- - emptyDir: {}
26142614- name: data
26152615- - emptyDir: {}
26162616- name: tmp
26512651+ - emptyDir: {}
26522652+ name: data
26532653+ - emptyDir: {}
26542654+ name: tmp
26172655---
26182656apiVersion: apiextensions.k8s.io/v1
26192657kind: CustomResourceDefinition
···26332671 listKind: KustomizationList
26342672 plural: kustomizations
26352673 shortNames:
26362636- - ks
26742674+ - ks
26372675 singular: kustomization
26382676 scope: Namespaced
26392677 versions:
26402640- - additionalPrinterColumns:
26412641- - jsonPath: .metadata.creationTimestamp
26422642- name: Age
26432643- type: date
26442644- - jsonPath: .status.conditions[?(@.type=="Ready")].status
26452645- name: Ready
26462646- type: string
26472647- - jsonPath: .status.conditions[?(@.type=="Ready")].message
26482648- name: Status
26492649- type: string
26502650- name: v1
26512651- schema:
26522652- openAPIV3Schema:
26532653- description: Kustomization is the Schema for the kustomizations API.
26542654- properties:
26552655- apiVersion:
26562656- description: |-
26572657- APIVersion defines the versioned schema of this representation of an object.
26582658- Servers should convert recognized schemas to the latest internal value, and
26592659- may reject unrecognized values.
26602660- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
26612661- type: string
26622662- kind:
26632663- description: |-
26642664- Kind is a string value representing the REST resource this object represents.
26652665- Servers may infer this from the endpoint the client submits requests to.
26662666- Cannot be updated.
26672667- In CamelCase.
26682668- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
26692669- type: string
26702670- metadata:
26712671- type: object
26722672- spec:
26732673- description: |-
26742674- KustomizationSpec defines the configuration to calculate the desired state
26752675- from a Source using Kustomize.
26762676- properties:
26772677- commonMetadata:
26782678- description: |-
26792679- CommonMetadata specifies the common labels and annotations that are
26802680- applied to all resources. Any existing label or annotation will be
26812681- overridden if its key matches a common one.
26822682- properties:
26832683- annotations:
26842684- additionalProperties:
26782678+ - additionalPrinterColumns:
26792679+ - jsonPath: .metadata.creationTimestamp
26802680+ name: Age
26812681+ type: date
26822682+ - jsonPath: .status.conditions[?(@.type=="Ready")].status
26832683+ name: Ready
26842684+ type: string
26852685+ - jsonPath: .status.conditions[?(@.type=="Ready")].message
26862686+ name: Status
26872687+ type: string
26882688+ name: v1
26892689+ schema:
26902690+ openAPIV3Schema:
26912691+ description: Kustomization is the Schema for the kustomizations API.
26922692+ properties:
26932693+ apiVersion:
26942694+ description: |-
26952695+ APIVersion defines the versioned schema of this representation of an object.
26962696+ Servers should convert recognized schemas to the latest internal value, and
26972697+ may reject unrecognized values.
26982698+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
26992699+ type: string
27002700+ kind:
27012701+ description: |-
27022702+ Kind is a string value representing the REST resource this object represents.
27032703+ Servers may infer this from the endpoint the client submits requests to.
27042704+ Cannot be updated.
27052705+ In CamelCase.
27062706+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
27072707+ type: string
27082708+ metadata:
27092709+ type: object
27102710+ spec:
27112711+ description: |-
27122712+ KustomizationSpec defines the configuration to calculate the desired state
27132713+ from a Source using Kustomize.
27142714+ properties:
27152715+ commonMetadata:
27162716+ description: |-
27172717+ CommonMetadata specifies the common labels and annotations that are
27182718+ applied to all resources. Any existing label or annotation will be
27192719+ overridden if its key matches a common one.
27202720+ properties:
27212721+ annotations:
27222722+ additionalProperties:
27232723+ type: string
27242724+ description: Annotations to be added to the object's metadata.
27252725+ type: object
27262726+ labels:
27272727+ additionalProperties:
27282728+ type: string
27292729+ description: Labels to be added to the object's metadata.
27302730+ type: object
27312731+ type: object
27322732+ components:
27332733+ description: Components specifies relative paths to kustomize Components.
27342734+ items:
27352735+ type: string
27362736+ type: array
27372737+ decryption:
27382738+ description:
27392739+ Decrypt Kubernetes secrets before applying them on the
27402740+ cluster.
27412741+ properties:
27422742+ provider:
27432743+ description: Provider is the name of the decryption engine.
27442744+ enum:
27452745+ - sops
26852746 type: string
26862686- description: Annotations to be added to the object's metadata.
26872687- type: object
26882688- labels:
26892689- additionalProperties:
27472747+ secretRef:
27482748+ description: |-
27492749+ The secret name containing the private OpenPGP keys used for decryption.
27502750+ A static credential for a cloud provider defined inside the Secret
27512751+ takes priority to secret-less authentication with the ServiceAccountName
27522752+ field.
27532753+ properties:
27542754+ name:
27552755+ description: Name of the referent.
27562756+ type: string
27572757+ required:
27582758+ - name
27592759+ type: object
27602760+ serviceAccountName:
27612761+ description: |-
27622762+ ServiceAccountName is the name of the service account used to
27632763+ authenticate with KMS services from cloud providers. If a
27642764+ static credential for a given cloud provider is defined
27652765+ inside the Secret referenced by SecretRef, that static
27662766+ credential takes priority.
26902767 type: string
26912691- description: Labels to be added to the object's metadata.
26922692- type: object
26932693- type: object
26942694- components:
26952695- description: Components specifies relative paths to kustomize Components.
26962696- items:
27682768+ required:
27692769+ - provider
27702770+ type: object
27712771+ deletionPolicy:
27722772+ description: |-
27732773+ DeletionPolicy can be used to control garbage collection when this
27742774+ Kustomization is deleted. Valid values are ('MirrorPrune', 'Delete',
27752775+ 'WaitForTermination', 'Orphan'). 'MirrorPrune' mirrors the Prune field
27762776+ (orphan if false, delete if true). Defaults to 'MirrorPrune'.
27772777+ enum:
27782778+ - MirrorPrune
27792779+ - Delete
27802780+ - WaitForTermination
27812781+ - Orphan
26972782 type: string
26982698- type: array
26992699- decryption:
27002700- description: Decrypt Kubernetes secrets before applying them on the
27012701- cluster.
27022702- properties:
27032703- provider:
27042704- description: Provider is the name of the decryption engine.
27052705- enum:
27062706- - sops
27072707- type: string
27082708- secretRef:
27092709- description: |-
27102710- The secret name containing the private OpenPGP keys used for decryption.
27112711- A static credential for a cloud provider defined inside the Secret
27122712- takes priority to secret-less authentication with the ServiceAccountName
27132713- field.
27832783+ dependsOn:
27842784+ description: |-
27852785+ DependsOn may contain a DependencyReference slice
27862786+ with references to Kustomization resources that must be ready before this
27872787+ Kustomization can be reconciled.
27882788+ items:
27892789+ description:
27902790+ DependencyReference defines a Kustomization dependency
27912791+ on another Kustomization resource.
27142792 properties:
27152793 name:
27162794 description: Name of the referent.
27172795 type: string
27962796+ namespace:
27972797+ description: |-
27982798+ Namespace of the referent, defaults to the namespace of the Kustomization
27992799+ resource object that contains the reference.
28002800+ type: string
28012801+ readyExpr:
28022802+ description: |-
28032803+ ReadyExpr is a CEL expression that can be used to assess the readiness
28042804+ of a dependency. When specified, the built-in readiness check
28052805+ is replaced by the logic defined in the CEL expression.
28062806+ To make the CEL expression additive to the built-in readiness check,
28072807+ the feature gate `AdditiveCELDependencyCheck` must be set to `true`.
28082808+ type: string
27182809 required:
27192719- - name
28102810+ - name
27202811 type: object
27212721- serviceAccountName:
27222722- description: |-
27232723- ServiceAccountName is the name of the service account used to
27242724- authenticate with KMS services from cloud providers. If a
27252725- static credential for a given cloud provider is defined
27262726- inside the Secret referenced by SecretRef, that static
27272727- credential takes priority.
27282728- type: string
27292729- required:
27302730- - provider
27312731- type: object
27322732- deletionPolicy:
27332733- description: |-
27342734- DeletionPolicy can be used to control garbage collection when this
27352735- Kustomization is deleted. Valid values are ('MirrorPrune', 'Delete',
27362736- 'WaitForTermination', 'Orphan'). 'MirrorPrune' mirrors the Prune field
27372737- (orphan if false, delete if true). Defaults to 'MirrorPrune'.
27382738- enum:
27392739- - MirrorPrune
27402740- - Delete
27412741- - WaitForTermination
27422742- - Orphan
27432743- type: string
27442744- dependsOn:
27452745- description: |-
27462746- DependsOn may contain a DependencyReference slice
27472747- with references to Kustomization resources that must be ready before this
27482748- Kustomization can be reconciled.
27492749- items:
27502750- description: DependencyReference defines a Kustomization dependency
27512751- on another Kustomization resource.
27522752- properties:
27532753- name:
27542754- description: Name of the referent.
27552755- type: string
27562756- namespace:
27572757- description: |-
27582758- Namespace of the referent, defaults to the namespace of the Kustomization
27592759- resource object that contains the reference.
27602760- type: string
27612761- readyExpr:
27622762- description: |-
27632763- ReadyExpr is a CEL expression that can be used to assess the readiness
27642764- of a dependency. When specified, the built-in readiness check
27652765- is replaced by the logic defined in the CEL expression.
27662766- To make the CEL expression additive to the built-in readiness check,
27672767- the feature gate `AdditiveCELDependencyCheck` must be set to `true`.
27682768- type: string
27692769- required:
27702770- - name
27712771- type: object
27722772- type: array
27732773- force:
27742774- default: false
27752775- description: |-
27762776- Force instructs the controller to recreate resources
27772777- when patching fails due to an immutable field change.
27782778- type: boolean
27792779- healthCheckExprs:
27802780- description: |-
27812781- HealthCheckExprs is a list of healthcheck expressions for evaluating the
27822782- health of custom resources using Common Expression Language (CEL).
27832783- The expressions are evaluated only when Wait or HealthChecks are specified.
27842784- items:
27852785- description: CustomHealthCheck defines the health check for custom
27862786- resources.
27872787- properties:
27882788- apiVersion:
27892789- description: APIVersion of the custom resource under evaluation.
27902790- type: string
27912791- current:
27922792- description: |-
27932793- Current is the CEL expression that determines if the status
27942794- of the custom resource has reached the desired state.
27952795- type: string
27962796- failed:
27972797- description: |-
27982798- Failed is the CEL expression that determines if the status
27992799- of the custom resource has failed to reach the desired state.
28002800- type: string
28012801- inProgress:
28022802- description: |-
28032803- InProgress is the CEL expression that determines if the status
28042804- of the custom resource has not yet reached the desired state.
28052805- type: string
28062806- kind:
28072807- description: Kind of the custom resource under evaluation.
28082808- type: string
28092809- required:
28102810- - apiVersion
28112811- - current
28122812- - kind
28132813- type: object
28142814- type: array
28152815- healthChecks:
28162816- description: A list of resources to be included in the health assessment.
28172817- items:
28122812+ type: array
28132813+ force:
28142814+ default: false
28152815+ description: |-
28162816+ Force instructs the controller to recreate resources
28172817+ when patching fails due to an immutable field change.
28182818+ type: boolean
28192819+ healthCheckExprs:
28182820 description: |-
28192819- NamespacedObjectKindReference contains enough information to locate the typed referenced Kubernetes resource object
28202820- in any namespace.
28212821- properties:
28222822- apiVersion:
28232823- description: API version of the referent, if not specified the
28242824- Kubernetes preferred version will be used.
28252825- type: string
28262826- kind:
28272827- description: Kind of the referent.
28282828- type: string
28292829- name:
28302830- description: Name of the referent.
28312831- type: string
28322832- namespace:
28332833- description: Namespace of the referent, when not specified it
28342834- acts as LocalObjectReference.
28352835- type: string
28362836- required:
28372837- - kind
28382838- - name
28392839- type: object
28402840- type: array
28412841- ignoreMissingComponents:
28422842- description: |-
28432843- IgnoreMissingComponents instructs the controller to ignore Components paths
28442844- not found in source by removing them from the generated kustomization.yaml
28452845- before running kustomize build.
28462846- type: boolean
28472847- images:
28482848- description: |-
28492849- Images is a list of (image name, new name, new tag or digest)
28502850- for changing image names, tags or digests. This can also be achieved with a
28512851- patch, but this operator is simpler to specify.
28522852- items:
28532853- description: Image contains an image name, a new name, a new tag
28542854- or digest, which will replace the original name and tag.
28552855- properties:
28562856- digest:
28572857- description: |-
28582858- Digest is the value used to replace the original image tag.
28592859- If digest is present NewTag value is ignored.
28602860- type: string
28612861- name:
28622862- description: Name is a tag-less image name.
28632863- type: string
28642864- newName:
28652865- description: NewName is the value used to replace the original
28662866- name.
28672867- type: string
28682868- newTag:
28692869- description: NewTag is the value used to replace the original
28702870- tag.
28712871- type: string
28722872- required:
28732873- - name
28742874- type: object
28752875- type: array
28762876- interval:
28772877- description: |-
28782878- The interval at which to reconcile the Kustomization.
28792879- This interval is approximate and may be subject to jitter to ensure
28802880- efficient use of resources.
28812881- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
28822882- type: string
28832883- kubeConfig:
28842884- description: |-
28852885- The KubeConfig for reconciling the Kustomization on a remote cluster.
28862886- When used in combination with KustomizationSpec.ServiceAccountName,
28872887- forces the controller to act on behalf of that Service Account at the
28882888- target cluster.
28892889- If the --default-service-account flag is set, its value will be used as
28902890- a controller level fallback for when KustomizationSpec.ServiceAccountName
28912891- is empty.
28922892- properties:
28932893- configMapRef:
28212821+ HealthCheckExprs is a list of healthcheck expressions for evaluating the
28222822+ health of custom resources using Common Expression Language (CEL).
28232823+ The expressions are evaluated only when Wait or HealthChecks are specified.
28242824+ items:
28252825+ description:
28262826+ CustomHealthCheck defines the health check for custom
28272827+ resources.
28282828+ properties:
28292829+ apiVersion:
28302830+ description: APIVersion of the custom resource under evaluation.
28312831+ type: string
28322832+ current:
28332833+ description: |-
28342834+ Current is the CEL expression that determines if the status
28352835+ of the custom resource has reached the desired state.
28362836+ type: string
28372837+ failed:
28382838+ description: |-
28392839+ Failed is the CEL expression that determines if the status
28402840+ of the custom resource has failed to reach the desired state.
28412841+ type: string
28422842+ inProgress:
28432843+ description: |-
28442844+ InProgress is the CEL expression that determines if the status
28452845+ of the custom resource has not yet reached the desired state.
28462846+ type: string
28472847+ kind:
28482848+ description: Kind of the custom resource under evaluation.
28492849+ type: string
28502850+ required:
28512851+ - apiVersion
28522852+ - current
28532853+ - kind
28542854+ type: object
28552855+ type: array
28562856+ healthChecks:
28572857+ description: A list of resources to be included in the health assessment.
28582858+ items:
28942859 description: |-
28952895- ConfigMapRef holds an optional name of a ConfigMap that contains
28962896- the following keys:
28972897-28982898- - `provider`: the provider to use. One of `aws`, `azure`, `gcp`, or
28992899- `generic`. Required.
29002900- - `cluster`: the fully qualified resource name of the Kubernetes
29012901- cluster in the cloud provider API. Not used by the `generic`
29022902- provider. Required when one of `address` or `ca.crt` is not set.
29032903- - `address`: the address of the Kubernetes API server. Required
29042904- for `generic`. For the other providers, if not specified, the
29052905- first address in the cluster resource will be used, and if
29062906- specified, it must match one of the addresses in the cluster
29072907- resource.
29082908- If audiences is not set, will be used as the audience for the
29092909- `generic` provider.
29102910- - `ca.crt`: the optional PEM-encoded CA certificate for the
29112911- Kubernetes API server. If not set, the controller will use the
29122912- CA certificate from the cluster resource.
29132913- - `audiences`: the optional audiences as a list of
29142914- line-break-separated strings for the Kubernetes ServiceAccount
29152915- token. Defaults to the `address` for the `generic` provider, or
29162916- to specific values for the other providers depending on the
29172917- provider.
29182918- - `serviceAccountName`: the optional name of the Kubernetes
29192919- ServiceAccount in the same namespace that should be used
29202920- for authentication. If not specified, the controller
29212921- ServiceAccount will be used.
29222922-29232923- Mutually exclusive with SecretRef.
28602860+ NamespacedObjectKindReference contains enough information to locate the typed referenced Kubernetes resource object
28612861+ in any namespace.
29242862 properties:
28632863+ apiVersion:
28642864+ description:
28652865+ API version of the referent, if not specified the
28662866+ Kubernetes preferred version will be used.
28672867+ type: string
28682868+ kind:
28692869+ description: Kind of the referent.
28702870+ type: string
29252871 name:
29262872 description: Name of the referent.
29272873 type: string
28742874+ namespace:
28752875+ description:
28762876+ Namespace of the referent, when not specified it
28772877+ acts as LocalObjectReference.
28782878+ type: string
29282879 required:
29292929- - name
28802880+ - kind
28812881+ - name
29302882 type: object
29312931- secretRef:
29322932- description: |-
29332933- SecretRef holds an optional name of a secret that contains a key with
29342934- the kubeconfig file as the value. If no key is set, the key will default
29352935- to 'value'. Mutually exclusive with ConfigMapRef.
29362936- It is recommended that the kubeconfig is self-contained, and the secret
29372937- is regularly updated if credentials such as a cloud-access-token expire.
29382938- Cloud specific `cmd-path` auth helpers will not function without adding
29392939- binaries and credentials to the Pod that is responsible for reconciling
29402940- Kubernetes resources. Supported only for the generic provider.
28832883+ type: array
28842884+ ignoreMissingComponents:
28852885+ description: |-
28862886+ IgnoreMissingComponents instructs the controller to ignore Components paths
28872887+ not found in source by removing them from the generated kustomization.yaml
28882888+ before running kustomize build.
28892889+ type: boolean
28902890+ images:
28912891+ description: |-
28922892+ Images is a list of (image name, new name, new tag or digest)
28932893+ for changing image names, tags or digests. This can also be achieved with a
28942894+ patch, but this operator is simpler to specify.
28952895+ items:
28962896+ description:
28972897+ Image contains an image name, a new name, a new tag
28982898+ or digest, which will replace the original name and tag.
29412899 properties:
29422942- key:
29432943- description: Key in the Secret, when not specified an implementation-specific
29442944- default key is used.
29002900+ digest:
29012901+ description: |-
29022902+ Digest is the value used to replace the original image tag.
29032903+ If digest is present NewTag value is ignored.
29452904 type: string
29462905 name:
29472947- description: Name of the Secret.
29062906+ description: Name is a tag-less image name.
29072907+ type: string
29082908+ newName:
29092909+ description:
29102910+ NewName is the value used to replace the original
29112911+ name.
29122912+ type: string
29132913+ newTag:
29142914+ description:
29152915+ NewTag is the value used to replace the original
29162916+ tag.
29482917 type: string
29492918 required:
29502950- - name
29192919+ - name
29512920 type: object
29522952- type: object
29532953- x-kubernetes-validations:
29542954- - message: exactly one of spec.kubeConfig.configMapRef or spec.kubeConfig.secretRef
29552955- must be specified
29562956- rule: has(self.configMapRef) || has(self.secretRef)
29572957- - message: exactly one of spec.kubeConfig.configMapRef or spec.kubeConfig.secretRef
29582958- must be specified
29592959- rule: '!has(self.configMapRef) || !has(self.secretRef)'
29602960- namePrefix:
29612961- description: NamePrefix will prefix the names of all managed resources.
29622962- maxLength: 200
29632963- minLength: 1
29642964- type: string
29652965- nameSuffix:
29662966- description: NameSuffix will suffix the names of all managed resources.
29672967- maxLength: 200
29682968- minLength: 1
29692969- type: string
29702970- patches:
29712971- description: |-
29722972- Strategic merge and JSON patches, defined as inline YAML objects,
29732973- capable of targeting objects based on kind, label and annotation selectors.
29742974- items:
29212921+ type: array
29222922+ interval:
29232923+ description: |-
29242924+ The interval at which to reconcile the Kustomization.
29252925+ This interval is approximate and may be subject to jitter to ensure
29262926+ efficient use of resources.
29272927+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
29282928+ type: string
29292929+ kubeConfig:
29752930 description: |-
29762976- Patch contains an inline StrategicMerge or JSON6902 patch, and the target the patch should
29772977- be applied to.
29312931+ The KubeConfig for reconciling the Kustomization on a remote cluster.
29322932+ When used in combination with KustomizationSpec.ServiceAccountName,
29332933+ forces the controller to act on behalf of that Service Account at the
29342934+ target cluster.
29352935+ If the --default-service-account flag is set, its value will be used as
29362936+ a controller level fallback for when KustomizationSpec.ServiceAccountName
29372937+ is empty.
29782938 properties:
29792979- patch:
29392939+ configMapRef:
29802940 description: |-
29812981- Patch contains an inline StrategicMerge patch or an inline JSON6902 patch with
29822982- an array of operation objects.
29832983- type: string
29842984- target:
29852985- description: Target points to the resources that the patch document
29862986- should be applied to.
29412941+ ConfigMapRef holds an optional name of a ConfigMap that contains
29422942+ the following keys:
29432943+29442944+ - `provider`: the provider to use. One of `aws`, `azure`, `gcp`, or
29452945+ `generic`. Required.
29462946+ - `cluster`: the fully qualified resource name of the Kubernetes
29472947+ cluster in the cloud provider API. Not used by the `generic`
29482948+ provider. Required when one of `address` or `ca.crt` is not set.
29492949+ - `address`: the address of the Kubernetes API server. Required
29502950+ for `generic`. For the other providers, if not specified, the
29512951+ first address in the cluster resource will be used, and if
29522952+ specified, it must match one of the addresses in the cluster
29532953+ resource.
29542954+ If audiences is not set, will be used as the audience for the
29552955+ `generic` provider.
29562956+ - `ca.crt`: the optional PEM-encoded CA certificate for the
29572957+ Kubernetes API server. If not set, the controller will use the
29582958+ CA certificate from the cluster resource.
29592959+ - `audiences`: the optional audiences as a list of
29602960+ line-break-separated strings for the Kubernetes ServiceAccount
29612961+ token. Defaults to the `address` for the `generic` provider, or
29622962+ to specific values for the other providers depending on the
29632963+ provider.
29642964+ - `serviceAccountName`: the optional name of the Kubernetes
29652965+ ServiceAccount in the same namespace that should be used
29662966+ for authentication. If not specified, the controller
29672967+ ServiceAccount will be used.
29682968+29692969+ Mutually exclusive with SecretRef.
29872970 properties:
29882988- annotationSelector:
29892989- description: |-
29902990- AnnotationSelector is a string that follows the label selection expression
29912991- https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
29922992- It matches with the resource annotations.
29932993- type: string
29942994- group:
29952995- description: |-
29962996- Group is the API group to select resources from.
29972997- Together with Version and Kind it is capable of unambiguously identifying and/or selecting resources.
29982998- https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
29992999- type: string
30003000- kind:
30013001- description: |-
30023002- Kind of the API Group to select resources from.
30033003- Together with Group and Version it is capable of unambiguously
30043004- identifying and/or selecting resources.
30053005- https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
30063006- type: string
30073007- labelSelector:
30083008- description: |-
30093009- LabelSelector is a string that follows the label selection expression
30103010- https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
30113011- It matches with the resource labels.
30123012- type: string
30132971 name:
30143014- description: Name to match resources with.
29722972+ description: Name of the referent.
30152973 type: string
30163016- namespace:
30173017- description: Namespace to select resources from.
30183018- type: string
30193019- version:
30203020- description: |-
30213021- Version of the API Group to select resources from.
30223022- Together with Group and Kind it is capable of unambiguously identifying and/or selecting resources.
30233023- https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
30243024- type: string
29742974+ required:
29752975+ - name
30252976 type: object
30263026- required:
30273027- - patch
30283028- type: object
30293029- type: array
30303030- path:
30313031- description: |-
30323032- Path to the directory containing the kustomization.yaml file, or the
30333033- set of plain YAMLs a kustomization.yaml should be generated for.
30343034- Defaults to 'None', which translates to the root path of the SourceRef.
30353035- type: string
30363036- postBuild:
30373037- description: |-
30383038- PostBuild describes which actions to perform on the YAML manifest
30393039- generated by building the kustomize overlay.
30403040- properties:
30413041- substitute:
30423042- additionalProperties:
30433043- type: string
30443044- description: |-
30453045- Substitute holds a map of key/value pairs.
30463046- The variables defined in your YAML manifests that match any of the keys
30473047- defined in the map will be substituted with the set value.
30483048- Includes support for bash string replacement functions
30493049- e.g. ${var:=default}, ${var:position} and ${var/substring/replacement}.
30503050- type: object
30513051- substituteFrom:
30523052- description: |-
30533053- SubstituteFrom holds references to ConfigMaps and Secrets containing
30543054- the variables and their values to be substituted in the YAML manifests.
30553055- The ConfigMap and the Secret data keys represent the var names, and they
30563056- must match the vars declared in the manifests for the substitution to
30573057- happen.
30583058- items:
29772977+ secretRef:
30592978 description: |-
30603060- SubstituteReference contains a reference to a resource containing
30613061- the variables name and value.
29792979+ SecretRef holds an optional name of a secret that contains a key with
29802980+ the kubeconfig file as the value. If no key is set, the key will default
29812981+ to 'value'. Mutually exclusive with ConfigMapRef.
29822982+ It is recommended that the kubeconfig is self-contained, and the secret
29832983+ is regularly updated if credentials such as a cloud-access-token expire.
29842984+ Cloud specific `cmd-path` auth helpers will not function without adding
29852985+ binaries and credentials to the Pod that is responsible for reconciling
29862986+ Kubernetes resources. Supported only for the generic provider.
30622987 properties:
30633063- kind:
30643064- description: Kind of the values referent, valid values are
30653065- ('Secret', 'ConfigMap').
30663066- enum:
30673067- - Secret
30683068- - ConfigMap
29882988+ key:
29892989+ description:
29902990+ Key in the Secret, when not specified an implementation-specific
29912991+ default key is used.
30692992 type: string
30702993 name:
30713071- description: |-
30723072- Name of the values referent. Should reside in the same namespace as the
30733073- referring resource.
30743074- maxLength: 253
30753075- minLength: 1
29942994+ description: Name of the Secret.
30762995 type: string
30773077- optional:
30783078- default: false
30793079- description: |-
30803080- Optional indicates whether the referenced resource must exist, or whether to
30813081- tolerate its absence. If true and the referenced resource is absent, proceed
30823082- as if the resource was present but empty, without any variables defined.
30833083- type: boolean
30842996 required:
30853085- - kind
30863086- - name
29972997+ - name
30872998 type: object
30883088- type: array
30893089- type: object
30903090- prune:
30913091- description: Prune enables garbage collection.
30923092- type: boolean
30933093- retryInterval:
30943094- description: |-
30953095- The interval at which to retry a previously failed reconciliation.
30963096- When not specified, the controller uses the KustomizationSpec.Interval
30973097- value to retry failures.
30983098- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
30993099- type: string
31003100- serviceAccountName:
31013101- description: |-
31023102- The name of the Kubernetes service account to impersonate
31033103- when reconciling this Kustomization.
31043104- type: string
31053105- sourceRef:
31063106- description: Reference of the source where the kustomization file
31073107- is.
31083108- properties:
31093109- apiVersion:
31103110- description: API version of the referent.
31113111- type: string
31123112- kind:
31133113- description: Kind of the referent.
31143114- enum:
31153115- - OCIRepository
31163116- - GitRepository
31173117- - Bucket
31183118- - ExternalArtifact
31193119- type: string
31203120- name:
31213121- description: Name of the referent.
31223122- type: string
31233123- namespace:
29992999+ type: object
30003000+ x-kubernetes-validations:
30013001+ - message:
30023002+ exactly one of spec.kubeConfig.configMapRef or spec.kubeConfig.secretRef
30033003+ must be specified
30043004+ rule: has(self.configMapRef) || has(self.secretRef)
30053005+ - message:
30063006+ exactly one of spec.kubeConfig.configMapRef or spec.kubeConfig.secretRef
30073007+ must be specified
30083008+ rule: "!has(self.configMapRef) || !has(self.secretRef)"
30093009+ namePrefix:
30103010+ description: NamePrefix will prefix the names of all managed resources.
30113011+ maxLength: 200
30123012+ minLength: 1
30133013+ type: string
30143014+ nameSuffix:
30153015+ description: NameSuffix will suffix the names of all managed resources.
30163016+ maxLength: 200
30173017+ minLength: 1
30183018+ type: string
30193019+ patches:
30203020+ description: |-
30213021+ Strategic merge and JSON patches, defined as inline YAML objects,
30223022+ capable of targeting objects based on kind, label and annotation selectors.
30233023+ items:
31243024 description: |-
31253125- Namespace of the referent, defaults to the namespace of the Kubernetes
31263126- resource object that contains the reference.
31273127- type: string
31283128- required:
31293129- - kind
31303130- - name
31313131- type: object
31323132- suspend:
31333133- description: |-
31343134- This flag tells the controller to suspend subsequent kustomize executions,
31353135- it does not apply to already started executions. Defaults to false.
31363136- type: boolean
31373137- targetNamespace:
31383138- description: |-
31393139- TargetNamespace sets or overrides the namespace in the
31403140- kustomization.yaml file.
31413141- maxLength: 63
31423142- minLength: 1
31433143- type: string
31443144- timeout:
31453145- description: |-
31463146- Timeout for validation, apply and health checking operations.
31473147- Defaults to 'Interval' duration.
31483148- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
31493149- type: string
31503150- wait:
31513151- description: |-
31523152- Wait instructs the controller to check the health of all the reconciled
31533153- resources. When enabled, the HealthChecks are ignored. Defaults to false.
31543154- type: boolean
31553155- required:
31563156- - interval
31573157- - prune
31583158- - sourceRef
31593159- type: object
31603160- status:
31613161- default:
31623162- observedGeneration: -1
31633163- description: KustomizationStatus defines the observed state of a kustomization.
31643164- properties:
31653165- conditions:
31663166- items:
31673167- description: Condition contains details for one aspect of the current
31683168- state of this API Resource.
30253025+ Patch contains an inline StrategicMerge or JSON6902 patch, and the target the patch should
30263026+ be applied to.
30273027+ properties:
30283028+ patch:
30293029+ description: |-
30303030+ Patch contains an inline StrategicMerge patch or an inline JSON6902 patch with
30313031+ an array of operation objects.
30323032+ type: string
30333033+ target:
30343034+ description:
30353035+ Target points to the resources that the patch document
30363036+ should be applied to.
30373037+ properties:
30383038+ annotationSelector:
30393039+ description: |-
30403040+ AnnotationSelector is a string that follows the label selection expression
30413041+ https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
30423042+ It matches with the resource annotations.
30433043+ type: string
30443044+ group:
30453045+ description: |-
30463046+ Group is the API group to select resources from.
30473047+ Together with Version and Kind it is capable of unambiguously identifying and/or selecting resources.
30483048+ https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
30493049+ type: string
30503050+ kind:
30513051+ description: |-
30523052+ Kind of the API Group to select resources from.
30533053+ Together with Group and Version it is capable of unambiguously
30543054+ identifying and/or selecting resources.
30553055+ https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
30563056+ type: string
30573057+ labelSelector:
30583058+ description: |-
30593059+ LabelSelector is a string that follows the label selection expression
30603060+ https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
30613061+ It matches with the resource labels.
30623062+ type: string
30633063+ name:
30643064+ description: Name to match resources with.
30653065+ type: string
30663066+ namespace:
30673067+ description: Namespace to select resources from.
30683068+ type: string
30693069+ version:
30703070+ description: |-
30713071+ Version of the API Group to select resources from.
30723072+ Together with Group and Kind it is capable of unambiguously identifying and/or selecting resources.
30733073+ https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
30743074+ type: string
30753075+ type: object
30763076+ required:
30773077+ - patch
30783078+ type: object
30793079+ type: array
30803080+ path:
30813081+ description: |-
30823082+ Path to the directory containing the kustomization.yaml file, or the
30833083+ set of plain YAMLs a kustomization.yaml should be generated for.
30843084+ Defaults to 'None', which translates to the root path of the SourceRef.
30853085+ type: string
30863086+ postBuild:
30873087+ description: |-
30883088+ PostBuild describes which actions to perform on the YAML manifest
30893089+ generated by building the kustomize overlay.
31693090 properties:
31703170- lastTransitionTime:
30913091+ substitute:
30923092+ additionalProperties:
30933093+ type: string
31713094 description: |-
31723172- lastTransitionTime is the last time the condition transitioned from one status to another.
31733173- This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
31743174- format: date-time
31753175- type: string
31763176- message:
31773177- description: |-
31783178- message is a human readable message indicating details about the transition.
31793179- This may be an empty string.
31803180- maxLength: 32768
31813181- type: string
31823182- observedGeneration:
31833183- description: |-
31843184- observedGeneration represents the .metadata.generation that the condition was set based upon.
31853185- For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
31863186- with respect to the current state of the instance.
31873187- format: int64
31883188- minimum: 0
31893189- type: integer
31903190- reason:
30953095+ Substitute holds a map of key/value pairs.
30963096+ The variables defined in your YAML manifests that match any of the keys
30973097+ defined in the map will be substituted with the set value.
30983098+ Includes support for bash string replacement functions
30993099+ e.g. ${var:=default}, ${var:position} and ${var/substring/replacement}.
31003100+ type: object
31013101+ substituteFrom:
31913102 description: |-
31923192- reason contains a programmatic identifier indicating the reason for the condition's last transition.
31933193- Producers of specific condition types may define expected values and meanings for this field,
31943194- and whether the values are considered a guaranteed API.
31953195- The value should be a CamelCase string.
31963196- This field may not be empty.
31973197- maxLength: 1024
31983198- minLength: 1
31993199- pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
32003200- type: string
32013201- status:
32023202- description: status of the condition, one of True, False, Unknown.
32033203- enum:
32043204- - "True"
32053205- - "False"
32063206- - Unknown
32073207- type: string
32083208- type:
32093209- description: type of condition in CamelCase or in foo.example.com/CamelCase.
32103210- maxLength: 316
32113211- 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])$
32123212- type: string
32133213- required:
32143214- - lastTransitionTime
32153215- - message
32163216- - reason
32173217- - status
32183218- - type
31033103+ SubstituteFrom holds references to ConfigMaps and Secrets containing
31043104+ the variables and their values to be substituted in the YAML manifests.
31053105+ The ConfigMap and the Secret data keys represent the var names, and they
31063106+ must match the vars declared in the manifests for the substitution to
31073107+ happen.
31083108+ items:
31093109+ description: |-
31103110+ SubstituteReference contains a reference to a resource containing
31113111+ the variables name and value.
31123112+ properties:
31133113+ kind:
31143114+ description:
31153115+ Kind of the values referent, valid values are
31163116+ ('Secret', 'ConfigMap').
31173117+ enum:
31183118+ - Secret
31193119+ - ConfigMap
31203120+ type: string
31213121+ name:
31223122+ description: |-
31233123+ Name of the values referent. Should reside in the same namespace as the
31243124+ referring resource.
31253125+ maxLength: 253
31263126+ minLength: 1
31273127+ type: string
31283128+ optional:
31293129+ default: false
31303130+ description: |-
31313131+ Optional indicates whether the referenced resource must exist, or whether to
31323132+ tolerate its absence. If true and the referenced resource is absent, proceed
31333133+ as if the resource was present but empty, without any variables defined.
31343134+ type: boolean
31353135+ required:
31363136+ - kind
31373137+ - name
31383138+ type: object
31393139+ type: array
32193140 type: object
32203220- type: array
32213221- history:
32223222- description: |-
32233223- History contains a set of snapshots of the last reconciliation attempts
32243224- tracking the revision, the state and the duration of each attempt.
32253225- items:
31413141+ prune:
31423142+ description: Prune enables garbage collection.
31433143+ type: boolean
31443144+ retryInterval:
31453145+ description: |-
31463146+ The interval at which to retry a previously failed reconciliation.
31473147+ When not specified, the controller uses the KustomizationSpec.Interval
31483148+ value to retry failures.
31493149+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
31503150+ type: string
31513151+ serviceAccountName:
32263152 description: |-
32273227- Snapshot represents a point-in-time record of a group of resources reconciliation,
32283228- including timing information, status, and a unique digest identifier.
31533153+ The name of the Kubernetes service account to impersonate
31543154+ when reconciling this Kustomization.
31553155+ type: string
31563156+ sourceRef:
31573157+ description:
31583158+ Reference of the source where the kustomization file
31593159+ is.
32293160 properties:
32303230- digest:
32313231- description: Digest is the checksum in the format `<algo>:<hex>`
32323232- of the resources in this snapshot.
31613161+ apiVersion:
31623162+ description: API version of the referent.
32333163 type: string
32343234- firstReconciled:
32353235- description: FirstReconciled is the time when this revision
32363236- was first reconciled to the cluster.
32373237- format: date-time
31643164+ kind:
31653165+ description: Kind of the referent.
31663166+ enum:
31673167+ - OCIRepository
31683168+ - GitRepository
31693169+ - Bucket
31703170+ - ExternalArtifact
32383171 type: string
32393239- lastReconciled:
32403240- description: LastReconciled is the time when this revision was
32413241- last reconciled to the cluster.
32423242- format: date-time
32433243- type: string
32443244- lastReconciledDuration:
32453245- description: LastReconciledDuration is time it took to reconcile
32463246- the resources in this revision.
31723172+ name:
31733173+ description: Name of the referent.
32473174 type: string
32483248- lastReconciledStatus:
32493249- description: LastReconciledStatus is the status of the last
32503250- reconciliation.
31753175+ namespace:
31763176+ description: |-
31773177+ Namespace of the referent, defaults to the namespace of the Kubernetes
31783178+ resource object that contains the reference.
32513179 type: string
32523252- metadata:
32533253- additionalProperties:
32543254- type: string
32553255- description: Metadata contains additional information about
32563256- the snapshot.
32573257- type: object
32583258- totalReconciliations:
32593259- description: TotalReconciliations is the total number of reconciliations
32603260- that have occurred for this snapshot.
32613261- format: int64
32623262- type: integer
32633180 required:
32643264- - digest
32653265- - firstReconciled
32663266- - lastReconciled
32673267- - lastReconciledDuration
32683268- - lastReconciledStatus
32693269- - totalReconciliations
31813181+ - kind
31823182+ - name
32703183 type: object
32713271- type: array
32723272- inventory:
32733273- description: |-
32743274- Inventory contains the list of Kubernetes resource object references that
32753275- have been successfully applied.
32763276- properties:
32773277- entries:
32783278- description: Entries of Kubernetes resource object references.
32793279- items:
32803280- description: ResourceRef contains the information necessary
32813281- to locate a resource within a cluster.
32823282- properties:
32833283- id:
32843284- description: |-
32853285- ID is the string representation of the Kubernetes resource object's metadata,
32863286- in the format '<namespace>_<name>_<group>_<kind>'.
32873287- type: string
32883288- v:
32893289- description: Version is the API version of the Kubernetes
32903290- resource object's kind.
31843184+ suspend:
31853185+ description: |-
31863186+ This flag tells the controller to suspend subsequent kustomize executions,
31873187+ it does not apply to already started executions. Defaults to false.
31883188+ type: boolean
31893189+ targetNamespace:
31903190+ description: |-
31913191+ TargetNamespace sets or overrides the namespace in the
31923192+ kustomization.yaml file.
31933193+ maxLength: 63
31943194+ minLength: 1
31953195+ type: string
31963196+ timeout:
31973197+ description: |-
31983198+ Timeout for validation, apply and health checking operations.
31993199+ Defaults to 'Interval' duration.
32003200+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
32013201+ type: string
32023202+ wait:
32033203+ description: |-
32043204+ Wait instructs the controller to check the health of all the reconciled
32053205+ resources. When enabled, the HealthChecks are ignored. Defaults to false.
32063206+ type: boolean
32073207+ required:
32083208+ - interval
32093209+ - prune
32103210+ - sourceRef
32113211+ type: object
32123212+ status:
32133213+ default:
32143214+ observedGeneration: -1
32153215+ description: KustomizationStatus defines the observed state of a kustomization.
32163216+ properties:
32173217+ conditions:
32183218+ items:
32193219+ description:
32203220+ Condition contains details for one aspect of the current
32213221+ state of this API Resource.
32223222+ properties:
32233223+ lastTransitionTime:
32243224+ description: |-
32253225+ lastTransitionTime is the last time the condition transitioned from one status to another.
32263226+ This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
32273227+ format: date-time
32283228+ type: string
32293229+ message:
32303230+ description: |-
32313231+ message is a human readable message indicating details about the transition.
32323232+ This may be an empty string.
32333233+ maxLength: 32768
32343234+ type: string
32353235+ observedGeneration:
32363236+ description: |-
32373237+ observedGeneration represents the .metadata.generation that the condition was set based upon.
32383238+ For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
32393239+ with respect to the current state of the instance.
32403240+ format: int64
32413241+ minimum: 0
32423242+ type: integer
32433243+ reason:
32443244+ description: |-
32453245+ reason contains a programmatic identifier indicating the reason for the condition's last transition.
32463246+ Producers of specific condition types may define expected values and meanings for this field,
32473247+ and whether the values are considered a guaranteed API.
32483248+ The value should be a CamelCase string.
32493249+ This field may not be empty.
32503250+ maxLength: 1024
32513251+ minLength: 1
32523252+ pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
32533253+ type: string
32543254+ status:
32553255+ description: status of the condition, one of True, False, Unknown.
32563256+ enum:
32573257+ - "True"
32583258+ - "False"
32593259+ - Unknown
32603260+ type: string
32613261+ type:
32623262+ description: type of condition in CamelCase or in foo.example.com/CamelCase.
32633263+ maxLength: 316
32643264+ 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])$
32653265+ type: string
32663266+ required:
32673267+ - lastTransitionTime
32683268+ - message
32693269+ - reason
32703270+ - status
32713271+ - type
32723272+ type: object
32733273+ type: array
32743274+ history:
32753275+ description: |-
32763276+ History contains a set of snapshots of the last reconciliation attempts
32773277+ tracking the revision, the state and the duration of each attempt.
32783278+ items:
32793279+ description: |-
32803280+ Snapshot represents a point-in-time record of a group of resources reconciliation,
32813281+ including timing information, status, and a unique digest identifier.
32823282+ properties:
32833283+ digest:
32843284+ description:
32853285+ Digest is the checksum in the format `<algo>:<hex>`
32863286+ of the resources in this snapshot.
32873287+ type: string
32883288+ firstReconciled:
32893289+ description:
32903290+ FirstReconciled is the time when this revision
32913291+ was first reconciled to the cluster.
32923292+ format: date-time
32933293+ type: string
32943294+ lastReconciled:
32953295+ description:
32963296+ LastReconciled is the time when this revision was
32973297+ last reconciled to the cluster.
32983298+ format: date-time
32993299+ type: string
33003300+ lastReconciledDuration:
33013301+ description:
33023302+ LastReconciledDuration is time it took to reconcile
33033303+ the resources in this revision.
33043304+ type: string
33053305+ lastReconciledStatus:
33063306+ description:
33073307+ LastReconciledStatus is the status of the last
33083308+ reconciliation.
33093309+ type: string
33103310+ metadata:
33113311+ additionalProperties:
32913312 type: string
32923292- required:
32933293- - id
32943294- - v
32953295- type: object
32963296- type: array
32973297- required:
32983298- - entries
32993299- type: object
33003300- lastAppliedOriginRevision:
33013301- description: |-
33023302- The last successfully applied origin revision.
33033303- Equals the origin revision of the applied Artifact from the referenced Source.
33043304- Usually present on the Metadata of the applied Artifact and depends on the
33053305- Source type, e.g. for OCI it's the value associated with the key
33063306- "org.opencontainers.image.revision".
33073307- type: string
33083308- lastAppliedRevision:
33093309- description: |-
33103310- The last successfully applied revision.
33113311- Equals the Revision of the applied Artifact from the referenced Source.
33123312- type: string
33133313- lastAttemptedRevision:
33143314- description: LastAttemptedRevision is the revision of the last reconciliation
33153315- attempt.
33163316- type: string
33173317- lastHandledReconcileAt:
33183318- description: |-
33193319- LastHandledReconcileAt holds the value of the most recent
33203320- reconcile request value, so a change of the annotation value
33213321- can be detected.
33223322- type: string
33233323- observedGeneration:
33243324- description: ObservedGeneration is the last reconciled generation.
33253325- format: int64
33263326- type: integer
33273327- type: object
33283328- type: object
33293329- served: true
33303330- storage: true
33313331- subresources:
33323332- status: {}
33133313+ description:
33143314+ Metadata contains additional information about
33153315+ the snapshot.
33163316+ type: object
33173317+ totalReconciliations:
33183318+ description:
33193319+ TotalReconciliations is the total number of reconciliations
33203320+ that have occurred for this snapshot.
33213321+ format: int64
33223322+ type: integer
33233323+ required:
33243324+ - digest
33253325+ - firstReconciled
33263326+ - lastReconciled
33273327+ - lastReconciledDuration
33283328+ - lastReconciledStatus
33293329+ - totalReconciliations
33303330+ type: object
33313331+ type: array
33323332+ inventory:
33333333+ description: |-
33343334+ Inventory contains the list of Kubernetes resource object references that
33353335+ have been successfully applied.
33363336+ properties:
33373337+ entries:
33383338+ description: Entries of Kubernetes resource object references.
33393339+ items:
33403340+ description:
33413341+ ResourceRef contains the information necessary
33423342+ to locate a resource within a cluster.
33433343+ properties:
33443344+ id:
33453345+ description: |-
33463346+ ID is the string representation of the Kubernetes resource object's metadata,
33473347+ in the format '<namespace>_<name>_<group>_<kind>'.
33483348+ type: string
33493349+ v:
33503350+ description:
33513351+ Version is the API version of the Kubernetes
33523352+ resource object's kind.
33533353+ type: string
33543354+ required:
33553355+ - id
33563356+ - v
33573357+ type: object
33583358+ type: array
33593359+ required:
33603360+ - entries
33613361+ type: object
33623362+ lastAppliedOriginRevision:
33633363+ description: |-
33643364+ The last successfully applied origin revision.
33653365+ Equals the origin revision of the applied Artifact from the referenced Source.
33663366+ Usually present on the Metadata of the applied Artifact and depends on the
33673367+ Source type, e.g. for OCI it's the value associated with the key
33683368+ "org.opencontainers.image.revision".
33693369+ type: string
33703370+ lastAppliedRevision:
33713371+ description: |-
33723372+ The last successfully applied revision.
33733373+ Equals the Revision of the applied Artifact from the referenced Source.
33743374+ type: string
33753375+ lastAttemptedRevision:
33763376+ description:
33773377+ LastAttemptedRevision is the revision of the last reconciliation
33783378+ attempt.
33793379+ type: string
33803380+ lastHandledReconcileAt:
33813381+ description: |-
33823382+ LastHandledReconcileAt holds the value of the most recent
33833383+ reconcile request value, so a change of the annotation value
33843384+ can be detected.
33853385+ type: string
33863386+ observedGeneration:
33873387+ description: ObservedGeneration is the last reconciled generation.
33883388+ format: int64
33893389+ type: integer
33903390+ type: object
33913391+ type: object
33923392+ served: true
33933393+ storage: true
33943394+ subresources:
33953395+ status: {}
33333396---
33343397apiVersion: v1
33353398kind: ServiceAccount
···33713434 app.kubernetes.io/version: v2.8.8
33723435 spec:
33733436 containers:
33743374- - args:
33753375- - --events-addr=http://notification-controller.$(RUNTIME_NAMESPACE).svc.cluster.local./
33763376- - --watch-all-namespaces=true
33773377- - --log-level=info
33783378- - --log-encoding=json
33793379- - --enable-leader-election
33803380- env:
33813381- - name: RUNTIME_NAMESPACE
33823382- valueFrom:
33833383- fieldRef:
33843384- fieldPath: metadata.namespace
33853385- - name: GOMEMLIMIT
33863386- valueFrom:
33873387- resourceFieldRef:
33883388- containerName: manager
33893389- resource: limits.memory
33903390- image: ghcr.io/fluxcd/kustomize-controller:v1.8.5
33913391- imagePullPolicy: IfNotPresent
33923392- livenessProbe:
33933393- httpGet:
33943394- path: /healthz
33953395- port: healthz
33963396- name: manager
33973397- ports:
33983398- - containerPort: 8080
33993399- name: http-prom
34003400- protocol: TCP
34013401- - containerPort: 9440
34023402- name: healthz
34033403- protocol: TCP
34043404- readinessProbe:
34053405- httpGet:
34063406- path: /readyz
34073407- port: healthz
34083408- resources:
34093409- limits:
34103410- cpu: 1000m
34113411- memory: 1Gi
34123412- requests:
34133413- cpu: 100m
34143414- memory: 64Mi
34153415- securityContext:
34163416- allowPrivilegeEscalation: false
34173417- capabilities:
34183418- drop:
34193419- - ALL
34203420- readOnlyRootFilesystem: true
34213421- runAsNonRoot: true
34223422- seccompProfile:
34233423- type: RuntimeDefault
34243424- volumeMounts:
34253425- - mountPath: /tmp
34263426- name: temp
34373437+ - args:
34383438+ - --events-addr=http://notification-controller.$(RUNTIME_NAMESPACE).svc.cluster.local./
34393439+ - --watch-all-namespaces=true
34403440+ - --log-level=info
34413441+ - --log-encoding=json
34423442+ - --enable-leader-election
34433443+ env:
34443444+ - name: RUNTIME_NAMESPACE
34453445+ valueFrom:
34463446+ fieldRef:
34473447+ fieldPath: metadata.namespace
34483448+ - name: GOMEMLIMIT
34493449+ valueFrom:
34503450+ resourceFieldRef:
34513451+ containerName: manager
34523452+ resource: limits.memory
34533453+ image: ghcr.io/fluxcd/kustomize-controller:v1.8.5
34543454+ imagePullPolicy: IfNotPresent
34553455+ livenessProbe:
34563456+ httpGet:
34573457+ path: /healthz
34583458+ port: healthz
34593459+ name: manager
34603460+ ports:
34613461+ - containerPort: 8080
34623462+ name: http-prom
34633463+ protocol: TCP
34643464+ - containerPort: 9440
34653465+ name: healthz
34663466+ protocol: TCP
34673467+ readinessProbe:
34683468+ httpGet:
34693469+ path: /readyz
34703470+ port: healthz
34713471+ resources:
34723472+ limits:
34733473+ cpu: 1000m
34743474+ memory: 1Gi
34753475+ requests:
34763476+ cpu: 100m
34773477+ memory: 64Mi
34783478+ securityContext:
34793479+ allowPrivilegeEscalation: false
34803480+ capabilities:
34813481+ drop:
34823482+ - ALL
34833483+ readOnlyRootFilesystem: true
34843484+ runAsNonRoot: true
34853485+ seccompProfile:
34863486+ type: RuntimeDefault
34873487+ volumeMounts:
34883488+ - mountPath: /tmp
34893489+ name: temp
34273490 nodeSelector:
34283491 kubernetes.io/os: linux
34293492 priorityClassName: system-cluster-critical
···34323495 serviceAccountName: kustomize-controller
34333496 terminationGracePeriodSeconds: 60
34343497 volumes:
34353435- - emptyDir: {}
34363436- name: temp
34983498+ - emptyDir: {}
34993499+ name: temp
34373500---
34383501apiVersion: apiextensions.k8s.io/v1
34393502kind: CustomResourceDefinition
···34533516 listKind: HelmReleaseList
34543517 plural: helmreleases
34553518 shortNames:
34563456- - hr
35193519+ - hr
34573520 singular: helmrelease
34583521 scope: Namespaced
34593522 versions:
34603460- - additionalPrinterColumns:
34613461- - jsonPath: .metadata.creationTimestamp
34623462- name: Age
34633463- type: date
34643464- - jsonPath: .status.conditions[?(@.type=="Ready")].status
34653465- name: Ready
34663466- type: string
34673467- - jsonPath: .status.conditions[?(@.type=="Ready")].message
34683468- name: Status
34693469- type: string
34703470- name: v2
34713471- schema:
34723472- openAPIV3Schema:
34733473- description: HelmRelease is the Schema for the helmreleases API
34743474- properties:
34753475- apiVersion:
34763476- description: |-
34773477- APIVersion defines the versioned schema of this representation of an object.
34783478- Servers should convert recognized schemas to the latest internal value, and
34793479- may reject unrecognized values.
34803480- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
34813481- type: string
34823482- kind:
34833483- description: |-
34843484- Kind is a string value representing the REST resource this object represents.
34853485- Servers may infer this from the endpoint the client submits requests to.
34863486- Cannot be updated.
34873487- In CamelCase.
34883488- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
34893489- type: string
34903490- metadata:
34913491- type: object
34923492- spec:
34933493- description: HelmReleaseSpec defines the desired state of a Helm release.
34943494- properties:
34953495- chart:
34963496- description: |-
34973497- Chart defines the template of the v1.HelmChart that should be created
34983498- for this HelmRelease.
34993499- properties:
35003500- metadata:
35013501- description: ObjectMeta holds the template for metadata like labels
35023502- and annotations.
35033503- properties:
35043504- annotations:
35053505- additionalProperties:
35063506- type: string
35073507- description: |-
35083508- Annotations is an unstructured key value map stored with a resource that may be
35093509- set by external tools to store and retrieve arbitrary metadata. They are not
35103510- queryable and should be preserved when modifying objects.
35113511- More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
35123512- type: object
35133513- labels:
35143514- additionalProperties:
35153515- type: string
35163516- description: |-
35173517- Map of string keys and values that can be used to organize and categorize
35183518- (scope and select) objects.
35193519- More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
35203520- type: object
35213521- type: object
35223522- spec:
35233523- description: Spec holds the template for the v1.HelmChartSpec
35243524- for this HelmRelease.
35253525- properties:
35263526- chart:
35273527- description: The name or path the Helm chart is available
35283528- at in the SourceRef.
35293529- maxLength: 2048
35303530- minLength: 1
35313531- type: string
35323532- ignoreMissingValuesFiles:
35333533- description: IgnoreMissingValuesFiles controls whether to
35343534- silently ignore missing values files rather than failing.
35353535- type: boolean
35363536- interval:
35373537- description: |-
35383538- Interval at which to check the v1.Source for updates. Defaults to
35393539- 'HelmReleaseSpec.Interval'.
35403540- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
35413541- type: string
35423542- reconcileStrategy:
35433543- default: ChartVersion
35443544- description: |-
35453545- Determines what enables the creation of a new artifact. Valid values are
35463546- ('ChartVersion', 'Revision').
35473547- See the documentation of the values for an explanation on their behavior.
35483548- Defaults to ChartVersion when omitted.
35493549- enum:
35503550- - ChartVersion
35513551- - Revision
35523552- type: string
35533553- sourceRef:
35543554- description: The name and namespace of the v1.Source the chart
35553555- is available at.
35563556- properties:
35573557- apiVersion:
35583558- description: APIVersion of the referent.
35233523+ - additionalPrinterColumns:
35243524+ - jsonPath: .metadata.creationTimestamp
35253525+ name: Age
35263526+ type: date
35273527+ - jsonPath: .status.conditions[?(@.type=="Ready")].status
35283528+ name: Ready
35293529+ type: string
35303530+ - jsonPath: .status.conditions[?(@.type=="Ready")].message
35313531+ name: Status
35323532+ type: string
35333533+ name: v2
35343534+ schema:
35353535+ openAPIV3Schema:
35363536+ description: HelmRelease is the Schema for the helmreleases API
35373537+ properties:
35383538+ apiVersion:
35393539+ description: |-
35403540+ APIVersion defines the versioned schema of this representation of an object.
35413541+ Servers should convert recognized schemas to the latest internal value, and
35423542+ may reject unrecognized values.
35433543+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
35443544+ type: string
35453545+ kind:
35463546+ description: |-
35473547+ Kind is a string value representing the REST resource this object represents.
35483548+ Servers may infer this from the endpoint the client submits requests to.
35493549+ Cannot be updated.
35503550+ In CamelCase.
35513551+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
35523552+ type: string
35533553+ metadata:
35543554+ type: object
35553555+ spec:
35563556+ description: HelmReleaseSpec defines the desired state of a Helm release.
35573557+ properties:
35583558+ chart:
35593559+ description: |-
35603560+ Chart defines the template of the v1.HelmChart that should be created
35613561+ for this HelmRelease.
35623562+ properties:
35633563+ metadata:
35643564+ description:
35653565+ ObjectMeta holds the template for metadata like labels
35663566+ and annotations.
35673567+ properties:
35683568+ annotations:
35693569+ additionalProperties:
35593570 type: string
35603560- kind:
35613561- description: Kind of the referent.
35623562- enum:
35633563- - HelmRepository
35643564- - GitRepository
35653565- - Bucket
35713571+ description: |-
35723572+ Annotations is an unstructured key value map stored with a resource that may be
35733573+ set by external tools to store and retrieve arbitrary metadata. They are not
35743574+ queryable and should be preserved when modifying objects.
35753575+ More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
35763576+ type: object
35773577+ labels:
35783578+ additionalProperties:
35663579 type: string
35673567- name:
35683568- description: Name of the referent.
35693569- maxLength: 253
35703570- minLength: 1
35713571- type: string
35723572- namespace:
35733573- description: Namespace of the referent.
35743574- maxLength: 63
35753575- minLength: 1
35763576- type: string
35773577- required:
35783578- - kind
35793579- - name
35803580- type: object
35813581- valuesFiles:
35823582- description: |-
35833583- Alternative list of values files to use as the chart values (values.yaml
35843584- is not included by default), expected to be a relative path in the SourceRef.
35853585- Values files are merged in the order of this list with the last file overriding
35863586- the first. Ignored when omitted.
35873587- items:
35803580+ description: |-
35813581+ Map of string keys and values that can be used to organize and categorize
35823582+ (scope and select) objects.
35833583+ More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
35843584+ type: object
35853585+ type: object
35863586+ spec:
35873587+ description:
35883588+ Spec holds the template for the v1.HelmChartSpec
35893589+ for this HelmRelease.
35903590+ properties:
35913591+ chart:
35923592+ description:
35933593+ The name or path the Helm chart is available
35943594+ at in the SourceRef.
35953595+ maxLength: 2048
35963596+ minLength: 1
35883597 type: string
35893589- type: array
35903590- verify:
35913591- description: |-
35923592- Verify contains the secret name containing the trusted public keys
35933593- used to verify the signature and specifies which provider to use to check
35943594- whether OCI image is authentic.
35953595- This field is only supported for OCI sources.
35963596- Chart dependencies, which are not bundled in the umbrella chart artifact,
35973597- are not verified.
35983598- properties:
35993599- provider:
36003600- default: cosign
36013601- description: Provider specifies the technology used to
36023602- sign the OCI Helm chart.
36033603- enum:
36043604- - cosign
36053605- - notation
36063606- type: string
36073607- secretRef:
36083608- description: |-
36093609- SecretRef specifies the Kubernetes Secret containing the
36103610- trusted public keys.
36113611- properties:
36123612- name:
36133613- description: Name of the referent.
36143614- type: string
36153615- required:
36163616- - name
36173617- type: object
36183618- required:
36193619- - provider
36203620- type: object
36213621- version:
36223622- default: '*'
36233623- description: |-
36243624- Version semver expression, ignored for charts from v1.GitRepository and
36253625- v1beta2.Bucket sources. Defaults to latest when omitted.
36263626- type: string
36273627- required:
36283628- - chart
36293629- - sourceRef
36303630- type: object
36313631- required:
36323632- - spec
36333633- type: object
36343634- chartRef:
36353635- description: |-
36363636- ChartRef holds a reference to a source controller resource containing the
36373637- Helm chart artifact.
36383638- properties:
36393639- apiVersion:
36403640- description: APIVersion of the referent.
36413641- type: string
36423642- kind:
36433643- description: Kind of the referent.
36443644- enum:
36453645- - OCIRepository
36463646- - HelmChart
36473647- - ExternalArtifact
36483648- type: string
36493649- name:
36503650- description: Name of the referent.
36513651- maxLength: 253
36523652- minLength: 1
36533653- type: string
36543654- namespace:
36553655- description: |-
36563656- Namespace of the referent, defaults to the namespace of the Kubernetes
36573657- resource object that contains the reference.
36583658- maxLength: 63
36593659- minLength: 1
36603660- type: string
36613661- required:
36623662- - kind
36633663- - name
36643664- type: object
36653665- commonMetadata:
36663666- description: |-
36673667- CommonMetadata specifies the common labels and annotations that are
36683668- applied to all resources. Any existing label or annotation will be
36693669- overridden if its key matches a common one.
36703670- properties:
36713671- annotations:
36723672- additionalProperties:
36733673- type: string
36743674- description: Annotations to be added to the object's metadata.
36753675- type: object
36763676- labels:
36773677- additionalProperties:
36783678- type: string
36793679- description: Labels to be added to the object's metadata.
36803680- type: object
36813681- type: object
36823682- dependsOn:
36833683- description: |-
36843684- DependsOn may contain a DependencyReference slice with
36853685- references to HelmRelease resources that must be ready before this HelmRelease
36863686- can be reconciled.
36873687- items:
36883688- description: DependencyReference defines a HelmRelease dependency
36893689- on another HelmRelease resource.
36903690- properties:
36913691- name:
36923692- description: Name of the referent.
36933693- type: string
36943694- namespace:
36953695- description: |-
36963696- Namespace of the referent, defaults to the namespace of the HelmRelease
36973697- resource object that contains the reference.
36983698- type: string
36993699- readyExpr:
37003700- description: |-
37013701- ReadyExpr is a CEL expression that can be used to assess the readiness
37023702- of a dependency. When specified, the built-in readiness check
37033703- is replaced by the logic defined in the CEL expression.
37043704- To make the CEL expression additive to the built-in readiness check,
37053705- the feature gate `AdditiveCELDependencyCheck` must be set to `true`.
37063706- type: string
37073707- required:
37083708- - name
37093709- type: object
37103710- type: array
37113711- driftDetection:
37123712- description: |-
37133713- DriftDetection holds the configuration for detecting and handling
37143714- differences between the manifest in the Helm storage and the resources
37153715- currently existing in the cluster.
37163716- properties:
37173717- ignore:
37183718- description: |-
37193719- Ignore contains a list of rules for specifying which changes to ignore
37203720- during diffing.
37213721- items:
37223722- description: |-
37233723- IgnoreRule defines a rule to selectively disregard specific changes during
37243724- the drift detection process.
37253725- properties:
37263726- paths:
35983598+ ignoreMissingValuesFiles:
35993599+ description:
36003600+ IgnoreMissingValuesFiles controls whether to
36013601+ silently ignore missing values files rather than failing.
36023602+ type: boolean
36033603+ interval:
37273604 description: |-
37283728- Paths is a list of JSON Pointer (RFC 6901) paths to be excluded from
37293729- consideration in a Kubernetes object.
37303730- items:
37313731- type: string
37323732- type: array
37333733- target:
36053605+ Interval at which to check the v1.Source for updates. Defaults to
36063606+ 'HelmReleaseSpec.Interval'.
36073607+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
36083608+ type: string
36093609+ reconcileStrategy:
36103610+ default: ChartVersion
37343611 description: |-
37353735- Target is a selector for specifying Kubernetes objects to which this
37363736- rule applies.
37373737- If Target is not set, the Paths will be ignored for all Kubernetes
37383738- objects within the manifest of the Helm release.
36123612+ Determines what enables the creation of a new artifact. Valid values are
36133613+ ('ChartVersion', 'Revision').
36143614+ See the documentation of the values for an explanation on their behavior.
36153615+ Defaults to ChartVersion when omitted.
36163616+ enum:
36173617+ - ChartVersion
36183618+ - Revision
36193619+ type: string
36203620+ sourceRef:
36213621+ description:
36223622+ The name and namespace of the v1.Source the chart
36233623+ is available at.
37393624 properties:
37403740- annotationSelector:
37413741- description: |-
37423742- AnnotationSelector is a string that follows the label selection expression
37433743- https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
37443744- It matches with the resource annotations.
37453745- type: string
37463746- group:
37473747- description: |-
37483748- Group is the API group to select resources from.
37493749- Together with Version and Kind it is capable of unambiguously identifying and/or selecting resources.
37503750- https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
36253625+ apiVersion:
36263626+ description: APIVersion of the referent.
37513627 type: string
37523628 kind:
37533753- description: |-
37543754- Kind of the API Group to select resources from.
37553755- Together with Group and Version it is capable of unambiguously
37563756- identifying and/or selecting resources.
37573757- https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
37583758- type: string
37593759- labelSelector:
37603760- description: |-
37613761- LabelSelector is a string that follows the label selection expression
37623762- https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
37633763- It matches with the resource labels.
36293629+ description: Kind of the referent.
36303630+ enum:
36313631+ - HelmRepository
36323632+ - GitRepository
36333633+ - Bucket
37643634 type: string
37653635 name:
37663766- description: Name to match resources with.
36363636+ description: Name of the referent.
36373637+ maxLength: 253
36383638+ minLength: 1
37673639 type: string
37683640 namespace:
37693769- description: Namespace to select resources from.
36413641+ description: Namespace of the referent.
36423642+ maxLength: 63
36433643+ minLength: 1
37703644 type: string
37713771- version:
37723772- description: |-
37733773- Version of the API Group to select resources from.
37743774- Together with Group and Kind it is capable of unambiguously identifying and/or selecting resources.
37753775- https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
36453645+ required:
36463646+ - kind
36473647+ - name
36483648+ type: object
36493649+ valuesFiles:
36503650+ description: |-
36513651+ Alternative list of values files to use as the chart values (values.yaml
36523652+ is not included by default), expected to be a relative path in the SourceRef.
36533653+ Values files are merged in the order of this list with the last file overriding
36543654+ the first. Ignored when omitted.
36553655+ items:
36563656+ type: string
36573657+ type: array
36583658+ verify:
36593659+ description: |-
36603660+ Verify contains the secret name containing the trusted public keys
36613661+ used to verify the signature and specifies which provider to use to check
36623662+ whether OCI image is authentic.
36633663+ This field is only supported for OCI sources.
36643664+ Chart dependencies, which are not bundled in the umbrella chart artifact,
36653665+ are not verified.
36663666+ properties:
36673667+ provider:
36683668+ default: cosign
36693669+ description:
36703670+ Provider specifies the technology used to
36713671+ sign the OCI Helm chart.
36723672+ enum:
36733673+ - cosign
36743674+ - notation
37763675 type: string
36763676+ secretRef:
36773677+ description: |-
36783678+ SecretRef specifies the Kubernetes Secret containing the
36793679+ trusted public keys.
36803680+ properties:
36813681+ name:
36823682+ description: Name of the referent.
36833683+ type: string
36843684+ required:
36853685+ - name
36863686+ type: object
36873687+ required:
36883688+ - provider
37773689 type: object
36903690+ version:
36913691+ default: "*"
36923692+ description: |-
36933693+ Version semver expression, ignored for charts from v1.GitRepository and
36943694+ v1beta2.Bucket sources. Defaults to latest when omitted.
36953695+ type: string
37783696 required:
37793779- - paths
36973697+ - chart
36983698+ - sourceRef
37803699 type: object
37813781- type: array
37823782- mode:
37833783- description: |-
37843784- Mode defines how differences should be handled between the Helm manifest
37853785- and the manifest currently applied to the cluster.
37863786- If not explicitly set, it defaults to DiffModeDisabled.
37873787- enum:
37883788- - enabled
37893789- - warn
37903790- - disabled
37913791- type: string
37923792- type: object
37933793- healthCheckExprs:
37943794- description: |-
37953795- HealthCheckExprs is a list of healthcheck expressions for evaluating the
37963796- health of custom resources using Common Expression Language (CEL).
37973797- The expressions are evaluated only when the specific Helm action
37983798- taking place has wait enabled, i.e. DisableWait is false, and the
37993799- 'poller' WaitStrategy is used.
38003800- items:
38013801- description: CustomHealthCheck defines the health check for custom
38023802- resources.
37003700+ required:
37013701+ - spec
37023702+ type: object
37033703+ chartRef:
37043704+ description: |-
37053705+ ChartRef holds a reference to a source controller resource containing the
37063706+ Helm chart artifact.
38033707 properties:
38043708 apiVersion:
38053805- description: APIVersion of the custom resource under evaluation.
37093709+ description: APIVersion of the referent.
38063710 type: string
38073807- current:
38083808- description: |-
38093809- Current is the CEL expression that determines if the status
38103810- of the custom resource has reached the desired state.
37113711+ kind:
37123712+ description: Kind of the referent.
37133713+ enum:
37143714+ - OCIRepository
37153715+ - HelmChart
37163716+ - ExternalArtifact
38113717 type: string
38123812- failed:
38133813- description: |-
38143814- Failed is the CEL expression that determines if the status
38153815- of the custom resource has failed to reach the desired state.
37183718+ name:
37193719+ description: Name of the referent.
37203720+ maxLength: 253
37213721+ minLength: 1
38163722 type: string
38173817- inProgress:
37233723+ namespace:
38183724 description: |-
38193819- InProgress is the CEL expression that determines if the status
38203820- of the custom resource has not yet reached the desired state.
38213821- type: string
38223822- kind:
38233823- description: Kind of the custom resource under evaluation.
37253725+ Namespace of the referent, defaults to the namespace of the Kubernetes
37263726+ resource object that contains the reference.
37273727+ maxLength: 63
37283728+ minLength: 1
38243729 type: string
38253730 required:
38263826- - apiVersion
38273827- - current
38283828- - kind
37313731+ - kind
37323732+ - name
38293733 type: object
38303830- type: array
38313831- install:
38323832- description: Install holds the configuration for Helm install actions
38333833- for this HelmRelease.
38343834- properties:
38353835- crds:
38363836- description: |-
38373837- CRDs upgrade CRDs from the Helm Chart's crds directory according
38383838- to the CRD upgrade policy provided here. Valid values are `Skip`,
38393839- `Create` or `CreateReplace`. Default is `Create` and if omitted
38403840- CRDs are installed but not updated.
38413841-38423842- Skip: do neither install nor replace (update) any CRDs.
38433843-38443844- Create: new CRDs are created, existing CRDs are neither updated nor deleted.
38453845-38463846- CreateReplace: new CRDs are created, existing CRDs are updated (replaced)
38473847- but not deleted.
38483848-38493849- By default, CRDs are applied (installed) during Helm install action.
38503850- With this option users can opt in to CRD replace existing CRDs on Helm
38513851- install actions, which is not (yet) natively supported by Helm.
38523852- https://helm.sh/docs/chart_best_practices/custom_resource_definitions.
38533853- enum:
38543854- - Skip
38553855- - Create
38563856- - CreateReplace
38573857- type: string
38583858- createNamespace:
38593859- description: |-
38603860- CreateNamespace tells the Helm install action to create the
38613861- HelmReleaseSpec.TargetNamespace if it does not exist yet.
38623862- On uninstall, the namespace will not be garbage collected.
38633863- type: boolean
38643864- disableHooks:
38653865- description: DisableHooks prevents hooks from running during the
38663866- Helm install action.
38673867- type: boolean
38683868- disableOpenAPIValidation:
38693869- description: |-
38703870- DisableOpenAPIValidation prevents the Helm install action from validating
38713871- rendered templates against the Kubernetes OpenAPI Schema.
38723872- type: boolean
38733873- disableSchemaValidation:
38743874- description: |-
38753875- DisableSchemaValidation prevents the Helm install action from validating
38763876- the values against the JSON Schema.
38773877- type: boolean
38783878- disableTakeOwnership:
38793879- description: |-
38803880- DisableTakeOwnership disables taking ownership of existing resources
38813881- during the Helm install action. Defaults to false.
38823882- type: boolean
38833883- disableWait:
38843884- description: |-
38853885- DisableWait disables the waiting for resources to be ready after a Helm
38863886- install has been performed.
38873887- type: boolean
38883888- disableWaitForJobs:
38893889- description: |-
38903890- DisableWaitForJobs disables waiting for jobs to complete after a Helm
38913891- install has been performed.
38923892- type: boolean
38933893- remediation:
38943894- description: |-
38953895- Remediation holds the remediation configuration for when the Helm install
38963896- action for the HelmRelease fails. The default is to not perform any action.
38973897- properties:
38983898- ignoreTestFailures:
38993899- description: |-
39003900- IgnoreTestFailures tells the controller to skip remediation when the Helm
39013901- tests are run after an install action but fail. Defaults to
39023902- 'Test.IgnoreFailures'.
39033903- type: boolean
39043904- remediateLastFailure:
39053905- description: |-
39063906- RemediateLastFailure tells the controller to remediate the last failure, when
39073907- no retries remain. Defaults to 'false'.
39083908- type: boolean
39093909- retries:
39103910- description: |-
39113911- Retries is the number of retries that should be attempted on failures before
39123912- bailing. Remediation, using an uninstall, is performed between each attempt.
39133913- Defaults to '0', a negative integer equals to unlimited retries.
39143914- type: integer
39153915- type: object
39163916- replace:
39173917- description: |-
39183918- Replace tells the Helm install action to re-use the 'ReleaseName', but only
39193919- if that name is a deleted release which remains in the history.
39203920- type: boolean
39213921- serverSideApply:
39223922- description: |-
39233923- ServerSideApply enables server-side apply for resources during install.
39243924- Defaults to true (or false when UseHelm3Defaults feature gate is enabled).
39253925- type: boolean
39263926- skipCRDs:
39273927- description: |-
39283928- SkipCRDs tells the Helm install action to not install any CRDs. By default,
39293929- CRDs are installed if not already present.
39303930-39313931- Deprecated use CRD policy (`crds`) attribute with value `Skip` instead.
39323932- type: boolean
39333933- strategy:
39343934- description: |-
39353935- Strategy defines the install strategy to use for this HelmRelease.
39363936- Defaults to 'RemediateOnFailure', or 'RetryOnFailure' when the
39373937- DefaultToRetryOnFailure feature gate is enabled.
39383938- properties:
39393939- name:
39403940- description: Name of the install strategy.
39413941- enum:
39423942- - RemediateOnFailure
39433943- - RetryOnFailure
37343734+ commonMetadata:
37353735+ description: |-
37363736+ CommonMetadata specifies the common labels and annotations that are
37373737+ applied to all resources. Any existing label or annotation will be
37383738+ overridden if its key matches a common one.
37393739+ properties:
37403740+ annotations:
37413741+ additionalProperties:
39443742 type: string
39453945- retryInterval:
39463946- description: |-
39473947- RetryInterval is the interval at which to retry a failed install.
39483948- Can be used only when Name is set to RetryOnFailure.
39493949- Defaults to '5m'.
39503950- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
37433743+ description: Annotations to be added to the object's metadata.
37443744+ type: object
37453745+ labels:
37463746+ additionalProperties:
39513747 type: string
39523952- required:
39533953- - name
39543954- type: object
39553955- x-kubernetes-validations:
39563956- - message: .retryInterval cannot be set when .name is 'RemediateOnFailure'
39573957- rule: '!has(self.retryInterval) || self.name != ''RemediateOnFailure'''
39583958- timeout:
39593959- description: |-
39603960- Timeout is the time to wait for any individual Kubernetes operation (like
39613961- Jobs for hooks) during the performance of a Helm install action. Defaults to
39623962- 'HelmReleaseSpec.Timeout'.
39633963- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
39643964- type: string
39653965- type: object
39663966- interval:
39673967- description: Interval at which to reconcile the Helm release.
39683968- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
39693969- type: string
39703970- kubeConfig:
39713971- description: |-
39723972- KubeConfig for reconciling the HelmRelease on a remote cluster.
39733973- When used in combination with HelmReleaseSpec.ServiceAccountName,
39743974- forces the controller to act on behalf of that Service Account at the
39753975- target cluster.
39763976- If the --default-service-account flag is set, its value will be used as
39773977- a controller level fallback for when HelmReleaseSpec.ServiceAccountName
39783978- is empty.
39793979- properties:
39803980- configMapRef:
39813981- description: |-
39823982- ConfigMapRef holds an optional name of a ConfigMap that contains
39833983- the following keys:
39843984-39853985- - `provider`: the provider to use. One of `aws`, `azure`, `gcp`, or
39863986- `generic`. Required.
39873987- - `cluster`: the fully qualified resource name of the Kubernetes
39883988- cluster in the cloud provider API. Not used by the `generic`
39893989- provider. Required when one of `address` or `ca.crt` is not set.
39903990- - `address`: the address of the Kubernetes API server. Required
39913991- for `generic`. For the other providers, if not specified, the
39923992- first address in the cluster resource will be used, and if
39933993- specified, it must match one of the addresses in the cluster
39943994- resource.
39953995- If audiences is not set, will be used as the audience for the
39963996- `generic` provider.
39973997- - `ca.crt`: the optional PEM-encoded CA certificate for the
39983998- Kubernetes API server. If not set, the controller will use the
39993999- CA certificate from the cluster resource.
40004000- - `audiences`: the optional audiences as a list of
40014001- line-break-separated strings for the Kubernetes ServiceAccount
40024002- token. Defaults to the `address` for the `generic` provider, or
40034003- to specific values for the other providers depending on the
40044004- provider.
40054005- - `serviceAccountName`: the optional name of the Kubernetes
40064006- ServiceAccount in the same namespace that should be used
40074007- for authentication. If not specified, the controller
40084008- ServiceAccount will be used.
40094009-40104010- Mutually exclusive with SecretRef.
37483748+ description: Labels to be added to the object's metadata.
37493749+ type: object
37503750+ type: object
37513751+ dependsOn:
37523752+ description: |-
37533753+ DependsOn may contain a DependencyReference slice with
37543754+ references to HelmRelease resources that must be ready before this HelmRelease
37553755+ can be reconciled.
37563756+ items:
37573757+ description:
37583758+ DependencyReference defines a HelmRelease dependency
37593759+ on another HelmRelease resource.
40113760 properties:
40123761 name:
40133762 description: Name of the referent.
40143763 type: string
40154015- required:
40164016- - name
40174017- type: object
40184018- secretRef:
40194019- description: |-
40204020- SecretRef holds an optional name of a secret that contains a key with
40214021- the kubeconfig file as the value. If no key is set, the key will default
40224022- to 'value'. Mutually exclusive with ConfigMapRef.
40234023- It is recommended that the kubeconfig is self-contained, and the secret
40244024- is regularly updated if credentials such as a cloud-access-token expire.
40254025- Cloud specific `cmd-path` auth helpers will not function without adding
40264026- binaries and credentials to the Pod that is responsible for reconciling
40274027- Kubernetes resources. Supported only for the generic provider.
40284028- properties:
40294029- key:
40304030- description: Key in the Secret, when not specified an implementation-specific
40314031- default key is used.
37643764+ namespace:
37653765+ description: |-
37663766+ Namespace of the referent, defaults to the namespace of the HelmRelease
37673767+ resource object that contains the reference.
40323768 type: string
40334033- name:
40344034- description: Name of the Secret.
37693769+ readyExpr:
37703770+ description: |-
37713771+ ReadyExpr is a CEL expression that can be used to assess the readiness
37723772+ of a dependency. When specified, the built-in readiness check
37733773+ is replaced by the logic defined in the CEL expression.
37743774+ To make the CEL expression additive to the built-in readiness check,
37753775+ the feature gate `AdditiveCELDependencyCheck` must be set to `true`.
40353776 type: string
40363777 required:
40374037- - name
37783778+ - name
40383779 type: object
40394039- type: object
40404040- x-kubernetes-validations:
40414041- - message: exactly one of spec.kubeConfig.configMapRef or spec.kubeConfig.secretRef
40424042- must be specified
40434043- rule: has(self.configMapRef) || has(self.secretRef)
40444044- - message: exactly one of spec.kubeConfig.configMapRef or spec.kubeConfig.secretRef
40454045- must be specified
40464046- rule: '!has(self.configMapRef) || !has(self.secretRef)'
40474047- maxHistory:
40484048- description: |-
40494049- MaxHistory is the number of revisions saved by Helm for this HelmRelease.
40504050- Use '0' for an unlimited number of revisions; defaults to '5'.
40514051- type: integer
40524052- persistentClient:
40534053- description: |-
40544054- PersistentClient tells the controller to use a persistent Kubernetes
40554055- client for this release. When enabled, the client will be reused for the
40564056- duration of the reconciliation, instead of being created and destroyed
40574057- for each (step of a) Helm action.
40584058-40594059- This can improve performance, but may cause issues with some Helm charts
40604060- that for example do create Custom Resource Definitions during installation
40614061- outside Helm's CRD lifecycle hooks, which are then not observed to be
40624062- available by e.g. post-install hooks.
40634063-40644064- If not set, it defaults to true.
40654065- type: boolean
40664066- postRenderers:
40674067- description: |-
40684068- PostRenderers holds an array of Helm PostRenderers, which will be applied in order
40694069- of their definition.
40704070- items:
40714071- description: PostRenderer contains a Helm PostRenderer specification.
37803780+ type: array
37813781+ driftDetection:
37823782+ description: |-
37833783+ DriftDetection holds the configuration for detecting and handling
37843784+ differences between the manifest in the Helm storage and the resources
37853785+ currently existing in the cluster.
40723786 properties:
40734073- kustomize:
40744074- description: Kustomization to apply as PostRenderer.
40754075- properties:
40764076- images:
40774077- description: |-
40784078- Images is a list of (image name, new name, new tag or digest)
40794079- for changing image names, tags or digests. This can also be achieved with a
40804080- patch, but this operator is simpler to specify.
40814081- items:
40824082- description: Image contains an image name, a new name,
40834083- a new tag or digest, which will replace the original
40844084- name and tag.
37873787+ ignore:
37883788+ description: |-
37893789+ Ignore contains a list of rules for specifying which changes to ignore
37903790+ during diffing.
37913791+ items:
37923792+ description: |-
37933793+ IgnoreRule defines a rule to selectively disregard specific changes during
37943794+ the drift detection process.
37953795+ properties:
37963796+ paths:
37973797+ description: |-
37983798+ Paths is a list of JSON Pointer (RFC 6901) paths to be excluded from
37993799+ consideration in a Kubernetes object.
38003800+ items:
38013801+ type: string
38023802+ type: array
38033803+ target:
38043804+ description: |-
38053805+ Target is a selector for specifying Kubernetes objects to which this
38063806+ rule applies.
38073807+ If Target is not set, the Paths will be ignored for all Kubernetes
38083808+ objects within the manifest of the Helm release.
40853809 properties:
40864086- digest:
38103810+ annotationSelector:
38113811+ description: |-
38123812+ AnnotationSelector is a string that follows the label selection expression
38133813+ https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
38143814+ It matches with the resource annotations.
38153815+ type: string
38163816+ group:
38173817+ description: |-
38183818+ Group is the API group to select resources from.
38193819+ Together with Version and Kind it is capable of unambiguously identifying and/or selecting resources.
38203820+ https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
38213821+ type: string
38223822+ kind:
40873823 description: |-
40884088- Digest is the value used to replace the original image tag.
40894089- If digest is present NewTag value is ignored.
38243824+ Kind of the API Group to select resources from.
38253825+ Together with Group and Version it is capable of unambiguously
38263826+ identifying and/or selecting resources.
38273827+ https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
40903828 type: string
40914091- name:
40924092- description: Name is a tag-less image name.
38293829+ labelSelector:
38303830+ description: |-
38313831+ LabelSelector is a string that follows the label selection expression
38323832+ https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
38333833+ It matches with the resource labels.
40933834 type: string
40944094- newName:
40954095- description: NewName is the value used to replace
40964096- the original name.
38353835+ name:
38363836+ description: Name to match resources with.
40973837 type: string
40984098- newTag:
40994099- description: NewTag is the value used to replace the
41004100- original tag.
38383838+ namespace:
38393839+ description: Namespace to select resources from.
41013840 type: string
41024102- required:
41034103- - name
41044104- type: object
41054105- type: array
41064106- patches:
41074107- description: |-
41084108- Strategic merge and JSON patches, defined as inline YAML objects,
41094109- capable of targeting objects based on kind, label and annotation selectors.
41104110- items:
41114111- description: |-
41124112- Patch contains an inline StrategicMerge or JSON6902 patch, and the target the patch should
41134113- be applied to.
41144114- properties:
41154115- patch:
38413841+ version:
41163842 description: |-
41174117- Patch contains an inline StrategicMerge patch or an inline JSON6902 patch with
41184118- an array of operation objects.
38433843+ Version of the API Group to select resources from.
38443844+ Together with Group and Kind it is capable of unambiguously identifying and/or selecting resources.
38453845+ https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
41193846 type: string
41204120- target:
41214121- description: Target points to the resources that the
41224122- patch document should be applied to.
41234123- properties:
41244124- annotationSelector:
41254125- description: |-
41264126- AnnotationSelector is a string that follows the label selection expression
41274127- https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
41284128- It matches with the resource annotations.
41294129- type: string
41304130- group:
41314131- description: |-
41324132- Group is the API group to select resources from.
41334133- Together with Version and Kind it is capable of unambiguously identifying and/or selecting resources.
41344134- https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
41354135- type: string
41364136- kind:
41374137- description: |-
41384138- Kind of the API Group to select resources from.
41394139- Together with Group and Version it is capable of unambiguously
41404140- identifying and/or selecting resources.
41414141- https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
41424142- type: string
41434143- labelSelector:
41444144- description: |-
41454145- LabelSelector is a string that follows the label selection expression
41464146- https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
41474147- It matches with the resource labels.
41484148- type: string
41494149- name:
41504150- description: Name to match resources with.
41514151- type: string
41524152- namespace:
41534153- description: Namespace to select resources from.
41544154- type: string
41554155- version:
41564156- description: |-
41574157- Version of the API Group to select resources from.
41584158- Together with Group and Kind it is capable of unambiguously identifying and/or selecting resources.
41594159- https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
41604160- type: string
41614161- type: object
41624162- required:
41634163- - patch
41643847 type: object
41654165- type: array
41664166- type: object
38483848+ required:
38493849+ - paths
38503850+ type: object
38513851+ type: array
38523852+ mode:
38533853+ description: |-
38543854+ Mode defines how differences should be handled between the Helm manifest
38553855+ and the manifest currently applied to the cluster.
38563856+ If not explicitly set, it defaults to DiffModeDisabled.
38573857+ enum:
38583858+ - enabled
38593859+ - warn
38603860+ - disabled
38613861+ type: string
41673862 type: object
41684168- type: array
41694169- releaseName:
41704170- description: |-
41714171- ReleaseName used for the Helm release. Defaults to a composition of
41724172- '[TargetNamespace-]Name'.
41734173- maxLength: 53
41744174- minLength: 1
41754175- type: string
41764176- rollback:
41774177- description: Rollback holds the configuration for Helm rollback actions
41784178- for this HelmRelease.
41794179- properties:
41804180- cleanupOnFail:
41814181- description: |-
41824182- CleanupOnFail allows deletion of new resources created during the Helm
41834183- rollback action when it fails.
41844184- type: boolean
41854185- disableHooks:
41864186- description: DisableHooks prevents hooks from running during the
41874187- Helm rollback action.
41884188- type: boolean
41894189- disableWait:
41904190- description: |-
41914191- DisableWait disables the waiting for resources to be ready after a Helm
41924192- rollback has been performed.
41934193- type: boolean
41944194- disableWaitForJobs:
41954195- description: |-
41964196- DisableWaitForJobs disables waiting for jobs to complete after a Helm
41974197- rollback has been performed.
41984198- type: boolean
41994199- force:
42004200- description: |-
42014201- Force forces resource updates through a replacement strategy
42024202- that avoids 3-way merge conflicts on client-side apply.
42034203- This field is ignored for server-side apply (which always
42044204- forces conflicts with other field managers).
42054205- type: boolean
42064206- recreate:
42074207- description: |-
42084208- Recreate performs pod restarts for any managed workloads.
38633863+ healthCheckExprs:
38643864+ description: |-
38653865+ HealthCheckExprs is a list of healthcheck expressions for evaluating the
38663866+ health of custom resources using Common Expression Language (CEL).
38673867+ The expressions are evaluated only when the specific Helm action
38683868+ taking place has wait enabled, i.e. DisableWait is false, and the
38693869+ 'poller' WaitStrategy is used.
38703870+ items:
38713871+ description:
38723872+ CustomHealthCheck defines the health check for custom
38733873+ resources.
38743874+ properties:
38753875+ apiVersion:
38763876+ description: APIVersion of the custom resource under evaluation.
38773877+ type: string
38783878+ current:
38793879+ description: |-
38803880+ Current is the CEL expression that determines if the status
38813881+ of the custom resource has reached the desired state.
38823882+ type: string
38833883+ failed:
38843884+ description: |-
38853885+ Failed is the CEL expression that determines if the status
38863886+ of the custom resource has failed to reach the desired state.
38873887+ type: string
38883888+ inProgress:
38893889+ description: |-
38903890+ InProgress is the CEL expression that determines if the status
38913891+ of the custom resource has not yet reached the desired state.
38923892+ type: string
38933893+ kind:
38943894+ description: Kind of the custom resource under evaluation.
38953895+ type: string
38963896+ required:
38973897+ - apiVersion
38983898+ - current
38993899+ - kind
39003900+ type: object
39013901+ type: array
39023902+ install:
39033903+ description:
39043904+ Install holds the configuration for Helm install actions
39053905+ for this HelmRelease.
39063906+ properties:
39073907+ crds:
39083908+ description: |-
39093909+ CRDs upgrade CRDs from the Helm Chart's crds directory according
39103910+ to the CRD upgrade policy provided here. Valid values are `Skip`,
39113911+ `Create` or `CreateReplace`. Default is `Create` and if omitted
39123912+ CRDs are installed but not updated.
39133913+39143914+ Skip: do neither install nor replace (update) any CRDs.
39153915+39163916+ Create: new CRDs are created, existing CRDs are neither updated nor deleted.
39173917+39183918+ CreateReplace: new CRDs are created, existing CRDs are updated (replaced)
39193919+ but not deleted.
4209392042104210- Deprecated: This behavior was deprecated in Helm 3:
42114211- - Deprecation: https://github.com/helm/helm/pull/6463
42124212- - Removal: https://github.com/helm/helm/pull/31023
42134213- After helm-controller was upgraded to the Helm 4 SDK,
42144214- this field is no longer functional and will print a
42154215- warning if set to true. It will also be removed in a
42164216- future release.
42174217- type: boolean
42184218- serverSideApply:
42194219- description: |-
42204220- ServerSideApply enables server-side apply for resources during rollback.
42214221- Can be "enabled", "disabled", or "auto".
42224222- When "auto", server-side apply usage will be based on the release's previous usage.
42234223- Defaults to "auto".
42244224- enum:
42254225- - enabled
42264226- - disabled
42274227- - auto
42284228- type: string
42294229- timeout:
42304230- description: |-
42314231- Timeout is the time to wait for any individual Kubernetes operation (like
42324232- Jobs for hooks) during the performance of a Helm rollback action. Defaults to
42334233- 'HelmReleaseSpec.Timeout'.
42344234- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
42354235- type: string
42364236- type: object
42374237- serviceAccountName:
42384238- description: |-
42394239- The name of the Kubernetes service account to impersonate
42404240- when reconciling this HelmRelease.
42414241- maxLength: 253
42424242- minLength: 1
42434243- type: string
42444244- storageNamespace:
42454245- description: |-
42464246- StorageNamespace used for the Helm storage.
42474247- Defaults to the namespace of the HelmRelease.
42484248- maxLength: 63
42494249- minLength: 1
42504250- type: string
42514251- suspend:
42524252- description: |-
42534253- Suspend tells the controller to suspend reconciliation for this HelmRelease,
42544254- it does not apply to already started reconciliations. Defaults to false.
42554255- type: boolean
42564256- targetNamespace:
42574257- description: |-
42584258- TargetNamespace to target when performing operations for the HelmRelease.
42594259- Defaults to the namespace of the HelmRelease.
42604260- maxLength: 63
42614261- minLength: 1
42624262- type: string
42634263- test:
42644264- description: Test holds the configuration for Helm test actions for
42654265- this HelmRelease.
42664266- properties:
42674267- enable:
42684268- description: |-
42694269- Enable enables Helm test actions for this HelmRelease after an Helm install
42704270- or upgrade action has been performed.
42714271- type: boolean
42724272- filters:
42734273- description: Filters is a list of tests to run or exclude from
42744274- running.
42754275- items:
42764276- description: Filter holds the configuration for individual Helm
42774277- test filters.
39213921+ By default, CRDs are applied (installed) during Helm install action.
39223922+ With this option users can opt in to CRD replace existing CRDs on Helm
39233923+ install actions, which is not (yet) natively supported by Helm.
39243924+ https://helm.sh/docs/chart_best_practices/custom_resource_definitions.
39253925+ enum:
39263926+ - Skip
39273927+ - Create
39283928+ - CreateReplace
39293929+ type: string
39303930+ createNamespace:
39313931+ description: |-
39323932+ CreateNamespace tells the Helm install action to create the
39333933+ HelmReleaseSpec.TargetNamespace if it does not exist yet.
39343934+ On uninstall, the namespace will not be garbage collected.
39353935+ type: boolean
39363936+ disableHooks:
39373937+ description:
39383938+ DisableHooks prevents hooks from running during the
39393939+ Helm install action.
39403940+ type: boolean
39413941+ disableOpenAPIValidation:
39423942+ description: |-
39433943+ DisableOpenAPIValidation prevents the Helm install action from validating
39443944+ rendered templates against the Kubernetes OpenAPI Schema.
39453945+ type: boolean
39463946+ disableSchemaValidation:
39473947+ description: |-
39483948+ DisableSchemaValidation prevents the Helm install action from validating
39493949+ the values against the JSON Schema.
39503950+ type: boolean
39513951+ disableTakeOwnership:
39523952+ description: |-
39533953+ DisableTakeOwnership disables taking ownership of existing resources
39543954+ during the Helm install action. Defaults to false.
39553955+ type: boolean
39563956+ disableWait:
39573957+ description: |-
39583958+ DisableWait disables the waiting for resources to be ready after a Helm
39593959+ install has been performed.
39603960+ type: boolean
39613961+ disableWaitForJobs:
39623962+ description: |-
39633963+ DisableWaitForJobs disables waiting for jobs to complete after a Helm
39643964+ install has been performed.
39653965+ type: boolean
39663966+ remediation:
39673967+ description: |-
39683968+ Remediation holds the remediation configuration for when the Helm install
39693969+ action for the HelmRelease fails. The default is to not perform any action.
42783970 properties:
42794279- exclude:
42804280- description: Exclude specifies whether the named test should
42814281- be excluded.
39713971+ ignoreTestFailures:
39723972+ description: |-
39733973+ IgnoreTestFailures tells the controller to skip remediation when the Helm
39743974+ tests are run after an install action but fail. Defaults to
39753975+ 'Test.IgnoreFailures'.
39763976+ type: boolean
39773977+ remediateLastFailure:
39783978+ description: |-
39793979+ RemediateLastFailure tells the controller to remediate the last failure, when
39803980+ no retries remain. Defaults to 'false'.
42823981 type: boolean
39823982+ retries:
39833983+ description: |-
39843984+ Retries is the number of retries that should be attempted on failures before
39853985+ bailing. Remediation, using an uninstall, is performed between each attempt.
39863986+ Defaults to '0', a negative integer equals to unlimited retries.
39873987+ type: integer
39883988+ type: object
39893989+ replace:
39903990+ description: |-
39913991+ Replace tells the Helm install action to re-use the 'ReleaseName', but only
39923992+ if that name is a deleted release which remains in the history.
39933993+ type: boolean
39943994+ serverSideApply:
39953995+ description: |-
39963996+ ServerSideApply enables server-side apply for resources during install.
39973997+ Defaults to true (or false when UseHelm3Defaults feature gate is enabled).
39983998+ type: boolean
39993999+ skipCRDs:
40004000+ description: |-
40014001+ SkipCRDs tells the Helm install action to not install any CRDs. By default,
40024002+ CRDs are installed if not already present.
40034003+40044004+ Deprecated use CRD policy (`crds`) attribute with value `Skip` instead.
40054005+ type: boolean
40064006+ strategy:
40074007+ description: |-
40084008+ Strategy defines the install strategy to use for this HelmRelease.
40094009+ Defaults to 'RemediateOnFailure', or 'RetryOnFailure' when the
40104010+ DefaultToRetryOnFailure feature gate is enabled.
40114011+ properties:
42834012 name:
42844284- description: Name is the name of the test.
42854285- maxLength: 253
42864286- minLength: 1
40134013+ description: Name of the install strategy.
40144014+ enum:
40154015+ - RemediateOnFailure
40164016+ - RetryOnFailure
40174017+ type: string
40184018+ retryInterval:
40194019+ description: |-
40204020+ RetryInterval is the interval at which to retry a failed install.
40214021+ Can be used only when Name is set to RetryOnFailure.
40224022+ Defaults to '5m'.
40234023+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
42874024 type: string
42884025 required:
42894289- - name
40264026+ - name
42904027 type: object
42914291- type: array
42924292- ignoreFailures:
42934293- description: |-
42944294- IgnoreFailures tells the controller to skip remediation when the Helm tests
42954295- are run but fail. Can be overwritten for tests run after install or upgrade
42964296- actions in 'Install.IgnoreTestFailures' and 'Upgrade.IgnoreTestFailures'.
42974297- type: boolean
42984298- timeout:
42994299- description: |-
43004300- Timeout is the time to wait for any individual Kubernetes operation during
43014301- the performance of a Helm test action. Defaults to 'HelmReleaseSpec.Timeout'.
43024302- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
43034303- type: string
43044304- type: object
43054305- timeout:
43064306- description: |-
43074307- Timeout is the time to wait for any individual Kubernetes operation (like Jobs
43084308- for hooks) during the performance of a Helm action. Defaults to '5m0s'.
43094309- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
43104310- type: string
43114311- uninstall:
43124312- description: Uninstall holds the configuration for Helm uninstall
43134313- actions for this HelmRelease.
43144314- properties:
43154315- deletionPropagation:
43164316- default: background
43174317- description: |-
43184318- DeletionPropagation specifies the deletion propagation policy when
43194319- a Helm uninstall is performed.
43204320- enum:
43214321- - background
43224322- - foreground
43234323- - orphan
43244324- type: string
43254325- disableHooks:
43264326- description: DisableHooks prevents hooks from running during the
43274327- Helm rollback action.
43284328- type: boolean
43294329- disableWait:
43304330- description: |-
43314331- DisableWait disables waiting for all the resources to be deleted after
43324332- a Helm uninstall is performed.
43334333- type: boolean
43344334- keepHistory:
43354335- description: |-
43364336- KeepHistory tells Helm to remove all associated resources and mark the
43374337- release as deleted, but retain the release history.
43384338- type: boolean
43394339- timeout:
43404340- description: |-
43414341- Timeout is the time to wait for any individual Kubernetes operation (like
43424342- Jobs for hooks) during the performance of a Helm uninstall action. Defaults
43434343- to 'HelmReleaseSpec.Timeout'.
43444344- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
43454345- type: string
43464346- type: object
43474347- upgrade:
43484348- description: Upgrade holds the configuration for Helm upgrade actions
43494349- for this HelmRelease.
43504350- properties:
43514351- cleanupOnFail:
43524352- description: |-
43534353- CleanupOnFail allows deletion of new resources created during the Helm
43544354- upgrade action when it fails.
43554355- type: boolean
43564356- crds:
43574357- description: |-
43584358- CRDs upgrade CRDs from the Helm Chart's crds directory according
43594359- to the CRD upgrade policy provided here. Valid values are `Skip`,
43604360- `Create` or `CreateReplace`. Default is `Skip` and if omitted
43614361- CRDs are neither installed nor upgraded.
40284028+ x-kubernetes-validations:
40294029+ - message: .retryInterval cannot be set when .name is 'RemediateOnFailure'
40304030+ rule: "!has(self.retryInterval) || self.name != 'RemediateOnFailure'"
40314031+ timeout:
40324032+ description: |-
40334033+ Timeout is the time to wait for any individual Kubernetes operation (like
40344034+ Jobs for hooks) during the performance of a Helm install action. Defaults to
40354035+ 'HelmReleaseSpec.Timeout'.
40364036+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
40374037+ type: string
40384038+ type: object
40394039+ interval:
40404040+ description: Interval at which to reconcile the Helm release.
40414041+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
40424042+ type: string
40434043+ kubeConfig:
40444044+ description: |-
40454045+ KubeConfig for reconciling the HelmRelease on a remote cluster.
40464046+ When used in combination with HelmReleaseSpec.ServiceAccountName,
40474047+ forces the controller to act on behalf of that Service Account at the
40484048+ target cluster.
40494049+ If the --default-service-account flag is set, its value will be used as
40504050+ a controller level fallback for when HelmReleaseSpec.ServiceAccountName
40514051+ is empty.
40524052+ properties:
40534053+ configMapRef:
40544054+ description: |-
40554055+ ConfigMapRef holds an optional name of a ConfigMap that contains
40564056+ the following keys:
4362405743634363- Skip: do neither install nor replace (update) any CRDs.
40584058+ - `provider`: the provider to use. One of `aws`, `azure`, `gcp`, or
40594059+ `generic`. Required.
40604060+ - `cluster`: the fully qualified resource name of the Kubernetes
40614061+ cluster in the cloud provider API. Not used by the `generic`
40624062+ provider. Required when one of `address` or `ca.crt` is not set.
40634063+ - `address`: the address of the Kubernetes API server. Required
40644064+ for `generic`. For the other providers, if not specified, the
40654065+ first address in the cluster resource will be used, and if
40664066+ specified, it must match one of the addresses in the cluster
40674067+ resource.
40684068+ If audiences is not set, will be used as the audience for the
40694069+ `generic` provider.
40704070+ - `ca.crt`: the optional PEM-encoded CA certificate for the
40714071+ Kubernetes API server. If not set, the controller will use the
40724072+ CA certificate from the cluster resource.
40734073+ - `audiences`: the optional audiences as a list of
40744074+ line-break-separated strings for the Kubernetes ServiceAccount
40754075+ token. Defaults to the `address` for the `generic` provider, or
40764076+ to specific values for the other providers depending on the
40774077+ provider.
40784078+ - `serviceAccountName`: the optional name of the Kubernetes
40794079+ ServiceAccount in the same namespace that should be used
40804080+ for authentication. If not specified, the controller
40814081+ ServiceAccount will be used.
4364408243654365- Create: new CRDs are created, existing CRDs are neither updated nor deleted.
40834083+ Mutually exclusive with SecretRef.
40844084+ properties:
40854085+ name:
40864086+ description: Name of the referent.
40874087+ type: string
40884088+ required:
40894089+ - name
40904090+ type: object
40914091+ secretRef:
40924092+ description: |-
40934093+ SecretRef holds an optional name of a secret that contains a key with
40944094+ the kubeconfig file as the value. If no key is set, the key will default
40954095+ to 'value'. Mutually exclusive with ConfigMapRef.
40964096+ It is recommended that the kubeconfig is self-contained, and the secret
40974097+ is regularly updated if credentials such as a cloud-access-token expire.
40984098+ Cloud specific `cmd-path` auth helpers will not function without adding
40994099+ binaries and credentials to the Pod that is responsible for reconciling
41004100+ Kubernetes resources. Supported only for the generic provider.
41014101+ properties:
41024102+ key:
41034103+ description:
41044104+ Key in the Secret, when not specified an implementation-specific
41054105+ default key is used.
41064106+ type: string
41074107+ name:
41084108+ description: Name of the Secret.
41094109+ type: string
41104110+ required:
41114111+ - name
41124112+ type: object
41134113+ type: object
41144114+ x-kubernetes-validations:
41154115+ - message:
41164116+ exactly one of spec.kubeConfig.configMapRef or spec.kubeConfig.secretRef
41174117+ must be specified
41184118+ rule: has(self.configMapRef) || has(self.secretRef)
41194119+ - message:
41204120+ exactly one of spec.kubeConfig.configMapRef or spec.kubeConfig.secretRef
41214121+ must be specified
41224122+ rule: "!has(self.configMapRef) || !has(self.secretRef)"
41234123+ maxHistory:
41244124+ description: |-
41254125+ MaxHistory is the number of revisions saved by Helm for this HelmRelease.
41264126+ Use '0' for an unlimited number of revisions; defaults to '5'.
41274127+ type: integer
41284128+ persistentClient:
41294129+ description: |-
41304130+ PersistentClient tells the controller to use a persistent Kubernetes
41314131+ client for this release. When enabled, the client will be reused for the
41324132+ duration of the reconciliation, instead of being created and destroyed
41334133+ for each (step of a) Helm action.
4366413443674367- CreateReplace: new CRDs are created, existing CRDs are updated (replaced)
43684368- but not deleted.
41354135+ This can improve performance, but may cause issues with some Helm charts
41364136+ that for example do create Custom Resource Definitions during installation
41374137+ outside Helm's CRD lifecycle hooks, which are then not observed to be
41384138+ available by e.g. post-install hooks.
4369413943704370- By default, CRDs are not applied during Helm upgrade action. With this
43714371- option users can opt-in to CRD upgrade, which is not (yet) natively supported by Helm.
43724372- https://helm.sh/docs/chart_best_practices/custom_resource_definitions.
43734373- enum:
43744374- - Skip
43754375- - Create
43764376- - CreateReplace
43774377- type: string
43784378- disableHooks:
43794379- description: DisableHooks prevents hooks from running during the
43804380- Helm upgrade action.
43814381- type: boolean
43824382- disableOpenAPIValidation:
43834383- description: |-
43844384- DisableOpenAPIValidation prevents the Helm upgrade action from validating
43854385- rendered templates against the Kubernetes OpenAPI Schema.
43864386- type: boolean
43874387- disableSchemaValidation:
43884388- description: |-
43894389- DisableSchemaValidation prevents the Helm upgrade action from validating
43904390- the values against the JSON Schema.
43914391- type: boolean
43924392- disableTakeOwnership:
43934393- description: |-
43944394- DisableTakeOwnership disables taking ownership of existing resources
43954395- during the Helm upgrade action. Defaults to false.
43964396- type: boolean
43974397- disableWait:
43984398- description: |-
43994399- DisableWait disables the waiting for resources to be ready after a Helm
44004400- upgrade has been performed.
44014401- type: boolean
44024402- disableWaitForJobs:
44034403- description: |-
44044404- DisableWaitForJobs disables waiting for jobs to complete after a Helm
44054405- upgrade has been performed.
44064406- type: boolean
44074407- force:
44084408- description: |-
44094409- Force forces resource updates through a replacement strategy
44104410- that avoids 3-way merge conflicts on client-side apply.
44114411- This field is ignored for server-side apply (which always
44124412- forces conflicts with other field managers).
44134413- type: boolean
44144414- preserveValues:
44154415- description: |-
44164416- PreserveValues will make Helm reuse the last release's values and merge in
44174417- overrides from 'Values'. Setting this flag makes the HelmRelease
44184418- non-declarative.
44194419- type: boolean
44204420- remediation:
44214421- description: |-
44224422- Remediation holds the remediation configuration for when the Helm upgrade
44234423- action for the HelmRelease fails. The default is to not perform any action.
41404140+ If not set, it defaults to true.
41414141+ type: boolean
41424142+ postRenderers:
41434143+ description: |-
41444144+ PostRenderers holds an array of Helm PostRenderers, which will be applied in order
41454145+ of their definition.
41464146+ items:
41474147+ description: PostRenderer contains a Helm PostRenderer specification.
44244148 properties:
44254425- ignoreTestFailures:
44264426- description: |-
44274427- IgnoreTestFailures tells the controller to skip remediation when the Helm
44284428- tests are run after an upgrade action but fail.
44294429- Defaults to 'Test.IgnoreFailures'.
44304430- type: boolean
44314431- remediateLastFailure:
44324432- description: |-
44334433- RemediateLastFailure tells the controller to remediate the last failure, when
44344434- no retries remain. Defaults to 'false' unless 'Retries' is greater than 0.
44354435- type: boolean
44364436- retries:
44374437- description: |-
44384438- Retries is the number of retries that should be attempted on failures before
44394439- bailing. Remediation, using 'Strategy', is performed between each attempt.
44404440- Defaults to '0', a negative integer equals to unlimited retries.
44414441- type: integer
44424442- strategy:
44434443- description: Strategy to use for failure remediation. Defaults
44444444- to 'rollback'.
44454445- enum:
44464446- - rollback
44474447- - uninstall
44484448- type: string
41494149+ kustomize:
41504150+ description: Kustomization to apply as PostRenderer.
41514151+ properties:
41524152+ images:
41534153+ description: |-
41544154+ Images is a list of (image name, new name, new tag or digest)
41554155+ for changing image names, tags or digests. This can also be achieved with a
41564156+ patch, but this operator is simpler to specify.
41574157+ items:
41584158+ description:
41594159+ Image contains an image name, a new name,
41604160+ a new tag or digest, which will replace the original
41614161+ name and tag.
41624162+ properties:
41634163+ digest:
41644164+ description: |-
41654165+ Digest is the value used to replace the original image tag.
41664166+ If digest is present NewTag value is ignored.
41674167+ type: string
41684168+ name:
41694169+ description: Name is a tag-less image name.
41704170+ type: string
41714171+ newName:
41724172+ description:
41734173+ NewName is the value used to replace
41744174+ the original name.
41754175+ type: string
41764176+ newTag:
41774177+ description:
41784178+ NewTag is the value used to replace the
41794179+ original tag.
41804180+ type: string
41814181+ required:
41824182+ - name
41834183+ type: object
41844184+ type: array
41854185+ patches:
41864186+ description: |-
41874187+ Strategic merge and JSON patches, defined as inline YAML objects,
41884188+ capable of targeting objects based on kind, label and annotation selectors.
41894189+ items:
41904190+ description: |-
41914191+ Patch contains an inline StrategicMerge or JSON6902 patch, and the target the patch should
41924192+ be applied to.
41934193+ properties:
41944194+ patch:
41954195+ description: |-
41964196+ Patch contains an inline StrategicMerge patch or an inline JSON6902 patch with
41974197+ an array of operation objects.
41984198+ type: string
41994199+ target:
42004200+ description:
42014201+ Target points to the resources that the
42024202+ patch document should be applied to.
42034203+ properties:
42044204+ annotationSelector:
42054205+ description: |-
42064206+ AnnotationSelector is a string that follows the label selection expression
42074207+ https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
42084208+ It matches with the resource annotations.
42094209+ type: string
42104210+ group:
42114211+ description: |-
42124212+ Group is the API group to select resources from.
42134213+ Together with Version and Kind it is capable of unambiguously identifying and/or selecting resources.
42144214+ https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
42154215+ type: string
42164216+ kind:
42174217+ description: |-
42184218+ Kind of the API Group to select resources from.
42194219+ Together with Group and Version it is capable of unambiguously
42204220+ identifying and/or selecting resources.
42214221+ https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
42224222+ type: string
42234223+ labelSelector:
42244224+ description: |-
42254225+ LabelSelector is a string that follows the label selection expression
42264226+ https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
42274227+ It matches with the resource labels.
42284228+ type: string
42294229+ name:
42304230+ description: Name to match resources with.
42314231+ type: string
42324232+ namespace:
42334233+ description: Namespace to select resources from.
42344234+ type: string
42354235+ version:
42364236+ description: |-
42374237+ Version of the API Group to select resources from.
42384238+ Together with Group and Kind it is capable of unambiguously identifying and/or selecting resources.
42394239+ https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md
42404240+ type: string
42414241+ type: object
42424242+ required:
42434243+ - patch
42444244+ type: object
42454245+ type: array
42464246+ type: object
44494247 type: object
44504450- serverSideApply:
44514451- description: |-
44524452- ServerSideApply enables server-side apply for resources during upgrade.
44534453- Can be "enabled", "disabled", or "auto".
44544454- When "auto", server-side apply usage will be based on the release's previous usage.
44554455- Defaults to "auto".
44564456- enum:
44574457- - enabled
44584458- - disabled
44594459- - auto
44604460- type: string
44614461- strategy:
44624462- description: |-
44634463- Strategy defines the upgrade strategy to use for this HelmRelease.
44644464- Defaults to 'RemediateOnFailure', or 'RetryOnFailure' when the
44654465- DefaultToRetryOnFailure feature gate is enabled.
44664466- properties:
44674467- name:
44684468- description: Name of the upgrade strategy.
44694469- enum:
44704470- - RemediateOnFailure
44714471- - RetryOnFailure
44724472- type: string
44734473- retryInterval:
44744474- description: |-
44754475- RetryInterval is the interval at which to retry a failed upgrade.
44764476- Can be used only when Name is set to RetryOnFailure.
44774477- Defaults to '5m'.
44784478- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
44794479- type: string
44804480- required:
44814481- - name
44824482- type: object
44834483- x-kubernetes-validations:
44844484- - message: .retryInterval can only be set when .name is 'RetryOnFailure'
44854485- rule: '!has(self.retryInterval) || self.name == ''RetryOnFailure'''
44864486- timeout:
44874487- description: |-
44884488- Timeout is the time to wait for any individual Kubernetes operation (like
44894489- Jobs for hooks) during the performance of a Helm upgrade action. Defaults to
44904490- 'HelmReleaseSpec.Timeout'.
44914491- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
44924492- type: string
44934493- type: object
44944494- values:
44954495- description: Values holds the values for this Helm release.
44964496- x-kubernetes-preserve-unknown-fields: true
44974497- valuesFrom:
44984498- description: |-
44994499- ValuesFrom holds references to resources containing Helm values for this HelmRelease,
45004500- and information about how they should be merged.
45014501- items:
42484248+ type: array
42494249+ releaseName:
45024250 description: |-
45034503- ValuesReference contains a reference to a resource containing Helm values,
45044504- and optionally the key they can be found at.
42514251+ ReleaseName used for the Helm release. Defaults to a composition of
42524252+ '[TargetNamespace-]Name'.
42534253+ maxLength: 53
42544254+ minLength: 1
42554255+ type: string
42564256+ rollback:
42574257+ description:
42584258+ Rollback holds the configuration for Helm rollback actions
42594259+ for this HelmRelease.
45054260 properties:
45064506- kind:
45074507- description: Kind of the values referent, valid values are ('Secret',
45084508- 'ConfigMap').
42614261+ cleanupOnFail:
42624262+ description: |-
42634263+ CleanupOnFail allows deletion of new resources created during the Helm
42644264+ rollback action when it fails.
42654265+ type: boolean
42664266+ disableHooks:
42674267+ description:
42684268+ DisableHooks prevents hooks from running during the
42694269+ Helm rollback action.
42704270+ type: boolean
42714271+ disableWait:
42724272+ description: |-
42734273+ DisableWait disables the waiting for resources to be ready after a Helm
42744274+ rollback has been performed.
42754275+ type: boolean
42764276+ disableWaitForJobs:
42774277+ description: |-
42784278+ DisableWaitForJobs disables waiting for jobs to complete after a Helm
42794279+ rollback has been performed.
42804280+ type: boolean
42814281+ force:
42824282+ description: |-
42834283+ Force forces resource updates through a replacement strategy
42844284+ that avoids 3-way merge conflicts on client-side apply.
42854285+ This field is ignored for server-side apply (which always
42864286+ forces conflicts with other field managers).
42874287+ type: boolean
42884288+ recreate:
42894289+ description: |-
42904290+ Recreate performs pod restarts for any managed workloads.
42914291+42924292+ Deprecated: This behavior was deprecated in Helm 3:
42934293+ - Deprecation: https://github.com/helm/helm/pull/6463
42944294+ - Removal: https://github.com/helm/helm/pull/31023
42954295+ After helm-controller was upgraded to the Helm 4 SDK,
42964296+ this field is no longer functional and will print a
42974297+ warning if set to true. It will also be removed in a
42984298+ future release.
42994299+ type: boolean
43004300+ serverSideApply:
43014301+ description: |-
43024302+ ServerSideApply enables server-side apply for resources during rollback.
43034303+ Can be "enabled", "disabled", or "auto".
43044304+ When "auto", server-side apply usage will be based on the release's previous usage.
43054305+ Defaults to "auto".
45094306 enum:
45104510- - Secret
45114511- - ConfigMap
43074307+ - enabled
43084308+ - disabled
43094309+ - auto
45124310 type: string
45134513- name:
43114311+ timeout:
45144312 description: |-
45154515- Name of the values referent. Should reside in the same namespace as the
45164516- referring resource.
45174517- maxLength: 253
45184518- minLength: 1
43134313+ Timeout is the time to wait for any individual Kubernetes operation (like
43144314+ Jobs for hooks) during the performance of a Helm rollback action. Defaults to
43154315+ 'HelmReleaseSpec.Timeout'.
43164316+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
45194317 type: string
45204520- optional:
43184318+ type: object
43194319+ serviceAccountName:
43204320+ description: |-
43214321+ The name of the Kubernetes service account to impersonate
43224322+ when reconciling this HelmRelease.
43234323+ maxLength: 253
43244324+ minLength: 1
43254325+ type: string
43264326+ storageNamespace:
43274327+ description: |-
43284328+ StorageNamespace used for the Helm storage.
43294329+ Defaults to the namespace of the HelmRelease.
43304330+ maxLength: 63
43314331+ minLength: 1
43324332+ type: string
43334333+ suspend:
43344334+ description: |-
43354335+ Suspend tells the controller to suspend reconciliation for this HelmRelease,
43364336+ it does not apply to already started reconciliations. Defaults to false.
43374337+ type: boolean
43384338+ targetNamespace:
43394339+ description: |-
43404340+ TargetNamespace to target when performing operations for the HelmRelease.
43414341+ Defaults to the namespace of the HelmRelease.
43424342+ maxLength: 63
43434343+ minLength: 1
43444344+ type: string
43454345+ test:
43464346+ description:
43474347+ Test holds the configuration for Helm test actions for
43484348+ this HelmRelease.
43494349+ properties:
43504350+ enable:
45214351 description: |-
45224522- Optional marks this ValuesReference as optional. When set, a not found error
45234523- for the values reference is ignored, but any ValuesKey, TargetPath or
45244524- transient error will still result in a reconciliation failure.
43524352+ Enable enables Helm test actions for this HelmRelease after an Helm install
43534353+ or upgrade action has been performed.
45254354 type: boolean
45264526- targetPath:
43554355+ filters:
43564356+ description:
43574357+ Filters is a list of tests to run or exclude from
43584358+ running.
43594359+ items:
43604360+ description:
43614361+ Filter holds the configuration for individual Helm
43624362+ test filters.
43634363+ properties:
43644364+ exclude:
43654365+ description:
43664366+ Exclude specifies whether the named test should
43674367+ be excluded.
43684368+ type: boolean
43694369+ name:
43704370+ description: Name is the name of the test.
43714371+ maxLength: 253
43724372+ minLength: 1
43734373+ type: string
43744374+ required:
43754375+ - name
43764376+ type: object
43774377+ type: array
43784378+ ignoreFailures:
45274379 description: |-
45284528- TargetPath is the YAML dot notation path the value should be merged at. When
45294529- set, the ValuesKey is expected to be a single flat value. Defaults to 'None',
45304530- which results in the values getting merged at the root.
45314531- maxLength: 250
45324532- pattern: ^([a-zA-Z0-9_\-.\\\/]|\[[0-9]{1,5}\])+$
45334533- type: string
45344534- valuesKey:
43804380+ IgnoreFailures tells the controller to skip remediation when the Helm tests
43814381+ are run but fail. Can be overwritten for tests run after install or upgrade
43824382+ actions in 'Install.IgnoreTestFailures' and 'Upgrade.IgnoreTestFailures'.
43834383+ type: boolean
43844384+ timeout:
45354385 description: |-
45364536- ValuesKey is the data key where the values.yaml or a specific value can be
45374537- found at. Defaults to 'values.yaml'.
45384538- maxLength: 253
45394539- pattern: ^[\-._a-zA-Z0-9]+$
43864386+ Timeout is the time to wait for any individual Kubernetes operation during
43874387+ the performance of a Helm test action. Defaults to 'HelmReleaseSpec.Timeout'.
43884388+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
45404389 type: string
45414541- required:
45424542- - kind
45434543- - name
45444390 type: object
45454545- type: array
45464546- waitStrategy:
45474547- description: |-
45484548- WaitStrategy defines Helm's wait strategy for waiting for applied
45494549- resources to become ready.
45504550- properties:
45514551- name:
45524552- description: |-
45534553- Name is Helm's wait strategy for waiting for applied resources to
45544554- become ready. One of 'poller' or 'legacy'. The 'poller' strategy uses
45554555- kstatus to poll resource statuses, while the 'legacy' strategy uses
45564556- Helm v3's waiting logic.
45574557- Defaults to 'poller', or to 'legacy' when UseHelm3Defaults feature
45584558- gate is enabled.
45594559- enum:
45604560- - poller
45614561- - legacy
45624562- type: string
45634563- required:
45644564- - name
45654565- type: object
45664566- required:
45674567- - interval
45684568- type: object
45694569- x-kubernetes-validations:
45704570- - message: either chart or chartRef must be set
45714571- rule: (has(self.chart) && !has(self.chartRef)) || (!has(self.chart)
45724572- && has(self.chartRef))
45734573- status:
45744574- default:
45754575- observedGeneration: -1
45764576- description: HelmReleaseStatus defines the observed state of a HelmRelease.
45774577- properties:
45784578- conditions:
45794579- description: Conditions holds the conditions for the HelmRelease.
45804580- items:
45814581- description: Condition contains details for one aspect of the current
45824582- state of this API Resource.
43914391+ timeout:
43924392+ description: |-
43934393+ Timeout is the time to wait for any individual Kubernetes operation (like Jobs
43944394+ for hooks) during the performance of a Helm action. Defaults to '5m0s'.
43954395+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
43964396+ type: string
43974397+ uninstall:
43984398+ description:
43994399+ Uninstall holds the configuration for Helm uninstall
44004400+ actions for this HelmRelease.
45834401 properties:
45844584- lastTransitionTime:
44024402+ deletionPropagation:
44034403+ default: background
45854404 description: |-
45864586- lastTransitionTime is the last time the condition transitioned from one status to another.
45874587- This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
45884588- format: date-time
44054405+ DeletionPropagation specifies the deletion propagation policy when
44064406+ a Helm uninstall is performed.
44074407+ enum:
44084408+ - background
44094409+ - foreground
44104410+ - orphan
45894411 type: string
45904590- message:
44124412+ disableHooks:
44134413+ description:
44144414+ DisableHooks prevents hooks from running during the
44154415+ Helm rollback action.
44164416+ type: boolean
44174417+ disableWait:
45914418 description: |-
45924592- message is a human readable message indicating details about the transition.
45934593- This may be an empty string.
45944594- maxLength: 32768
45954595- type: string
45964596- observedGeneration:
44194419+ DisableWait disables waiting for all the resources to be deleted after
44204420+ a Helm uninstall is performed.
44214421+ type: boolean
44224422+ keepHistory:
45974423 description: |-
45984598- observedGeneration represents the .metadata.generation that the condition was set based upon.
45994599- For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
46004600- with respect to the current state of the instance.
46014601- format: int64
46024602- minimum: 0
46034603- type: integer
46044604- reason:
44244424+ KeepHistory tells Helm to remove all associated resources and mark the
44254425+ release as deleted, but retain the release history.
44264426+ type: boolean
44274427+ timeout:
46054428 description: |-
46064606- reason contains a programmatic identifier indicating the reason for the condition's last transition.
46074607- Producers of specific condition types may define expected values and meanings for this field,
46084608- and whether the values are considered a guaranteed API.
46094609- The value should be a CamelCase string.
46104610- This field may not be empty.
46114611- maxLength: 1024
46124612- minLength: 1
46134613- pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
46144614- type: string
46154615- status:
46164616- description: status of the condition, one of True, False, Unknown.
46174617- enum:
46184618- - "True"
46194619- - "False"
46204620- - Unknown
46214621- type: string
46224622- type:
46234623- description: type of condition in CamelCase or in foo.example.com/CamelCase.
46244624- maxLength: 316
46254625- 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])$
44294429+ Timeout is the time to wait for any individual Kubernetes operation (like
44304430+ Jobs for hooks) during the performance of a Helm uninstall action. Defaults
44314431+ to 'HelmReleaseSpec.Timeout'.
44324432+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
46264433 type: string
46274627- required:
46284628- - lastTransitionTime
46294629- - message
46304630- - reason
46314631- - status
46324632- - type
46334434 type: object
46344634- type: array
46354635- failures:
46364636- description: |-
46374637- Failures is the reconciliation failure count against the latest desired
46384638- state. It is reset after a successful reconciliation.
46394639- format: int64
46404640- type: integer
46414641- helmChart:
46424642- description: |-
46434643- HelmChart is the namespaced name of the HelmChart resource created by
46444644- the controller for the HelmRelease.
46454645- type: string
46464646- history:
46474647- description: |-
46484648- History holds the history of Helm releases performed for this HelmRelease
46494649- up to the last successfully completed release.
46504650- items:
46514651- description: |-
46524652- Snapshot captures a point-in-time copy of the status information for a Helm release,
46534653- as managed by the controller.
44354435+ upgrade:
44364436+ description:
44374437+ Upgrade holds the configuration for Helm upgrade actions
44384438+ for this HelmRelease.
46544439 properties:
46554655- action:
46564656- description: Action is the action that resulted in this snapshot
46574657- being created.
44404440+ cleanupOnFail:
44414441+ description: |-
44424442+ CleanupOnFail allows deletion of new resources created during the Helm
44434443+ upgrade action when it fails.
44444444+ type: boolean
44454445+ crds:
44464446+ description: |-
44474447+ CRDs upgrade CRDs from the Helm Chart's crds directory according
44484448+ to the CRD upgrade policy provided here. Valid values are `Skip`,
44494449+ `Create` or `CreateReplace`. Default is `Skip` and if omitted
44504450+ CRDs are neither installed nor upgraded.
44514451+44524452+ Skip: do neither install nor replace (update) any CRDs.
44534453+44544454+ Create: new CRDs are created, existing CRDs are neither updated nor deleted.
44554455+44564456+ CreateReplace: new CRDs are created, existing CRDs are updated (replaced)
44574457+ but not deleted.
44584458+44594459+ By default, CRDs are not applied during Helm upgrade action. With this
44604460+ option users can opt-in to CRD upgrade, which is not (yet) natively supported by Helm.
44614461+ https://helm.sh/docs/chart_best_practices/custom_resource_definitions.
44624462+ enum:
44634463+ - Skip
44644464+ - Create
44654465+ - CreateReplace
46584466 type: string
46594659- apiVersion:
44674467+ disableHooks:
44684468+ description:
44694469+ DisableHooks prevents hooks from running during the
44704470+ Helm upgrade action.
44714471+ type: boolean
44724472+ disableOpenAPIValidation:
44734473+ description: |-
44744474+ DisableOpenAPIValidation prevents the Helm upgrade action from validating
44754475+ rendered templates against the Kubernetes OpenAPI Schema.
44764476+ type: boolean
44774477+ disableSchemaValidation:
44784478+ description: |-
44794479+ DisableSchemaValidation prevents the Helm upgrade action from validating
44804480+ the values against the JSON Schema.
44814481+ type: boolean
44824482+ disableTakeOwnership:
44834483+ description: |-
44844484+ DisableTakeOwnership disables taking ownership of existing resources
44854485+ during the Helm upgrade action. Defaults to false.
44864486+ type: boolean
44874487+ disableWait:
44884488+ description: |-
44894489+ DisableWait disables the waiting for resources to be ready after a Helm
44904490+ upgrade has been performed.
44914491+ type: boolean
44924492+ disableWaitForJobs:
46604493 description: |-
46614661- APIVersion is the API version of the Snapshot.
46624662- When the calculation method of the Digest field is changed, this
46634663- field will be used to distinguish between the old and new methods.
46644664- type: string
46654665- appVersion:
46664666- description: AppVersion is the chart app version of the release
46674667- object in storage.
46684668- type: string
46694669- chartName:
46704670- description: ChartName is the chart name of the release object
46714671- in storage.
46724672- type: string
46734673- chartVersion:
44944494+ DisableWaitForJobs disables waiting for jobs to complete after a Helm
44954495+ upgrade has been performed.
44964496+ type: boolean
44974497+ force:
44984498+ description: |-
44994499+ Force forces resource updates through a replacement strategy
45004500+ that avoids 3-way merge conflicts on client-side apply.
45014501+ This field is ignored for server-side apply (which always
45024502+ forces conflicts with other field managers).
45034503+ type: boolean
45044504+ preserveValues:
45054505+ description: |-
45064506+ PreserveValues will make Helm reuse the last release's values and merge in
45074507+ overrides from 'Values'. Setting this flag makes the HelmRelease
45084508+ non-declarative.
45094509+ type: boolean
45104510+ remediation:
45114511+ description: |-
45124512+ Remediation holds the remediation configuration for when the Helm upgrade
45134513+ action for the HelmRelease fails. The default is to not perform any action.
45144514+ properties:
45154515+ ignoreTestFailures:
45164516+ description: |-
45174517+ IgnoreTestFailures tells the controller to skip remediation when the Helm
45184518+ tests are run after an upgrade action but fail.
45194519+ Defaults to 'Test.IgnoreFailures'.
45204520+ type: boolean
45214521+ remediateLastFailure:
45224522+ description: |-
45234523+ RemediateLastFailure tells the controller to remediate the last failure, when
45244524+ no retries remain. Defaults to 'false' unless 'Retries' is greater than 0.
45254525+ type: boolean
45264526+ retries:
45274527+ description: |-
45284528+ Retries is the number of retries that should be attempted on failures before
45294529+ bailing. Remediation, using 'Strategy', is performed between each attempt.
45304530+ Defaults to '0', a negative integer equals to unlimited retries.
45314531+ type: integer
45324532+ strategy:
45334533+ description:
45344534+ Strategy to use for failure remediation. Defaults
45354535+ to 'rollback'.
45364536+ enum:
45374537+ - rollback
45384538+ - uninstall
45394539+ type: string
45404540+ type: object
45414541+ serverSideApply:
46744542 description: |-
46754675- ChartVersion is the chart version of the release object in
46764676- storage.
45434543+ ServerSideApply enables server-side apply for resources during upgrade.
45444544+ Can be "enabled", "disabled", or "auto".
45454545+ When "auto", server-side apply usage will be based on the release's previous usage.
45464546+ Defaults to "auto".
45474547+ enum:
45484548+ - enabled
45494549+ - disabled
45504550+ - auto
46774551 type: string
46784678- configDigest:
45524552+ strategy:
46794553 description: |-
46804680- ConfigDigest is the checksum of the config (better known as
46814681- "values") of the release object in storage.
46824682- It has the format of `<algo>:<checksum>`.
46834683- type: string
46844684- deleted:
46854685- description: Deleted is when the release was deleted.
46864686- format: date-time
46874687- type: string
46884688- digest:
45544554+ Strategy defines the upgrade strategy to use for this HelmRelease.
45554555+ Defaults to 'RemediateOnFailure', or 'RetryOnFailure' when the
45564556+ DefaultToRetryOnFailure feature gate is enabled.
45574557+ properties:
45584558+ name:
45594559+ description: Name of the upgrade strategy.
45604560+ enum:
45614561+ - RemediateOnFailure
45624562+ - RetryOnFailure
45634563+ type: string
45644564+ retryInterval:
45654565+ description: |-
45664566+ RetryInterval is the interval at which to retry a failed upgrade.
45674567+ Can be used only when Name is set to RetryOnFailure.
45684568+ Defaults to '5m'.
45694569+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
45704570+ type: string
45714571+ required:
45724572+ - name
45734573+ type: object
45744574+ x-kubernetes-validations:
45754575+ - message: .retryInterval can only be set when .name is 'RetryOnFailure'
45764576+ rule: "!has(self.retryInterval) || self.name == 'RetryOnFailure'"
45774577+ timeout:
46894578 description: |-
46904690- Digest is the checksum of the release object in storage.
46914691- It has the format of `<algo>:<checksum>`.
45794579+ Timeout is the time to wait for any individual Kubernetes operation (like
45804580+ Jobs for hooks) during the performance of a Helm upgrade action. Defaults to
45814581+ 'HelmReleaseSpec.Timeout'.
45824582+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
46924583 type: string
46934693- firstDeployed:
46944694- description: FirstDeployed is when the release was first deployed.
46954695- format: date-time
46964696- type: string
46974697- lastDeployed:
46984698- description: LastDeployed is when the release was last deployed.
46994699- format: date-time
47004700- type: string
45844584+ type: object
45854585+ values:
45864586+ description: Values holds the values for this Helm release.
45874587+ x-kubernetes-preserve-unknown-fields: true
45884588+ valuesFrom:
45894589+ description: |-
45904590+ ValuesFrom holds references to resources containing Helm values for this HelmRelease,
45914591+ and information about how they should be merged.
45924592+ items:
45934593+ description: |-
45944594+ ValuesReference contains a reference to a resource containing Helm values,
45954595+ and optionally the key they can be found at.
45964596+ properties:
45974597+ kind:
45984598+ description:
45994599+ Kind of the values referent, valid values are ('Secret',
46004600+ 'ConfigMap').
46014601+ enum:
46024602+ - Secret
46034603+ - ConfigMap
46044604+ type: string
46054605+ name:
46064606+ description: |-
46074607+ Name of the values referent. Should reside in the same namespace as the
46084608+ referring resource.
46094609+ maxLength: 253
46104610+ minLength: 1
46114611+ type: string
46124612+ optional:
46134613+ description: |-
46144614+ Optional marks this ValuesReference as optional. When set, a not found error
46154615+ for the values reference is ignored, but any ValuesKey, TargetPath or
46164616+ transient error will still result in a reconciliation failure.
46174617+ type: boolean
46184618+ targetPath:
46194619+ description: |-
46204620+ TargetPath is the YAML dot notation path the value should be merged at. When
46214621+ set, the ValuesKey is expected to be a single flat value. Defaults to 'None',
46224622+ which results in the values getting merged at the root.
46234623+ maxLength: 250
46244624+ pattern: ^([a-zA-Z0-9_\-.\\\/]|\[[0-9]{1,5}\])+$
46254625+ type: string
46264626+ valuesKey:
46274627+ description: |-
46284628+ ValuesKey is the data key where the values.yaml or a specific value can be
46294629+ found at. Defaults to 'values.yaml'.
46304630+ maxLength: 253
46314631+ pattern: ^[\-._a-zA-Z0-9]+$
46324632+ type: string
46334633+ required:
46344634+ - kind
46354635+ - name
46364636+ type: object
46374637+ type: array
46384638+ waitStrategy:
46394639+ description: |-
46404640+ WaitStrategy defines Helm's wait strategy for waiting for applied
46414641+ resources to become ready.
46424642+ properties:
47014643 name:
47024702- description: Name is the name of the release.
46444644+ description: |-
46454645+ Name is Helm's wait strategy for waiting for applied resources to
46464646+ become ready. One of 'poller' or 'legacy'. The 'poller' strategy uses
46474647+ kstatus to poll resource statuses, while the 'legacy' strategy uses
46484648+ Helm v3's waiting logic.
46494649+ Defaults to 'poller', or to 'legacy' when UseHelm3Defaults feature
46504650+ gate is enabled.
46514651+ enum:
46524652+ - poller
46534653+ - legacy
47034654 type: string
47044704- namespace:
47054705- description: Namespace is the namespace the release is deployed
47064706- to.
47074707- type: string
47084708- ociDigest:
47094709- description: OCIDigest is the digest of the OCI artifact associated
47104710- with the release.
47114711- type: string
47124712- status:
47134713- description: Status is the current state of the release.
47144714- type: string
47154715- testHooks:
47164716- additionalProperties:
46554655+ required:
46564656+ - name
46574657+ type: object
46584658+ required:
46594659+ - interval
46604660+ type: object
46614661+ x-kubernetes-validations:
46624662+ - message: either chart or chartRef must be set
46634663+ rule:
46644664+ (has(self.chart) && !has(self.chartRef)) || (!has(self.chart)
46654665+ && has(self.chartRef))
46664666+ status:
46674667+ default:
46684668+ observedGeneration: -1
46694669+ description: HelmReleaseStatus defines the observed state of a HelmRelease.
46704670+ properties:
46714671+ conditions:
46724672+ description: Conditions holds the conditions for the HelmRelease.
46734673+ items:
46744674+ description:
46754675+ Condition contains details for one aspect of the current
46764676+ state of this API Resource.
46774677+ properties:
46784678+ lastTransitionTime:
47174679 description: |-
47184718- TestHookStatus holds the status information for a test hook as observed
47194719- to be run by the controller.
46804680+ lastTransitionTime is the last time the condition transitioned from one status to another.
46814681+ This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
46824682+ format: date-time
46834683+ type: string
46844684+ message:
46854685+ description: |-
46864686+ message is a human readable message indicating details about the transition.
46874687+ This may be an empty string.
46884688+ maxLength: 32768
46894689+ type: string
46904690+ observedGeneration:
46914691+ description: |-
46924692+ observedGeneration represents the .metadata.generation that the condition was set based upon.
46934693+ For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
46944694+ with respect to the current state of the instance.
46954695+ format: int64
46964696+ minimum: 0
46974697+ type: integer
46984698+ reason:
46994699+ description: |-
47004700+ reason contains a programmatic identifier indicating the reason for the condition's last transition.
47014701+ Producers of specific condition types may define expected values and meanings for this field,
47024702+ and whether the values are considered a guaranteed API.
47034703+ The value should be a CamelCase string.
47044704+ This field may not be empty.
47054705+ maxLength: 1024
47064706+ minLength: 1
47074707+ pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
47084708+ type: string
47094709+ status:
47104710+ description: status of the condition, one of True, False, Unknown.
47114711+ enum:
47124712+ - "True"
47134713+ - "False"
47144714+ - Unknown
47154715+ type: string
47164716+ type:
47174717+ description: type of condition in CamelCase or in foo.example.com/CamelCase.
47184718+ maxLength: 316
47194719+ 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])$
47204720+ type: string
47214721+ required:
47224722+ - lastTransitionTime
47234723+ - message
47244724+ - reason
47254725+ - status
47264726+ - type
47274727+ type: object
47284728+ type: array
47294729+ failures:
47304730+ description: |-
47314731+ Failures is the reconciliation failure count against the latest desired
47324732+ state. It is reset after a successful reconciliation.
47334733+ format: int64
47344734+ type: integer
47354735+ helmChart:
47364736+ description: |-
47374737+ HelmChart is the namespaced name of the HelmChart resource created by
47384738+ the controller for the HelmRelease.
47394739+ type: string
47404740+ history:
47414741+ description: |-
47424742+ History holds the history of Helm releases performed for this HelmRelease
47434743+ up to the last successfully completed release.
47444744+ items:
47454745+ description: |-
47464746+ Snapshot captures a point-in-time copy of the status information for a Helm release,
47474747+ as managed by the controller.
47484748+ properties:
47494749+ action:
47504750+ description:
47514751+ Action is the action that resulted in this snapshot
47524752+ being created.
47534753+ type: string
47544754+ apiVersion:
47554755+ description: |-
47564756+ APIVersion is the API version of the Snapshot.
47574757+ When the calculation method of the Digest field is changed, this
47584758+ field will be used to distinguish between the old and new methods.
47594759+ type: string
47604760+ appVersion:
47614761+ description:
47624762+ AppVersion is the chart app version of the release
47634763+ object in storage.
47644764+ type: string
47654765+ chartName:
47664766+ description:
47674767+ ChartName is the chart name of the release object
47684768+ in storage.
47694769+ type: string
47704770+ chartVersion:
47714771+ description: |-
47724772+ ChartVersion is the chart version of the release object in
47734773+ storage.
47744774+ type: string
47754775+ configDigest:
47764776+ description: |-
47774777+ ConfigDigest is the checksum of the config (better known as
47784778+ "values") of the release object in storage.
47794779+ It has the format of `<algo>:<checksum>`.
47804780+ type: string
47814781+ deleted:
47824782+ description: Deleted is when the release was deleted.
47834783+ format: date-time
47844784+ type: string
47854785+ digest:
47864786+ description: |-
47874787+ Digest is the checksum of the release object in storage.
47884788+ It has the format of `<algo>:<checksum>`.
47894789+ type: string
47904790+ firstDeployed:
47914791+ description: FirstDeployed is when the release was first deployed.
47924792+ format: date-time
47934793+ type: string
47944794+ lastDeployed:
47954795+ description: LastDeployed is when the release was last deployed.
47964796+ format: date-time
47974797+ type: string
47984798+ name:
47994799+ description: Name is the name of the release.
48004800+ type: string
48014801+ namespace:
48024802+ description:
48034803+ Namespace is the namespace the release is deployed
48044804+ to.
48054805+ type: string
48064806+ ociDigest:
48074807+ description:
48084808+ OCIDigest is the digest of the OCI artifact associated
48094809+ with the release.
48104810+ type: string
48114811+ status:
48124812+ description: Status is the current state of the release.
48134813+ type: string
48144814+ testHooks:
48154815+ additionalProperties:
48164816+ description: |-
48174817+ TestHookStatus holds the status information for a test hook as observed
48184818+ to be run by the controller.
48194819+ properties:
48204820+ lastCompleted:
48214821+ description:
48224822+ LastCompleted is the time the test hook last
48234823+ completed.
48244824+ format: date-time
48254825+ type: string
48264826+ lastStarted:
48274827+ description:
48284828+ LastStarted is the time the test hook was
48294829+ last started.
48304830+ format: date-time
48314831+ type: string
48324832+ phase:
48334833+ description: Phase the test hook was observed to be in.
48344834+ type: string
48354835+ type: object
48364836+ description: |-
48374837+ TestHooks is the list of test hooks for the release as observed to be
48384838+ run by the controller.
48394839+ type: object
48404840+ version:
48414841+ description:
48424842+ Version is the version of the release object in
48434843+ storage.
48444844+ type: integer
48454845+ required:
48464846+ - chartName
48474847+ - chartVersion
48484848+ - configDigest
48494849+ - digest
48504850+ - firstDeployed
48514851+ - lastDeployed
48524852+ - name
48534853+ - namespace
48544854+ - status
48554855+ - version
48564856+ type: object
48574857+ type: array
48584858+ installFailures:
48594859+ description: |-
48604860+ InstallFailures is the install failure count against the latest desired
48614861+ state. It is reset after a successful reconciliation.
48624862+ format: int64
48634863+ type: integer
48644864+ inventory:
48654865+ description: |-
48664866+ Inventory contains the list of Kubernetes resource object references
48674867+ that have been applied for this release.
48684868+ properties:
48694869+ entries:
48704870+ description: Entries of Kubernetes resource object references.
48714871+ items:
48724872+ description:
48734873+ ResourceRef contains the information necessary
48744874+ to locate a resource within a cluster.
47204875 properties:
47214721- lastCompleted:
47224722- description: LastCompleted is the time the test hook last
47234723- completed.
47244724- format: date-time
48764876+ id:
48774877+ description: |-
48784878+ ID is the string representation of the Kubernetes resource object's metadata,
48794879+ in the format '<namespace>_<name>_<group>_<kind>'.
47254880 type: string
47264726- lastStarted:
47274727- description: LastStarted is the time the test hook was
47284728- last started.
47294729- format: date-time
47304730- type: string
47314731- phase:
47324732- description: Phase the test hook was observed to be in.
48814881+ v:
48824882+ description:
48834883+ Version is the API version of the Kubernetes
48844884+ resource object's kind.
47334885 type: string
48864886+ required:
48874887+ - id
48884888+ - v
47344889 type: object
47354735- description: |-
47364736- TestHooks is the list of test hooks for the release as observed to be
47374737- run by the controller.
47384738- type: object
47394739- version:
47404740- description: Version is the version of the release object in
47414741- storage.
47424742- type: integer
48904890+ type: array
47434891 required:
47444744- - chartName
47454745- - chartVersion
47464746- - configDigest
47474747- - digest
47484748- - firstDeployed
47494749- - lastDeployed
47504750- - name
47514751- - namespace
47524752- - status
47534753- - version
48924892+ - entries
47544893 type: object
47554755- type: array
47564756- installFailures:
47574757- description: |-
47584758- InstallFailures is the install failure count against the latest desired
47594759- state. It is reset after a successful reconciliation.
47604760- format: int64
47614761- type: integer
47624762- inventory:
47634763- description: |-
47644764- Inventory contains the list of Kubernetes resource object references
47654765- that have been applied for this release.
47664766- properties:
47674767- entries:
47684768- description: Entries of Kubernetes resource object references.
47694769- items:
47704770- description: ResourceRef contains the information necessary
47714771- to locate a resource within a cluster.
47724772- properties:
47734773- id:
47744774- description: |-
47754775- ID is the string representation of the Kubernetes resource object's metadata,
47764776- in the format '<namespace>_<name>_<group>_<kind>'.
47774777- type: string
47784778- v:
47794779- description: Version is the API version of the Kubernetes
47804780- resource object's kind.
47814781- type: string
47824782- required:
47834783- - id
47844784- - v
47854785- type: object
47864786- type: array
47874787- required:
47884788- - entries
47894789- type: object
47904790- lastAttemptedConfigDigest:
47914791- description: |-
47924792- LastAttemptedConfigDigest is the digest for the config (better known as
47934793- "values") of the last reconciliation attempt.
47944794- type: string
47954795- lastAttemptedGeneration:
47964796- description: |-
47974797- LastAttemptedGeneration is the last generation the controller attempted
47984798- to reconcile.
47994799- format: int64
48004800- type: integer
48014801- lastAttemptedReleaseAction:
48024802- description: |-
48034803- LastAttemptedReleaseAction is the last release action performed for this
48044804- HelmRelease. It is used to determine the active retry or remediation
48054805- strategy.
48064806- enum:
48074807- - install
48084808- - upgrade
48094809- type: string
48104810- lastAttemptedReleaseActionDuration:
48114811- description: |-
48124812- LastAttemptedReleaseActionDuration is the duration of the last
48134813- release action performed for this HelmRelease.
48144814- type: string
48154815- lastAttemptedRevision:
48164816- description: |-
48174817- LastAttemptedRevision is the Source revision of the last reconciliation
48184818- attempt. For OCIRepository sources, the 12 first characters of the digest are
48194819- appended to the chart version e.g. "1.2.3+1234567890ab".
48204820- type: string
48214821- lastAttemptedRevisionDigest:
48224822- description: |-
48234823- LastAttemptedRevisionDigest is the digest of the last reconciliation attempt.
48244824- This is only set for OCIRepository sources.
48254825- type: string
48264826- lastAttemptedValuesChecksum:
48274827- description: |-
48284828- LastAttemptedValuesChecksum is the SHA1 checksum for the values of the last
48294829- reconciliation attempt.
48944894+ lastAttemptedConfigDigest:
48954895+ description: |-
48964896+ LastAttemptedConfigDigest is the digest for the config (better known as
48974897+ "values") of the last reconciliation attempt.
48984898+ type: string
48994899+ lastAttemptedGeneration:
49004900+ description: |-
49014901+ LastAttemptedGeneration is the last generation the controller attempted
49024902+ to reconcile.
49034903+ format: int64
49044904+ type: integer
49054905+ lastAttemptedReleaseAction:
49064906+ description: |-
49074907+ LastAttemptedReleaseAction is the last release action performed for this
49084908+ HelmRelease. It is used to determine the active retry or remediation
49094909+ strategy.
49104910+ enum:
49114911+ - install
49124912+ - upgrade
49134913+ type: string
49144914+ lastAttemptedReleaseActionDuration:
49154915+ description: |-
49164916+ LastAttemptedReleaseActionDuration is the duration of the last
49174917+ release action performed for this HelmRelease.
49184918+ type: string
49194919+ lastAttemptedRevision:
49204920+ description: |-
49214921+ LastAttemptedRevision is the Source revision of the last reconciliation
49224922+ attempt. For OCIRepository sources, the 12 first characters of the digest are
49234923+ appended to the chart version e.g. "1.2.3+1234567890ab".
49244924+ type: string
49254925+ lastAttemptedRevisionDigest:
49264926+ description: |-
49274927+ LastAttemptedRevisionDigest is the digest of the last reconciliation attempt.
49284928+ This is only set for OCIRepository sources.
49294929+ type: string
49304930+ lastAttemptedValuesChecksum:
49314931+ description: |-
49324932+ LastAttemptedValuesChecksum is the SHA1 checksum for the values of the last
49334933+ reconciliation attempt.
4830493448314831- Deprecated: Use LastAttemptedConfigDigest instead.
48324832- type: string
48334833- lastHandledForceAt:
48344834- description: |-
48354835- LastHandledForceAt holds the value of the most recent
48364836- force request value, so a change of the annotation value
48374837- can be detected.
48384838- type: string
48394839- lastHandledReconcileAt:
48404840- description: |-
48414841- LastHandledReconcileAt holds the value of the most recent
48424842- reconcile request value, so a change of the annotation value
48434843- can be detected.
48444844- type: string
48454845- lastHandledResetAt:
48464846- description: |-
48474847- LastHandledResetAt holds the value of the most recent reset request
48484848- value, so a change of the annotation value can be detected.
48494849- type: string
48504850- lastReleaseRevision:
48514851- description: |-
48524852- LastReleaseRevision is the revision of the last successful Helm release.
49354935+ Deprecated: Use LastAttemptedConfigDigest instead.
49364936+ type: string
49374937+ lastHandledForceAt:
49384938+ description: |-
49394939+ LastHandledForceAt holds the value of the most recent
49404940+ force request value, so a change of the annotation value
49414941+ can be detected.
49424942+ type: string
49434943+ lastHandledReconcileAt:
49444944+ description: |-
49454945+ LastHandledReconcileAt holds the value of the most recent
49464946+ reconcile request value, so a change of the annotation value
49474947+ can be detected.
49484948+ type: string
49494949+ lastHandledResetAt:
49504950+ description: |-
49514951+ LastHandledResetAt holds the value of the most recent reset request
49524952+ value, so a change of the annotation value can be detected.
49534953+ type: string
49544954+ lastReleaseRevision:
49554955+ description: |-
49564956+ LastReleaseRevision is the revision of the last successful Helm release.
4853495748544854- Deprecated: Use History instead.
48554855- type: integer
48564856- observedCommonMetadataDigest:
48574857- description: |-
48584858- ObservedCommonMetadataDigest is the digest for the common metadata of
48594859- the last successful reconciliation attempt.
48604860- type: string
48614861- observedGeneration:
48624862- description: ObservedGeneration is the last observed generation.
48634863- format: int64
48644864- type: integer
48654865- observedPostRenderersDigest:
48664866- description: |-
48674867- ObservedPostRenderersDigest is the digest for the post-renderers of
48684868- the last successful reconciliation attempt.
48694869- type: string
48704870- storageNamespace:
48714871- description: |-
48724872- StorageNamespace is the namespace of the Helm release storage for the
48734873- current release.
48744874- maxLength: 63
48754875- minLength: 1
48764876- type: string
48774877- upgradeFailures:
48784878- description: |-
48794879- UpgradeFailures is the upgrade failure count against the latest desired
48804880- state. It is reset after a successful reconciliation.
48814881- format: int64
48824882- type: integer
48834883- type: object
48844884- type: object
48854885- served: true
48864886- storage: true
48874887- subresources:
48884888- status: {}
49584958+ Deprecated: Use History instead.
49594959+ type: integer
49604960+ observedCommonMetadataDigest:
49614961+ description: |-
49624962+ ObservedCommonMetadataDigest is the digest for the common metadata of
49634963+ the last successful reconciliation attempt.
49644964+ type: string
49654965+ observedGeneration:
49664966+ description: ObservedGeneration is the last observed generation.
49674967+ format: int64
49684968+ type: integer
49694969+ observedPostRenderersDigest:
49704970+ description: |-
49714971+ ObservedPostRenderersDigest is the digest for the post-renderers of
49724972+ the last successful reconciliation attempt.
49734973+ type: string
49744974+ storageNamespace:
49754975+ description: |-
49764976+ StorageNamespace is the namespace of the Helm release storage for the
49774977+ current release.
49784978+ maxLength: 63
49794979+ minLength: 1
49804980+ type: string
49814981+ upgradeFailures:
49824982+ description: |-
49834983+ UpgradeFailures is the upgrade failure count against the latest desired
49844984+ state. It is reset after a successful reconciliation.
49854985+ format: int64
49864986+ type: integer
49874987+ type: object
49884988+ type: object
49894989+ served: true
49904990+ storage: true
49914991+ subresources:
49924992+ status: {}
48894993---
48904994apiVersion: v1
48914995kind: ServiceAccount
···49275031 app.kubernetes.io/version: v2.8.8
49285032 spec:
49295033 containers:
49304930- - args:
49314931- - --events-addr=http://notification-controller.$(RUNTIME_NAMESPACE).svc.cluster.local./
49324932- - --watch-all-namespaces=true
49334933- - --log-level=info
49344934- - --log-encoding=json
49354935- - --enable-leader-election
49364936- env:
49374937- - name: RUNTIME_NAMESPACE
49384938- valueFrom:
49394939- fieldRef:
49404940- fieldPath: metadata.namespace
49414941- - name: GOMEMLIMIT
49424942- valueFrom:
49434943- resourceFieldRef:
49444944- containerName: manager
49454945- resource: limits.memory
49464946- image: ghcr.io/fluxcd/helm-controller:v1.5.5
49474947- imagePullPolicy: IfNotPresent
49484948- livenessProbe:
49494949- httpGet:
49504950- path: /healthz
49514951- port: healthz
49524952- name: manager
49534953- ports:
49544954- - containerPort: 8080
49554955- name: http-prom
49564956- protocol: TCP
49574957- - containerPort: 9440
49584958- name: healthz
49594959- protocol: TCP
49604960- readinessProbe:
49614961- httpGet:
49624962- path: /readyz
49634963- port: healthz
49644964- resources:
49654965- limits:
49664966- cpu: 1000m
49674967- memory: 1Gi
49684968- requests:
49694969- cpu: 100m
49704970- memory: 64Mi
49714971- securityContext:
49724972- allowPrivilegeEscalation: false
49734973- capabilities:
49744974- drop:
49754975- - ALL
49764976- readOnlyRootFilesystem: true
49774977- runAsNonRoot: true
49784978- seccompProfile:
49794979- type: RuntimeDefault
49804980- volumeMounts:
49814981- - mountPath: /tmp
49824982- name: temp
50345034+ - args:
50355035+ - --events-addr=http://notification-controller.$(RUNTIME_NAMESPACE).svc.cluster.local./
50365036+ - --watch-all-namespaces=true
50375037+ - --log-level=info
50385038+ - --log-encoding=json
50395039+ - --enable-leader-election
50405040+ env:
50415041+ - name: RUNTIME_NAMESPACE
50425042+ valueFrom:
50435043+ fieldRef:
50445044+ fieldPath: metadata.namespace
50455045+ - name: GOMEMLIMIT
50465046+ valueFrom:
50475047+ resourceFieldRef:
50485048+ containerName: manager
50495049+ resource: limits.memory
50505050+ image: ghcr.io/fluxcd/helm-controller:v1.5.5
50515051+ imagePullPolicy: IfNotPresent
50525052+ livenessProbe:
50535053+ httpGet:
50545054+ path: /healthz
50555055+ port: healthz
50565056+ name: manager
50575057+ ports:
50585058+ - containerPort: 8080
50595059+ name: http-prom
50605060+ protocol: TCP
50615061+ - containerPort: 9440
50625062+ name: healthz
50635063+ protocol: TCP
50645064+ readinessProbe:
50655065+ httpGet:
50665066+ path: /readyz
50675067+ port: healthz
50685068+ resources:
50695069+ limits:
50705070+ cpu: 1000m
50715071+ memory: 1Gi
50725072+ requests:
50735073+ cpu: 100m
50745074+ memory: 64Mi
50755075+ securityContext:
50765076+ allowPrivilegeEscalation: false
50775077+ capabilities:
50785078+ drop:
50795079+ - ALL
50805080+ readOnlyRootFilesystem: true
50815081+ runAsNonRoot: true
50825082+ seccompProfile:
50835083+ type: RuntimeDefault
50845084+ volumeMounts:
50855085+ - mountPath: /tmp
50865086+ name: temp
49835087 nodeSelector:
49845088 kubernetes.io/os: linux
49855089 priorityClassName: system-cluster-critical
···49885092 serviceAccountName: helm-controller
49895093 terminationGracePeriodSeconds: 600
49905094 volumes:
49914991- - emptyDir: {}
49924992- name: temp
50955095+ - emptyDir: {}
50965096+ name: temp
49935097---
49945098apiVersion: apiextensions.k8s.io/v1
49955099kind: CustomResourceDefinition
···50115115 singular: alert
50125116 scope: Namespaced
50135117 versions:
50145014- - additionalPrinterColumns:
50155015- - jsonPath: .metadata.creationTimestamp
50165016- name: Age
50175017- type: date
50185018- - jsonPath: .status.conditions[?(@.type=="Ready")].status
50195019- name: Ready
50205020- type: string
50215021- - jsonPath: .status.conditions[?(@.type=="Ready")].message
50225022- name: Status
50235023- type: string
50245024- deprecated: true
50255025- deprecationWarning: v1beta2 Alert is deprecated, upgrade to v1beta3
50265026- name: v1beta2
50275027- schema:
50285028- openAPIV3Schema:
50295029- description: Alert is the Schema for the alerts API
50305030- properties:
50315031- apiVersion:
50325032- description: |-
50335033- APIVersion defines the versioned schema of this representation of an object.
50345034- Servers should convert recognized schemas to the latest internal value, and
50355035- may reject unrecognized values.
50365036- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
50375037- type: string
50385038- kind:
50395039- description: |-
50405040- Kind is a string value representing the REST resource this object represents.
50415041- Servers may infer this from the endpoint the client submits requests to.
50425042- Cannot be updated.
50435043- In CamelCase.
50445044- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
50455045- type: string
50465046- metadata:
50475047- type: object
50485048- spec:
50495049- description: AlertSpec defines an alerting rule for events involving a
50505050- list of objects.
50515051- properties:
50525052- eventMetadata:
50535053- additionalProperties:
51185118+ - additionalPrinterColumns:
51195119+ - jsonPath: .metadata.creationTimestamp
51205120+ name: Age
51215121+ type: date
51225122+ - jsonPath: .status.conditions[?(@.type=="Ready")].status
51235123+ name: Ready
51245124+ type: string
51255125+ - jsonPath: .status.conditions[?(@.type=="Ready")].message
51265126+ name: Status
51275127+ type: string
51285128+ deprecated: true
51295129+ deprecationWarning: v1beta2 Alert is deprecated, upgrade to v1beta3
51305130+ name: v1beta2
51315131+ schema:
51325132+ openAPIV3Schema:
51335133+ description: Alert is the Schema for the alerts API
51345134+ properties:
51355135+ apiVersion:
51365136+ description: |-
51375137+ APIVersion defines the versioned schema of this representation of an object.
51385138+ Servers should convert recognized schemas to the latest internal value, and
51395139+ may reject unrecognized values.
51405140+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
51415141+ type: string
51425142+ kind:
51435143+ description: |-
51445144+ Kind is a string value representing the REST resource this object represents.
51455145+ Servers may infer this from the endpoint the client submits requests to.
51465146+ Cannot be updated.
51475147+ In CamelCase.
51485148+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
51495149+ type: string
51505150+ metadata:
51515151+ type: object
51525152+ spec:
51535153+ description:
51545154+ AlertSpec defines an alerting rule for events involving a
51555155+ list of objects.
51565156+ properties:
51575157+ eventMetadata:
51585158+ additionalProperties:
51595159+ type: string
51605160+ description: |-
51615161+ EventMetadata is an optional field for adding metadata to events dispatched by the
51625162+ controller. This can be used for enhancing the context of the event. If a field
51635163+ would override one already present on the original event as generated by the emitter,
51645164+ then the override doesn't happen, i.e. the original value is preserved, and an info
51655165+ log is printed.
51665166+ type: object
51675167+ eventSeverity:
51685168+ default: info
51695169+ description: |-
51705170+ EventSeverity specifies how to filter events based on severity.
51715171+ If set to 'info' no events will be filtered.
51725172+ enum:
51735173+ - info
51745174+ - error
50545175 type: string
50555055- description: |-
50565056- EventMetadata is an optional field for adding metadata to events dispatched by the
50575057- controller. This can be used for enhancing the context of the event. If a field
50585058- would override one already present on the original event as generated by the emitter,
50595059- then the override doesn't happen, i.e. the original value is preserved, and an info
50605060- log is printed.
50615061- type: object
50625062- eventSeverity:
50635063- default: info
50645064- description: |-
50655065- EventSeverity specifies how to filter events based on severity.
50665066- If set to 'info' no events will be filtered.
50675067- enum:
50685068- - info
50695069- - error
50705070- type: string
50715071- eventSources:
50725072- description: |-
50735073- EventSources specifies how to filter events based
50745074- on the involved object kind, name and namespace.
50755075- items:
51765176+ eventSources:
51775177+ description: |-
51785178+ EventSources specifies how to filter events based
51795179+ on the involved object kind, name and namespace.
51805180+ items:
51815181+ description: |-
51825182+ CrossNamespaceObjectReference contains enough information to let you locate the
51835183+ typed referenced object at cluster level
51845184+ properties:
51855185+ apiVersion:
51865186+ description: API version of the referent
51875187+ type: string
51885188+ kind:
51895189+ description: Kind of the referent
51905190+ enum:
51915191+ - Bucket
51925192+ - GitRepository
51935193+ - Kustomization
51945194+ - HelmRelease
51955195+ - HelmChart
51965196+ - HelmRepository
51975197+ - ImageRepository
51985198+ - ImagePolicy
51995199+ - ImageUpdateAutomation
52005200+ - OCIRepository
52015201+ - ArtifactGenerator
52025202+ - ExternalArtifact
52035203+ type: string
52045204+ matchLabels:
52055205+ additionalProperties:
52065206+ type: string
52075207+ description: |-
52085208+ MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
52095209+ map is equivalent to an element of matchExpressions, whose key field is "key", the
52105210+ operator is "In", and the values array contains only "value". The requirements are ANDed.
52115211+ MatchLabels requires the name to be set to `*`.
52125212+ type: object
52135213+ name:
52145214+ description: |-
52155215+ Name of the referent
52165216+ If multiple resources are targeted `*` may be set.
52175217+ maxLength: 253
52185218+ minLength: 1
52195219+ type: string
52205220+ namespace:
52215221+ description: Namespace of the referent
52225222+ maxLength: 253
52235223+ minLength: 1
52245224+ type: string
52255225+ required:
52265226+ - kind
52275227+ - name
52285228+ type: object
52295229+ type: array
52305230+ exclusionList:
52315231+ description: |-
52325232+ ExclusionList specifies a list of Golang regular expressions
52335233+ to be used for excluding messages.
52345234+ items:
52355235+ type: string
52365236+ type: array
52375237+ inclusionList:
50765238 description: |-
50775077- CrossNamespaceObjectReference contains enough information to let you locate the
50785078- typed referenced object at cluster level
52395239+ InclusionList specifies a list of Golang regular expressions
52405240+ to be used for including messages.
52415241+ items:
52425242+ type: string
52435243+ type: array
52445244+ providerRef:
52455245+ description:
52465246+ ProviderRef specifies which Provider this Alert should
52475247+ use.
50795248 properties:
50805080- apiVersion:
50815081- description: API version of the referent
50825082- type: string
50835083- kind:
50845084- description: Kind of the referent
50855085- enum:
50865086- - Bucket
50875087- - GitRepository
50885088- - Kustomization
50895089- - HelmRelease
50905090- - HelmChart
50915091- - HelmRepository
50925092- - ImageRepository
50935093- - ImagePolicy
50945094- - ImageUpdateAutomation
50955095- - OCIRepository
50965096- - ArtifactGenerator
50975097- - ExternalArtifact
50985098- type: string
50995099- matchLabels:
51005100- additionalProperties:
51015101- type: string
51025102- description: |-
51035103- MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
51045104- map is equivalent to an element of matchExpressions, whose key field is "key", the
51055105- operator is "In", and the values array contains only "value". The requirements are ANDed.
51065106- MatchLabels requires the name to be set to `*`.
51075107- type: object
51085249 name:
51095109- description: |-
51105110- Name of the referent
51115111- If multiple resources are targeted `*` may be set.
51125112- maxLength: 253
51135113- minLength: 1
51145114- type: string
51155115- namespace:
51165116- description: Namespace of the referent
51175117- maxLength: 253
51185118- minLength: 1
52505250+ description: Name of the referent.
51195251 type: string
51205252 required:
51215121- - kind
51225122- - name
52535253+ - name
51235254 type: object
51245124- type: array
51255125- exclusionList:
51265126- description: |-
51275127- ExclusionList specifies a list of Golang regular expressions
51285128- to be used for excluding messages.
51295129- items:
52555255+ summary:
52565256+ description:
52575257+ Summary holds a short description of the impact and affected
52585258+ cluster.
52595259+ maxLength: 255
51305260 type: string
51315131- type: array
51325132- inclusionList:
51335133- description: |-
51345134- InclusionList specifies a list of Golang regular expressions
51355135- to be used for including messages.
51365136- items:
52615261+ suspend:
52625262+ description: |-
52635263+ Suspend tells the controller to suspend subsequent
52645264+ events handling for this Alert.
52655265+ type: boolean
52665266+ required:
52675267+ - eventSources
52685268+ - providerRef
52695269+ type: object
52705270+ status:
52715271+ default:
52725272+ observedGeneration: -1
52735273+ description: AlertStatus defines the observed state of the Alert.
52745274+ properties:
52755275+ conditions:
52765276+ description: Conditions holds the conditions for the Alert.
52775277+ items:
52785278+ description:
52795279+ Condition contains details for one aspect of the current
52805280+ state of this API Resource.
52815281+ properties:
52825282+ lastTransitionTime:
52835283+ description: |-
52845284+ lastTransitionTime is the last time the condition transitioned from one status to another.
52855285+ This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
52865286+ format: date-time
52875287+ type: string
52885288+ message:
52895289+ description: |-
52905290+ message is a human readable message indicating details about the transition.
52915291+ This may be an empty string.
52925292+ maxLength: 32768
52935293+ type: string
52945294+ observedGeneration:
52955295+ description: |-
52965296+ observedGeneration represents the .metadata.generation that the condition was set based upon.
52975297+ For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
52985298+ with respect to the current state of the instance.
52995299+ format: int64
53005300+ minimum: 0
53015301+ type: integer
53025302+ reason:
53035303+ description: |-
53045304+ reason contains a programmatic identifier indicating the reason for the condition's last transition.
53055305+ Producers of specific condition types may define expected values and meanings for this field,
53065306+ and whether the values are considered a guaranteed API.
53075307+ The value should be a CamelCase string.
53085308+ This field may not be empty.
53095309+ maxLength: 1024
53105310+ minLength: 1
53115311+ pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
53125312+ type: string
53135313+ status:
53145314+ description: status of the condition, one of True, False, Unknown.
53155315+ enum:
53165316+ - "True"
53175317+ - "False"
53185318+ - Unknown
53195319+ type: string
53205320+ type:
53215321+ description: type of condition in CamelCase or in foo.example.com/CamelCase.
53225322+ maxLength: 316
53235323+ 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])$
53245324+ type: string
53255325+ required:
53265326+ - lastTransitionTime
53275327+ - message
53285328+ - reason
53295329+ - status
53305330+ - type
53315331+ type: object
53325332+ type: array
53335333+ lastHandledReconcileAt:
53345334+ description: |-
53355335+ LastHandledReconcileAt holds the value of the most recent
53365336+ reconcile request value, so a change of the annotation value
53375337+ can be detected.
51375338 type: string
51385138- type: array
51395139- providerRef:
51405140- description: ProviderRef specifies which Provider this Alert should
51415141- use.
51425142- properties:
51435143- name:
51445144- description: Name of the referent.
53395339+ observedGeneration:
53405340+ description: ObservedGeneration is the last observed generation.
53415341+ format: int64
53425342+ type: integer
53435343+ type: object
53445344+ type: object
53455345+ served: true
53465346+ storage: false
53475347+ subresources:
53485348+ status: {}
53495349+ - additionalPrinterColumns:
53505350+ - jsonPath: .metadata.creationTimestamp
53515351+ name: Age
53525352+ type: date
53535353+ name: v1beta3
53545354+ schema:
53555355+ openAPIV3Schema:
53565356+ description: Alert is the Schema for the alerts API
53575357+ properties:
53585358+ apiVersion:
53595359+ description: |-
53605360+ APIVersion defines the versioned schema of this representation of an object.
53615361+ Servers should convert recognized schemas to the latest internal value, and
53625362+ may reject unrecognized values.
53635363+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
53645364+ type: string
53655365+ kind:
53665366+ description: |-
53675367+ Kind is a string value representing the REST resource this object represents.
53685368+ Servers may infer this from the endpoint the client submits requests to.
53695369+ Cannot be updated.
53705370+ In CamelCase.
53715371+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
53725372+ type: string
53735373+ metadata:
53745374+ type: object
53755375+ spec:
53765376+ description:
53775377+ AlertSpec defines an alerting rule for events involving a
53785378+ list of objects.
53795379+ properties:
53805380+ eventMetadata:
53815381+ additionalProperties:
51455382 type: string
51465146- required:
51475147- - name
51485148- type: object
51495149- summary:
51505150- description: Summary holds a short description of the impact and affected
51515151- cluster.
51525152- maxLength: 255
51535153- type: string
51545154- suspend:
51555155- description: |-
51565156- Suspend tells the controller to suspend subsequent
51575157- events handling for this Alert.
51585158- type: boolean
51595159- required:
51605160- - eventSources
51615161- - providerRef
51625162- type: object
51635163- status:
51645164- default:
51655165- observedGeneration: -1
51665166- description: AlertStatus defines the observed state of the Alert.
51675167- properties:
51685168- conditions:
51695169- description: Conditions holds the conditions for the Alert.
51705170- items:
51715171- description: Condition contains details for one aspect of the current
51725172- state of this API Resource.
51735173- properties:
51745174- lastTransitionTime:
51755175- description: |-
51765176- lastTransitionTime is the last time the condition transitioned from one status to another.
51775177- This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
51785178- format: date-time
51795179- type: string
51805180- message:
51815181- description: |-
51825182- message is a human readable message indicating details about the transition.
51835183- This may be an empty string.
51845184- maxLength: 32768
51855185- type: string
51865186- observedGeneration:
51875187- description: |-
51885188- observedGeneration represents the .metadata.generation that the condition was set based upon.
51895189- For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
51905190- with respect to the current state of the instance.
51915191- format: int64
51925192- minimum: 0
51935193- type: integer
51945194- reason:
51955195- description: |-
51965196- reason contains a programmatic identifier indicating the reason for the condition's last transition.
51975197- Producers of specific condition types may define expected values and meanings for this field,
51985198- and whether the values are considered a guaranteed API.
51995199- The value should be a CamelCase string.
52005200- This field may not be empty.
52015201- maxLength: 1024
52025202- minLength: 1
52035203- pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
52045204- type: string
52055205- status:
52065206- description: status of the condition, one of True, False, Unknown.
52075207- enum:
52085208- - "True"
52095209- - "False"
52105210- - Unknown
52115211- type: string
52125212- type:
52135213- description: type of condition in CamelCase or in foo.example.com/CamelCase.
52145214- maxLength: 316
52155215- 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])$
52165216- type: string
52175217- required:
52185218- - lastTransitionTime
52195219- - message
52205220- - reason
52215221- - status
52225222- - type
53835383+ description: |-
53845384+ EventMetadata is an optional field for adding metadata to events dispatched by the
53855385+ controller. This can be used for enhancing the context of the event. If a field
53865386+ would override one already present on the original event as generated by the emitter,
53875387+ then the override doesn't happen, i.e. the original value is preserved, and an info
53885388+ log is printed.
52235389 type: object
52245224- type: array
52255225- lastHandledReconcileAt:
52265226- description: |-
52275227- LastHandledReconcileAt holds the value of the most recent
52285228- reconcile request value, so a change of the annotation value
52295229- can be detected.
52305230- type: string
52315231- observedGeneration:
52325232- description: ObservedGeneration is the last observed generation.
52335233- format: int64
52345234- type: integer
52355235- type: object
52365236- type: object
52375237- served: true
52385238- storage: false
52395239- subresources:
52405240- status: {}
52415241- - additionalPrinterColumns:
52425242- - jsonPath: .metadata.creationTimestamp
52435243- name: Age
52445244- type: date
52455245- name: v1beta3
52465246- schema:
52475247- openAPIV3Schema:
52485248- description: Alert is the Schema for the alerts API
52495249- properties:
52505250- apiVersion:
52515251- description: |-
52525252- APIVersion defines the versioned schema of this representation of an object.
52535253- Servers should convert recognized schemas to the latest internal value, and
52545254- may reject unrecognized values.
52555255- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
52565256- type: string
52575257- kind:
52585258- description: |-
52595259- Kind is a string value representing the REST resource this object represents.
52605260- Servers may infer this from the endpoint the client submits requests to.
52615261- Cannot be updated.
52625262- In CamelCase.
52635263- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
52645264- type: string
52655265- metadata:
52665266- type: object
52675267- spec:
52685268- description: AlertSpec defines an alerting rule for events involving a
52695269- list of objects.
52705270- properties:
52715271- eventMetadata:
52725272- additionalProperties:
53905390+ eventSeverity:
53915391+ default: info
53925392+ description: |-
53935393+ EventSeverity specifies how to filter events based on severity.
53945394+ If set to 'info' no events will be filtered.
53955395+ enum:
53965396+ - info
53975397+ - error
52735398 type: string
52745274- description: |-
52755275- EventMetadata is an optional field for adding metadata to events dispatched by the
52765276- controller. This can be used for enhancing the context of the event. If a field
52775277- would override one already present on the original event as generated by the emitter,
52785278- then the override doesn't happen, i.e. the original value is preserved, and an info
52795279- log is printed.
52805280- type: object
52815281- eventSeverity:
52825282- default: info
52835283- description: |-
52845284- EventSeverity specifies how to filter events based on severity.
52855285- If set to 'info' no events will be filtered.
52865286- enum:
52875287- - info
52885288- - error
52895289- type: string
52905290- eventSources:
52915291- description: |-
52925292- EventSources specifies how to filter events based
52935293- on the involved object kind, name and namespace.
52945294- items:
53995399+ eventSources:
54005400+ description: |-
54015401+ EventSources specifies how to filter events based
54025402+ on the involved object kind, name and namespace.
54035403+ items:
54045404+ description: |-
54055405+ CrossNamespaceObjectReference contains enough information to let you locate the
54065406+ typed referenced object at cluster level
54075407+ properties:
54085408+ apiVersion:
54095409+ description: API version of the referent
54105410+ type: string
54115411+ kind:
54125412+ description: Kind of the referent
54135413+ enum:
54145414+ - Bucket
54155415+ - GitRepository
54165416+ - Kustomization
54175417+ - HelmRelease
54185418+ - HelmChart
54195419+ - HelmRepository
54205420+ - ImageRepository
54215421+ - ImagePolicy
54225422+ - ImageUpdateAutomation
54235423+ - OCIRepository
54245424+ - ArtifactGenerator
54255425+ - ExternalArtifact
54265426+ type: string
54275427+ matchLabels:
54285428+ additionalProperties:
54295429+ type: string
54305430+ description: |-
54315431+ MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
54325432+ map is equivalent to an element of matchExpressions, whose key field is "key", the
54335433+ operator is "In", and the values array contains only "value". The requirements are ANDed.
54345434+ MatchLabels requires the name to be set to `*`.
54355435+ type: object
54365436+ name:
54375437+ description: |-
54385438+ Name of the referent
54395439+ If multiple resources are targeted `*` may be set.
54405440+ maxLength: 253
54415441+ minLength: 1
54425442+ type: string
54435443+ namespace:
54445444+ description: Namespace of the referent
54455445+ maxLength: 253
54465446+ minLength: 1
54475447+ type: string
54485448+ required:
54495449+ - kind
54505450+ - name
54515451+ type: object
54525452+ type: array
54535453+ exclusionList:
52955454 description: |-
52965296- CrossNamespaceObjectReference contains enough information to let you locate the
52975297- typed referenced object at cluster level
54555455+ ExclusionList specifies a list of Golang regular expressions
54565456+ to be used for excluding messages.
54575457+ items:
54585458+ type: string
54595459+ type: array
54605460+ inclusionList:
54615461+ description: |-
54625462+ InclusionList specifies a list of Golang regular expressions
54635463+ to be used for including messages.
54645464+ items:
54655465+ type: string
54665466+ type: array
54675467+ providerRef:
54685468+ description:
54695469+ ProviderRef specifies which Provider this Alert should
54705470+ use.
52985471 properties:
52995299- apiVersion:
53005300- description: API version of the referent
53015301- type: string
53025302- kind:
53035303- description: Kind of the referent
53045304- enum:
53055305- - Bucket
53065306- - GitRepository
53075307- - Kustomization
53085308- - HelmRelease
53095309- - HelmChart
53105310- - HelmRepository
53115311- - ImageRepository
53125312- - ImagePolicy
53135313- - ImageUpdateAutomation
53145314- - OCIRepository
53155315- - ArtifactGenerator
53165316- - ExternalArtifact
53175317- type: string
53185318- matchLabels:
53195319- additionalProperties:
53205320- type: string
53215321- description: |-
53225322- MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
53235323- map is equivalent to an element of matchExpressions, whose key field is "key", the
53245324- operator is "In", and the values array contains only "value". The requirements are ANDed.
53255325- MatchLabels requires the name to be set to `*`.
53265326- type: object
53275472 name:
53285328- description: |-
53295329- Name of the referent
53305330- If multiple resources are targeted `*` may be set.
53315331- maxLength: 253
53325332- minLength: 1
53335333- type: string
53345334- namespace:
53355335- description: Namespace of the referent
53365336- maxLength: 253
53375337- minLength: 1
54735473+ description: Name of the referent.
53385474 type: string
53395475 required:
53405340- - kind
53415341- - name
54765476+ - name
53425477 type: object
53435343- type: array
53445344- exclusionList:
53455345- description: |-
53465346- ExclusionList specifies a list of Golang regular expressions
53475347- to be used for excluding messages.
53485348- items:
53495349- type: string
53505350- type: array
53515351- inclusionList:
53525352- description: |-
53535353- InclusionList specifies a list of Golang regular expressions
53545354- to be used for including messages.
53555355- items:
54785478+ summary:
54795479+ description: |-
54805480+ Summary holds a short description of the impact and affected cluster.
54815481+ Deprecated: Use EventMetadata instead.
54825482+ maxLength: 255
53565483 type: string
53575357- type: array
53585358- providerRef:
53595359- description: ProviderRef specifies which Provider this Alert should
53605360- use.
53615361- properties:
53625362- name:
53635363- description: Name of the referent.
53645364- type: string
53655365- required:
53665366- - name
53675367- type: object
53685368- summary:
53695369- description: |-
53705370- Summary holds a short description of the impact and affected cluster.
53715371- Deprecated: Use EventMetadata instead.
53725372- maxLength: 255
53735373- type: string
53745374- suspend:
53755375- description: |-
53765376- Suspend tells the controller to suspend subsequent
53775377- events handling for this Alert.
53785378- type: boolean
53795379- required:
53805380- - eventSources
53815381- - providerRef
53825382- type: object
53835383- type: object
53845384- served: true
53855385- storage: true
53865386- subresources: {}
54845484+ suspend:
54855485+ description: |-
54865486+ Suspend tells the controller to suspend subsequent
54875487+ events handling for this Alert.
54885488+ type: boolean
54895489+ required:
54905490+ - eventSources
54915491+ - providerRef
54925492+ type: object
54935493+ type: object
54945494+ served: true
54955495+ storage: true
54965496+ subresources: {}
53875497---
53885498apiVersion: apiextensions.k8s.io/v1
53895499kind: CustomResourceDefinition
···54055515 singular: provider
54065516 scope: Namespaced
54075517 versions:
54085408- - additionalPrinterColumns:
54095409- - jsonPath: .metadata.creationTimestamp
54105410- name: Age
54115411- type: date
54125412- - jsonPath: .status.conditions[?(@.type=="Ready")].status
54135413- name: Ready
54145414- type: string
54155415- - jsonPath: .status.conditions[?(@.type=="Ready")].message
54165416- name: Status
54175417- type: string
54185418- deprecated: true
54195419- deprecationWarning: v1beta2 Provider is deprecated, upgrade to v1beta3
54205420- name: v1beta2
54215421- schema:
54225422- openAPIV3Schema:
54235423- description: Provider is the Schema for the providers API.
54245424- properties:
54255425- apiVersion:
54265426- description: |-
54275427- APIVersion defines the versioned schema of this representation of an object.
54285428- Servers should convert recognized schemas to the latest internal value, and
54295429- may reject unrecognized values.
54305430- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
54315431- type: string
54325432- kind:
54335433- description: |-
54345434- Kind is a string value representing the REST resource this object represents.
54355435- Servers may infer this from the endpoint the client submits requests to.
54365436- Cannot be updated.
54375437- In CamelCase.
54385438- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
54395439- type: string
54405440- metadata:
54415441- type: object
54425442- spec:
54435443- description: ProviderSpec defines the desired state of the Provider.
54445444- properties:
54455445- address:
54465446- description: |-
54475447- Address specifies the endpoint, in a generic sense, to where alerts are sent.
54485448- What kind of endpoint depends on the specific Provider type being used.
54495449- For the generic Provider, for example, this is an HTTP/S address.
54505450- For other Provider types this could be a project ID or a namespace.
54515451- maxLength: 2048
54525452- type: string
54535453- certSecretRef:
54545454- description: |-
54555455- CertSecretRef specifies the Secret containing
54565456- a PEM-encoded CA certificate (in the `ca.crt` key).
55185518+ - additionalPrinterColumns:
55195519+ - jsonPath: .metadata.creationTimestamp
55205520+ name: Age
55215521+ type: date
55225522+ - jsonPath: .status.conditions[?(@.type=="Ready")].status
55235523+ name: Ready
55245524+ type: string
55255525+ - jsonPath: .status.conditions[?(@.type=="Ready")].message
55265526+ name: Status
55275527+ type: string
55285528+ deprecated: true
55295529+ deprecationWarning: v1beta2 Provider is deprecated, upgrade to v1beta3
55305530+ name: v1beta2
55315531+ schema:
55325532+ openAPIV3Schema:
55335533+ description: Provider is the Schema for the providers API.
55345534+ properties:
55355535+ apiVersion:
55365536+ description: |-
55375537+ APIVersion defines the versioned schema of this representation of an object.
55385538+ Servers should convert recognized schemas to the latest internal value, and
55395539+ may reject unrecognized values.
55405540+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
55415541+ type: string
55425542+ kind:
55435543+ description: |-
55445544+ Kind is a string value representing the REST resource this object represents.
55455545+ Servers may infer this from the endpoint the client submits requests to.
55465546+ Cannot be updated.
55475547+ In CamelCase.
55485548+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
55495549+ type: string
55505550+ metadata:
55515551+ type: object
55525552+ spec:
55535553+ description: ProviderSpec defines the desired state of the Provider.
55545554+ properties:
55555555+ address:
55565556+ description: |-
55575557+ Address specifies the endpoint, in a generic sense, to where alerts are sent.
55585558+ What kind of endpoint depends on the specific Provider type being used.
55595559+ For the generic Provider, for example, this is an HTTP/S address.
55605560+ For other Provider types this could be a project ID or a namespace.
55615561+ maxLength: 2048
55625562+ type: string
55635563+ certSecretRef:
55645564+ description: |-
55655565+ CertSecretRef specifies the Secret containing
55665566+ a PEM-encoded CA certificate (in the `ca.crt` key).
5457556754585458- Note: Support for the `caFile` key has
54595459- been deprecated.
54605460- properties:
54615461- name:
54625462- description: Name of the referent.
54635463- type: string
54645464- required:
54655465- - name
54665466- type: object
54675467- channel:
54685468- description: Channel specifies the destination channel where events
54695469- should be posted.
54705470- maxLength: 2048
54715471- type: string
54725472- interval:
54735473- description: Interval at which to reconcile the Provider with its
54745474- Secret references.
54755475- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
54765476- type: string
54775477- proxy:
54785478- description: Proxy the HTTP/S address of the proxy server.
54795479- maxLength: 2048
54805480- pattern: ^(http|https)://.*$
54815481- type: string
54825482- secretRef:
54835483- description: |-
54845484- SecretRef specifies the Secret containing the authentication
54855485- credentials for this Provider.
54865486- properties:
54875487- name:
54885488- description: Name of the referent.
54895489- type: string
54905490- required:
54915491- - name
54925492- type: object
54935493- suspend:
54945494- description: |-
54955495- Suspend tells the controller to suspend subsequent
54965496- events handling for this Provider.
54975497- type: boolean
54985498- timeout:
54995499- description: Timeout for sending alerts to the Provider.
55005500- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m))+$
55015501- type: string
55025502- type:
55035503- description: Type specifies which Provider implementation to use.
55045504- enum:
55055505- - slack
55065506- - discord
55075507- - msteams
55085508- - rocket
55095509- - generic
55105510- - generic-hmac
55115511- - github
55125512- - gitlab
55135513- - gitea
55145514- - bitbucketserver
55155515- - bitbucket
55165516- - azuredevops
55175517- - googlechat
55185518- - googlepubsub
55195519- - webex
55205520- - sentry
55215521- - azureeventhub
55225522- - telegram
55235523- - lark
55245524- - matrix
55255525- - opsgenie
55265526- - alertmanager
55275527- - grafana
55285528- - githubdispatch
55295529- - pagerduty
55305530- - datadog
55315531- type: string
55325532- username:
55335533- description: Username specifies the name under which events are posted.
55345534- maxLength: 2048
55355535- type: string
55365536- required:
55375537- - type
55385538- type: object
55395539- status:
55405540- default:
55415541- observedGeneration: -1
55425542- description: ProviderStatus defines the observed state of the Provider.
55435543- properties:
55445544- conditions:
55455545- description: Conditions holds the conditions for the Provider.
55465546- items:
55475547- description: Condition contains details for one aspect of the current
55485548- state of this API Resource.
55685568+ Note: Support for the `caFile` key has
55695569+ been deprecated.
55495570 properties:
55505550- lastTransitionTime:
55515551- description: |-
55525552- lastTransitionTime is the last time the condition transitioned from one status to another.
55535553- This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
55545554- format: date-time
55715571+ name:
55725572+ description: Name of the referent.
55555573 type: string
55565556- message:
55575557- description: |-
55585558- message is a human readable message indicating details about the transition.
55595559- This may be an empty string.
55605560- maxLength: 32768
55745574+ required:
55755575+ - name
55765576+ type: object
55775577+ channel:
55785578+ description:
55795579+ Channel specifies the destination channel where events
55805580+ should be posted.
55815581+ maxLength: 2048
55825582+ type: string
55835583+ interval:
55845584+ description:
55855585+ Interval at which to reconcile the Provider with its
55865586+ Secret references.
55875587+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
55885588+ type: string
55895589+ proxy:
55905590+ description: Proxy the HTTP/S address of the proxy server.
55915591+ maxLength: 2048
55925592+ pattern: ^(http|https)://.*$
55935593+ type: string
55945594+ secretRef:
55955595+ description: |-
55965596+ SecretRef specifies the Secret containing the authentication
55975597+ credentials for this Provider.
55985598+ properties:
55995599+ name:
56005600+ description: Name of the referent.
55615601 type: string
55625562- observedGeneration:
55635563- description: |-
55645564- observedGeneration represents the .metadata.generation that the condition was set based upon.
55655565- For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
55665566- with respect to the current state of the instance.
55675567- format: int64
55685568- minimum: 0
55695569- type: integer
55705570- reason:
55715571- description: |-
55725572- reason contains a programmatic identifier indicating the reason for the condition's last transition.
55735573- Producers of specific condition types may define expected values and meanings for this field,
55745574- and whether the values are considered a guaranteed API.
55755575- The value should be a CamelCase string.
55765576- This field may not be empty.
55775577- maxLength: 1024
55785578- minLength: 1
55795579- pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
56025602+ required:
56035603+ - name
56045604+ type: object
56055605+ suspend:
56065606+ description: |-
56075607+ Suspend tells the controller to suspend subsequent
56085608+ events handling for this Provider.
56095609+ type: boolean
56105610+ timeout:
56115611+ description: Timeout for sending alerts to the Provider.
56125612+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m))+$
56135613+ type: string
56145614+ type:
56155615+ description: Type specifies which Provider implementation to use.
56165616+ enum:
56175617+ - slack
56185618+ - discord
56195619+ - msteams
56205620+ - rocket
56215621+ - generic
56225622+ - generic-hmac
56235623+ - github
56245624+ - gitlab
56255625+ - gitea
56265626+ - bitbucketserver
56275627+ - bitbucket
56285628+ - azuredevops
56295629+ - googlechat
56305630+ - googlepubsub
56315631+ - webex
56325632+ - sentry
56335633+ - azureeventhub
56345634+ - telegram
56355635+ - lark
56365636+ - matrix
56375637+ - opsgenie
56385638+ - alertmanager
56395639+ - grafana
56405640+ - githubdispatch
56415641+ - pagerduty
56425642+ - datadog
56435643+ type: string
56445644+ username:
56455645+ description: Username specifies the name under which events are posted.
56465646+ maxLength: 2048
56475647+ type: string
56485648+ required:
56495649+ - type
56505650+ type: object
56515651+ status:
56525652+ default:
56535653+ observedGeneration: -1
56545654+ description: ProviderStatus defines the observed state of the Provider.
56555655+ properties:
56565656+ conditions:
56575657+ description: Conditions holds the conditions for the Provider.
56585658+ items:
56595659+ description:
56605660+ Condition contains details for one aspect of the current
56615661+ state of this API Resource.
56625662+ properties:
56635663+ lastTransitionTime:
56645664+ description: |-
56655665+ lastTransitionTime is the last time the condition transitioned from one status to another.
56665666+ This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
56675667+ format: date-time
56685668+ type: string
56695669+ message:
56705670+ description: |-
56715671+ message is a human readable message indicating details about the transition.
56725672+ This may be an empty string.
56735673+ maxLength: 32768
56745674+ type: string
56755675+ observedGeneration:
56765676+ description: |-
56775677+ observedGeneration represents the .metadata.generation that the condition was set based upon.
56785678+ For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
56795679+ with respect to the current state of the instance.
56805680+ format: int64
56815681+ minimum: 0
56825682+ type: integer
56835683+ reason:
56845684+ description: |-
56855685+ reason contains a programmatic identifier indicating the reason for the condition's last transition.
56865686+ Producers of specific condition types may define expected values and meanings for this field,
56875687+ and whether the values are considered a guaranteed API.
56885688+ The value should be a CamelCase string.
56895689+ This field may not be empty.
56905690+ maxLength: 1024
56915691+ minLength: 1
56925692+ pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
56935693+ type: string
56945694+ status:
56955695+ description: status of the condition, one of True, False, Unknown.
56965696+ enum:
56975697+ - "True"
56985698+ - "False"
56995699+ - Unknown
57005700+ type: string
57015701+ type:
57025702+ description: type of condition in CamelCase or in foo.example.com/CamelCase.
57035703+ maxLength: 316
57045704+ 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])$
57055705+ type: string
57065706+ required:
57075707+ - lastTransitionTime
57085708+ - message
57095709+ - reason
57105710+ - status
57115711+ - type
57125712+ type: object
57135713+ type: array
57145714+ lastHandledReconcileAt:
57155715+ description: |-
57165716+ LastHandledReconcileAt holds the value of the most recent
57175717+ reconcile request value, so a change of the annotation value
57185718+ can be detected.
57195719+ type: string
57205720+ observedGeneration:
57215721+ description: ObservedGeneration is the last reconciled generation.
57225722+ format: int64
57235723+ type: integer
57245724+ type: object
57255725+ type: object
57265726+ served: true
57275727+ storage: false
57285728+ subresources:
57295729+ status: {}
57305730+ - additionalPrinterColumns:
57315731+ - jsonPath: .metadata.creationTimestamp
57325732+ name: Age
57335733+ type: date
57345734+ name: v1beta3
57355735+ schema:
57365736+ openAPIV3Schema:
57375737+ description: Provider is the Schema for the providers API
57385738+ properties:
57395739+ apiVersion:
57405740+ description: |-
57415741+ APIVersion defines the versioned schema of this representation of an object.
57425742+ Servers should convert recognized schemas to the latest internal value, and
57435743+ may reject unrecognized values.
57445744+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
57455745+ type: string
57465746+ kind:
57475747+ description: |-
57485748+ Kind is a string value representing the REST resource this object represents.
57495749+ Servers may infer this from the endpoint the client submits requests to.
57505750+ Cannot be updated.
57515751+ In CamelCase.
57525752+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
57535753+ type: string
57545754+ metadata:
57555755+ type: object
57565756+ spec:
57575757+ description: ProviderSpec defines the desired state of the Provider.
57585758+ properties:
57595759+ address:
57605760+ description: |-
57615761+ Address specifies the endpoint, in a generic sense, to where alerts are sent.
57625762+ What kind of endpoint depends on the specific Provider type being used.
57635763+ For the generic Provider, for example, this is an HTTP/S address.
57645764+ For other Provider types this could be a project ID or a namespace.
57655765+ maxLength: 2048
57665766+ type: string
57675767+ certSecretRef:
57685768+ description: |-
57695769+ CertSecretRef specifies the Secret containing TLS certificates
57705770+ for secure communication.
57715771+57725772+ Supported configurations:
57735773+ - CA-only: Server authentication (provide ca.crt only)
57745774+ - mTLS: Mutual authentication (provide ca.crt + tls.crt + tls.key)
57755775+ - Client-only: Client authentication with system CA (provide tls.crt + tls.key only)
57765776+57775777+ Legacy keys "caFile", "certFile", "keyFile" are supported but deprecated. Use "ca.crt", "tls.crt", "tls.key" instead.
57785778+ properties:
57795779+ name:
57805780+ description: Name of the referent.
55805781 type: string
55815581- status:
55825582- description: status of the condition, one of True, False, Unknown.
55835583- enum:
55845584- - "True"
55855585- - "False"
55865586- - Unknown
57825782+ required:
57835783+ - name
57845784+ type: object
57855785+ channel:
57865786+ description:
57875787+ Channel specifies the destination channel where events
57885788+ should be posted.
57895789+ maxLength: 2048
57905790+ type: string
57915791+ commitStatusExpr:
57925792+ description: |-
57935793+ CommitStatusExpr is a CEL expression that evaluates to a string value
57945794+ that can be used to generate a custom commit status message for use
57955795+ with eligible Provider types (github, gitlab, gitea, bitbucketserver,
57965796+ bitbucket, azuredevops). Supported variables are: event, provider,
57975797+ and alert.
57985798+ type: string
57995799+ interval:
58005800+ description: |-
58015801+ Interval at which to reconcile the Provider with its Secret references.
58025802+ Deprecated and not used in v1beta3.
58035803+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
58045804+ type: string
58055805+ proxy:
58065806+ description: |-
58075807+ Proxy the HTTP/S address of the proxy server.
58085808+ Deprecated: Use ProxySecretRef instead. Will be removed in v1.
58095809+ maxLength: 2048
58105810+ pattern: ^(http|https)://.*$
58115811+ type: string
58125812+ proxySecretRef:
58135813+ description: |-
58145814+ ProxySecretRef specifies the Secret containing the proxy configuration
58155815+ for this Provider. The Secret should contain an 'address' key with the
58165816+ HTTP/S address of the proxy server. Optional 'username' and 'password'
58175817+ keys can be provided for proxy authentication.
58185818+ properties:
58195819+ name:
58205820+ description: Name of the referent.
55875821 type: string
55885588- type:
55895589- description: type of condition in CamelCase or in foo.example.com/CamelCase.
55905590- maxLength: 316
55915591- 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])$
58225822+ required:
58235823+ - name
58245824+ type: object
58255825+ secretRef:
58265826+ description: |-
58275827+ SecretRef specifies the Secret containing the authentication
58285828+ credentials for this Provider.
58295829+ properties:
58305830+ name:
58315831+ description: Name of the referent.
55925832 type: string
55935833 required:
55945594- - lastTransitionTime
55955595- - message
55965596- - reason
55975597- - status
55985598- - type
58345834+ - name
55995835 type: object
56005600- type: array
56015601- lastHandledReconcileAt:
56025602- description: |-
56035603- LastHandledReconcileAt holds the value of the most recent
56045604- reconcile request value, so a change of the annotation value
56055605- can be detected.
56065606- type: string
56075607- observedGeneration:
56085608- description: ObservedGeneration is the last reconciled generation.
56095609- format: int64
56105610- type: integer
56115611- type: object
56125612- type: object
56135613- served: true
56145614- storage: false
56155615- subresources:
56165616- status: {}
56175617- - additionalPrinterColumns:
56185618- - jsonPath: .metadata.creationTimestamp
56195619- name: Age
56205620- type: date
56215621- name: v1beta3
56225622- schema:
56235623- openAPIV3Schema:
56245624- description: Provider is the Schema for the providers API
56255625- properties:
56265626- apiVersion:
56275627- description: |-
56285628- APIVersion defines the versioned schema of this representation of an object.
56295629- Servers should convert recognized schemas to the latest internal value, and
56305630- may reject unrecognized values.
56315631- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
56325632- type: string
56335633- kind:
56345634- description: |-
56355635- Kind is a string value representing the REST resource this object represents.
56365636- Servers may infer this from the endpoint the client submits requests to.
56375637- Cannot be updated.
56385638- In CamelCase.
56395639- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
56405640- type: string
56415641- metadata:
56425642- type: object
56435643- spec:
56445644- description: ProviderSpec defines the desired state of the Provider.
56455645- properties:
56465646- address:
56475647- description: |-
56485648- Address specifies the endpoint, in a generic sense, to where alerts are sent.
56495649- What kind of endpoint depends on the specific Provider type being used.
56505650- For the generic Provider, for example, this is an HTTP/S address.
56515651- For other Provider types this could be a project ID or a namespace.
56525652- maxLength: 2048
56535653- type: string
56545654- certSecretRef:
56555655- description: |-
56565656- CertSecretRef specifies the Secret containing TLS certificates
56575657- for secure communication.
56585658-56595659- Supported configurations:
56605660- - CA-only: Server authentication (provide ca.crt only)
56615661- - mTLS: Mutual authentication (provide ca.crt + tls.crt + tls.key)
56625662- - Client-only: Client authentication with system CA (provide tls.crt + tls.key only)
56635663-56645664- Legacy keys "caFile", "certFile", "keyFile" are supported but deprecated. Use "ca.crt", "tls.crt", "tls.key" instead.
56655665- properties:
56665666- name:
56675667- description: Name of the referent.
56685668- type: string
56695669- required:
56705670- - name
56715671- type: object
56725672- channel:
56735673- description: Channel specifies the destination channel where events
56745674- should be posted.
56755675- maxLength: 2048
56765676- type: string
56775677- commitStatusExpr:
56785678- description: |-
56795679- CommitStatusExpr is a CEL expression that evaluates to a string value
56805680- that can be used to generate a custom commit status message for use
56815681- with eligible Provider types (github, gitlab, gitea, bitbucketserver,
56825682- bitbucket, azuredevops). Supported variables are: event, provider,
56835683- and alert.
56845684- type: string
56855685- interval:
56865686- description: |-
56875687- Interval at which to reconcile the Provider with its Secret references.
56885688- Deprecated and not used in v1beta3.
56895689- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
56905690- type: string
56915691- proxy:
56925692- description: |-
56935693- Proxy the HTTP/S address of the proxy server.
56945694- Deprecated: Use ProxySecretRef instead. Will be removed in v1.
56955695- maxLength: 2048
56965696- pattern: ^(http|https)://.*$
56975697- type: string
56985698- proxySecretRef:
56995699- description: |-
57005700- ProxySecretRef specifies the Secret containing the proxy configuration
57015701- for this Provider. The Secret should contain an 'address' key with the
57025702- HTTP/S address of the proxy server. Optional 'username' and 'password'
57035703- keys can be provided for proxy authentication.
57045704- properties:
57055705- name:
57065706- description: Name of the referent.
57075707- type: string
57085708- required:
57095709- - name
57105710- type: object
57115711- secretRef:
57125712- description: |-
57135713- SecretRef specifies the Secret containing the authentication
57145714- credentials for this Provider.
57155715- properties:
57165716- name:
57175717- description: Name of the referent.
57185718- type: string
57195719- required:
57205720- - name
57215721- type: object
57225722- serviceAccountName:
57235723- description: |-
57245724- ServiceAccountName is the name of the Kubernetes ServiceAccount used to
57255725- authenticate with cloud provider services through workload identity.
57265726- This enables multi-tenant authentication without storing static credentials.
58365836+ serviceAccountName:
58375837+ description: |-
58385838+ ServiceAccountName is the name of the Kubernetes ServiceAccount used to
58395839+ authenticate with cloud provider services through workload identity.
58405840+ This enables multi-tenant authentication without storing static credentials.
5727584157285728- Supported provider types: azureeventhub, azuredevops, googlepubsub
58425842+ Supported provider types: azureeventhub, azuredevops, googlepubsub
5729584357305730- When specified, the controller will:
57315731- 1. Create an OIDC token for the specified ServiceAccount
57325732- 2. Exchange it for cloud provider credentials via STS
57335733- 3. Use the obtained credentials for API authentication
58445844+ When specified, the controller will:
58455845+ 1. Create an OIDC token for the specified ServiceAccount
58465846+ 2. Exchange it for cloud provider credentials via STS
58475847+ 3. Use the obtained credentials for API authentication
5734584857355735- When unspecified, controller-level authentication is used (single-tenant).
58495849+ When unspecified, controller-level authentication is used (single-tenant).
5736585057375737- An error is thrown if static credentials are also defined in SecretRef.
57385738- This field requires the ObjectLevelWorkloadIdentity feature gate to be enabled.
57395739- type: string
57405740- suspend:
57415741- description: |-
57425742- Suspend tells the controller to suspend subsequent
57435743- events handling for this Provider.
57445744- type: boolean
57455745- timeout:
57465746- description: Timeout for sending alerts to the Provider.
57475747- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m))+$
57485748- type: string
57495749- type:
57505750- description: Type specifies which Provider implementation to use.
57515751- enum:
57525752- - slack
57535753- - discord
57545754- - msteams
57555755- - rocket
57565756- - generic
57575757- - generic-hmac
57585758- - github
57595759- - gitlab
57605760- - gitea
57615761- - giteapullrequestcomment
57625762- - bitbucketserver
57635763- - bitbucket
57645764- - azuredevops
57655765- - googlechat
57665766- - googlepubsub
57675767- - webex
57685768- - sentry
57695769- - azureeventhub
57705770- - telegram
57715771- - lark
57725772- - matrix
57735773- - opsgenie
57745774- - alertmanager
57755775- - grafana
57765776- - githubdispatch
57775777- - githubpullrequestcomment
57785778- - gitlabmergerequestcomment
57795779- - pagerduty
57805780- - datadog
57815781- - nats
57825782- - zulip
57835783- - otel
57845784- type: string
57855785- username:
57865786- description: Username specifies the name under which events are posted.
57875787- maxLength: 2048
57885788- type: string
57895789- required:
57905790- - type
57915791- type: object
57925792- x-kubernetes-validations:
57935793- - message: spec.commitStatusExpr is only supported for the 'github', 'gitlab',
57945794- 'gitea', 'bitbucketserver', 'bitbucket', 'azuredevops' provider types
57955795- rule: self.type == 'github' || self.type == 'gitlab' || self.type ==
57965796- 'gitea' || self.type == 'bitbucketserver' || self.type == 'bitbucket'
57975797- || self.type == 'azuredevops' || !has(self.commitStatusExpr)
57985798- type: object
57995799- served: true
58005800- storage: true
58015801- subresources: {}
58515851+ An error is thrown if static credentials are also defined in SecretRef.
58525852+ This field requires the ObjectLevelWorkloadIdentity feature gate to be enabled.
58535853+ type: string
58545854+ suspend:
58555855+ description: |-
58565856+ Suspend tells the controller to suspend subsequent
58575857+ events handling for this Provider.
58585858+ type: boolean
58595859+ timeout:
58605860+ description: Timeout for sending alerts to the Provider.
58615861+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m))+$
58625862+ type: string
58635863+ type:
58645864+ description: Type specifies which Provider implementation to use.
58655865+ enum:
58665866+ - slack
58675867+ - discord
58685868+ - msteams
58695869+ - rocket
58705870+ - generic
58715871+ - generic-hmac
58725872+ - github
58735873+ - gitlab
58745874+ - gitea
58755875+ - giteapullrequestcomment
58765876+ - bitbucketserver
58775877+ - bitbucket
58785878+ - azuredevops
58795879+ - googlechat
58805880+ - googlepubsub
58815881+ - webex
58825882+ - sentry
58835883+ - azureeventhub
58845884+ - telegram
58855885+ - lark
58865886+ - matrix
58875887+ - opsgenie
58885888+ - alertmanager
58895889+ - grafana
58905890+ - githubdispatch
58915891+ - githubpullrequestcomment
58925892+ - gitlabmergerequestcomment
58935893+ - pagerduty
58945894+ - datadog
58955895+ - nats
58965896+ - zulip
58975897+ - otel
58985898+ type: string
58995899+ username:
59005900+ description: Username specifies the name under which events are posted.
59015901+ maxLength: 2048
59025902+ type: string
59035903+ required:
59045904+ - type
59055905+ type: object
59065906+ x-kubernetes-validations:
59075907+ - message:
59085908+ spec.commitStatusExpr is only supported for the 'github', 'gitlab',
59095909+ 'gitea', 'bitbucketserver', 'bitbucket', 'azuredevops' provider types
59105910+ rule:
59115911+ self.type == 'github' || self.type == 'gitlab' || self.type ==
59125912+ 'gitea' || self.type == 'bitbucketserver' || self.type == 'bitbucket'
59135913+ || self.type == 'azuredevops' || !has(self.commitStatusExpr)
59145914+ type: object
59155915+ served: true
59165916+ storage: true
59175917+ subresources: {}
58025918---
58035919apiVersion: apiextensions.k8s.io/v1
58045920kind: CustomResourceDefinition
···58205936 singular: receiver
58215937 scope: Namespaced
58225938 versions:
58235823- - additionalPrinterColumns:
58245824- - jsonPath: .metadata.creationTimestamp
58255825- name: Age
58265826- type: date
58275827- - jsonPath: .status.conditions[?(@.type=="Ready")].status
58285828- name: Ready
58295829- type: string
58305830- - jsonPath: .status.conditions[?(@.type=="Ready")].message
58315831- name: Status
58325832- type: string
58335833- name: v1
58345834- schema:
58355835- openAPIV3Schema:
58365836- description: Receiver is the Schema for the receivers API.
58375837- properties:
58385838- apiVersion:
58395839- description: |-
58405840- APIVersion defines the versioned schema of this representation of an object.
58415841- Servers should convert recognized schemas to the latest internal value, and
58425842- may reject unrecognized values.
58435843- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
58445844- type: string
58455845- kind:
58465846- description: |-
58475847- Kind is a string value representing the REST resource this object represents.
58485848- Servers may infer this from the endpoint the client submits requests to.
58495849- Cannot be updated.
58505850- In CamelCase.
58515851- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
58525852- type: string
58535853- metadata:
58545854- type: object
58555855- spec:
58565856- description: ReceiverSpec defines the desired state of the Receiver.
58575857- properties:
58585858- events:
58595859- description: |-
58605860- Events specifies the list of event types to handle,
58615861- e.g. 'push' for GitHub or 'Push Hook' for GitLab.
58625862- items:
59395939+ - additionalPrinterColumns:
59405940+ - jsonPath: .metadata.creationTimestamp
59415941+ name: Age
59425942+ type: date
59435943+ - jsonPath: .status.conditions[?(@.type=="Ready")].status
59445944+ name: Ready
59455945+ type: string
59465946+ - jsonPath: .status.conditions[?(@.type=="Ready")].message
59475947+ name: Status
59485948+ type: string
59495949+ name: v1
59505950+ schema:
59515951+ openAPIV3Schema:
59525952+ description: Receiver is the Schema for the receivers API.
59535953+ properties:
59545954+ apiVersion:
59555955+ description: |-
59565956+ APIVersion defines the versioned schema of this representation of an object.
59575957+ Servers should convert recognized schemas to the latest internal value, and
59585958+ may reject unrecognized values.
59595959+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
59605960+ type: string
59615961+ kind:
59625962+ description: |-
59635963+ Kind is a string value representing the REST resource this object represents.
59645964+ Servers may infer this from the endpoint the client submits requests to.
59655965+ Cannot be updated.
59665966+ In CamelCase.
59675967+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
59685968+ type: string
59695969+ metadata:
59705970+ type: object
59715971+ spec:
59725972+ description: ReceiverSpec defines the desired state of the Receiver.
59735973+ properties:
59745974+ events:
59755975+ description: |-
59765976+ Events specifies the list of event types to handle,
59775977+ e.g. 'push' for GitHub or 'Push Hook' for GitLab.
59785978+ items:
59795979+ type: string
59805980+ type: array
59815981+ interval:
59825982+ default: 10m
59835983+ description:
59845984+ Interval at which to reconcile the Receiver with its
59855985+ Secret references.
59865986+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
59875987+ type: string
59885988+ resourceFilter:
59895989+ description: |-
59905990+ ResourceFilter is a CEL expression expected to return a boolean that is
59915991+ evaluated for each resource referenced in the Resources field when a
59925992+ webhook is received. If the expression returns false then the controller
59935993+ will not request a reconciliation for the resource.
59945994+ When the expression is specified the controller will parse it and mark
59955995+ the object as terminally failed if the expression is invalid or does not
59965996+ return a boolean.
58635997 type: string
58645864- type: array
58655865- interval:
58665866- default: 10m
58675867- description: Interval at which to reconcile the Receiver with its
58685868- Secret references.
58695869- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
58705870- type: string
58715871- resourceFilter:
58725872- description: |-
58735873- ResourceFilter is a CEL expression expected to return a boolean that is
58745874- evaluated for each resource referenced in the Resources field when a
58755875- webhook is received. If the expression returns false then the controller
58765876- will not request a reconciliation for the resource.
58775877- When the expression is specified the controller will parse it and mark
58785878- the object as terminally failed if the expression is invalid or does not
58795879- return a boolean.
58805880- type: string
58815881- resources:
58825882- description: A list of resources to be notified about changes.
58835883- items:
59985998+ resources:
59995999+ description: A list of resources to be notified about changes.
60006000+ items:
60016001+ description: |-
60026002+ CrossNamespaceObjectReference contains enough information to let you locate the
60036003+ typed referenced object at cluster level
60046004+ properties:
60056005+ apiVersion:
60066006+ description: API version of the referent
60076007+ type: string
60086008+ kind:
60096009+ description: Kind of the referent
60106010+ enum:
60116011+ - Bucket
60126012+ - GitRepository
60136013+ - Kustomization
60146014+ - HelmRelease
60156015+ - HelmChart
60166016+ - HelmRepository
60176017+ - ImageRepository
60186018+ - ImagePolicy
60196019+ - ImageUpdateAutomation
60206020+ - OCIRepository
60216021+ - ArtifactGenerator
60226022+ - ExternalArtifact
60236023+ type: string
60246024+ matchLabels:
60256025+ additionalProperties:
60266026+ type: string
60276027+ description: |-
60286028+ MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
60296029+ map is equivalent to an element of matchExpressions, whose key field is "key", the
60306030+ operator is "In", and the values array contains only "value". The requirements are ANDed.
60316031+ MatchLabels requires the name to be set to `*`.
60326032+ type: object
60336033+ name:
60346034+ description: |-
60356035+ Name of the referent
60366036+ If multiple resources are targeted `*` may be set.
60376037+ maxLength: 253
60386038+ minLength: 1
60396039+ type: string
60406040+ namespace:
60416041+ description: Namespace of the referent
60426042+ maxLength: 253
60436043+ minLength: 1
60446044+ type: string
60456045+ required:
60466046+ - kind
60476047+ - name
60486048+ type: object
60496049+ type: array
60506050+ secretRef:
58846051 description: |-
58855885- CrossNamespaceObjectReference contains enough information to let you locate the
58865886- typed referenced object at cluster level
60526052+ SecretRef specifies the Secret containing the token used
60536053+ to validate the payload authenticity. The Secret must contain a 'token'
60546054+ key. For GCR receivers, the Secret must also contain an 'email' key
60556055+ with the IAM service account email configured on the Pub/Sub push
60566056+ subscription, and an 'audience' key with the expected OIDC token audience.
58876057 properties:
58885888- apiVersion:
58895889- description: API version of the referent
58905890- type: string
58915891- kind:
58925892- description: Kind of the referent
58935893- enum:
58945894- - Bucket
58955895- - GitRepository
58965896- - Kustomization
58975897- - HelmRelease
58985898- - HelmChart
58995899- - HelmRepository
59005900- - ImageRepository
59015901- - ImagePolicy
59025902- - ImageUpdateAutomation
59035903- - OCIRepository
59045904- - ArtifactGenerator
59055905- - ExternalArtifact
59065906- type: string
59075907- matchLabels:
59085908- additionalProperties:
59095909- type: string
59105910- description: |-
59115911- MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
59125912- map is equivalent to an element of matchExpressions, whose key field is "key", the
59135913- operator is "In", and the values array contains only "value". The requirements are ANDed.
59145914- MatchLabels requires the name to be set to `*`.
59155915- type: object
59166058 name:
59175917- description: |-
59185918- Name of the referent
59195919- If multiple resources are targeted `*` may be set.
59205920- maxLength: 253
59215921- minLength: 1
59225922- type: string
59235923- namespace:
59245924- description: Namespace of the referent
59255925- maxLength: 253
59265926- minLength: 1
60596059+ description: Name of the referent.
59276060 type: string
59286061 required:
59295929- - kind
59305930- - name
60626062+ - name
59316063 type: object
59325932- type: array
59335933- secretRef:
59345934- description: |-
59355935- SecretRef specifies the Secret containing the token used
59365936- to validate the payload authenticity. The Secret must contain a 'token'
59375937- key. For GCR receivers, the Secret must also contain an 'email' key
59385938- with the IAM service account email configured on the Pub/Sub push
59395939- subscription, and an 'audience' key with the expected OIDC token audience.
59405940- properties:
59415941- name:
59425942- description: Name of the referent.
60646064+ suspend:
60656065+ description: |-
60666066+ Suspend tells the controller to suspend subsequent
60676067+ events handling for this receiver.
60686068+ type: boolean
60696069+ type:
60706070+ description: |-
60716071+ Type of webhook sender, used to determine
60726072+ the validation procedure and payload deserialization.
60736073+ enum:
60746074+ - generic
60756075+ - generic-hmac
60766076+ - github
60776077+ - gitlab
60786078+ - bitbucket
60796079+ - harbor
60806080+ - dockerhub
60816081+ - quay
60826082+ - gcr
60836083+ - nexus
60846084+ - acr
60856085+ - cdevents
60866086+ type: string
60876087+ required:
60886088+ - resources
60896089+ - secretRef
60906090+ - type
60916091+ type: object
60926092+ status:
60936093+ default:
60946094+ observedGeneration: -1
60956095+ description: ReceiverStatus defines the observed state of the Receiver.
60966096+ properties:
60976097+ conditions:
60986098+ description: Conditions holds the conditions for the Receiver.
60996099+ items:
61006100+ description:
61016101+ Condition contains details for one aspect of the current
61026102+ state of this API Resource.
61036103+ properties:
61046104+ lastTransitionTime:
61056105+ description: |-
61066106+ lastTransitionTime is the last time the condition transitioned from one status to another.
61076107+ This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
61086108+ format: date-time
61096109+ type: string
61106110+ message:
61116111+ description: |-
61126112+ message is a human readable message indicating details about the transition.
61136113+ This may be an empty string.
61146114+ maxLength: 32768
61156115+ type: string
61166116+ observedGeneration:
61176117+ description: |-
61186118+ observedGeneration represents the .metadata.generation that the condition was set based upon.
61196119+ For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
61206120+ with respect to the current state of the instance.
61216121+ format: int64
61226122+ minimum: 0
61236123+ type: integer
61246124+ reason:
61256125+ description: |-
61266126+ reason contains a programmatic identifier indicating the reason for the condition's last transition.
61276127+ Producers of specific condition types may define expected values and meanings for this field,
61286128+ and whether the values are considered a guaranteed API.
61296129+ The value should be a CamelCase string.
61306130+ This field may not be empty.
61316131+ maxLength: 1024
61326132+ minLength: 1
61336133+ pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
61346134+ type: string
61356135+ status:
61366136+ description: status of the condition, one of True, False, Unknown.
61376137+ enum:
61386138+ - "True"
61396139+ - "False"
61406140+ - Unknown
61416141+ type: string
61426142+ type:
61436143+ description: type of condition in CamelCase or in foo.example.com/CamelCase.
61446144+ maxLength: 316
61456145+ 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])$
61466146+ type: string
61476147+ required:
61486148+ - lastTransitionTime
61496149+ - message
61506150+ - reason
61516151+ - status
61526152+ - type
61536153+ type: object
61546154+ type: array
61556155+ lastHandledReconcileAt:
61566156+ description: |-
61576157+ LastHandledReconcileAt holds the value of the most recent
61586158+ reconcile request value, so a change of the annotation value
61596159+ can be detected.
61606160+ type: string
61616161+ observedGeneration:
61626162+ description:
61636163+ ObservedGeneration is the last observed generation of
61646164+ the Receiver object.
61656165+ format: int64
61666166+ type: integer
61676167+ webhookPath:
61686168+ description: |-
61696169+ WebhookPath is the generated incoming webhook address in the format
61706170+ of '/hook/sha256sum(token+name+namespace)'.
61716171+ type: string
61726172+ type: object
61736173+ type: object
61746174+ served: true
61756175+ storage: true
61766176+ subresources:
61776177+ status: {}
61786178+ - additionalPrinterColumns:
61796179+ - jsonPath: .metadata.creationTimestamp
61806180+ name: Age
61816181+ type: date
61826182+ - jsonPath: .status.conditions[?(@.type=="Ready")].status
61836183+ name: Ready
61846184+ type: string
61856185+ - jsonPath: .status.conditions[?(@.type=="Ready")].message
61866186+ name: Status
61876187+ type: string
61886188+ deprecated: true
61896189+ deprecationWarning: v1beta2 Receiver is deprecated, upgrade to v1
61906190+ name: v1beta2
61916191+ schema:
61926192+ openAPIV3Schema:
61936193+ description: Receiver is the Schema for the receivers API.
61946194+ properties:
61956195+ apiVersion:
61966196+ description: |-
61976197+ APIVersion defines the versioned schema of this representation of an object.
61986198+ Servers should convert recognized schemas to the latest internal value, and
61996199+ may reject unrecognized values.
62006200+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
62016201+ type: string
62026202+ kind:
62036203+ description: |-
62046204+ Kind is a string value representing the REST resource this object represents.
62056205+ Servers may infer this from the endpoint the client submits requests to.
62066206+ Cannot be updated.
62076207+ In CamelCase.
62086208+ More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
62096209+ type: string
62106210+ metadata:
62116211+ type: object
62126212+ spec:
62136213+ description: ReceiverSpec defines the desired state of the Receiver.
62146214+ properties:
62156215+ events:
62166216+ description: |-
62176217+ Events specifies the list of event types to handle,
62186218+ e.g. 'push' for GitHub or 'Push Hook' for GitLab.
62196219+ items:
59436220 type: string
59445944- required:
59455945- - name
59465946- type: object
59475947- suspend:
59485948- description: |-
59495949- Suspend tells the controller to suspend subsequent
59505950- events handling for this receiver.
59515951- type: boolean
59525952- type:
59535953- description: |-
59545954- Type of webhook sender, used to determine
59555955- the validation procedure and payload deserialization.
59565956- enum:
59575957- - generic
59585958- - generic-hmac
59595959- - github
59605960- - gitlab
59615961- - bitbucket
59625962- - harbor
59635963- - dockerhub
59645964- - quay
59655965- - gcr
59665966- - nexus
59675967- - acr
59685968- - cdevents
59695969- type: string
59705970- required:
59715971- - resources
59725972- - secretRef
59735973- - type
59745974- type: object
59755975- status:
59765976- default:
59775977- observedGeneration: -1
59785978- description: ReceiverStatus defines the observed state of the Receiver.
59795979- properties:
59805980- conditions:
59815981- description: Conditions holds the conditions for the Receiver.
59825982- items:
59835983- description: Condition contains details for one aspect of the current
59845984- state of this API Resource.
59855985- properties:
59865986- lastTransitionTime:
59875987- description: |-
59885988- lastTransitionTime is the last time the condition transitioned from one status to another.
59895989- This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
59905990- format: date-time
59915991- type: string
59925992- message:
59935993- description: |-
59945994- message is a human readable message indicating details about the transition.
59955995- This may be an empty string.
59965996- maxLength: 32768
59975997- type: string
59985998- observedGeneration:
59995999- description: |-
60006000- observedGeneration represents the .metadata.generation that the condition was set based upon.
60016001- For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
60026002- with respect to the current state of the instance.
60036003- format: int64
60046004- minimum: 0
60056005- type: integer
60066006- reason:
60076007- description: |-
60086008- reason contains a programmatic identifier indicating the reason for the condition's last transition.
60096009- Producers of specific condition types may define expected values and meanings for this field,
60106010- and whether the values are considered a guaranteed API.
60116011- The value should be a CamelCase string.
60126012- This field may not be empty.
60136013- maxLength: 1024
60146014- minLength: 1
60156015- pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
60166016- type: string
60176017- status:
60186018- description: status of the condition, one of True, False, Unknown.
60196019- enum:
60206020- - "True"
60216021- - "False"
60226022- - Unknown
60236023- type: string
60246024- type:
60256025- description: type of condition in CamelCase or in foo.example.com/CamelCase.
60266026- maxLength: 316
60276027- 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])$
60286028- type: string
60296029- required:
60306030- - lastTransitionTime
60316031- - message
60326032- - reason
60336033- - status
60346034- - type
60356035- type: object
60366036- type: array
60376037- lastHandledReconcileAt:
60386038- description: |-
60396039- LastHandledReconcileAt holds the value of the most recent
60406040- reconcile request value, so a change of the annotation value
60416041- can be detected.
60426042- type: string
60436043- observedGeneration:
60446044- description: ObservedGeneration is the last observed generation of
60456045- the Receiver object.
60466046- format: int64
60476047- type: integer
60486048- webhookPath:
60496049- description: |-
60506050- WebhookPath is the generated incoming webhook address in the format
60516051- of '/hook/sha256sum(token+name+namespace)'.
60526052- type: string
60536053- type: object
60546054- type: object
60556055- served: true
60566056- storage: true
60576057- subresources:
60586058- status: {}
60596059- - additionalPrinterColumns:
60606060- - jsonPath: .metadata.creationTimestamp
60616061- name: Age
60626062- type: date
60636063- - jsonPath: .status.conditions[?(@.type=="Ready")].status
60646064- name: Ready
60656065- type: string
60666066- - jsonPath: .status.conditions[?(@.type=="Ready")].message
60676067- name: Status
60686068- type: string
60696069- deprecated: true
60706070- deprecationWarning: v1beta2 Receiver is deprecated, upgrade to v1
60716071- name: v1beta2
60726072- schema:
60736073- openAPIV3Schema:
60746074- description: Receiver is the Schema for the receivers API.
60756075- properties:
60766076- apiVersion:
60776077- description: |-
60786078- APIVersion defines the versioned schema of this representation of an object.
60796079- Servers should convert recognized schemas to the latest internal value, and
60806080- may reject unrecognized values.
60816081- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
60826082- type: string
60836083- kind:
60846084- description: |-
60856085- Kind is a string value representing the REST resource this object represents.
60866086- Servers may infer this from the endpoint the client submits requests to.
60876087- Cannot be updated.
60886088- In CamelCase.
60896089- More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
60906090- type: string
60916091- metadata:
60926092- type: object
60936093- spec:
60946094- description: ReceiverSpec defines the desired state of the Receiver.
60956095- properties:
60966096- events:
60976097- description: |-
60986098- Events specifies the list of event types to handle,
60996099- e.g. 'push' for GitHub or 'Push Hook' for GitLab.
61006100- items:
62216221+ type: array
62226222+ interval:
62236223+ description:
62246224+ Interval at which to reconcile the Receiver with its
62256225+ Secret references.
62266226+ pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
61016227 type: string
61026102- type: array
61036103- interval:
61046104- description: Interval at which to reconcile the Receiver with its
61056105- Secret references.
61066106- pattern: ^([0-9]+(\.[0-9]+)?(ms|s|m|h))+$
61076107- type: string
61086108- resources:
61096109- description: A list of resources to be notified about changes.
61106110- items:
62286228+ resources:
62296229+ description: A list of resources to be notified about changes.
62306230+ items:
62316231+ description: |-
62326232+ CrossNamespaceObjectReference contains enough information to let you locate the
62336233+ typed referenced object at cluster level
62346234+ properties:
62356235+ apiVersion:
62366236+ description: API version of the referent
62376237+ type: string
62386238+ kind:
62396239+ description: Kind of the referent
62406240+ enum:
62416241+ - Bucket
62426242+ - GitRepository
62436243+ - Kustomization
62446244+ - HelmRelease
62456245+ - HelmChart
62466246+ - HelmRepository
62476247+ - ImageRepository
62486248+ - ImagePolicy
62496249+ - ImageUpdateAutomation
62506250+ - OCIRepository
62516251+ - ArtifactGenerator
62526252+ - ExternalArtifact
62536253+ type: string
62546254+ matchLabels:
62556255+ additionalProperties:
62566256+ type: string
62576257+ description: |-
62586258+ MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
62596259+ map is equivalent to an element of matchExpressions, whose key field is "key", the
62606260+ operator is "In", and the values array contains only "value". The requirements are ANDed.
62616261+ MatchLabels requires the name to be set to `*`.
62626262+ type: object
62636263+ name:
62646264+ description: |-
62656265+ Name of the referent
62666266+ If multiple resources are targeted `*` may be set.
62676267+ maxLength: 253
62686268+ minLength: 1
62696269+ type: string
62706270+ namespace:
62716271+ description: Namespace of the referent
62726272+ maxLength: 253
62736273+ minLength: 1
62746274+ type: string
62756275+ required:
62766276+ - kind
62776277+ - name
62786278+ type: object
62796279+ type: array
62806280+ secretRef:
61116281 description: |-
61126112- CrossNamespaceObjectReference contains enough information to let you locate the
61136113- typed referenced object at cluster level
62826282+ SecretRef specifies the Secret containing the token used
62836283+ to validate the payload authenticity.
61146284 properties:
61156115- apiVersion:
61166116- description: API version of the referent
61176117- type: string
61186118- kind:
61196119- description: Kind of the referent
61206120- enum:
61216121- - Bucket
61226122- - GitRepository
61236123- - Kustomization
61246124- - HelmRelease
61256125- - HelmChart
61266126- - HelmRepository
61276127- - ImageRepository
61286128- - ImagePolicy
61296129- - ImageUpdateAutomation
61306130- - OCIRepository
61316131- - ArtifactGenerator
61326132- - ExternalArtifact
61336133- type: string
61346134- matchLabels:
61356135- additionalProperties:
61366136- type: string
61376137- description: |-
61386138- MatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
61396139- map is equivalent to an element of matchExpressions, whose key field is "key", the
61406140- operator is "In", and the values array contains only "value". The requirements are ANDed.
61416141- MatchLabels requires the name to be set to `*`.
61426142- type: object
61436285 name:
61446144- description: |-
61456145- Name of the referent
61466146- If multiple resources are targeted `*` may be set.
61476147- maxLength: 253
61486148- minLength: 1
61496149- type: string
61506150- namespace:
61516151- description: Namespace of the referent
61526152- maxLength: 253
61536153- minLength: 1
61546154- type: string
61556155- required:
61566156- - kind
61576157- - name
61586158- type: object
61596159- type: array
61606160- secretRef:
61616161- description: |-
61626162- SecretRef specifies the Secret containing the token used
61636163- to validate the payload authenticity.
61646164- properties:
61656165- name:
61666166- description: Name of the referent.
61676167- type: string
61686168- required:
61696169- - name
61706170- type: object
61716171- suspend:
61726172- description: |-
61736173- Suspend tells the controller to suspend subsequent
61746174- events handling for this receiver.
61756175- type: boolean
61766176- type:
61776177- description: |-
61786178- Type of webhook sender, used to determine
61796179- the validation procedure and payload deserialization.
61806180- enum:
61816181- - generic
61826182- - generic-hmac
61836183- - github
61846184- - gitlab
61856185- - bitbucket
61866186- - harbor
61876187- - dockerhub
61886188- - quay
61896189- - gcr
61906190- - nexus
61916191- - acr
61926192- type: string
61936193- required:
61946194- - resources
61956195- - secretRef
61966196- - type
61976197- type: object
61986198- status:
61996199- default:
62006200- observedGeneration: -1
62016201- description: ReceiverStatus defines the observed state of the Receiver.
62026202- properties:
62036203- conditions:
62046204- description: Conditions holds the conditions for the Receiver.
62056205- items:
62066206- description: Condition contains details for one aspect of the current
62076207- state of this API Resource.
62086208- properties:
62096209- lastTransitionTime:
62106210- description: |-
62116211- lastTransitionTime is the last time the condition transitioned from one status to another.
62126212- This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
62136213- format: date-time
62146214- type: string
62156215- message:
62166216- description: |-
62176217- message is a human readable message indicating details about the transition.
62186218- This may be an empty string.
62196219- maxLength: 32768
62206220- type: string
62216221- observedGeneration:
62226222- description: |-
62236223- observedGeneration represents the .metadata.generation that the condition was set based upon.
62246224- For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
62256225- with respect to the current state of the instance.
62266226- format: int64
62276227- minimum: 0
62286228- type: integer
62296229- reason:
62306230- description: |-
62316231- reason contains a programmatic identifier indicating the reason for the condition's last transition.
62326232- Producers of specific condition types may define expected values and meanings for this field,
62336233- and whether the values are considered a guaranteed API.
62346234- The value should be a CamelCase string.
62356235- This field may not be empty.
62366236- maxLength: 1024
62376237- minLength: 1
62386238- pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
62396239- type: string
62406240- status:
62416241- description: status of the condition, one of True, False, Unknown.
62426242- enum:
62436243- - "True"
62446244- - "False"
62456245- - Unknown
62466246- type: string
62476247- type:
62486248- description: type of condition in CamelCase or in foo.example.com/CamelCase.
62496249- maxLength: 316
62506250- 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])$
62866286+ description: Name of the referent.
62516287 type: string
62526288 required:
62536253- - lastTransitionTime
62546254- - message
62556255- - reason
62566256- - status
62576257- - type
62896289+ - name
62586290 type: object
62596259- type: array
62606260- lastHandledReconcileAt:
62616261- description: |-
62626262- LastHandledReconcileAt holds the value of the most recent
62636263- reconcile request value, so a change of the annotation value
62646264- can be detected.
62656265- type: string
62666266- observedGeneration:
62676267- description: ObservedGeneration is the last observed generation of
62686268- the Receiver object.
62696269- format: int64
62706270- type: integer
62716271- url:
62726272- description: |-
62736273- URL is the generated incoming webhook address in the format
62746274- of '/hook/sha256sum(token+name+namespace)'.
62756275- Deprecated: Replaced by WebhookPath.
62766276- type: string
62776277- webhookPath:
62786278- description: |-
62796279- WebhookPath is the generated incoming webhook address in the format
62806280- of '/hook/sha256sum(token+name+namespace)'.
62816281- type: string
62826282- type: object
62836283- type: object
62846284- served: true
62856285- storage: false
62866286- subresources:
62876287- status: {}
62916291+ suspend:
62926292+ description: |-
62936293+ Suspend tells the controller to suspend subsequent
62946294+ events handling for this receiver.
62956295+ type: boolean
62966296+ type:
62976297+ description: |-
62986298+ Type of webhook sender, used to determine
62996299+ the validation procedure and payload deserialization.
63006300+ enum:
63016301+ - generic
63026302+ - generic-hmac
63036303+ - github
63046304+ - gitlab
63056305+ - bitbucket
63066306+ - harbor
63076307+ - dockerhub
63086308+ - quay
63096309+ - gcr
63106310+ - nexus
63116311+ - acr
63126312+ type: string
63136313+ required:
63146314+ - resources
63156315+ - secretRef
63166316+ - type
63176317+ type: object
63186318+ status:
63196319+ default:
63206320+ observedGeneration: -1
63216321+ description: ReceiverStatus defines the observed state of the Receiver.
63226322+ properties:
63236323+ conditions:
63246324+ description: Conditions holds the conditions for the Receiver.
63256325+ items:
63266326+ description:
63276327+ Condition contains details for one aspect of the current
63286328+ state of this API Resource.
63296329+ properties:
63306330+ lastTransitionTime:
63316331+ description: |-
63326332+ lastTransitionTime is the last time the condition transitioned from one status to another.
63336333+ This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
63346334+ format: date-time
63356335+ type: string
63366336+ message:
63376337+ description: |-
63386338+ message is a human readable message indicating details about the transition.
63396339+ This may be an empty string.
63406340+ maxLength: 32768
63416341+ type: string
63426342+ observedGeneration:
63436343+ description: |-
63446344+ observedGeneration represents the .metadata.generation that the condition was set based upon.
63456345+ For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
63466346+ with respect to the current state of the instance.
63476347+ format: int64
63486348+ minimum: 0
63496349+ type: integer
63506350+ reason:
63516351+ description: |-
63526352+ reason contains a programmatic identifier indicating the reason for the condition's last transition.
63536353+ Producers of specific condition types may define expected values and meanings for this field,
63546354+ and whether the values are considered a guaranteed API.
63556355+ The value should be a CamelCase string.
63566356+ This field may not be empty.
63576357+ maxLength: 1024
63586358+ minLength: 1
63596359+ pattern: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$
63606360+ type: string
63616361+ status:
63626362+ description: status of the condition, one of True, False, Unknown.
63636363+ enum:
63646364+ - "True"
63656365+ - "False"
63666366+ - Unknown
63676367+ type: string
63686368+ type:
63696369+ description: type of condition in CamelCase or in foo.example.com/CamelCase.
63706370+ maxLength: 316
63716371+ 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])$
63726372+ type: string
63736373+ required:
63746374+ - lastTransitionTime
63756375+ - message
63766376+ - reason
63776377+ - status
63786378+ - type
63796379+ type: object
63806380+ type: array
63816381+ lastHandledReconcileAt:
63826382+ description: |-
63836383+ LastHandledReconcileAt holds the value of the most recent
63846384+ reconcile request value, so a change of the annotation value
63856385+ can be detected.
63866386+ type: string
63876387+ observedGeneration:
63886388+ description:
63896389+ ObservedGeneration is the last observed generation of
63906390+ the Receiver object.
63916391+ format: int64
63926392+ type: integer
63936393+ url:
63946394+ description: |-
63956395+ URL is the generated incoming webhook address in the format
63966396+ of '/hook/sha256sum(token+name+namespace)'.
63976397+ Deprecated: Replaced by WebhookPath.
63986398+ type: string
63996399+ webhookPath:
64006400+ description: |-
64016401+ WebhookPath is the generated incoming webhook address in the format
64026402+ of '/hook/sha256sum(token+name+namespace)'.
64036403+ type: string
64046404+ type: object
64056405+ type: object
64066406+ served: true
64076407+ storage: false
64086408+ subresources:
64096409+ status: {}
62886410---
62896411apiVersion: v1
62906412kind: ServiceAccount
···63106432 namespace: flux-system
63116433spec:
63126434 ports:
63136313- - name: http
63146314- port: 80
63156315- protocol: TCP
63166316- targetPort: http
64356435+ - name: http
64366436+ port: 80
64376437+ protocol: TCP
64386438+ targetPort: http
63176439 selector:
63186440 app: notification-controller
63196441 type: ClusterIP
···63316453 namespace: flux-system
63326454spec:
63336455 ports:
63346334- - name: http
63356335- port: 80
63366336- protocol: TCP
63376337- targetPort: http-webhook
64566456+ - name: http
64576457+ port: 80
64586458+ protocol: TCP
64596459+ targetPort: http-webhook
63386460 selector:
63396461 app: notification-controller
63406462 type: ClusterIP
···63686490 app.kubernetes.io/version: v2.8.8
63696491 spec:
63706492 containers:
63716371- - args:
63726372- - --watch-all-namespaces=true
63736373- - --log-level=info
63746374- - --log-encoding=json
63756375- - --enable-leader-election
63766376- env:
63776377- - name: RUNTIME_NAMESPACE
63786378- valueFrom:
63796379- fieldRef:
63806380- fieldPath: metadata.namespace
63816381- - name: GOMEMLIMIT
63826382- valueFrom:
63836383- resourceFieldRef:
63846384- containerName: manager
63856385- resource: limits.memory
63866386- image: ghcr.io/fluxcd/notification-controller:v1.8.4
63876387- imagePullPolicy: IfNotPresent
63886388- livenessProbe:
63896389- httpGet:
63906390- path: /healthz
63916391- port: healthz
63926392- name: manager
63936393- ports:
63946394- - containerPort: 9090
63956395- name: http
63966396- protocol: TCP
63976397- - containerPort: 9292
63986398- name: http-webhook
63996399- protocol: TCP
64006400- - containerPort: 8080
64016401- name: http-prom
64026402- protocol: TCP
64036403- - containerPort: 9440
64046404- name: healthz
64056405- protocol: TCP
64066406- readinessProbe:
64076407- httpGet:
64086408- path: /readyz
64096409- port: healthz
64106410- resources:
64116411- limits:
64126412- cpu: 1000m
64136413- memory: 1Gi
64146414- requests:
64156415- cpu: 100m
64166416- memory: 64Mi
64176417- securityContext:
64186418- allowPrivilegeEscalation: false
64196419- capabilities:
64206420- drop:
64216421- - ALL
64226422- readOnlyRootFilesystem: true
64236423- runAsNonRoot: true
64246424- seccompProfile:
64256425- type: RuntimeDefault
64266426- volumeMounts:
64276427- - mountPath: /tmp
64286428- name: temp
64936493+ - args:
64946494+ - --watch-all-namespaces=true
64956495+ - --log-level=info
64966496+ - --log-encoding=json
64976497+ - --enable-leader-election
64986498+ env:
64996499+ - name: RUNTIME_NAMESPACE
65006500+ valueFrom:
65016501+ fieldRef:
65026502+ fieldPath: metadata.namespace
65036503+ - name: GOMEMLIMIT
65046504+ valueFrom:
65056505+ resourceFieldRef:
65066506+ containerName: manager
65076507+ resource: limits.memory
65086508+ image: ghcr.io/fluxcd/notification-controller:v1.8.4
65096509+ imagePullPolicy: IfNotPresent
65106510+ livenessProbe:
65116511+ httpGet:
65126512+ path: /healthz
65136513+ port: healthz
65146514+ name: manager
65156515+ ports:
65166516+ - containerPort: 9090
65176517+ name: http
65186518+ protocol: TCP
65196519+ - containerPort: 9292
65206520+ name: http-webhook
65216521+ protocol: TCP
65226522+ - containerPort: 8080
65236523+ name: http-prom
65246524+ protocol: TCP
65256525+ - containerPort: 9440
65266526+ name: healthz
65276527+ protocol: TCP
65286528+ readinessProbe:
65296529+ httpGet:
65306530+ path: /readyz
65316531+ port: healthz
65326532+ resources:
65336533+ limits:
65346534+ cpu: 1000m
65356535+ memory: 1Gi
65366536+ requests:
65376537+ cpu: 100m
65386538+ memory: 64Mi
65396539+ securityContext:
65406540+ allowPrivilegeEscalation: false
65416541+ capabilities:
65426542+ drop:
65436543+ - ALL
65446544+ readOnlyRootFilesystem: true
65456545+ runAsNonRoot: true
65466546+ seccompProfile:
65476547+ type: RuntimeDefault
65486548+ volumeMounts:
65496549+ - mountPath: /tmp
65506550+ name: temp
64296551 nodeSelector:
64306552 kubernetes.io/os: linux
64316553 securityContext:
···64336555 serviceAccountName: notification-controller
64346556 terminationGracePeriodSeconds: 10
64356557 volumes:
64366436- - emptyDir: {}
64376437- name: temp
65586558+ - emptyDir: {}
65596559+ name: temp