KeptnConfig
KeptnConfig
defines Keptn configuration values.
Yaml Synopsis
apiVersion: options.keptn.sh/v1alpha1
kind: KeptnConfig
metadata:
name: <configuration-name>
spec:
OTelCollectorUrl: '<otelurl:port>'
keptnAppCreationRequestTimeoutSeconds: <#-seconds>
cloudEventsEndpoint: <endpoint>
blockDeployment: true | false
observabilityTimeout: <duration>
Fields
- apiVersion -- API version being used.
-
kind -- Resource type. Must be set to
KeptnConfig
. -
metadata
- name -- Unique name of this set of configurations. Names must comply with the Kubernetes Object Names and IDs specification.
-
spec
- OTelCollectorUrl -- The URL and port of the OpenTelemetry collector. This field must be populated in order to export traces to the OpenTelemetry Collector.
- keptnAppCreationRequestTimeoutSeconds -- Interval in which automatic app discovery searches for workloads to put into the same auto-generated KeptnApp. The default value is 30 (seconds).
- cloudEventsEndpoint -- Endpoint where the lifecycle operator posts Cloud Events.
- blockDeployment -- If set to
true
(default), application deployment is blocked until the pre-deployment tasks and evaluations succeed. You can set this field tofalse
when building up your pre-deployment tasks and evaluations so that your application is deployed even if the pre-deployment tasks and/or evaluations fail. For more information see the non-blocking deployment section. - observabilityTimeout -- specifies the maximum time
to observe the deployment phase of
KeptnWorkload.
The value supplied should specify the unit of measurement;
for example,
5m
indicates 5 minutes and1h
indicates 1 hour. If the workload is not deployed successfully within this time frame, it is considered to be failed.
Usage
Each cluster should have a single KeptnConfig
CRD that describes all configurations for that cluster.
Example
This example specifies:
- the URL of the OpenTelemetry collector
- automatic app discovery that should be run every 40 seconds
- CloudEvents endpoint URL
- blocking functionality of the deployment of the application is disabled in case of the pre-deployment task or evaluation failure
apiVersion: options.keptn.sh/v1alpha1
kind: KeptnConfig
metadata:
name: keptn-config
spec:
OTelCollectorUrl: 'otel-collector:4317'
keptnAppCreationRequestTimeoutSeconds: 40
cloudEventsEndpoint: 'http://endpoint.com'
blockDeployment: false
observabilityTimeout: 10m
Files
API Reference: