API Reference#
Packages:
k0rdent.mirantis.com/v1alpha1#
Resource Types:
AccessManagement#
AccessManagement is the Schema for the AccessManagements API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | AccessManagement | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
AccessManagementSpec defines the desired state of AccessManagement |
false |
status | object |
AccessManagementStatus defines the observed state of AccessManagement |
false |
AccessManagement.spec#
AccessManagementSpec defines the desired state of AccessManagement
Name | Type | Description | Required |
---|---|---|---|
accessRules | []object |
AccessRules is the list of access rules. Each AccessRule enforces
objects distribution to the TargetNamespaces. |
false |
AccessManagement.spec.accessRules[index]#
AccessRule is the definition of the AccessManagement access rule. Each AccessRule enforces Templates and Credentials distribution to the TargetNamespaces
Name | Type | Description | Required |
---|---|---|---|
clusterTemplateChains | []string |
ClusterTemplateChains lists the names of ClusterTemplateChains whose ClusterTemplates
will be distributed to all namespaces specified in TargetNamespaces. |
false |
credentials | []string |
Credentials is the list of Credential names that will be distributed to all the
namespaces specified in TargetNamespaces. |
false |
serviceTemplateChains | []string |
ServiceTemplateChains lists the names of ServiceTemplateChains whose ServiceTemplates
will be distributed to all namespaces specified in TargetNamespaces. |
false |
targetNamespaces | object |
TargetNamespaces defines the namespaces where selected objects will be distributed.
Templates and Credentials will be distributed to all namespaces if unset. Validations: |
false |
AccessManagement.spec.accessRules[index].targetNamespaces#
TargetNamespaces defines the namespaces where selected objects will be distributed. Templates and Credentials will be distributed to all namespaces if unset.
Name | Type | Description | Required |
---|---|---|---|
list | []string |
List is the list of namespaces to select.
Mutually exclusive with StringSelector and Selector. |
false |
selector | object |
Selector is a structured label query to select namespaces.
Mutually exclusive with StringSelector and List. |
false |
stringSelector | string |
StringSelector is a label query to select namespaces.
Mutually exclusive with Selector and List. |
false |
AccessManagement.spec.accessRules[index].targetNamespaces.selector#
Selector is a structured label query to select namespaces. Mutually exclusive with StringSelector and List.
Name | Type | Description | Required |
---|---|---|---|
matchExpressions | []object |
matchExpressions is a list of label selector requirements. The requirements are ANDed. |
false |
matchLabels | map[string]string |
matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions, whose key field is "key", the
operator is "In", and the values array contains only "value". The requirements are ANDed. |
false |
AccessManagement.spec.accessRules[index].targetNamespaces.selector.matchExpressions[index]#
A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
Name | Type | Description | Required |
---|---|---|---|
key | string |
key is the label key that the selector applies to. |
true |
operator | string |
operator represents a key's relationship to a set of values.
Valid operators are In, NotIn, Exists and DoesNotExist. |
true |
values | []string |
values is an array of string values. If the operator is In or NotIn,
the values array must be non-empty. If the operator is Exists or DoesNotExist,
the values array must be empty. This array is replaced during a strategic
merge patch. |
false |
AccessManagement.status#
AccessManagementStatus defines the observed state of AccessManagement
Name | Type | Description | Required |
---|---|---|---|
current | []object |
Current reflects the applied access rules configuration. |
false |
error | string |
Error is the error message occurred during the reconciliation (if any) |
false |
observedGeneration | integer |
ObservedGeneration is the last observed generation. Format: int64 |
false |
AccessManagement.status.current[index]#
AccessRule is the definition of the AccessManagement access rule. Each AccessRule enforces Templates and Credentials distribution to the TargetNamespaces
Name | Type | Description | Required |
---|---|---|---|
clusterTemplateChains | []string |
ClusterTemplateChains lists the names of ClusterTemplateChains whose ClusterTemplates
will be distributed to all namespaces specified in TargetNamespaces. |
false |
credentials | []string |
Credentials is the list of Credential names that will be distributed to all the
namespaces specified in TargetNamespaces. |
false |
serviceTemplateChains | []string |
ServiceTemplateChains lists the names of ServiceTemplateChains whose ServiceTemplates
will be distributed to all namespaces specified in TargetNamespaces. |
false |
targetNamespaces | object |
TargetNamespaces defines the namespaces where selected objects will be distributed.
Templates and Credentials will be distributed to all namespaces if unset. Validations: |
false |
AccessManagement.status.current[index].targetNamespaces#
TargetNamespaces defines the namespaces where selected objects will be distributed. Templates and Credentials will be distributed to all namespaces if unset.
Name | Type | Description | Required |
---|---|---|---|
list | []string |
List is the list of namespaces to select.
Mutually exclusive with StringSelector and Selector. |
false |
selector | object |
Selector is a structured label query to select namespaces.
Mutually exclusive with StringSelector and List. |
false |
stringSelector | string |
StringSelector is a label query to select namespaces.
Mutually exclusive with Selector and List. |
false |
AccessManagement.status.current[index].targetNamespaces.selector#
Selector is a structured label query to select namespaces. Mutually exclusive with StringSelector and List.
Name | Type | Description | Required |
---|---|---|---|
matchExpressions | []object |
matchExpressions is a list of label selector requirements. The requirements are ANDed. |
false |
matchLabels | map[string]string |
matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions, whose key field is "key", the
operator is "In", and the values array contains only "value". The requirements are ANDed. |
false |
AccessManagement.status.current[index].targetNamespaces.selector.matchExpressions[index]#
A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
Name | Type | Description | Required |
---|---|---|---|
key | string |
key is the label key that the selector applies to. |
true |
operator | string |
operator represents a key's relationship to a set of values.
Valid operators are In, NotIn, Exists and DoesNotExist. |
true |
values | []string |
values is an array of string values. If the operator is In or NotIn,
the values array must be non-empty. If the operator is Exists or DoesNotExist,
the values array must be empty. This array is replaced during a strategic
merge patch. |
false |
ClusterDeployment#
ClusterDeployment is the Schema for the ClusterDeployments API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | ClusterDeployment | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
ClusterDeploymentSpec defines the desired state of ClusterDeployment |
false |
status | object |
ClusterDeploymentStatus defines the observed state of ClusterDeployment |
false |
ClusterDeployment.spec#
ClusterDeploymentSpec defines the desired state of ClusterDeployment
Name | Type | Description | Required |
---|---|---|---|
template | string |
Template is a reference to a Template object located in the same namespace. |
true |
config | JSON |
Config allows to provide parameters for template customization.
If no Config provided, the field will be populated with the default values for
the template and DryRun will be enabled. |
false |
credential | string |
Name reference to the related Credentials object. |
false |
dryRun | boolean |
DryRun specifies whether the template should be applied after validation or only validated. |
false |
propagateCredentials | boolean |
PropagateCredentials indicates whether credentials should be propagated
for use by CCM (Cloud Controller Manager). Default: true |
false |
serviceSpec | object |
ServiceSpec is spec related to deployment of services. |
false |
ClusterDeployment.spec.serviceSpec#
ServiceSpec is spec related to deployment of services.
Name | Type | Description | Required |
---|---|---|---|
continueOnError | boolean |
ContinueOnError specifies if the services deployment should continue if an error occurs. Default: false |
false |
driftExclusions | []object |
DriftExclusions specifies specific configurations of resources to ignore for drift detection. |
false |
driftIgnore | []object |
DriftIgnore specifies resources to ignore for drift detection. |
false |
priority | integer |
Priority sets the priority for the services defined in this spec.
Higher value means higher priority and lower means lower.
In case of conflict with another object managing the service,
the one with higher priority will get to deploy its services. Format: int32 Default: 100 Minimum: 1 Maximum: 2.147483646e+09 |
false |
reload | boolean |
Reload instances via rolling upgrade when a ConfigMap/Secret mounted as volume is modified. |
false |
services | []object |
Services is a list of services created via ServiceTemplates
that could be installed on the target cluster. |
false |
stopOnConflict | boolean |
StopOnConflict specifies what to do in case of a conflict.
E.g. If another object is already managing a service.
By default the remaining services will be deployed even if conflict is detected.
If set to true, the deployment will stop after encountering the first conflict. Default: false |
false |
syncMode | enum |
SyncMode specifies how services are synced in the target cluster. Enum: OneTime, Continuous, ContinuousWithDriftDetection, DryRun Default: Continuous |
false |
templateResourceRefs | []object |
TemplateResourceRefs is a list of resources to collect from the management cluster,
the values from which can be used in templates. |
false |
ClusterDeployment.spec.serviceSpec.driftExclusions[index]#
Name | Type | Description | Required |
---|---|---|---|
paths | []string |
Paths is a slice of JSON6902 paths to exclude from configuration drift evaluation. |
true |
target | object |
Target points to the resources that the paths refers to. |
false |
ClusterDeployment.spec.serviceSpec.driftExclusions[index].target#
Target points to the resources that the paths refers to.
Name | Type | Description | Required |
---|---|---|---|
annotationSelector | string |
AnnotationSelector is a string that follows the label selection expression
https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
It matches with the resource annotations. |
false |
group | string |
Group is the API group to select resources from.
Together with Version and Kind it is capable of unambiguously identifying and/or selecting resources.
https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md |
false |
kind | string |
Kind of the API Group to select resources from.
Together with Group and Version it is capable of unambiguously
identifying and/or selecting resources.
https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md |
false |
labelSelector | string |
LabelSelector is a string that follows the label selection expression
https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
It matches with the resource labels. |
false |
name | string |
Name to match resources with. |
false |
namespace | string |
Namespace to select resources from. |
false |
version | string |
Version of the API Group to select resources from.
Together with Group and Kind it is capable of unambiguously identifying and/or selecting resources.
https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md |
false |
ClusterDeployment.spec.serviceSpec.driftIgnore[index]#
Name | Type | Description | Required |
---|---|---|---|
annotationSelector | string |
AnnotationSelector is a string that follows the label selection expression
https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
It matches with the resource annotations. |
false |
group | string |
Group is the API group to select resources from.
Together with Version and Kind it is capable of unambiguously identifying and/or selecting resources.
https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md |
false |
kind | string |
Kind of the API Group to select resources from.
Together with Group and Version it is capable of unambiguously
identifying and/or selecting resources.
https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md |
false |
labelSelector | string |
LabelSelector is a string that follows the label selection expression
https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
It matches with the resource labels. |
false |
name | string |
Name to match resources with. |
false |
namespace | string |
Namespace to select resources from. |
false |
version | string |
Version of the API Group to select resources from.
Together with Group and Kind it is capable of unambiguously identifying and/or selecting resources.
https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md |
false |
ClusterDeployment.spec.serviceSpec.services[index]#
Service represents a Service to be deployed.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name is the chart release. |
true |
template | string |
Template is a reference to a Template object located in the same namespace. |
true |
disable | boolean |
Disable can be set to disable handling of this service. |
false |
namespace | string |
Namespace is the namespace the release will be installed in.
It will default to Name if not provided. |
false |
values | string |
Values is the helm values to be passed to the chart used by the template.
The string type is used in order to allow for templating. |
false |
valuesFrom | []object |
ValuesFrom can reference a ConfigMap or Secret containing helm values. |
false |
ClusterDeployment.spec.serviceSpec.services[index].valuesFrom[index]#
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind of the resource. Supported kinds are:
- ConfigMap/Secret Enum: ConfigMap, Secret |
true |
name | string |
Name of the referenced resource.
Name can be expressed as a template and instantiate using
- cluster namespace: .Cluster.metadata.namespace
- cluster name: .Cluster.metadata.name
- cluster type: .Cluster.kind |
true |
namespace | string |
Namespace of the referenced resource.
For ClusterProfile namespace can be left empty. In such a case, namespace will
be implicit set to cluster's namespace.
For Profile namespace must be left empty. The Profile namespace will be used. |
false |
ClusterDeployment.spec.serviceSpec.templateResourceRefs[index]#
Name | Type | Description | Required |
---|---|---|---|
identifier | string |
Identifier is how the resource will be referred to in the
template |
true |
resource | object |
Resource references a Kubernetes instance in the management
cluster to fetch and use during template instantiation.
For ClusterProfile namespace can be left empty. In such a case, namespace will
be implicit set to cluster's namespace.
Name and namespace can be expressed as a template and instantiate using
- cluster namespace: .Cluster.metadata.namespace
- cluster name: .Cluster.metadata.name
- cluster type: .Cluster.kind |
true |
ClusterDeployment.spec.serviceSpec.templateResourceRefs[index].resource#
Resource references a Kubernetes instance in the management cluster to fetch and use during template instantiation. For ClusterProfile namespace can be left empty. In such a case, namespace will be implicit set to cluster's namespace. Name and namespace can be expressed as a template and instantiate using - cluster namespace: .Cluster.metadata.namespace - cluster name: .Cluster.metadata.name - cluster type: .Cluster.kind
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string |
API version of the referent. |
false |
fieldPath | string |
If referring to a piece of an object instead of an entire object, this string
should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2].
For example, if the object reference is to a container within a pod, this would take on a value like:
"spec.containers{name}" (where "name" refers to the name of the container that triggered
the event) or if no container name is specified "spec.containers[2]" (container with
index 2 in this pod). This syntax is chosen only to have some well-defined way of
referencing a part of an object. |
false |
kind | string |
Kind of the referent.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
false |
name | string |
Name of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
false |
namespace | string |
Namespace of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
false |
resourceVersion | string |
Specific resourceVersion to which this reference is made, if any.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
false |
uid | string |
UID of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
false |
ClusterDeployment.status#
ClusterDeploymentStatus defines the observed state of ClusterDeployment
Name | Type | Description | Required |
---|---|---|---|
availableUpgrades | []string |
AvailableUpgrades is the list of ClusterTemplate names to which
this cluster can be upgraded. It can be an empty array, which means no upgrades are
available. |
false |
conditions | []object |
Conditions contains details for the current state of the ClusterDeployment. |
false |
k8sVersion | string |
Currently compatible exact Kubernetes version of the cluster. Being set only if
provided by the corresponding ClusterTemplate. |
false |
observedGeneration | integer |
ObservedGeneration is the last observed generation. Format: int64 |
false |
services | []object |
Services contains details for the state of services. |
false |
ClusterDeployment.status.conditions[index]#
Condition contains details for one aspect of the current state of this API Resource.
Name | Type | Description | Required |
---|---|---|---|
lastTransitionTime | string |
lastTransitionTime is the last time the condition transitioned from one status to another.
This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable. Format: date-time |
true |
message | string |
message is a human readable message indicating details about the transition.
This may be an empty string. |
true |
reason | string |
reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty. |
true |
status | enum |
status of the condition, one of True, False, Unknown. Enum: True, False, Unknown |
true |
type | string |
type of condition in CamelCase or in foo.example.com/CamelCase. |
true |
observedGeneration | integer |
observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance. Format: int64 Minimum: 0 |
false |
ClusterDeployment.status.services[index]#
ServiceStatus contains details for the state of services.
Name | Type | Description | Required |
---|---|---|---|
clusterName | string |
ClusterName is the name of the associated cluster. |
true |
clusterNamespace | string |
ClusterNamespace is the namespace of the associated cluster. |
false |
conditions | []object |
Conditions contains details for the current state of managed services. |
false |
ClusterDeployment.status.services[index].conditions[index]#
Condition contains details for one aspect of the current state of this API Resource.
Name | Type | Description | Required |
---|---|---|---|
lastTransitionTime | string |
lastTransitionTime is the last time the condition transitioned from one status to another.
This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable. Format: date-time |
true |
message | string |
message is a human readable message indicating details about the transition.
This may be an empty string. |
true |
reason | string |
reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty. |
true |
status | enum |
status of the condition, one of True, False, Unknown. Enum: True, False, Unknown |
true |
type | string |
type of condition in CamelCase or in foo.example.com/CamelCase. |
true |
observedGeneration | integer |
observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance. Format: int64 Minimum: 0 |
false |
ClusterTemplateChain#
ClusterTemplateChain is the Schema for the clustertemplatechains API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | ClusterTemplateChain | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
TemplateChainSpec defines the desired state of *TemplateChain Validations: |
false |
status | object |
TemplateChainStatus defines the observed state of *TemplateChain |
false |
ClusterTemplateChain.spec#
TemplateChainSpec defines the desired state of *TemplateChain
Name | Type | Description | Required |
---|---|---|---|
supportedTemplates | []object |
SupportedTemplates is the list of supported Templates definitions and all available upgrade sequences for it. |
false |
ClusterTemplateChain.spec.supportedTemplates[index]#
SupportedTemplate is the supported Template definition and all available upgrade sequences for it
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name is the name of the Template. |
true |
availableUpgrades | []object |
AvailableUpgrades is the list of available upgrades for the specified Template. |
false |
ClusterTemplateChain.spec.supportedTemplates[index].availableUpgrades[index]#
AvailableUpgrade is the definition of the available upgrade for the Template
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name is the name of the Template to which the upgrade is available. |
true |
ClusterTemplateChain.status#
TemplateChainStatus defines the observed state of *TemplateChain
Name | Type | Description | Required |
---|---|---|---|
valid | boolean |
Valid indicates whether the chain is valid and can be considered when calculating available
upgrade paths. |
false |
validationError | string |
ValidationError provides information regarding issues encountered during templatechain validation. |
false |
ClusterTemplate#
ClusterTemplate is the Schema for the clustertemplates API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | ClusterTemplate | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
ClusterTemplateSpec defines the desired state of ClusterTemplate Validations: |
false |
status | object |
ClusterTemplateStatus defines the observed state of ClusterTemplate |
false |
ClusterTemplate.spec#
ClusterTemplateSpec defines the desired state of ClusterTemplate
Name | Type | Description | Required |
---|---|---|---|
helm | object |
HelmSpec references a Helm chart representing the KCM template Validations: |
true |
k8sVersion | string |
Kubernetes exact version in the SemVer format provided by this ClusterTemplate. |
false |
providerContracts | map[string]string |
Holds key-value pairs with compatibility [contract versions],
where the key is the name of the provider,
and the value is the provider contract version
required to be supported by the provider.
[contract versions]: https://cluster-api.sigs.k8s.io/developer/providers/contracts |
false |
providers | []string |
Providers represent required CAPI providers.
Should be set if not present in the Helm chart metadata. |
false |
ClusterTemplate.spec.helm#
HelmSpec references a Helm chart representing the KCM template
Name | Type | Description | Required |
---|---|---|---|
chartRef | object |
ChartRef is a reference to a source controller resource containing the
Helm chart representing the template. |
false |
chartSource | object |
ChartSource is a source of a Helm chart representing the template. Validations: |
false |
chartSpec | object |
ChartSpec defines the desired state of the HelmChart to be created by the controller |
false |
ClusterTemplate.spec.helm.chartRef#
ChartRef is a reference to a source controller resource containing the Helm chart representing the template.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind of the referent. Enum: OCIRepository, HelmChart |
true |
name | string |
Name of the referent. |
true |
apiVersion | string |
APIVersion of the referent. |
false |
namespace | string |
Namespace of the referent, defaults to the namespace of the Kubernetes
resource object that contains the reference. |
false |
ClusterTemplate.spec.helm.chartSource#
ChartSource is a source of a Helm chart representing the template.
Name | Type | Description | Required |
---|---|---|---|
deploymentType | enum |
DeploymentType is the type of the deployment. This field is ignored,
when ResourceSpec is used as part of Helm chart configuration. Enum: Local, Remote Default: Remote |
true |
path | string |
Path to the directory containing the resource manifest. |
true |
localSourceRef | object |
LocalSourceRef is the local source of the kustomize manifest. |
false |
remoteSourceSpec | object |
RemoteSourceSpec is the remote source of the kustomize manifest. Validations: |
false |
ClusterTemplate.spec.helm.chartSource.localSourceRef#
LocalSourceRef is the local source of the kustomize manifest.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind is the kind of the local source. Enum: ConfigMap, Secret, GitRepository, Bucket, OCIRepository |
true |
name | string |
Name is the name of the local source. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec#
RemoteSourceSpec is the remote source of the kustomize manifest.
Name | Type | Description | Required |
---|---|---|---|
bucket | object |
Bucket is the definition of bucket source. Validations: |
false |
git | object |
Git is the definition of git repository source. |
false |
oci | object |
OCI is the definition of OCI repository source. |
false |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.bucket#
Bucket is the definition of bucket source.
Name | Type | Description | Required |
---|---|---|---|
bucketName | string |
BucketName is the name of the object storage bucket. |
true |
endpoint | string |
Endpoint is the object storage address the BucketName is located at. |
true |
interval | string |
Interval at which the Bucket Endpoint is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
bucket. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
This field is only supported for the `generic` provider. |
false |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
insecure | boolean |
Insecure allows connecting to a non-TLS HTTP Endpoint. |
false |
prefix | string |
Prefix to use for server-side filtering of files in the Bucket. |
false |
provider | enum |
Provider of the object storage bucket.
Defaults to 'generic', which expects an S3 (API) compatible object
storage. Enum: generic, aws, gcp, azure Default: generic |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the Bucket server. |
false |
region | string |
Region of the Endpoint where the BucketName is located in. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials
for the Bucket. |
false |
sts | object |
STS specifies the required configuration to use a Security Token
Service for fetching temporary credentials to authenticate in a
Bucket provider.
This field is only supported for the `aws` and `generic` providers. |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
Bucket. |
false |
timeout | string |
Timeout for fetch operations, defaults to 60s. Default: 60s |
false |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
bucket. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
This field is only supported for the generic
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the Bucket server.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.secretRef#
SecretRef specifies the Secret containing authentication credentials for the Bucket.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.sts#
STS specifies the required configuration to use a Security Token Service for fetching temporary credentials to authenticate in a Bucket provider.
This field is only supported for the aws
and generic
providers.
Name | Type | Description | Required |
---|---|---|---|
endpoint | string |
Endpoint is the HTTP/S endpoint of the Security Token Service from
where temporary credentials will be fetched. |
true |
provider | enum |
Provider of the Security Token Service. Enum: aws, ldap |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
STS endpoint. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
This field is only supported for the `ldap` provider. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials
for the STS endpoint. This Secret must contain the fields `username`
and `password` and is supported only for the `ldap` provider. |
false |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.sts.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
STS endpoint. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
This field is only supported for the ldap
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.sts.secretRef#
SecretRef specifies the Secret containing authentication credentials
for the STS endpoint. This Secret must contain the fields username
and password
and is supported only for the ldap
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.git#
Git is the definition of git repository source.
Name | Type | Description | Required |
---|---|---|---|
interval | string |
Interval at which the GitRepository URL is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
url | string |
URL specifies the Git repository URL, it can be an HTTP/S or SSH address. |
true |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
include | []object |
Include specifies a list of GitRepository resources which Artifacts
should be included in the Artifact produced for this GitRepository. |
false |
provider | enum |
Provider used for authentication, can be 'azure', 'github', 'generic'.
When not specified, defaults to 'generic'. Enum: generic, azure, github |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the Git server. |
false |
recurseSubmodules | boolean |
RecurseSubmodules enables the initialization of all submodules within
the GitRepository as cloned from the URL, using their default settings. |
false |
ref | object |
Reference specifies the Git reference to resolve and monitor for
changes, defaults to the 'master' branch. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials for
the GitRepository.
For HTTPS repositories the Secret must contain 'username' and 'password'
fields for basic auth or 'bearerToken' field for token auth.
For SSH repositories the Secret must contain 'identity'
and 'known_hosts' fields. |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
GitRepository. |
false |
timeout | string |
Timeout for Git operations like cloning, defaults to 60s. Default: 60s |
false |
verify | object |
Verification specifies the configuration to verify the Git commit
signature(s). |
false |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.git.include[index]#
GitRepositoryInclude specifies a local reference to a GitRepository which Artifact (sub-)contents must be included, and where they should be placed.
Name | Type | Description | Required |
---|---|---|---|
repository | object |
GitRepositoryRef specifies the GitRepository which Artifact contents
must be included. |
true |
fromPath | string |
FromPath specifies the path to copy contents from, defaults to the root
of the Artifact. |
false |
toPath | string |
ToPath specifies the path to copy contents to, defaults to the name of
the GitRepositoryRef. |
false |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.git.include[index].repository#
GitRepositoryRef specifies the GitRepository which Artifact contents must be included.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.git.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the Git server.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.git.ref#
Reference specifies the Git reference to resolve and monitor for changes, defaults to the 'master' branch.
Name | Type | Description | Required |
---|---|---|---|
branch | string |
Branch to check out, defaults to 'master' if no other field is defined. |
false |
commit | string |
Commit SHA to check out, takes precedence over all reference fields.
This can be combined with Branch to shallow clone the branch, in which
the commit is expected to exist. |
false |
name | string |
Name of the reference to check out; takes precedence over Branch, Tag and SemVer.
It must be a valid Git reference: https://git-scm.com/docs/git-check-ref-format#_description
Examples: "refs/heads/main", "refs/tags/v0.1.0", "refs/pull/420/head", "refs/merge-requests/1/head" |
false |
semver | string |
SemVer tag expression to check out, takes precedence over Tag. |
false |
tag | string |
Tag to check out, takes precedence over Branch. |
false |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.git.secretRef#
SecretRef specifies the Secret containing authentication credentials for the GitRepository. For HTTPS repositories the Secret must contain 'username' and 'password' fields for basic auth or 'bearerToken' field for token auth. For SSH repositories the Secret must contain 'identity' and 'known_hosts' fields.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.git.verify#
Verification specifies the configuration to verify the Git commit signature(s).
Name | Type | Description | Required |
---|---|---|---|
secretRef | object |
SecretRef specifies the Secret containing the public keys of trusted Git
authors. |
true |
mode | enum |
Mode specifies which Git object(s) should be verified.
The variants "head" and "HEAD" both imply the same thing, i.e. verify
the commit that the HEAD of the Git repository points to. The variant
"head" solely exists to ensure backwards compatibility. Enum: head, HEAD, Tag, TagAndHEAD Default: HEAD |
false |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.git.verify.secretRef#
SecretRef specifies the Secret containing the public keys of trusted Git authors.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.oci#
OCI is the definition of OCI repository source.
Name | Type | Description | Required |
---|---|---|---|
interval | string |
Interval at which the OCIRepository URL is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
url | string |
URL is a reference to an OCI artifact repository hosted
on a remote container registry. |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
registry. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
Note: Support for the `caFile`, `certFile` and `keyFile` keys have
been deprecated. |
false |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
insecure | boolean |
Insecure allows connecting to a non-TLS HTTP container registry. |
false |
layerSelector | object |
LayerSelector specifies which layer should be extracted from the OCI artifact.
When not specified, the first layer found in the artifact is selected. |
false |
provider | enum |
The provider used for authentication, can be 'aws', 'azure', 'gcp' or 'generic'.
When not specified, defaults to 'generic'. Enum: generic, aws, azure, gcp Default: generic |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the container registry. |
false |
ref | object |
The OCI reference to pull and monitor for changes,
defaults to the latest tag. |
false |
secretRef | object |
SecretRef contains the secret name containing the registry login
credentials to resolve image metadata.
The secret must be of type kubernetes.io/dockerconfigjson. |
false |
serviceAccountName | string |
ServiceAccountName is the name of the Kubernetes ServiceAccount used to authenticate
the image pull if the service account has attached pull secrets. For more information:
https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#add-imagepullsecrets-to-a-service-account |
false |
suspend | boolean |
This flag tells the controller to suspend the reconciliation of this source. |
false |
timeout | string |
The timeout for remote OCI Repository operations like pulling, defaults to 60s. Default: 60s |
false |
verify | object |
Verify contains the secret name containing the trusted public keys
used to verify the signature and specifies which provider to use to check
whether OCI image is authentic. |
false |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.oci.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
registry. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
Note: Support for the caFile
, certFile
and keyFile
keys have
been deprecated.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.oci.layerSelector#
LayerSelector specifies which layer should be extracted from the OCI artifact. When not specified, the first layer found in the artifact is selected.
Name | Type | Description | Required |
---|---|---|---|
mediaType | string |
MediaType specifies the OCI media type of the layer
which should be extracted from the OCI Artifact. The
first layer matching this type is selected. |
false |
operation | enum |
Operation specifies how the selected layer should be processed.
By default, the layer compressed content is extracted to storage.
When the operation is set to 'copy', the layer compressed content
is persisted to storage as it is. Enum: extract, copy |
false |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.oci.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the container registry.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.oci.ref#
The OCI reference to pull and monitor for changes, defaults to the latest tag.
Name | Type | Description | Required |
---|---|---|---|
digest | string |
Digest is the image digest to pull, takes precedence over SemVer.
The value should be in the format 'sha256: |
false |
semver | string |
SemVer is the range of tags to pull selecting the latest within
the range, takes precedence over Tag. |
false |
semverFilter | string |
SemverFilter is a regex pattern to filter the tags within the SemVer range. |
false |
tag | string |
Tag is the image tag to pull, defaults to latest. |
false |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.oci.secretRef#
SecretRef contains the secret name containing the registry login credentials to resolve image metadata. The secret must be of type kubernetes.io/dockerconfigjson.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.oci.verify#
Verify contains the secret name containing the trusted public keys used to verify the signature and specifies which provider to use to check whether OCI image is authentic.
Name | Type | Description | Required |
---|---|---|---|
provider | enum |
Provider specifies the technology used to sign the OCI Artifact. Enum: cosign, notation Default: cosign |
true |
matchOIDCIdentity | []object |
MatchOIDCIdentity specifies the identity matching criteria to use
while verifying an OCI artifact which was signed using Cosign keyless
signing. The artifact's identity is deemed to be verified if any of the
specified matchers match against the identity. |
false |
secretRef | object |
SecretRef specifies the Kubernetes Secret containing the
trusted public keys. |
false |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.oci.verify.matchOIDCIdentity[index]#
OIDCIdentityMatch specifies options for verifying the certificate identity, i.e. the issuer and the subject of the certificate.
Name | Type | Description | Required |
---|---|---|---|
issuer | string |
Issuer specifies the regex pattern to match against to verify
the OIDC issuer in the Fulcio certificate. The pattern must be a
valid Go regular expression. |
true |
subject | string |
Subject specifies the regex pattern to match against to verify
the identity subject in the Fulcio certificate. The pattern must
be a valid Go regular expression. |
true |
ClusterTemplate.spec.helm.chartSource.remoteSourceSpec.oci.verify.secretRef#
SecretRef specifies the Kubernetes Secret containing the trusted public keys.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.spec.helm.chartSpec#
ChartSpec defines the desired state of the HelmChart to be created by the controller
Name | Type | Description | Required |
---|---|---|---|
chart | string |
Chart is the name or path the Helm chart is available at in the
SourceRef. |
true |
interval | string |
Interval at which the HelmChart SourceRef is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
sourceRef | object |
SourceRef is the reference to the Source the chart is available at. |
true |
ignoreMissingValuesFiles | boolean |
IgnoreMissingValuesFiles controls whether to silently ignore missing values
files rather than failing. |
false |
reconcileStrategy | enum |
ReconcileStrategy determines what enables the creation of a new artifact.
Valid values are ('ChartVersion', 'Revision').
See the documentation of the values for an explanation on their behavior.
Defaults to ChartVersion when omitted. Enum: ChartVersion, Revision Default: ChartVersion |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
source. |
false |
valuesFiles | []string |
ValuesFiles is an alternative list of values files to use as the chart
values (values.yaml is not included by default), expected to be a
relative path in the SourceRef.
Values files are merged in the order of this list with the last file
overriding the first. Ignored when omitted. |
false |
verify | object |
Verify contains the secret name containing the trusted public keys
used to verify the signature and specifies which provider to use to check
whether OCI image is authentic.
This field is only supported when using HelmRepository source with spec.type 'oci'.
Chart dependencies, which are not bundled in the umbrella chart artifact, are not verified. |
false |
version | string |
Version is the chart version semver expression, ignored for charts from
GitRepository and Bucket sources. Defaults to latest when omitted. Default: * |
false |
ClusterTemplate.spec.helm.chartSpec.sourceRef#
SourceRef is the reference to the Source the chart is available at.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind of the referent, valid values are ('HelmRepository', 'GitRepository',
'Bucket'). Enum: HelmRepository, GitRepository, Bucket |
true |
name | string |
Name of the referent. |
true |
apiVersion | string |
APIVersion of the referent. |
false |
ClusterTemplate.spec.helm.chartSpec.verify#
Verify contains the secret name containing the trusted public keys used to verify the signature and specifies which provider to use to check whether OCI image is authentic. This field is only supported when using HelmRepository source with spec.type 'oci'. Chart dependencies, which are not bundled in the umbrella chart artifact, are not verified.
Name | Type | Description | Required |
---|---|---|---|
provider | enum |
Provider specifies the technology used to sign the OCI Artifact. Enum: cosign, notation Default: cosign |
true |
matchOIDCIdentity | []object |
MatchOIDCIdentity specifies the identity matching criteria to use
while verifying an OCI artifact which was signed using Cosign keyless
signing. The artifact's identity is deemed to be verified if any of the
specified matchers match against the identity. |
false |
secretRef | object |
SecretRef specifies the Kubernetes Secret containing the
trusted public keys. |
false |
ClusterTemplate.spec.helm.chartSpec.verify.matchOIDCIdentity[index]#
OIDCIdentityMatch specifies options for verifying the certificate identity, i.e. the issuer and the subject of the certificate.
Name | Type | Description | Required |
---|---|---|---|
issuer | string |
Issuer specifies the regex pattern to match against to verify
the OIDC issuer in the Fulcio certificate. The pattern must be a
valid Go regular expression. |
true |
subject | string |
Subject specifies the regex pattern to match against to verify
the identity subject in the Fulcio certificate. The pattern must
be a valid Go regular expression. |
true |
ClusterTemplate.spec.helm.chartSpec.verify.secretRef#
SecretRef specifies the Kubernetes Secret containing the trusted public keys.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ClusterTemplate.status#
ClusterTemplateStatus defines the observed state of ClusterTemplate
Name | Type | Description | Required |
---|---|---|---|
valid | boolean |
Valid indicates whether the template passed validation or not. |
true |
chartRef | object |
ChartRef is a reference to a source controller resource containing the
Helm chart representing the template. |
false |
chartVersion | string |
ChartVersion represents the version of the Helm Chart associated with this template. |
false |
config | JSON |
Config demonstrates available parameters for template customization,
that can be used when creating ClusterDeployment objects. |
false |
description | string |
Description contains information about the template. |
false |
k8sVersion | string |
Kubernetes exact version in the SemVer format provided by this ClusterTemplate. |
false |
observedGeneration | integer |
ObservedGeneration is the last observed generation. Format: int64 |
false |
providerContracts | map[string]string |
Holds key-value pairs with compatibility [contract versions],
where the key is the name of the provider,
and the value is the provider contract version
required to be supported by the provider.
[contract versions]: https://cluster-api.sigs.k8s.io/developer/providers/contracts |
false |
providers | []string |
Providers represent required CAPI providers. |
false |
validationError | string |
ValidationError provides information regarding issues encountered during template validation. |
false |
ClusterTemplate.status.chartRef#
ChartRef is a reference to a source controller resource containing the Helm chart representing the template.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind of the referent. Enum: OCIRepository, HelmChart |
true |
name | string |
Name of the referent. |
true |
apiVersion | string |
APIVersion of the referent. |
false |
namespace | string |
Namespace of the referent, defaults to the namespace of the Kubernetes
resource object that contains the reference. |
false |
Credential#
Credential is the Schema for the credentials API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | Credential | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
CredentialSpec defines the desired state of Credential |
false |
status | object |
CredentialStatus defines the observed state of Credential |
false |
Credential.spec#
CredentialSpec defines the desired state of Credential
Name | Type | Description | Required |
---|---|---|---|
identityRef | object |
Reference to the Credential Identity |
true |
description | string |
Description of the Credential object |
false |
Credential.spec.identityRef#
Reference to the Credential Identity
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string |
API version of the referent. |
false |
fieldPath | string |
If referring to a piece of an object instead of an entire object, this string
should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2].
For example, if the object reference is to a container within a pod, this would take on a value like:
"spec.containers{name}" (where "name" refers to the name of the container that triggered
the event) or if no container name is specified "spec.containers[2]" (container with
index 2 in this pod). This syntax is chosen only to have some well-defined way of
referencing a part of an object. |
false |
kind | string |
Kind of the referent.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
false |
name | string |
Name of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
false |
namespace | string |
Namespace of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
false |
resourceVersion | string |
Specific resourceVersion to which this reference is made, if any.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
false |
uid | string |
UID of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
false |
Credential.status#
CredentialStatus defines the observed state of Credential
Name | Type | Description | Required |
---|---|---|---|
ready | boolean |
Ready holds the readiness of Credentials. Default: false |
true |
conditions | []object |
Conditions contains details for the current state of the Credential. |
false |
Credential.status.conditions[index]#
Condition contains details for one aspect of the current state of this API Resource.
Name | Type | Description | Required |
---|---|---|---|
lastTransitionTime | string |
lastTransitionTime is the last time the condition transitioned from one status to another.
This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable. Format: date-time |
true |
message | string |
message is a human readable message indicating details about the transition.
This may be an empty string. |
true |
reason | string |
reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty. |
true |
status | enum |
status of the condition, one of True, False, Unknown. Enum: True, False, Unknown |
true |
type | string |
type of condition in CamelCase or in foo.example.com/CamelCase. |
true |
observedGeneration | integer |
observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance. Format: int64 Minimum: 0 |
false |
ManagementBackup#
ManagementBackup is the Schema for the managementbackups API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | ManagementBackup | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
ManagementBackupSpec defines the desired state of ManagementBackup |
false |
status | object |
ManagementBackupStatus defines the observed state of ManagementBackup |
false |
ManagementBackup.spec#
ManagementBackupSpec defines the desired state of ManagementBackup
Name | Type | Description | Required |
---|---|---|---|
performOnManagementUpgrade | boolean |
PerformOnManagementUpgrade indicates that a single [ManagementBackup]
should be created and stored in the [ManagementBackup] storage location if not default
before the [Management] release upgrade. |
false |
schedule | string |
Schedule is a Cron expression defining when to run the scheduled [ManagementBackup].
If not set, the object is considered to be run only once. |
false |
storageLocation | string |
StorageLocation is the name of a [github.com/vmware-tanzu/velero/pkg/apis/velero/v1.StorageLocation]
where the backup should be stored. |
false |
ManagementBackup.status#
ManagementBackupStatus defines the observed state of ManagementBackup
Name | Type | Description | Required |
---|---|---|---|
error | string |
Error stores messages in case of failed backup creation. |
false |
lastBackup | object |
Most recently [github.com/vmware-tanzu/velero/pkg/apis/velero/v1.Backup] that has been created. |
false |
lastBackupName | string |
Name of most recently created [github.com/vmware-tanzu/velero/pkg/apis/velero/v1.Backup]. |
false |
lastBackupTime | string |
Time of the most recently created [github.com/vmware-tanzu/velero/pkg/apis/velero/v1.Backup]. Format: date-time |
false |
nextAttempt | string |
NextAttempt indicates the time when the next backup will be created.
Always absent for a single [ManagementBackup]. Format: date-time |
false |
ManagementBackup.status.lastBackup#
Most recently [github.com/vmware-tanzu/velero/pkg/apis/velero/v1.Backup] that has been created.
Name | Type | Description | Required |
---|---|---|---|
backupItemOperationsAttempted | integer |
BackupItemOperationsAttempted is the total number of attempted
async BackupItemAction operations for this backup. |
false |
backupItemOperationsCompleted | integer |
BackupItemOperationsCompleted is the total number of successfully completed
async BackupItemAction operations for this backup. |
false |
backupItemOperationsFailed | integer |
BackupItemOperationsFailed is the total number of async
BackupItemAction operations for this backup which ended with an error. |
false |
completionTimestamp | string |
CompletionTimestamp records the time a backup was completed.
Completion time is recorded even on failed backups.
Completion time is recorded before uploading the backup object.
The server's time is used for CompletionTimestamps Format: date-time |
false |
csiVolumeSnapshotsAttempted | integer |
CSIVolumeSnapshotsAttempted is the total number of attempted
CSI VolumeSnapshots for this backup. |
false |
csiVolumeSnapshotsCompleted | integer |
CSIVolumeSnapshotsCompleted is the total number of successfully
completed CSI VolumeSnapshots for this backup. |
false |
errors | integer |
Errors is a count of all error messages that were generated during
execution of the backup. The actual errors are in the backup's log
file in object storage. |
false |
expiration | string |
Expiration is when this Backup is eligible for garbage-collection. Format: date-time |
false |
failureReason | string |
FailureReason is an error that caused the entire backup to fail. |
false |
formatVersion | string |
FormatVersion is the backup format version, including major, minor, and patch version. |
false |
hookStatus | object |
HookStatus contains information about the status of the hooks. |
false |
phase | enum |
Phase is the current state of the Backup. Enum: New, FailedValidation, InProgress, WaitingForPluginOperations, WaitingForPluginOperationsPartiallyFailed, Finalizing, FinalizingPartiallyFailed, Completed, PartiallyFailed, Failed, Deleting |
false |
progress | object |
Progress contains information about the backup's execution progress. Note
that this information is best-effort only -- if Velero fails to update it
during a backup for any reason, it may be inaccurate/stale. |
false |
startTimestamp | string |
StartTimestamp records the time a backup was started.
Separate from CreationTimestamp, since that value changes
on restores.
The server's time is used for StartTimestamps Format: date-time |
false |
validationErrors | []string |
ValidationErrors is a slice of all validation errors (if
applicable). |
false |
version | integer |
Version is the backup format major version.
Deprecated: Please see FormatVersion |
false |
volumeSnapshotsAttempted | integer |
VolumeSnapshotsAttempted is the total number of attempted
volume snapshots for this backup. |
false |
volumeSnapshotsCompleted | integer |
VolumeSnapshotsCompleted is the total number of successfully
completed volume snapshots for this backup. |
false |
warnings | integer |
Warnings is a count of all warning messages that were generated during
execution of the backup. The actual warnings are in the backup's log
file in object storage. |
false |
ManagementBackup.status.lastBackup.hookStatus#
HookStatus contains information about the status of the hooks.
Name | Type | Description | Required |
---|---|---|---|
hooksAttempted | integer |
HooksAttempted is the total number of attempted hooks
Specifically, HooksAttempted represents the number of hooks that failed to execute
and the number of hooks that executed successfully. |
false |
hooksFailed | integer |
HooksFailed is the total number of hooks which ended with an error |
false |
ManagementBackup.status.lastBackup.progress#
Progress contains information about the backup's execution progress. Note that this information is best-effort only -- if Velero fails to update it during a backup for any reason, it may be inaccurate/stale.
Name | Type | Description | Required |
---|---|---|---|
itemsBackedUp | integer |
ItemsBackedUp is the number of items that have actually been written to the
backup tarball so far. |
false |
totalItems | integer |
TotalItems is the total number of items to be backed up. This number may change
throughout the execution of the backup due to plugins that return additional related
items to back up, the velero.io/exclude-from-backup label, and various other
filters that happen as items are processed. |
false |
Management#
Management is the Schema for the managements API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | Management | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
ManagementSpec defines the desired state of Management |
false |
status | object |
ManagementStatus defines the observed state of Management |
false |
Management.spec#
ManagementSpec defines the desired state of Management
Name | Type | Description | Required |
---|---|---|---|
release | string |
Release references the Release object. |
true |
core | object |
Core holds the core Management components that are mandatory.
If not specified, will be populated with the default values. |
false |
providers | []object |
Providers is the list of supported CAPI providers. |
false |
Management.spec.core#
Core holds the core Management components that are mandatory. If not specified, will be populated with the default values.
Name | Type | Description | Required |
---|---|---|---|
capi | object |
CAPI represents the core Cluster API component and references the Cluster API template. |
false |
kcm | object |
KCM represents the core KCM component and references the KCM template. |
false |
Management.spec.core.capi#
CAPI represents the core Cluster API component and references the Cluster API template.
Name | Type | Description | Required |
---|---|---|---|
config | JSON |
Config allows to provide parameters for management component customization.
If no Config provided, the field will be populated with the default
values for the template. |
false |
template | string |
Template is the name of the Template associated with this component.
If not specified, will be taken from the Release object. |
false |
Management.spec.core.kcm#
KCM represents the core KCM component and references the KCM template.
Name | Type | Description | Required |
---|---|---|---|
config | JSON |
Config allows to provide parameters for management component customization.
If no Config provided, the field will be populated with the default
values for the template. |
false |
template | string |
Template is the name of the Template associated with this component.
If not specified, will be taken from the Release object. |
false |
Management.spec.providers[index]#
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the provider. |
true |
config | JSON |
Config allows to provide parameters for management component customization.
If no Config provided, the field will be populated with the default
values for the template. |
false |
template | string |
Template is the name of the Template associated with this component.
If not specified, will be taken from the Release object. |
false |
Management.status#
ManagementStatus defines the observed state of Management
Name | Type | Description | Required |
---|---|---|---|
availableProviders | []string |
AvailableProviders holds all available CAPI providers. |
false |
backupName | string |
BackupName is a name of the management cluster scheduled backup. |
false |
capiContracts | map[string]map[string]string |
For each CAPI provider name holds its compatibility [contract versions]
in a key-value pairs, where the key is the core CAPI contract version,
and the value is an underscore-delimited (_) list of provider contract versions
supported by the core CAPI.
[contract versions]: https://cluster-api.sigs.k8s.io/developer/providers/contracts |
false |
components | map[string]object |
Components indicates the status of installed KCM components and CAPI providers. |
false |
conditions | []object |
Conditions represents the observations of a Management's current state. |
false |
observedGeneration | integer |
ObservedGeneration is the last observed generation. Format: int64 |
false |
release | string |
Release indicates the current Release object. |
false |
requestedProviders | []object |
RequestedProviders holds all requested CAPI providers. |
false |
Management.status.components[key]#
ComponentStatus is the status of Management component installation
Name | Type | Description | Required |
---|---|---|---|
error | string |
Error stores as error message in case of failed installation |
false |
success | boolean |
Success represents if a component installation was successful |
false |
template | string |
Template is the name of the Template associated with this component. |
false |
Management.status.conditions[index]#
Condition contains details for one aspect of the current state of this API Resource.
Name | Type | Description | Required |
---|---|---|---|
lastTransitionTime | string |
lastTransitionTime is the last time the condition transitioned from one status to another.
This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable. Format: date-time |
true |
message | string |
message is a human readable message indicating details about the transition.
This may be an empty string. |
true |
reason | string |
reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty. |
true |
status | enum |
status of the condition, one of True, False, Unknown. Enum: True, False, Unknown |
true |
type | string |
type of condition in CamelCase or in foo.example.com/CamelCase. |
true |
observedGeneration | integer |
observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance. Format: int64 Minimum: 0 |
false |
Management.status.requestedProviders[index]#
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the provider. |
true |
config | JSON |
Config allows to provide parameters for management component customization.
If no Config provided, the field will be populated with the default
values for the template. |
false |
template | string |
Template is the name of the Template associated with this component.
If not specified, will be taken from the Release object. |
false |
MultiClusterService#
MultiClusterService is the Schema for the multiclusterservices API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | MultiClusterService | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
MultiClusterServiceSpec defines the desired state of MultiClusterService |
false |
status | object |
MultiClusterServiceStatus defines the observed state of MultiClusterService. |
false |
MultiClusterService.spec#
MultiClusterServiceSpec defines the desired state of MultiClusterService
Name | Type | Description | Required |
---|---|---|---|
clusterSelector | object |
ClusterSelector identifies target clusters to manage services on. |
false |
serviceSpec | object |
ServiceSpec is spec related to deployment of services. |
false |
MultiClusterService.spec.clusterSelector#
ClusterSelector identifies target clusters to manage services on.
Name | Type | Description | Required |
---|---|---|---|
matchExpressions | []object |
matchExpressions is a list of label selector requirements. The requirements are ANDed. |
false |
matchLabels | map[string]string |
matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels
map is equivalent to an element of matchExpressions, whose key field is "key", the
operator is "In", and the values array contains only "value". The requirements are ANDed. |
false |
MultiClusterService.spec.clusterSelector.matchExpressions[index]#
A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
Name | Type | Description | Required |
---|---|---|---|
key | string |
key is the label key that the selector applies to. |
true |
operator | string |
operator represents a key's relationship to a set of values.
Valid operators are In, NotIn, Exists and DoesNotExist. |
true |
values | []string |
values is an array of string values. If the operator is In or NotIn,
the values array must be non-empty. If the operator is Exists or DoesNotExist,
the values array must be empty. This array is replaced during a strategic
merge patch. |
false |
MultiClusterService.spec.serviceSpec#
ServiceSpec is spec related to deployment of services.
Name | Type | Description | Required |
---|---|---|---|
continueOnError | boolean |
ContinueOnError specifies if the services deployment should continue if an error occurs. Default: false |
false |
driftExclusions | []object |
DriftExclusions specifies specific configurations of resources to ignore for drift detection. |
false |
driftIgnore | []object |
DriftIgnore specifies resources to ignore for drift detection. |
false |
priority | integer |
Priority sets the priority for the services defined in this spec.
Higher value means higher priority and lower means lower.
In case of conflict with another object managing the service,
the one with higher priority will get to deploy its services. Format: int32 Default: 100 Minimum: 1 Maximum: 2.147483646e+09 |
false |
reload | boolean |
Reload instances via rolling upgrade when a ConfigMap/Secret mounted as volume is modified. |
false |
services | []object |
Services is a list of services created via ServiceTemplates
that could be installed on the target cluster. |
false |
stopOnConflict | boolean |
StopOnConflict specifies what to do in case of a conflict.
E.g. If another object is already managing a service.
By default the remaining services will be deployed even if conflict is detected.
If set to true, the deployment will stop after encountering the first conflict. Default: false |
false |
syncMode | enum |
SyncMode specifies how services are synced in the target cluster. Enum: OneTime, Continuous, ContinuousWithDriftDetection, DryRun Default: Continuous |
false |
templateResourceRefs | []object |
TemplateResourceRefs is a list of resources to collect from the management cluster,
the values from which can be used in templates. |
false |
MultiClusterService.spec.serviceSpec.driftExclusions[index]#
Name | Type | Description | Required |
---|---|---|---|
paths | []string |
Paths is a slice of JSON6902 paths to exclude from configuration drift evaluation. |
true |
target | object |
Target points to the resources that the paths refers to. |
false |
MultiClusterService.spec.serviceSpec.driftExclusions[index].target#
Target points to the resources that the paths refers to.
Name | Type | Description | Required |
---|---|---|---|
annotationSelector | string |
AnnotationSelector is a string that follows the label selection expression
https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
It matches with the resource annotations. |
false |
group | string |
Group is the API group to select resources from.
Together with Version and Kind it is capable of unambiguously identifying and/or selecting resources.
https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md |
false |
kind | string |
Kind of the API Group to select resources from.
Together with Group and Version it is capable of unambiguously
identifying and/or selecting resources.
https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md |
false |
labelSelector | string |
LabelSelector is a string that follows the label selection expression
https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
It matches with the resource labels. |
false |
name | string |
Name to match resources with. |
false |
namespace | string |
Namespace to select resources from. |
false |
version | string |
Version of the API Group to select resources from.
Together with Group and Kind it is capable of unambiguously identifying and/or selecting resources.
https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md |
false |
MultiClusterService.spec.serviceSpec.driftIgnore[index]#
Name | Type | Description | Required |
---|---|---|---|
annotationSelector | string |
AnnotationSelector is a string that follows the label selection expression
https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
It matches with the resource annotations. |
false |
group | string |
Group is the API group to select resources from.
Together with Version and Kind it is capable of unambiguously identifying and/or selecting resources.
https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md |
false |
kind | string |
Kind of the API Group to select resources from.
Together with Group and Version it is capable of unambiguously
identifying and/or selecting resources.
https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md |
false |
labelSelector | string |
LabelSelector is a string that follows the label selection expression
https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
It matches with the resource labels. |
false |
name | string |
Name to match resources with. |
false |
namespace | string |
Namespace to select resources from. |
false |
version | string |
Version of the API Group to select resources from.
Together with Group and Kind it is capable of unambiguously identifying and/or selecting resources.
https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md |
false |
MultiClusterService.spec.serviceSpec.services[index]#
Service represents a Service to be deployed.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name is the chart release. |
true |
template | string |
Template is a reference to a Template object located in the same namespace. |
true |
disable | boolean |
Disable can be set to disable handling of this service. |
false |
namespace | string |
Namespace is the namespace the release will be installed in.
It will default to Name if not provided. |
false |
values | string |
Values is the helm values to be passed to the chart used by the template.
The string type is used in order to allow for templating. |
false |
valuesFrom | []object |
ValuesFrom can reference a ConfigMap or Secret containing helm values. |
false |
MultiClusterService.spec.serviceSpec.services[index].valuesFrom[index]#
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind of the resource. Supported kinds are:
- ConfigMap/Secret Enum: ConfigMap, Secret |
true |
name | string |
Name of the referenced resource.
Name can be expressed as a template and instantiate using
- cluster namespace: .Cluster.metadata.namespace
- cluster name: .Cluster.metadata.name
- cluster type: .Cluster.kind |
true |
namespace | string |
Namespace of the referenced resource.
For ClusterProfile namespace can be left empty. In such a case, namespace will
be implicit set to cluster's namespace.
For Profile namespace must be left empty. The Profile namespace will be used. |
false |
MultiClusterService.spec.serviceSpec.templateResourceRefs[index]#
Name | Type | Description | Required |
---|---|---|---|
identifier | string |
Identifier is how the resource will be referred to in the
template |
true |
resource | object |
Resource references a Kubernetes instance in the management
cluster to fetch and use during template instantiation.
For ClusterProfile namespace can be left empty. In such a case, namespace will
be implicit set to cluster's namespace.
Name and namespace can be expressed as a template and instantiate using
- cluster namespace: .Cluster.metadata.namespace
- cluster name: .Cluster.metadata.name
- cluster type: .Cluster.kind |
true |
MultiClusterService.spec.serviceSpec.templateResourceRefs[index].resource#
Resource references a Kubernetes instance in the management cluster to fetch and use during template instantiation. For ClusterProfile namespace can be left empty. In such a case, namespace will be implicit set to cluster's namespace. Name and namespace can be expressed as a template and instantiate using - cluster namespace: .Cluster.metadata.namespace - cluster name: .Cluster.metadata.name - cluster type: .Cluster.kind
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string |
API version of the referent. |
false |
fieldPath | string |
If referring to a piece of an object instead of an entire object, this string
should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2].
For example, if the object reference is to a container within a pod, this would take on a value like:
"spec.containers{name}" (where "name" refers to the name of the container that triggered
the event) or if no container name is specified "spec.containers[2]" (container with
index 2 in this pod). This syntax is chosen only to have some well-defined way of
referencing a part of an object. |
false |
kind | string |
Kind of the referent.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
false |
name | string |
Name of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
false |
namespace | string |
Namespace of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
false |
resourceVersion | string |
Specific resourceVersion to which this reference is made, if any.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
false |
uid | string |
UID of the referent.
More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
false |
MultiClusterService.status#
MultiClusterServiceStatus defines the observed state of MultiClusterService.
Name | Type | Description | Required |
---|---|---|---|
conditions | []object |
Conditions contains details for the current state of the MultiClusterService. |
false |
observedGeneration | integer |
ObservedGeneration is the last observed generation. Format: int64 |
false |
services | []object |
Services contains details for the state of services. |
false |
MultiClusterService.status.conditions[index]#
Condition contains details for one aspect of the current state of this API Resource.
Name | Type | Description | Required |
---|---|---|---|
lastTransitionTime | string |
lastTransitionTime is the last time the condition transitioned from one status to another.
This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable. Format: date-time |
true |
message | string |
message is a human readable message indicating details about the transition.
This may be an empty string. |
true |
reason | string |
reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty. |
true |
status | enum |
status of the condition, one of True, False, Unknown. Enum: True, False, Unknown |
true |
type | string |
type of condition in CamelCase or in foo.example.com/CamelCase. |
true |
observedGeneration | integer |
observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance. Format: int64 Minimum: 0 |
false |
MultiClusterService.status.services[index]#
ServiceStatus contains details for the state of services.
Name | Type | Description | Required |
---|---|---|---|
clusterName | string |
ClusterName is the name of the associated cluster. |
true |
clusterNamespace | string |
ClusterNamespace is the namespace of the associated cluster. |
false |
conditions | []object |
Conditions contains details for the current state of managed services. |
false |
MultiClusterService.status.services[index].conditions[index]#
Condition contains details for one aspect of the current state of this API Resource.
Name | Type | Description | Required |
---|---|---|---|
lastTransitionTime | string |
lastTransitionTime is the last time the condition transitioned from one status to another.
This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable. Format: date-time |
true |
message | string |
message is a human readable message indicating details about the transition.
This may be an empty string. |
true |
reason | string |
reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty. |
true |
status | enum |
status of the condition, one of True, False, Unknown. Enum: True, False, Unknown |
true |
type | string |
type of condition in CamelCase or in foo.example.com/CamelCase. |
true |
observedGeneration | integer |
observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance. Format: int64 Minimum: 0 |
false |
PluggableProvider#
PluggableProvider is the Schema for the PluggableProvider API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | PluggableProvider | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
PluggableProviderSpec defines the desired state of PluggableProvider |
false |
status | object |
PluggableProviderStatus defines the observed state of PluggableProvider |
false |
PluggableProvider.spec#
PluggableProviderSpec defines the desired state of PluggableProvider
Name | Type | Description | Required |
---|---|---|---|
clusterGVKs | []object |
ClusterGVKs defines the Group-Version-Kind resources this provider can manage |
false |
clusterIdentityKinds | []string |
ClusterIdentityKinds defines the Kind of identity objects supported by this provider |
false |
config | JSON |
Config allows to provide parameters for management component customization.
If no Config provided, the field will be populated with the default
values for the template. |
false |
description | string |
Description provides a human-readable explanation of what this provider does |
false |
template | string |
Template is the name of the Template associated with this component.
If not specified, will be taken from the Release object. |
false |
PluggableProvider.spec.clusterGVKs[index]#
GroupVersionKind unambiguously identifies a kind. It doesn't anonymously include GroupVersion to avoid automatic coercion. It doesn't use a GroupVersion to avoid custom marshalling Note: mirror of https://github.com/kubernetes/apimachinery/blob/v0.32.3/pkg/runtime/schema/group_version.go#L140-L146
Name | Type | Description | Required |
---|---|---|---|
group | string |
|
true |
kind | string |
|
true |
version | string |
|
true |
PluggableProvider.status#
PluggableProviderStatus defines the observed state of PluggableProvider
Name | Type | Description | Required |
---|---|---|---|
exposedProviders | string |
ExposedProviders contains the list of exposed provider |
false |
ProviderTemplate#
ProviderTemplate is the Schema for the providertemplates API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | ProviderTemplate | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
ProviderTemplateSpec defines the desired state of ProviderTemplate Validations: |
false |
status | object |
ProviderTemplateStatus defines the observed state of ProviderTemplate |
false |
ProviderTemplate.spec#
ProviderTemplateSpec defines the desired state of ProviderTemplate
Name | Type | Description | Required |
---|---|---|---|
capiContracts | map[string]string |
Holds key-value pairs with compatibility [contract versions],
where the key is the core CAPI contract version,
and the value is an underscore-delimited (_) list of provider contract versions
supported by the core CAPI.
[contract versions]: https://cluster-api.sigs.k8s.io/developer/providers/contracts |
false |
helm | object |
HelmSpec references a Helm chart representing the KCM template Validations: |
false |
providers | []string |
Providers represent exposed CAPI providers.
Should be set if not present in the Helm chart metadata. |
false |
ProviderTemplate.spec.helm#
HelmSpec references a Helm chart representing the KCM template
Name | Type | Description | Required |
---|---|---|---|
chartRef | object |
ChartRef is a reference to a source controller resource containing the
Helm chart representing the template. |
false |
chartSource | object |
ChartSource is a source of a Helm chart representing the template. Validations: |
false |
chartSpec | object |
ChartSpec defines the desired state of the HelmChart to be created by the controller |
false |
ProviderTemplate.spec.helm.chartRef#
ChartRef is a reference to a source controller resource containing the Helm chart representing the template.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind of the referent. Enum: OCIRepository, HelmChart |
true |
name | string |
Name of the referent. |
true |
apiVersion | string |
APIVersion of the referent. |
false |
namespace | string |
Namespace of the referent, defaults to the namespace of the Kubernetes
resource object that contains the reference. |
false |
ProviderTemplate.spec.helm.chartSource#
ChartSource is a source of a Helm chart representing the template.
Name | Type | Description | Required |
---|---|---|---|
deploymentType | enum |
DeploymentType is the type of the deployment. This field is ignored,
when ResourceSpec is used as part of Helm chart configuration. Enum: Local, Remote Default: Remote |
true |
path | string |
Path to the directory containing the resource manifest. |
true |
localSourceRef | object |
LocalSourceRef is the local source of the kustomize manifest. |
false |
remoteSourceSpec | object |
RemoteSourceSpec is the remote source of the kustomize manifest. Validations: |
false |
ProviderTemplate.spec.helm.chartSource.localSourceRef#
LocalSourceRef is the local source of the kustomize manifest.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind is the kind of the local source. Enum: ConfigMap, Secret, GitRepository, Bucket, OCIRepository |
true |
name | string |
Name is the name of the local source. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec#
RemoteSourceSpec is the remote source of the kustomize manifest.
Name | Type | Description | Required |
---|---|---|---|
bucket | object |
Bucket is the definition of bucket source. Validations: |
false |
git | object |
Git is the definition of git repository source. |
false |
oci | object |
OCI is the definition of OCI repository source. |
false |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.bucket#
Bucket is the definition of bucket source.
Name | Type | Description | Required |
---|---|---|---|
bucketName | string |
BucketName is the name of the object storage bucket. |
true |
endpoint | string |
Endpoint is the object storage address the BucketName is located at. |
true |
interval | string |
Interval at which the Bucket Endpoint is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
bucket. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
This field is only supported for the `generic` provider. |
false |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
insecure | boolean |
Insecure allows connecting to a non-TLS HTTP Endpoint. |
false |
prefix | string |
Prefix to use for server-side filtering of files in the Bucket. |
false |
provider | enum |
Provider of the object storage bucket.
Defaults to 'generic', which expects an S3 (API) compatible object
storage. Enum: generic, aws, gcp, azure Default: generic |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the Bucket server. |
false |
region | string |
Region of the Endpoint where the BucketName is located in. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials
for the Bucket. |
false |
sts | object |
STS specifies the required configuration to use a Security Token
Service for fetching temporary credentials to authenticate in a
Bucket provider.
This field is only supported for the `aws` and `generic` providers. |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
Bucket. |
false |
timeout | string |
Timeout for fetch operations, defaults to 60s. Default: 60s |
false |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
bucket. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
This field is only supported for the generic
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the Bucket server.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.secretRef#
SecretRef specifies the Secret containing authentication credentials for the Bucket.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.sts#
STS specifies the required configuration to use a Security Token Service for fetching temporary credentials to authenticate in a Bucket provider.
This field is only supported for the aws
and generic
providers.
Name | Type | Description | Required |
---|---|---|---|
endpoint | string |
Endpoint is the HTTP/S endpoint of the Security Token Service from
where temporary credentials will be fetched. |
true |
provider | enum |
Provider of the Security Token Service. Enum: aws, ldap |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
STS endpoint. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
This field is only supported for the `ldap` provider. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials
for the STS endpoint. This Secret must contain the fields `username`
and `password` and is supported only for the `ldap` provider. |
false |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.sts.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
STS endpoint. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
This field is only supported for the ldap
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.sts.secretRef#
SecretRef specifies the Secret containing authentication credentials
for the STS endpoint. This Secret must contain the fields username
and password
and is supported only for the ldap
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.git#
Git is the definition of git repository source.
Name | Type | Description | Required |
---|---|---|---|
interval | string |
Interval at which the GitRepository URL is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
url | string |
URL specifies the Git repository URL, it can be an HTTP/S or SSH address. |
true |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
include | []object |
Include specifies a list of GitRepository resources which Artifacts
should be included in the Artifact produced for this GitRepository. |
false |
provider | enum |
Provider used for authentication, can be 'azure', 'github', 'generic'.
When not specified, defaults to 'generic'. Enum: generic, azure, github |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the Git server. |
false |
recurseSubmodules | boolean |
RecurseSubmodules enables the initialization of all submodules within
the GitRepository as cloned from the URL, using their default settings. |
false |
ref | object |
Reference specifies the Git reference to resolve and monitor for
changes, defaults to the 'master' branch. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials for
the GitRepository.
For HTTPS repositories the Secret must contain 'username' and 'password'
fields for basic auth or 'bearerToken' field for token auth.
For SSH repositories the Secret must contain 'identity'
and 'known_hosts' fields. |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
GitRepository. |
false |
timeout | string |
Timeout for Git operations like cloning, defaults to 60s. Default: 60s |
false |
verify | object |
Verification specifies the configuration to verify the Git commit
signature(s). |
false |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.git.include[index]#
GitRepositoryInclude specifies a local reference to a GitRepository which Artifact (sub-)contents must be included, and where they should be placed.
Name | Type | Description | Required |
---|---|---|---|
repository | object |
GitRepositoryRef specifies the GitRepository which Artifact contents
must be included. |
true |
fromPath | string |
FromPath specifies the path to copy contents from, defaults to the root
of the Artifact. |
false |
toPath | string |
ToPath specifies the path to copy contents to, defaults to the name of
the GitRepositoryRef. |
false |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.git.include[index].repository#
GitRepositoryRef specifies the GitRepository which Artifact contents must be included.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.git.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the Git server.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.git.ref#
Reference specifies the Git reference to resolve and monitor for changes, defaults to the 'master' branch.
Name | Type | Description | Required |
---|---|---|---|
branch | string |
Branch to check out, defaults to 'master' if no other field is defined. |
false |
commit | string |
Commit SHA to check out, takes precedence over all reference fields.
This can be combined with Branch to shallow clone the branch, in which
the commit is expected to exist. |
false |
name | string |
Name of the reference to check out; takes precedence over Branch, Tag and SemVer.
It must be a valid Git reference: https://git-scm.com/docs/git-check-ref-format#_description
Examples: "refs/heads/main", "refs/tags/v0.1.0", "refs/pull/420/head", "refs/merge-requests/1/head" |
false |
semver | string |
SemVer tag expression to check out, takes precedence over Tag. |
false |
tag | string |
Tag to check out, takes precedence over Branch. |
false |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.git.secretRef#
SecretRef specifies the Secret containing authentication credentials for the GitRepository. For HTTPS repositories the Secret must contain 'username' and 'password' fields for basic auth or 'bearerToken' field for token auth. For SSH repositories the Secret must contain 'identity' and 'known_hosts' fields.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.git.verify#
Verification specifies the configuration to verify the Git commit signature(s).
Name | Type | Description | Required |
---|---|---|---|
secretRef | object |
SecretRef specifies the Secret containing the public keys of trusted Git
authors. |
true |
mode | enum |
Mode specifies which Git object(s) should be verified.
The variants "head" and "HEAD" both imply the same thing, i.e. verify
the commit that the HEAD of the Git repository points to. The variant
"head" solely exists to ensure backwards compatibility. Enum: head, HEAD, Tag, TagAndHEAD Default: HEAD |
false |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.git.verify.secretRef#
SecretRef specifies the Secret containing the public keys of trusted Git authors.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.oci#
OCI is the definition of OCI repository source.
Name | Type | Description | Required |
---|---|---|---|
interval | string |
Interval at which the OCIRepository URL is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
url | string |
URL is a reference to an OCI artifact repository hosted
on a remote container registry. |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
registry. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
Note: Support for the `caFile`, `certFile` and `keyFile` keys have
been deprecated. |
false |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
insecure | boolean |
Insecure allows connecting to a non-TLS HTTP container registry. |
false |
layerSelector | object |
LayerSelector specifies which layer should be extracted from the OCI artifact.
When not specified, the first layer found in the artifact is selected. |
false |
provider | enum |
The provider used for authentication, can be 'aws', 'azure', 'gcp' or 'generic'.
When not specified, defaults to 'generic'. Enum: generic, aws, azure, gcp Default: generic |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the container registry. |
false |
ref | object |
The OCI reference to pull and monitor for changes,
defaults to the latest tag. |
false |
secretRef | object |
SecretRef contains the secret name containing the registry login
credentials to resolve image metadata.
The secret must be of type kubernetes.io/dockerconfigjson. |
false |
serviceAccountName | string |
ServiceAccountName is the name of the Kubernetes ServiceAccount used to authenticate
the image pull if the service account has attached pull secrets. For more information:
https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#add-imagepullsecrets-to-a-service-account |
false |
suspend | boolean |
This flag tells the controller to suspend the reconciliation of this source. |
false |
timeout | string |
The timeout for remote OCI Repository operations like pulling, defaults to 60s. Default: 60s |
false |
verify | object |
Verify contains the secret name containing the trusted public keys
used to verify the signature and specifies which provider to use to check
whether OCI image is authentic. |
false |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.oci.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
registry. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
Note: Support for the caFile
, certFile
and keyFile
keys have
been deprecated.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.oci.layerSelector#
LayerSelector specifies which layer should be extracted from the OCI artifact. When not specified, the first layer found in the artifact is selected.
Name | Type | Description | Required |
---|---|---|---|
mediaType | string |
MediaType specifies the OCI media type of the layer
which should be extracted from the OCI Artifact. The
first layer matching this type is selected. |
false |
operation | enum |
Operation specifies how the selected layer should be processed.
By default, the layer compressed content is extracted to storage.
When the operation is set to 'copy', the layer compressed content
is persisted to storage as it is. Enum: extract, copy |
false |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.oci.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the container registry.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.oci.ref#
The OCI reference to pull and monitor for changes, defaults to the latest tag.
Name | Type | Description | Required |
---|---|---|---|
digest | string |
Digest is the image digest to pull, takes precedence over SemVer.
The value should be in the format 'sha256: |
false |
semver | string |
SemVer is the range of tags to pull selecting the latest within
the range, takes precedence over Tag. |
false |
semverFilter | string |
SemverFilter is a regex pattern to filter the tags within the SemVer range. |
false |
tag | string |
Tag is the image tag to pull, defaults to latest. |
false |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.oci.secretRef#
SecretRef contains the secret name containing the registry login credentials to resolve image metadata. The secret must be of type kubernetes.io/dockerconfigjson.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.oci.verify#
Verify contains the secret name containing the trusted public keys used to verify the signature and specifies which provider to use to check whether OCI image is authentic.
Name | Type | Description | Required |
---|---|---|---|
provider | enum |
Provider specifies the technology used to sign the OCI Artifact. Enum: cosign, notation Default: cosign |
true |
matchOIDCIdentity | []object |
MatchOIDCIdentity specifies the identity matching criteria to use
while verifying an OCI artifact which was signed using Cosign keyless
signing. The artifact's identity is deemed to be verified if any of the
specified matchers match against the identity. |
false |
secretRef | object |
SecretRef specifies the Kubernetes Secret containing the
trusted public keys. |
false |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.oci.verify.matchOIDCIdentity[index]#
OIDCIdentityMatch specifies options for verifying the certificate identity, i.e. the issuer and the subject of the certificate.
Name | Type | Description | Required |
---|---|---|---|
issuer | string |
Issuer specifies the regex pattern to match against to verify
the OIDC issuer in the Fulcio certificate. The pattern must be a
valid Go regular expression. |
true |
subject | string |
Subject specifies the regex pattern to match against to verify
the identity subject in the Fulcio certificate. The pattern must
be a valid Go regular expression. |
true |
ProviderTemplate.spec.helm.chartSource.remoteSourceSpec.oci.verify.secretRef#
SecretRef specifies the Kubernetes Secret containing the trusted public keys.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.spec.helm.chartSpec#
ChartSpec defines the desired state of the HelmChart to be created by the controller
Name | Type | Description | Required |
---|---|---|---|
chart | string |
Chart is the name or path the Helm chart is available at in the
SourceRef. |
true |
interval | string |
Interval at which the HelmChart SourceRef is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
sourceRef | object |
SourceRef is the reference to the Source the chart is available at. |
true |
ignoreMissingValuesFiles | boolean |
IgnoreMissingValuesFiles controls whether to silently ignore missing values
files rather than failing. |
false |
reconcileStrategy | enum |
ReconcileStrategy determines what enables the creation of a new artifact.
Valid values are ('ChartVersion', 'Revision').
See the documentation of the values for an explanation on their behavior.
Defaults to ChartVersion when omitted. Enum: ChartVersion, Revision Default: ChartVersion |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
source. |
false |
valuesFiles | []string |
ValuesFiles is an alternative list of values files to use as the chart
values (values.yaml is not included by default), expected to be a
relative path in the SourceRef.
Values files are merged in the order of this list with the last file
overriding the first. Ignored when omitted. |
false |
verify | object |
Verify contains the secret name containing the trusted public keys
used to verify the signature and specifies which provider to use to check
whether OCI image is authentic.
This field is only supported when using HelmRepository source with spec.type 'oci'.
Chart dependencies, which are not bundled in the umbrella chart artifact, are not verified. |
false |
version | string |
Version is the chart version semver expression, ignored for charts from
GitRepository and Bucket sources. Defaults to latest when omitted. Default: * |
false |
ProviderTemplate.spec.helm.chartSpec.sourceRef#
SourceRef is the reference to the Source the chart is available at.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind of the referent, valid values are ('HelmRepository', 'GitRepository',
'Bucket'). Enum: HelmRepository, GitRepository, Bucket |
true |
name | string |
Name of the referent. |
true |
apiVersion | string |
APIVersion of the referent. |
false |
ProviderTemplate.spec.helm.chartSpec.verify#
Verify contains the secret name containing the trusted public keys used to verify the signature and specifies which provider to use to check whether OCI image is authentic. This field is only supported when using HelmRepository source with spec.type 'oci'. Chart dependencies, which are not bundled in the umbrella chart artifact, are not verified.
Name | Type | Description | Required |
---|---|---|---|
provider | enum |
Provider specifies the technology used to sign the OCI Artifact. Enum: cosign, notation Default: cosign |
true |
matchOIDCIdentity | []object |
MatchOIDCIdentity specifies the identity matching criteria to use
while verifying an OCI artifact which was signed using Cosign keyless
signing. The artifact's identity is deemed to be verified if any of the
specified matchers match against the identity. |
false |
secretRef | object |
SecretRef specifies the Kubernetes Secret containing the
trusted public keys. |
false |
ProviderTemplate.spec.helm.chartSpec.verify.matchOIDCIdentity[index]#
OIDCIdentityMatch specifies options for verifying the certificate identity, i.e. the issuer and the subject of the certificate.
Name | Type | Description | Required |
---|---|---|---|
issuer | string |
Issuer specifies the regex pattern to match against to verify
the OIDC issuer in the Fulcio certificate. The pattern must be a
valid Go regular expression. |
true |
subject | string |
Subject specifies the regex pattern to match against to verify
the identity subject in the Fulcio certificate. The pattern must
be a valid Go regular expression. |
true |
ProviderTemplate.spec.helm.chartSpec.verify.secretRef#
SecretRef specifies the Kubernetes Secret containing the trusted public keys.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ProviderTemplate.status#
ProviderTemplateStatus defines the observed state of ProviderTemplate
Name | Type | Description | Required |
---|---|---|---|
valid | boolean |
Valid indicates whether the template passed validation or not. |
true |
capiContracts | map[string]string |
Holds key-value pairs with compatibility [contract versions],
where the key is the core CAPI contract version,
and the value is an underscore-delimited (_) list of provider contract versions
supported by the core CAPI.
[contract versions]: https://cluster-api.sigs.k8s.io/developer/providers/contracts |
false |
chartRef | object |
ChartRef is a reference to a source controller resource containing the
Helm chart representing the template. |
false |
chartVersion | string |
ChartVersion represents the version of the Helm Chart associated with this template. |
false |
config | JSON |
Config demonstrates available parameters for template customization,
that can be used when creating ClusterDeployment objects. |
false |
description | string |
Description contains information about the template. |
false |
observedGeneration | integer |
ObservedGeneration is the last observed generation. Format: int64 |
false |
providers | []string |
Providers represent exposed CAPI providers. |
false |
validationError | string |
ValidationError provides information regarding issues encountered during template validation. |
false |
ProviderTemplate.status.chartRef#
ChartRef is a reference to a source controller resource containing the Helm chart representing the template.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind of the referent. Enum: OCIRepository, HelmChart |
true |
name | string |
Name of the referent. |
true |
apiVersion | string |
APIVersion of the referent. |
false |
namespace | string |
Namespace of the referent, defaults to the namespace of the Kubernetes
resource object that contains the reference. |
false |
Release#
Release is the Schema for the releases API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | Release | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
ReleaseSpec defines the desired state of Release |
false |
status | object |
ReleaseStatus defines the observed state of Release |
false |
Release.spec#
ReleaseSpec defines the desired state of Release
Name | Type | Description | Required |
---|---|---|---|
capi | object |
CAPI references the Cluster API template. |
true |
kcm | object |
KCM references the KCM template. |
true |
version | string |
Version of the KCM Release in the semver format. |
true |
providers | []object |
Providers contains a list of Providers associated with the Release. |
false |
Release.spec.capi#
CAPI references the Cluster API template.
Name | Type | Description | Required |
---|---|---|---|
template | string |
Template references the Template associated with the provider. |
true |
Release.spec.kcm#
KCM references the KCM template.
Name | Type | Description | Required |
---|---|---|---|
template | string |
Template references the Template associated with the provider. |
true |
Release.spec.providers[index]#
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the provider. |
true |
template | string |
Template references the Template associated with the provider. |
true |
Release.status#
ReleaseStatus defines the observed state of Release
Name | Type | Description | Required |
---|---|---|---|
conditions | []object |
Conditions contains details for the current state of the Release |
false |
observedGeneration | integer |
ObservedGeneration is the last observed generation. Format: int64 |
false |
ready | boolean |
Ready indicates whether KCM is ready to be upgraded to this Release. |
false |
Release.status.conditions[index]#
Condition contains details for one aspect of the current state of this API Resource.
Name | Type | Description | Required |
---|---|---|---|
lastTransitionTime | string |
lastTransitionTime is the last time the condition transitioned from one status to another.
This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable. Format: date-time |
true |
message | string |
message is a human readable message indicating details about the transition.
This may be an empty string. |
true |
reason | string |
reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty. |
true |
status | enum |
status of the condition, one of True, False, Unknown. Enum: True, False, Unknown |
true |
type | string |
type of condition in CamelCase or in foo.example.com/CamelCase. |
true |
observedGeneration | integer |
observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance. Format: int64 Minimum: 0 |
false |
ServiceTemplateChain#
ServiceTemplateChain is the Schema for the servicetemplatechains API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | ServiceTemplateChain | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
TemplateChainSpec defines the desired state of *TemplateChain Validations: |
false |
status | object |
TemplateChainStatus defines the observed state of *TemplateChain |
false |
ServiceTemplateChain.spec#
TemplateChainSpec defines the desired state of *TemplateChain
Name | Type | Description | Required |
---|---|---|---|
supportedTemplates | []object |
SupportedTemplates is the list of supported Templates definitions and all available upgrade sequences for it. |
false |
ServiceTemplateChain.spec.supportedTemplates[index]#
SupportedTemplate is the supported Template definition and all available upgrade sequences for it
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name is the name of the Template. |
true |
availableUpgrades | []object |
AvailableUpgrades is the list of available upgrades for the specified Template. |
false |
ServiceTemplateChain.spec.supportedTemplates[index].availableUpgrades[index]#
AvailableUpgrade is the definition of the available upgrade for the Template
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name is the name of the Template to which the upgrade is available. |
true |
ServiceTemplateChain.status#
TemplateChainStatus defines the observed state of *TemplateChain
Name | Type | Description | Required |
---|---|---|---|
valid | boolean |
Valid indicates whether the chain is valid and can be considered when calculating available
upgrade paths. |
false |
validationError | string |
ValidationError provides information regarding issues encountered during templatechain validation. |
false |
ServiceTemplate#
ServiceTemplate is the Schema for the servicetemplates API
Name | Type | Description | Required |
---|---|---|---|
apiVersion | string | k0rdent.mirantis.com/v1alpha1 | true |
kind | string | ServiceTemplate | true |
metadata | object | Refer to the Kubernetes API documentation for the fields of the `metadata` field. | true |
spec | object |
ServiceTemplateSpec defines the desired state of ServiceTemplate Validations: |
false |
status | object |
ServiceTemplateStatus defines the observed state of ServiceTemplate |
false |
ServiceTemplate.spec#
ServiceTemplateSpec defines the desired state of ServiceTemplate
Name | Type | Description | Required |
---|---|---|---|
helm | object |
Helm contains the Helm chart information for the template. Validations: |
false |
k8sConstraint | string |
Constraint describing compatible K8S versions of the cluster set in the SemVer format. |
false |
kustomize | object |
Kustomize contains the Kustomize configuration for the template. Validations: |
false |
resources | object |
Resources contains the resource configuration for the template. Validations: |
false |
ServiceTemplate.spec.helm#
Helm contains the Helm chart information for the template.
Name | Type | Description | Required |
---|---|---|---|
chartRef | object |
ChartRef is a reference to a source controller resource containing the
Helm chart representing the template. |
false |
chartSource | object |
ChartSource is a source of a Helm chart representing the template. Validations: |
false |
chartSpec | object |
ChartSpec defines the desired state of the HelmChart to be created by the controller |
false |
ServiceTemplate.spec.helm.chartRef#
ChartRef is a reference to a source controller resource containing the Helm chart representing the template.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind of the referent. Enum: OCIRepository, HelmChart |
true |
name | string |
Name of the referent. |
true |
apiVersion | string |
APIVersion of the referent. |
false |
namespace | string |
Namespace of the referent, defaults to the namespace of the Kubernetes
resource object that contains the reference. |
false |
ServiceTemplate.spec.helm.chartSource#
ChartSource is a source of a Helm chart representing the template.
Name | Type | Description | Required |
---|---|---|---|
deploymentType | enum |
DeploymentType is the type of the deployment. This field is ignored,
when ResourceSpec is used as part of Helm chart configuration. Enum: Local, Remote Default: Remote |
true |
path | string |
Path to the directory containing the resource manifest. |
true |
localSourceRef | object |
LocalSourceRef is the local source of the kustomize manifest. |
false |
remoteSourceSpec | object |
RemoteSourceSpec is the remote source of the kustomize manifest. Validations: |
false |
ServiceTemplate.spec.helm.chartSource.localSourceRef#
LocalSourceRef is the local source of the kustomize manifest.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind is the kind of the local source. Enum: ConfigMap, Secret, GitRepository, Bucket, OCIRepository |
true |
name | string |
Name is the name of the local source. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec#
RemoteSourceSpec is the remote source of the kustomize manifest.
Name | Type | Description | Required |
---|---|---|---|
bucket | object |
Bucket is the definition of bucket source. Validations: |
false |
git | object |
Git is the definition of git repository source. |
false |
oci | object |
OCI is the definition of OCI repository source. |
false |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.bucket#
Bucket is the definition of bucket source.
Name | Type | Description | Required |
---|---|---|---|
bucketName | string |
BucketName is the name of the object storage bucket. |
true |
endpoint | string |
Endpoint is the object storage address the BucketName is located at. |
true |
interval | string |
Interval at which the Bucket Endpoint is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
bucket. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
This field is only supported for the `generic` provider. |
false |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
insecure | boolean |
Insecure allows connecting to a non-TLS HTTP Endpoint. |
false |
prefix | string |
Prefix to use for server-side filtering of files in the Bucket. |
false |
provider | enum |
Provider of the object storage bucket.
Defaults to 'generic', which expects an S3 (API) compatible object
storage. Enum: generic, aws, gcp, azure Default: generic |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the Bucket server. |
false |
region | string |
Region of the Endpoint where the BucketName is located in. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials
for the Bucket. |
false |
sts | object |
STS specifies the required configuration to use a Security Token
Service for fetching temporary credentials to authenticate in a
Bucket provider.
This field is only supported for the `aws` and `generic` providers. |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
Bucket. |
false |
timeout | string |
Timeout for fetch operations, defaults to 60s. Default: 60s |
false |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
bucket. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
This field is only supported for the generic
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the Bucket server.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.secretRef#
SecretRef specifies the Secret containing authentication credentials for the Bucket.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.sts#
STS specifies the required configuration to use a Security Token Service for fetching temporary credentials to authenticate in a Bucket provider.
This field is only supported for the aws
and generic
providers.
Name | Type | Description | Required |
---|---|---|---|
endpoint | string |
Endpoint is the HTTP/S endpoint of the Security Token Service from
where temporary credentials will be fetched. |
true |
provider | enum |
Provider of the Security Token Service. Enum: aws, ldap |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
STS endpoint. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
This field is only supported for the `ldap` provider. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials
for the STS endpoint. This Secret must contain the fields `username`
and `password` and is supported only for the `ldap` provider. |
false |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.sts.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
STS endpoint. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
This field is only supported for the ldap
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.bucket.sts.secretRef#
SecretRef specifies the Secret containing authentication credentials
for the STS endpoint. This Secret must contain the fields username
and password
and is supported only for the ldap
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.git#
Git is the definition of git repository source.
Name | Type | Description | Required |
---|---|---|---|
interval | string |
Interval at which the GitRepository URL is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
url | string |
URL specifies the Git repository URL, it can be an HTTP/S or SSH address. |
true |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
include | []object |
Include specifies a list of GitRepository resources which Artifacts
should be included in the Artifact produced for this GitRepository. |
false |
provider | enum |
Provider used for authentication, can be 'azure', 'github', 'generic'.
When not specified, defaults to 'generic'. Enum: generic, azure, github |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the Git server. |
false |
recurseSubmodules | boolean |
RecurseSubmodules enables the initialization of all submodules within
the GitRepository as cloned from the URL, using their default settings. |
false |
ref | object |
Reference specifies the Git reference to resolve and monitor for
changes, defaults to the 'master' branch. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials for
the GitRepository.
For HTTPS repositories the Secret must contain 'username' and 'password'
fields for basic auth or 'bearerToken' field for token auth.
For SSH repositories the Secret must contain 'identity'
and 'known_hosts' fields. |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
GitRepository. |
false |
timeout | string |
Timeout for Git operations like cloning, defaults to 60s. Default: 60s |
false |
verify | object |
Verification specifies the configuration to verify the Git commit
signature(s). |
false |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.git.include[index]#
GitRepositoryInclude specifies a local reference to a GitRepository which Artifact (sub-)contents must be included, and where they should be placed.
Name | Type | Description | Required |
---|---|---|---|
repository | object |
GitRepositoryRef specifies the GitRepository which Artifact contents
must be included. |
true |
fromPath | string |
FromPath specifies the path to copy contents from, defaults to the root
of the Artifact. |
false |
toPath | string |
ToPath specifies the path to copy contents to, defaults to the name of
the GitRepositoryRef. |
false |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.git.include[index].repository#
GitRepositoryRef specifies the GitRepository which Artifact contents must be included.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.git.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the Git server.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.git.ref#
Reference specifies the Git reference to resolve and monitor for changes, defaults to the 'master' branch.
Name | Type | Description | Required |
---|---|---|---|
branch | string |
Branch to check out, defaults to 'master' if no other field is defined. |
false |
commit | string |
Commit SHA to check out, takes precedence over all reference fields.
This can be combined with Branch to shallow clone the branch, in which
the commit is expected to exist. |
false |
name | string |
Name of the reference to check out; takes precedence over Branch, Tag and SemVer.
It must be a valid Git reference: https://git-scm.com/docs/git-check-ref-format#_description
Examples: "refs/heads/main", "refs/tags/v0.1.0", "refs/pull/420/head", "refs/merge-requests/1/head" |
false |
semver | string |
SemVer tag expression to check out, takes precedence over Tag. |
false |
tag | string |
Tag to check out, takes precedence over Branch. |
false |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.git.secretRef#
SecretRef specifies the Secret containing authentication credentials for the GitRepository. For HTTPS repositories the Secret must contain 'username' and 'password' fields for basic auth or 'bearerToken' field for token auth. For SSH repositories the Secret must contain 'identity' and 'known_hosts' fields.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.git.verify#
Verification specifies the configuration to verify the Git commit signature(s).
Name | Type | Description | Required |
---|---|---|---|
secretRef | object |
SecretRef specifies the Secret containing the public keys of trusted Git
authors. |
true |
mode | enum |
Mode specifies which Git object(s) should be verified.
The variants "head" and "HEAD" both imply the same thing, i.e. verify
the commit that the HEAD of the Git repository points to. The variant
"head" solely exists to ensure backwards compatibility. Enum: head, HEAD, Tag, TagAndHEAD Default: HEAD |
false |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.git.verify.secretRef#
SecretRef specifies the Secret containing the public keys of trusted Git authors.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.oci#
OCI is the definition of OCI repository source.
Name | Type | Description | Required |
---|---|---|---|
interval | string |
Interval at which the OCIRepository URL is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
url | string |
URL is a reference to an OCI artifact repository hosted
on a remote container registry. |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
registry. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
Note: Support for the `caFile`, `certFile` and `keyFile` keys have
been deprecated. |
false |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
insecure | boolean |
Insecure allows connecting to a non-TLS HTTP container registry. |
false |
layerSelector | object |
LayerSelector specifies which layer should be extracted from the OCI artifact.
When not specified, the first layer found in the artifact is selected. |
false |
provider | enum |
The provider used for authentication, can be 'aws', 'azure', 'gcp' or 'generic'.
When not specified, defaults to 'generic'. Enum: generic, aws, azure, gcp Default: generic |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the container registry. |
false |
ref | object |
The OCI reference to pull and monitor for changes,
defaults to the latest tag. |
false |
secretRef | object |
SecretRef contains the secret name containing the registry login
credentials to resolve image metadata.
The secret must be of type kubernetes.io/dockerconfigjson. |
false |
serviceAccountName | string |
ServiceAccountName is the name of the Kubernetes ServiceAccount used to authenticate
the image pull if the service account has attached pull secrets. For more information:
https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#add-imagepullsecrets-to-a-service-account |
false |
suspend | boolean |
This flag tells the controller to suspend the reconciliation of this source. |
false |
timeout | string |
The timeout for remote OCI Repository operations like pulling, defaults to 60s. Default: 60s |
false |
verify | object |
Verify contains the secret name containing the trusted public keys
used to verify the signature and specifies which provider to use to check
whether OCI image is authentic. |
false |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.oci.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
registry. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
Note: Support for the caFile
, certFile
and keyFile
keys have
been deprecated.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.oci.layerSelector#
LayerSelector specifies which layer should be extracted from the OCI artifact. When not specified, the first layer found in the artifact is selected.
Name | Type | Description | Required |
---|---|---|---|
mediaType | string |
MediaType specifies the OCI media type of the layer
which should be extracted from the OCI Artifact. The
first layer matching this type is selected. |
false |
operation | enum |
Operation specifies how the selected layer should be processed.
By default, the layer compressed content is extracted to storage.
When the operation is set to 'copy', the layer compressed content
is persisted to storage as it is. Enum: extract, copy |
false |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.oci.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the container registry.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.oci.ref#
The OCI reference to pull and monitor for changes, defaults to the latest tag.
Name | Type | Description | Required |
---|---|---|---|
digest | string |
Digest is the image digest to pull, takes precedence over SemVer.
The value should be in the format 'sha256: |
false |
semver | string |
SemVer is the range of tags to pull selecting the latest within
the range, takes precedence over Tag. |
false |
semverFilter | string |
SemverFilter is a regex pattern to filter the tags within the SemVer range. |
false |
tag | string |
Tag is the image tag to pull, defaults to latest. |
false |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.oci.secretRef#
SecretRef contains the secret name containing the registry login credentials to resolve image metadata. The secret must be of type kubernetes.io/dockerconfigjson.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.oci.verify#
Verify contains the secret name containing the trusted public keys used to verify the signature and specifies which provider to use to check whether OCI image is authentic.
Name | Type | Description | Required |
---|---|---|---|
provider | enum |
Provider specifies the technology used to sign the OCI Artifact. Enum: cosign, notation Default: cosign |
true |
matchOIDCIdentity | []object |
MatchOIDCIdentity specifies the identity matching criteria to use
while verifying an OCI artifact which was signed using Cosign keyless
signing. The artifact's identity is deemed to be verified if any of the
specified matchers match against the identity. |
false |
secretRef | object |
SecretRef specifies the Kubernetes Secret containing the
trusted public keys. |
false |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.oci.verify.matchOIDCIdentity[index]#
OIDCIdentityMatch specifies options for verifying the certificate identity, i.e. the issuer and the subject of the certificate.
Name | Type | Description | Required |
---|---|---|---|
issuer | string |
Issuer specifies the regex pattern to match against to verify
the OIDC issuer in the Fulcio certificate. The pattern must be a
valid Go regular expression. |
true |
subject | string |
Subject specifies the regex pattern to match against to verify
the identity subject in the Fulcio certificate. The pattern must
be a valid Go regular expression. |
true |
ServiceTemplate.spec.helm.chartSource.remoteSourceSpec.oci.verify.secretRef#
SecretRef specifies the Kubernetes Secret containing the trusted public keys.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.helm.chartSpec#
ChartSpec defines the desired state of the HelmChart to be created by the controller
Name | Type | Description | Required |
---|---|---|---|
chart | string |
Chart is the name or path the Helm chart is available at in the
SourceRef. |
true |
interval | string |
Interval at which the HelmChart SourceRef is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
sourceRef | object |
SourceRef is the reference to the Source the chart is available at. |
true |
ignoreMissingValuesFiles | boolean |
IgnoreMissingValuesFiles controls whether to silently ignore missing values
files rather than failing. |
false |
reconcileStrategy | enum |
ReconcileStrategy determines what enables the creation of a new artifact.
Valid values are ('ChartVersion', 'Revision').
See the documentation of the values for an explanation on their behavior.
Defaults to ChartVersion when omitted. Enum: ChartVersion, Revision Default: ChartVersion |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
source. |
false |
valuesFiles | []string |
ValuesFiles is an alternative list of values files to use as the chart
values (values.yaml is not included by default), expected to be a
relative path in the SourceRef.
Values files are merged in the order of this list with the last file
overriding the first. Ignored when omitted. |
false |
verify | object |
Verify contains the secret name containing the trusted public keys
used to verify the signature and specifies which provider to use to check
whether OCI image is authentic.
This field is only supported when using HelmRepository source with spec.type 'oci'.
Chart dependencies, which are not bundled in the umbrella chart artifact, are not verified. |
false |
version | string |
Version is the chart version semver expression, ignored for charts from
GitRepository and Bucket sources. Defaults to latest when omitted. Default: * |
false |
ServiceTemplate.spec.helm.chartSpec.sourceRef#
SourceRef is the reference to the Source the chart is available at.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind of the referent, valid values are ('HelmRepository', 'GitRepository',
'Bucket'). Enum: HelmRepository, GitRepository, Bucket |
true |
name | string |
Name of the referent. |
true |
apiVersion | string |
APIVersion of the referent. |
false |
ServiceTemplate.spec.helm.chartSpec.verify#
Verify contains the secret name containing the trusted public keys used to verify the signature and specifies which provider to use to check whether OCI image is authentic. This field is only supported when using HelmRepository source with spec.type 'oci'. Chart dependencies, which are not bundled in the umbrella chart artifact, are not verified.
Name | Type | Description | Required |
---|---|---|---|
provider | enum |
Provider specifies the technology used to sign the OCI Artifact. Enum: cosign, notation Default: cosign |
true |
matchOIDCIdentity | []object |
MatchOIDCIdentity specifies the identity matching criteria to use
while verifying an OCI artifact which was signed using Cosign keyless
signing. The artifact's identity is deemed to be verified if any of the
specified matchers match against the identity. |
false |
secretRef | object |
SecretRef specifies the Kubernetes Secret containing the
trusted public keys. |
false |
ServiceTemplate.spec.helm.chartSpec.verify.matchOIDCIdentity[index]#
OIDCIdentityMatch specifies options for verifying the certificate identity, i.e. the issuer and the subject of the certificate.
Name | Type | Description | Required |
---|---|---|---|
issuer | string |
Issuer specifies the regex pattern to match against to verify
the OIDC issuer in the Fulcio certificate. The pattern must be a
valid Go regular expression. |
true |
subject | string |
Subject specifies the regex pattern to match against to verify
the identity subject in the Fulcio certificate. The pattern must
be a valid Go regular expression. |
true |
ServiceTemplate.spec.helm.chartSpec.verify.secretRef#
SecretRef specifies the Kubernetes Secret containing the trusted public keys.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize#
Kustomize contains the Kustomize configuration for the template.
Name | Type | Description | Required |
---|---|---|---|
deploymentType | enum |
DeploymentType is the type of the deployment. This field is ignored,
when ResourceSpec is used as part of Helm chart configuration. Enum: Local, Remote Default: Remote |
true |
path | string |
Path to the directory containing the resource manifest. |
true |
localSourceRef | object |
LocalSourceRef is the local source of the kustomize manifest. |
false |
remoteSourceSpec | object |
RemoteSourceSpec is the remote source of the kustomize manifest. Validations: |
false |
ServiceTemplate.spec.kustomize.localSourceRef#
LocalSourceRef is the local source of the kustomize manifest.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind is the kind of the local source. Enum: ConfigMap, Secret, GitRepository, Bucket, OCIRepository |
true |
name | string |
Name is the name of the local source. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec#
RemoteSourceSpec is the remote source of the kustomize manifest.
Name | Type | Description | Required |
---|---|---|---|
bucket | object |
Bucket is the definition of bucket source. Validations: |
false |
git | object |
Git is the definition of git repository source. |
false |
oci | object |
OCI is the definition of OCI repository source. |
false |
ServiceTemplate.spec.kustomize.remoteSourceSpec.bucket#
Bucket is the definition of bucket source.
Name | Type | Description | Required |
---|---|---|---|
bucketName | string |
BucketName is the name of the object storage bucket. |
true |
endpoint | string |
Endpoint is the object storage address the BucketName is located at. |
true |
interval | string |
Interval at which the Bucket Endpoint is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
bucket. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
This field is only supported for the `generic` provider. |
false |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
insecure | boolean |
Insecure allows connecting to a non-TLS HTTP Endpoint. |
false |
prefix | string |
Prefix to use for server-side filtering of files in the Bucket. |
false |
provider | enum |
Provider of the object storage bucket.
Defaults to 'generic', which expects an S3 (API) compatible object
storage. Enum: generic, aws, gcp, azure Default: generic |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the Bucket server. |
false |
region | string |
Region of the Endpoint where the BucketName is located in. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials
for the Bucket. |
false |
sts | object |
STS specifies the required configuration to use a Security Token
Service for fetching temporary credentials to authenticate in a
Bucket provider.
This field is only supported for the `aws` and `generic` providers. |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
Bucket. |
false |
timeout | string |
Timeout for fetch operations, defaults to 60s. Default: 60s |
false |
ServiceTemplate.spec.kustomize.remoteSourceSpec.bucket.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
bucket. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
This field is only supported for the generic
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.bucket.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the Bucket server.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.bucket.secretRef#
SecretRef specifies the Secret containing authentication credentials for the Bucket.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.bucket.sts#
STS specifies the required configuration to use a Security Token Service for fetching temporary credentials to authenticate in a Bucket provider.
This field is only supported for the aws
and generic
providers.
Name | Type | Description | Required |
---|---|---|---|
endpoint | string |
Endpoint is the HTTP/S endpoint of the Security Token Service from
where temporary credentials will be fetched. |
true |
provider | enum |
Provider of the Security Token Service. Enum: aws, ldap |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
STS endpoint. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
This field is only supported for the `ldap` provider. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials
for the STS endpoint. This Secret must contain the fields `username`
and `password` and is supported only for the `ldap` provider. |
false |
ServiceTemplate.spec.kustomize.remoteSourceSpec.bucket.sts.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
STS endpoint. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
This field is only supported for the ldap
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.bucket.sts.secretRef#
SecretRef specifies the Secret containing authentication credentials
for the STS endpoint. This Secret must contain the fields username
and password
and is supported only for the ldap
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.git#
Git is the definition of git repository source.
Name | Type | Description | Required |
---|---|---|---|
interval | string |
Interval at which the GitRepository URL is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
url | string |
URL specifies the Git repository URL, it can be an HTTP/S or SSH address. |
true |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
include | []object |
Include specifies a list of GitRepository resources which Artifacts
should be included in the Artifact produced for this GitRepository. |
false |
provider | enum |
Provider used for authentication, can be 'azure', 'github', 'generic'.
When not specified, defaults to 'generic'. Enum: generic, azure, github |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the Git server. |
false |
recurseSubmodules | boolean |
RecurseSubmodules enables the initialization of all submodules within
the GitRepository as cloned from the URL, using their default settings. |
false |
ref | object |
Reference specifies the Git reference to resolve and monitor for
changes, defaults to the 'master' branch. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials for
the GitRepository.
For HTTPS repositories the Secret must contain 'username' and 'password'
fields for basic auth or 'bearerToken' field for token auth.
For SSH repositories the Secret must contain 'identity'
and 'known_hosts' fields. |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
GitRepository. |
false |
timeout | string |
Timeout for Git operations like cloning, defaults to 60s. Default: 60s |
false |
verify | object |
Verification specifies the configuration to verify the Git commit
signature(s). |
false |
ServiceTemplate.spec.kustomize.remoteSourceSpec.git.include[index]#
GitRepositoryInclude specifies a local reference to a GitRepository which Artifact (sub-)contents must be included, and where they should be placed.
Name | Type | Description | Required |
---|---|---|---|
repository | object |
GitRepositoryRef specifies the GitRepository which Artifact contents
must be included. |
true |
fromPath | string |
FromPath specifies the path to copy contents from, defaults to the root
of the Artifact. |
false |
toPath | string |
ToPath specifies the path to copy contents to, defaults to the name of
the GitRepositoryRef. |
false |
ServiceTemplate.spec.kustomize.remoteSourceSpec.git.include[index].repository#
GitRepositoryRef specifies the GitRepository which Artifact contents must be included.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.git.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the Git server.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.git.ref#
Reference specifies the Git reference to resolve and monitor for changes, defaults to the 'master' branch.
Name | Type | Description | Required |
---|---|---|---|
branch | string |
Branch to check out, defaults to 'master' if no other field is defined. |
false |
commit | string |
Commit SHA to check out, takes precedence over all reference fields.
This can be combined with Branch to shallow clone the branch, in which
the commit is expected to exist. |
false |
name | string |
Name of the reference to check out; takes precedence over Branch, Tag and SemVer.
It must be a valid Git reference: https://git-scm.com/docs/git-check-ref-format#_description
Examples: "refs/heads/main", "refs/tags/v0.1.0", "refs/pull/420/head", "refs/merge-requests/1/head" |
false |
semver | string |
SemVer tag expression to check out, takes precedence over Tag. |
false |
tag | string |
Tag to check out, takes precedence over Branch. |
false |
ServiceTemplate.spec.kustomize.remoteSourceSpec.git.secretRef#
SecretRef specifies the Secret containing authentication credentials for the GitRepository. For HTTPS repositories the Secret must contain 'username' and 'password' fields for basic auth or 'bearerToken' field for token auth. For SSH repositories the Secret must contain 'identity' and 'known_hosts' fields.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.git.verify#
Verification specifies the configuration to verify the Git commit signature(s).
Name | Type | Description | Required |
---|---|---|---|
secretRef | object |
SecretRef specifies the Secret containing the public keys of trusted Git
authors. |
true |
mode | enum |
Mode specifies which Git object(s) should be verified.
The variants "head" and "HEAD" both imply the same thing, i.e. verify
the commit that the HEAD of the Git repository points to. The variant
"head" solely exists to ensure backwards compatibility. Enum: head, HEAD, Tag, TagAndHEAD Default: HEAD |
false |
ServiceTemplate.spec.kustomize.remoteSourceSpec.git.verify.secretRef#
SecretRef specifies the Secret containing the public keys of trusted Git authors.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.oci#
OCI is the definition of OCI repository source.
Name | Type | Description | Required |
---|---|---|---|
interval | string |
Interval at which the OCIRepository URL is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
url | string |
URL is a reference to an OCI artifact repository hosted
on a remote container registry. |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
registry. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
Note: Support for the `caFile`, `certFile` and `keyFile` keys have
been deprecated. |
false |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
insecure | boolean |
Insecure allows connecting to a non-TLS HTTP container registry. |
false |
layerSelector | object |
LayerSelector specifies which layer should be extracted from the OCI artifact.
When not specified, the first layer found in the artifact is selected. |
false |
provider | enum |
The provider used for authentication, can be 'aws', 'azure', 'gcp' or 'generic'.
When not specified, defaults to 'generic'. Enum: generic, aws, azure, gcp Default: generic |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the container registry. |
false |
ref | object |
The OCI reference to pull and monitor for changes,
defaults to the latest tag. |
false |
secretRef | object |
SecretRef contains the secret name containing the registry login
credentials to resolve image metadata.
The secret must be of type kubernetes.io/dockerconfigjson. |
false |
serviceAccountName | string |
ServiceAccountName is the name of the Kubernetes ServiceAccount used to authenticate
the image pull if the service account has attached pull secrets. For more information:
https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#add-imagepullsecrets-to-a-service-account |
false |
suspend | boolean |
This flag tells the controller to suspend the reconciliation of this source. |
false |
timeout | string |
The timeout for remote OCI Repository operations like pulling, defaults to 60s. Default: 60s |
false |
verify | object |
Verify contains the secret name containing the trusted public keys
used to verify the signature and specifies which provider to use to check
whether OCI image is authentic. |
false |
ServiceTemplate.spec.kustomize.remoteSourceSpec.oci.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
registry. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
Note: Support for the caFile
, certFile
and keyFile
keys have
been deprecated.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.oci.layerSelector#
LayerSelector specifies which layer should be extracted from the OCI artifact. When not specified, the first layer found in the artifact is selected.
Name | Type | Description | Required |
---|---|---|---|
mediaType | string |
MediaType specifies the OCI media type of the layer
which should be extracted from the OCI Artifact. The
first layer matching this type is selected. |
false |
operation | enum |
Operation specifies how the selected layer should be processed.
By default, the layer compressed content is extracted to storage.
When the operation is set to 'copy', the layer compressed content
is persisted to storage as it is. Enum: extract, copy |
false |
ServiceTemplate.spec.kustomize.remoteSourceSpec.oci.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the container registry.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.oci.ref#
The OCI reference to pull and monitor for changes, defaults to the latest tag.
Name | Type | Description | Required |
---|---|---|---|
digest | string |
Digest is the image digest to pull, takes precedence over SemVer.
The value should be in the format 'sha256: |
false |
semver | string |
SemVer is the range of tags to pull selecting the latest within
the range, takes precedence over Tag. |
false |
semverFilter | string |
SemverFilter is a regex pattern to filter the tags within the SemVer range. |
false |
tag | string |
Tag is the image tag to pull, defaults to latest. |
false |
ServiceTemplate.spec.kustomize.remoteSourceSpec.oci.secretRef#
SecretRef contains the secret name containing the registry login credentials to resolve image metadata. The secret must be of type kubernetes.io/dockerconfigjson.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.oci.verify#
Verify contains the secret name containing the trusted public keys used to verify the signature and specifies which provider to use to check whether OCI image is authentic.
Name | Type | Description | Required |
---|---|---|---|
provider | enum |
Provider specifies the technology used to sign the OCI Artifact. Enum: cosign, notation Default: cosign |
true |
matchOIDCIdentity | []object |
MatchOIDCIdentity specifies the identity matching criteria to use
while verifying an OCI artifact which was signed using Cosign keyless
signing. The artifact's identity is deemed to be verified if any of the
specified matchers match against the identity. |
false |
secretRef | object |
SecretRef specifies the Kubernetes Secret containing the
trusted public keys. |
false |
ServiceTemplate.spec.kustomize.remoteSourceSpec.oci.verify.matchOIDCIdentity[index]#
OIDCIdentityMatch specifies options for verifying the certificate identity, i.e. the issuer and the subject of the certificate.
Name | Type | Description | Required |
---|---|---|---|
issuer | string |
Issuer specifies the regex pattern to match against to verify
the OIDC issuer in the Fulcio certificate. The pattern must be a
valid Go regular expression. |
true |
subject | string |
Subject specifies the regex pattern to match against to verify
the identity subject in the Fulcio certificate. The pattern must
be a valid Go regular expression. |
true |
ServiceTemplate.spec.kustomize.remoteSourceSpec.oci.verify.secretRef#
SecretRef specifies the Kubernetes Secret containing the trusted public keys.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources#
Resources contains the resource configuration for the template.
Name | Type | Description | Required |
---|---|---|---|
deploymentType | enum |
DeploymentType is the type of the deployment. This field is ignored,
when ResourceSpec is used as part of Helm chart configuration. Enum: Local, Remote Default: Remote |
true |
path | string |
Path to the directory containing the resource manifest. |
true |
localSourceRef | object |
LocalSourceRef is the local source of the kustomize manifest. |
false |
remoteSourceSpec | object |
RemoteSourceSpec is the remote source of the kustomize manifest. Validations: |
false |
ServiceTemplate.spec.resources.localSourceRef#
LocalSourceRef is the local source of the kustomize manifest.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind is the kind of the local source. Enum: ConfigMap, Secret, GitRepository, Bucket, OCIRepository |
true |
name | string |
Name is the name of the local source. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec#
RemoteSourceSpec is the remote source of the kustomize manifest.
Name | Type | Description | Required |
---|---|---|---|
bucket | object |
Bucket is the definition of bucket source. Validations: |
false |
git | object |
Git is the definition of git repository source. |
false |
oci | object |
OCI is the definition of OCI repository source. |
false |
ServiceTemplate.spec.resources.remoteSourceSpec.bucket#
Bucket is the definition of bucket source.
Name | Type | Description | Required |
---|---|---|---|
bucketName | string |
BucketName is the name of the object storage bucket. |
true |
endpoint | string |
Endpoint is the object storage address the BucketName is located at. |
true |
interval | string |
Interval at which the Bucket Endpoint is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
bucket. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
This field is only supported for the `generic` provider. |
false |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
insecure | boolean |
Insecure allows connecting to a non-TLS HTTP Endpoint. |
false |
prefix | string |
Prefix to use for server-side filtering of files in the Bucket. |
false |
provider | enum |
Provider of the object storage bucket.
Defaults to 'generic', which expects an S3 (API) compatible object
storage. Enum: generic, aws, gcp, azure Default: generic |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the Bucket server. |
false |
region | string |
Region of the Endpoint where the BucketName is located in. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials
for the Bucket. |
false |
sts | object |
STS specifies the required configuration to use a Security Token
Service for fetching temporary credentials to authenticate in a
Bucket provider.
This field is only supported for the `aws` and `generic` providers. |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
Bucket. |
false |
timeout | string |
Timeout for fetch operations, defaults to 60s. Default: 60s |
false |
ServiceTemplate.spec.resources.remoteSourceSpec.bucket.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
bucket. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
This field is only supported for the generic
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.bucket.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the Bucket server.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.bucket.secretRef#
SecretRef specifies the Secret containing authentication credentials for the Bucket.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.bucket.sts#
STS specifies the required configuration to use a Security Token Service for fetching temporary credentials to authenticate in a Bucket provider.
This field is only supported for the aws
and generic
providers.
Name | Type | Description | Required |
---|---|---|---|
endpoint | string |
Endpoint is the HTTP/S endpoint of the Security Token Service from
where temporary credentials will be fetched. |
true |
provider | enum |
Provider of the Security Token Service. Enum: aws, ldap |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
STS endpoint. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
This field is only supported for the `ldap` provider. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials
for the STS endpoint. This Secret must contain the fields `username`
and `password` and is supported only for the `ldap` provider. |
false |
ServiceTemplate.spec.resources.remoteSourceSpec.bucket.sts.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
STS endpoint. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
This field is only supported for the ldap
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.bucket.sts.secretRef#
SecretRef specifies the Secret containing authentication credentials
for the STS endpoint. This Secret must contain the fields username
and password
and is supported only for the ldap
provider.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.git#
Git is the definition of git repository source.
Name | Type | Description | Required |
---|---|---|---|
interval | string |
Interval at which the GitRepository URL is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
url | string |
URL specifies the Git repository URL, it can be an HTTP/S or SSH address. |
true |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
include | []object |
Include specifies a list of GitRepository resources which Artifacts
should be included in the Artifact produced for this GitRepository. |
false |
provider | enum |
Provider used for authentication, can be 'azure', 'github', 'generic'.
When not specified, defaults to 'generic'. Enum: generic, azure, github |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the Git server. |
false |
recurseSubmodules | boolean |
RecurseSubmodules enables the initialization of all submodules within
the GitRepository as cloned from the URL, using their default settings. |
false |
ref | object |
Reference specifies the Git reference to resolve and monitor for
changes, defaults to the 'master' branch. |
false |
secretRef | object |
SecretRef specifies the Secret containing authentication credentials for
the GitRepository.
For HTTPS repositories the Secret must contain 'username' and 'password'
fields for basic auth or 'bearerToken' field for token auth.
For SSH repositories the Secret must contain 'identity'
and 'known_hosts' fields. |
false |
suspend | boolean |
Suspend tells the controller to suspend the reconciliation of this
GitRepository. |
false |
timeout | string |
Timeout for Git operations like cloning, defaults to 60s. Default: 60s |
false |
verify | object |
Verification specifies the configuration to verify the Git commit
signature(s). |
false |
ServiceTemplate.spec.resources.remoteSourceSpec.git.include[index]#
GitRepositoryInclude specifies a local reference to a GitRepository which Artifact (sub-)contents must be included, and where they should be placed.
Name | Type | Description | Required |
---|---|---|---|
repository | object |
GitRepositoryRef specifies the GitRepository which Artifact contents
must be included. |
true |
fromPath | string |
FromPath specifies the path to copy contents from, defaults to the root
of the Artifact. |
false |
toPath | string |
ToPath specifies the path to copy contents to, defaults to the name of
the GitRepositoryRef. |
false |
ServiceTemplate.spec.resources.remoteSourceSpec.git.include[index].repository#
GitRepositoryRef specifies the GitRepository which Artifact contents must be included.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.git.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the Git server.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.git.ref#
Reference specifies the Git reference to resolve and monitor for changes, defaults to the 'master' branch.
Name | Type | Description | Required |
---|---|---|---|
branch | string |
Branch to check out, defaults to 'master' if no other field is defined. |
false |
commit | string |
Commit SHA to check out, takes precedence over all reference fields.
This can be combined with Branch to shallow clone the branch, in which
the commit is expected to exist. |
false |
name | string |
Name of the reference to check out; takes precedence over Branch, Tag and SemVer.
It must be a valid Git reference: https://git-scm.com/docs/git-check-ref-format#_description
Examples: "refs/heads/main", "refs/tags/v0.1.0", "refs/pull/420/head", "refs/merge-requests/1/head" |
false |
semver | string |
SemVer tag expression to check out, takes precedence over Tag. |
false |
tag | string |
Tag to check out, takes precedence over Branch. |
false |
ServiceTemplate.spec.resources.remoteSourceSpec.git.secretRef#
SecretRef specifies the Secret containing authentication credentials for the GitRepository. For HTTPS repositories the Secret must contain 'username' and 'password' fields for basic auth or 'bearerToken' field for token auth. For SSH repositories the Secret must contain 'identity' and 'known_hosts' fields.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.git.verify#
Verification specifies the configuration to verify the Git commit signature(s).
Name | Type | Description | Required |
---|---|---|---|
secretRef | object |
SecretRef specifies the Secret containing the public keys of trusted Git
authors. |
true |
mode | enum |
Mode specifies which Git object(s) should be verified.
The variants "head" and "HEAD" both imply the same thing, i.e. verify
the commit that the HEAD of the Git repository points to. The variant
"head" solely exists to ensure backwards compatibility. Enum: head, HEAD, Tag, TagAndHEAD Default: HEAD |
false |
ServiceTemplate.spec.resources.remoteSourceSpec.git.verify.secretRef#
SecretRef specifies the Secret containing the public keys of trusted Git authors.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.oci#
OCI is the definition of OCI repository source.
Name | Type | Description | Required |
---|---|---|---|
interval | string |
Interval at which the OCIRepository URL is checked for updates.
This interval is approximate and may be subject to jitter to ensure
efficient use of resources. |
true |
url | string |
URL is a reference to an OCI artifact repository hosted
on a remote container registry. |
true |
certSecretRef | object |
CertSecretRef can be given the name of a Secret containing
either or both of
- a PEM-encoded client certificate (`tls.crt`) and private
key (`tls.key`);
- a PEM-encoded CA certificate (`ca.crt`)
and whichever are supplied, will be used for connecting to the
registry. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type `Opaque` or `kubernetes.io/tls`.
Note: Support for the `caFile`, `certFile` and `keyFile` keys have
been deprecated. |
false |
ignore | string |
Ignore overrides the set of excluded patterns in the .sourceignore format
(which is the same as .gitignore). If not provided, a default will be used,
consult the documentation for your version to find out what those are. |
false |
insecure | boolean |
Insecure allows connecting to a non-TLS HTTP container registry. |
false |
layerSelector | object |
LayerSelector specifies which layer should be extracted from the OCI artifact.
When not specified, the first layer found in the artifact is selected. |
false |
provider | enum |
The provider used for authentication, can be 'aws', 'azure', 'gcp' or 'generic'.
When not specified, defaults to 'generic'. Enum: generic, aws, azure, gcp Default: generic |
false |
proxySecretRef | object |
ProxySecretRef specifies the Secret containing the proxy configuration
to use while communicating with the container registry. |
false |
ref | object |
The OCI reference to pull and monitor for changes,
defaults to the latest tag. |
false |
secretRef | object |
SecretRef contains the secret name containing the registry login
credentials to resolve image metadata.
The secret must be of type kubernetes.io/dockerconfigjson. |
false |
serviceAccountName | string |
ServiceAccountName is the name of the Kubernetes ServiceAccount used to authenticate
the image pull if the service account has attached pull secrets. For more information:
https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#add-imagepullsecrets-to-a-service-account |
false |
suspend | boolean |
This flag tells the controller to suspend the reconciliation of this source. |
false |
timeout | string |
The timeout for remote OCI Repository operations like pulling, defaults to 60s. Default: 60s |
false |
verify | object |
Verify contains the secret name containing the trusted public keys
used to verify the signature and specifies which provider to use to check
whether OCI image is authentic. |
false |
ServiceTemplate.spec.resources.remoteSourceSpec.oci.certSecretRef#
CertSecretRef can be given the name of a Secret containing either or both of
- a PEM-encoded client certificate (
tls.crt
) and private key (tls.key
); - a PEM-encoded CA certificate (
ca.crt
)
and whichever are supplied, will be used for connecting to the
registry. The client cert and key are useful if you are
authenticating with a certificate; the CA cert is useful if
you are using a self-signed server certificate. The Secret must
be of type Opaque
or kubernetes.io/tls
.
Note: Support for the caFile
, certFile
and keyFile
keys have
been deprecated.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.oci.layerSelector#
LayerSelector specifies which layer should be extracted from the OCI artifact. When not specified, the first layer found in the artifact is selected.
Name | Type | Description | Required |
---|---|---|---|
mediaType | string |
MediaType specifies the OCI media type of the layer
which should be extracted from the OCI Artifact. The
first layer matching this type is selected. |
false |
operation | enum |
Operation specifies how the selected layer should be processed.
By default, the layer compressed content is extracted to storage.
When the operation is set to 'copy', the layer compressed content
is persisted to storage as it is. Enum: extract, copy |
false |
ServiceTemplate.spec.resources.remoteSourceSpec.oci.proxySecretRef#
ProxySecretRef specifies the Secret containing the proxy configuration to use while communicating with the container registry.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.oci.ref#
The OCI reference to pull and monitor for changes, defaults to the latest tag.
Name | Type | Description | Required |
---|---|---|---|
digest | string |
Digest is the image digest to pull, takes precedence over SemVer.
The value should be in the format 'sha256: |
false |
semver | string |
SemVer is the range of tags to pull selecting the latest within
the range, takes precedence over Tag. |
false |
semverFilter | string |
SemverFilter is a regex pattern to filter the tags within the SemVer range. |
false |
tag | string |
Tag is the image tag to pull, defaults to latest. |
false |
ServiceTemplate.spec.resources.remoteSourceSpec.oci.secretRef#
SecretRef contains the secret name containing the registry login credentials to resolve image metadata. The secret must be of type kubernetes.io/dockerconfigjson.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.oci.verify#
Verify contains the secret name containing the trusted public keys used to verify the signature and specifies which provider to use to check whether OCI image is authentic.
Name | Type | Description | Required |
---|---|---|---|
provider | enum |
Provider specifies the technology used to sign the OCI Artifact. Enum: cosign, notation Default: cosign |
true |
matchOIDCIdentity | []object |
MatchOIDCIdentity specifies the identity matching criteria to use
while verifying an OCI artifact which was signed using Cosign keyless
signing. The artifact's identity is deemed to be verified if any of the
specified matchers match against the identity. |
false |
secretRef | object |
SecretRef specifies the Kubernetes Secret containing the
trusted public keys. |
false |
ServiceTemplate.spec.resources.remoteSourceSpec.oci.verify.matchOIDCIdentity[index]#
OIDCIdentityMatch specifies options for verifying the certificate identity, i.e. the issuer and the subject of the certificate.
Name | Type | Description | Required |
---|---|---|---|
issuer | string |
Issuer specifies the regex pattern to match against to verify
the OIDC issuer in the Fulcio certificate. The pattern must be a
valid Go regular expression. |
true |
subject | string |
Subject specifies the regex pattern to match against to verify
the identity subject in the Fulcio certificate. The pattern must
be a valid Go regular expression. |
true |
ServiceTemplate.spec.resources.remoteSourceSpec.oci.verify.secretRef#
SecretRef specifies the Kubernetes Secret containing the trusted public keys.
Name | Type | Description | Required |
---|---|---|---|
name | string |
Name of the referent. |
true |
ServiceTemplate.status#
ServiceTemplateStatus defines the observed state of ServiceTemplate
Name | Type | Description | Required |
---|---|---|---|
valid | boolean |
Valid indicates whether the template passed validation or not. |
true |
chartRef | object |
ChartRef is a reference to a source controller resource containing the
Helm chart representing the template. |
false |
chartVersion | string |
ChartVersion represents the version of the Helm Chart associated with this template. |
false |
config | JSON |
Config demonstrates available parameters for template customization,
that can be used when creating ClusterDeployment objects. |
false |
description | string |
Description contains information about the template. |
false |
k8sConstraint | string |
Constraint describing compatible K8S versions of the cluster set in the SemVer format. |
false |
observedGeneration | integer |
ObservedGeneration is the last observed generation. Format: int64 |
false |
sourceStatus | object |
SourceStatus reflects the status of the source. |
false |
validationError | string |
ValidationError provides information regarding issues encountered during template validation. |
false |
ServiceTemplate.status.chartRef#
ChartRef is a reference to a source controller resource containing the Helm chart representing the template.
Name | Type | Description | Required |
---|---|---|---|
kind | enum |
Kind of the referent. Enum: OCIRepository, HelmChart |
true |
name | string |
Name of the referent. |
true |
apiVersion | string |
APIVersion of the referent. |
false |
namespace | string |
Namespace of the referent, defaults to the namespace of the Kubernetes
resource object that contains the reference. |
false |
ServiceTemplate.status.sourceStatus#
SourceStatus reflects the status of the source.
Name | Type | Description | Required |
---|---|---|---|
kind | string |
Kind is the kind of the remote source. |
true |
name | string |
Name is the name of the remote source. |
true |
namespace | string |
Namespace is the namespace of the remote source. |
true |
artifact | object |
Artifact is the artifact that was generated from the template source. |
false |
conditions | []object |
Conditions reflects the conditions of the remote source object. |
false |
observedGeneration | integer |
ObservedGeneration is the latest source generation observed by the controller. Format: int64 |
false |
ServiceTemplate.status.sourceStatus.artifact#
Artifact is the artifact that was generated from the template source.
Name | Type | Description | Required |
---|---|---|---|
lastUpdateTime | string |
LastUpdateTime is the timestamp corresponding to the last update of the
Artifact. Format: date-time |
true |
path | string |
Path is the relative file path of the Artifact. It can be used to locate
the file in the root of the Artifact storage on the local file system of
the controller managing the Source. |
true |
revision | string |
Revision is a human-readable identifier traceable in the origin source
system. It can be a Git commit SHA, Git tag, a Helm chart version, etc. |
true |
url | string |
URL is the HTTP address of the Artifact as exposed by the controller
managing the Source. It can be used to retrieve the Artifact for
consumption, e.g. by another controller applying the Artifact contents. |
true |
digest | string |
Digest is the digest of the file in the form of ' |
false |
metadata | map[string]string |
Metadata holds upstream information such as OCI annotations. |
false |
size | integer |
Size is the number of bytes in the file. Format: int64 |
false |
ServiceTemplate.status.sourceStatus.conditions[index]#
Condition contains details for one aspect of the current state of this API Resource.
Name | Type | Description | Required |
---|---|---|---|
lastTransitionTime | string |
lastTransitionTime is the last time the condition transitioned from one status to another.
This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable. Format: date-time |
true |
message | string |
message is a human readable message indicating details about the transition.
This may be an empty string. |
true |
reason | string |
reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty. |
true |
status | enum |
status of the condition, one of True, False, Unknown. Enum: True, False, Unknown |
true |
type | string |
type of condition in CamelCase or in foo.example.com/CamelCase. |
true |
observedGeneration | integer |
observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance. Format: int64 Minimum: 0 |
false |