v1alpha3

Reference information for lifecycle.keptn.sh/v1alpha3

Packages

lifecycle.keptn.sh/v1alpha3

Package v1alpha3 contains API Schema definitions for the lifecycle v1alpha3 API group

Resource Types

ConfigMapReference

Appears in:

Field Description
name string Name is the name of the referenced ConfigMap.

EvaluationStatusItem

Appears in:

Field Description
value string Value represents the value of the KeptnMetric being evaluated.
message string Message contains additional information about the evaluation of an objective. This can include explanations about why an evaluation has failed (e.g. due to a missed objective), or if there was any error during the evaluation of the objective.

FunctionReference

Appears in:

Field Description
name string Name is the name of the referenced KeptnTaksDefinition.

FunctionSpec

Appears in:

Field Description
functionRef FunctionReference FunctionReference allows to reference another KeptnTaskDefinition which contains the source code of the function to be executes for KeptnTasks based on this KeptnTaskDefinition. This can be useful when you have multiple KeptnTaskDefinitions that should execute the same logic, but each with different parameters.
inline Inline Inline allows to specify the code that should be executed directly in the KeptnTaskDefinition, as a multi-line string.
httpRef HttpReference HttpReference allows to point to an HTTP URL containing the code of the function.
configMapRef ConfigMapReference ConfigMapReference allows to reference a ConfigMap containing the code of the function. When referencing a ConfigMap, the code of the function must be available as a value of the ‘code’ key of the referenced ConfigMap.
parameters TaskParameters Parameters contains parameters that will be passed to the job that executes the task.
secureParameters SecureParameters SecureParameters contains secure parameters that will be passed to the job that executes the task. These will be stored and accessed as secrets in the cluster.

FunctionStatus

Appears in:

Field Description
configMap string ConfigMap indicates the ConfigMap in which the function code is stored.

HttpReference

Appears in:

Field Description
url string Url is the URL containing the code of the function.

Inline

Appears in:

Field Description
code string Code contains the code of the function.

ItemStatus

Appears in:

Field Description
definitionName string DefinitionName is the name of the EvaluationDefinition/TaskDefiniton
name string Name is the name of the Evaluation/Task
startTime Time StartTime represents the time at which the Item (Evaluation/Task) started.
endTime Time EndTime represents the time at which the Item (Evaluation/Task) started.

KeptnApp

KeptnApp is the Schema for the keptnapps API

Appears in:

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnApp
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata.
spec KeptnAppSpec Spec describes the desired state of the KeptnApp.

KeptnAppCreationRequest

KeptnAppCreationRequest is the Schema for the keptnappcreationrequests API

Appears in:

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnAppCreationRequest
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata.
spec KeptnAppCreationRequestSpec Spec describes the desired state of the KeptnAppCreationRequest.

KeptnAppCreationRequestList

KeptnAppCreationRequestList contains a list of KeptnAppCreationRequest

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnAppCreationRequestList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata.
items KeptnAppCreationRequest array

KeptnAppCreationRequestSpec

KeptnAppCreationRequestSpec defines the desired state of KeptnAppCreationRequest

Appears in:

Field Description
appName string AppName is the name of the KeptnApp the KeptnAppCreationRequest should create if no user-defined object with that name is found.

KeptnAppList

KeptnAppList contains a list of KeptnApp

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnAppList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata.
items KeptnApp array

KeptnAppSpec

KeptnAppSpec defines the desired state of KeptnApp

Appears in:

Field Description
version string Version defines the version of the application. For automatically created KeptnApps, the version is a function of all KeptnWorkloads that are part of the KeptnApp.
revision integer Revision can be modified to trigger another deployment of a KeptnApp of the same version. This can be used for restarting a KeptnApp which failed to deploy, e.g. due to a failed preDeploymentEvaluation/preDeploymentTask.
workloads KeptnWorkloadRef array Workloads is a list of all KeptnWorkloads that are part of the KeptnApp.
preDeploymentTasks string array PreDeploymentTasks is a list of all tasks to be performed during the pre-deployment phase of the KeptnApp. The items of this list refer to the names of KeptnTaskDefinitions located in the same namespace as the KeptnApp, or in the KLT namespace.
postDeploymentTasks string array PostDeploymentTasks is a list of all tasks to be performed during the post-deployment phase of the KeptnApp. The items of this list refer to the names of KeptnTaskDefinitions located in the same namespace as the KeptnApp, or in the KLT namespace.
preDeploymentEvaluations string array PreDeploymentEvaluations is a list of all evaluations to be performed during the pre-deployment phase of the KeptnApp. The items of this list refer to the names of KeptnEvaluationDefinitions located in the same namespace as the KeptnApp, or in the KLT namespace.
postDeploymentEvaluations string array PostDeploymentEvaluations is a list of all evaluations to be performed during the post-deployment phase of the KeptnApp. The items of this list refer to the names of KeptnEvaluationDefinitions located in the same namespace as the KeptnApp, or in the KLT namespace.

KeptnAppVersion

KeptnAppVersion is the Schema for the keptnappversions API

Appears in:

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnAppVersion
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata.
spec KeptnAppVersionSpec Spec describes the desired state of the KeptnAppVersion.

KeptnAppVersionList

KeptnAppVersionList contains a list of KeptnAppVersion

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnAppVersionList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata.
items KeptnAppVersion array

KeptnAppVersionSpec

KeptnAppVersionSpec defines the desired state of KeptnAppVersion

Appears in:

Field Description
version string Version defines the version of the application. For automatically created KeptnApps, the version is a function of all KeptnWorkloads that are part of the KeptnApp.
revision integer Revision can be modified to trigger another deployment of a KeptnApp of the same version. This can be used for restarting a KeptnApp which failed to deploy, e.g. due to a failed preDeploymentEvaluation/preDeploymentTask.
workloads KeptnWorkloadRef array Workloads is a list of all KeptnWorkloads that are part of the KeptnApp.
preDeploymentTasks string array PreDeploymentTasks is a list of all tasks to be performed during the pre-deployment phase of the KeptnApp. The items of this list refer to the names of KeptnTaskDefinitions located in the same namespace as the KeptnApp, or in the KLT namespace.
postDeploymentTasks string array PostDeploymentTasks is a list of all tasks to be performed during the post-deployment phase of the KeptnApp. The items of this list refer to the names of KeptnTaskDefinitions located in the same namespace as the KeptnApp, or in the KLT namespace.
preDeploymentEvaluations string array PreDeploymentEvaluations is a list of all evaluations to be performed during the pre-deployment phase of the KeptnApp. The items of this list refer to the names of KeptnEvaluationDefinitions located in the same namespace as the KeptnApp, or in the KLT namespace.
postDeploymentEvaluations string array PostDeploymentEvaluations is a list of all evaluations to be performed during the post-deployment phase of the KeptnApp. The items of this list refer to the names of KeptnEvaluationDefinitions located in the same namespace as the KeptnApp, or in the KLT namespace.
appName string AppName is the name of the KeptnApp.
previousVersion string PreviousVersion is the version of the KeptnApp that has been deployed prior to this version.
traceId object (keys:string, values:string) TraceId contains the OpenTelemetry trace ID.

KeptnEvaluation

KeptnEvaluation is the Schema for the keptnevaluations API

Appears in:

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnEvaluation
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata.
spec KeptnEvaluationSpec Spec describes the desired state of the KeptnEvaluation.

KeptnEvaluationDefinition

KeptnEvaluationDefinition is the Schema for the keptnevaluationdefinitions API

Appears in:

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnEvaluationDefinition
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata.
spec KeptnEvaluationDefinitionSpec Spec describes the desired state of the KeptnEvaluationDefinition.

KeptnEvaluationDefinitionList

KeptnEvaluationDefinitionList contains a list of KeptnEvaluationDefinition

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnEvaluationDefinitionList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata.
items KeptnEvaluationDefinition array

KeptnEvaluationDefinitionSpec

KeptnEvaluationDefinitionSpec defines the desired state of KeptnEvaluationDefinition

Appears in:

Field Description
objectives Objective array Objectives is a list of objectives that have to be met for a KeptnEvaluation referencing this KeptnEvaluationDefinition to be successful.

KeptnEvaluationList

KeptnEvaluationList contains a list of KeptnEvaluation

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnEvaluationList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata.
items KeptnEvaluation array

KeptnEvaluationProvider

KeptnEvaluationProvider is the Schema for the keptnevaluationproviders API

Appears in:

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnEvaluationProvider
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata.
spec KeptnEvaluationProviderSpec

KeptnEvaluationProviderList

KeptnEvaluationProviderList contains a list of KeptnEvaluationProvider

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnEvaluationProviderList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata.
items KeptnEvaluationProvider array

KeptnEvaluationProviderSpec

KeptnEvaluationProviderSpec defines the desired state of KeptnEvaluationProvider

Appears in:

Field Description
targetServer string
secretKeyRef SecretKeySelector

KeptnEvaluationSpec

KeptnEvaluationSpec defines the desired state of KeptnEvaluation

Appears in:

Field Description
workload string Workload defines the KeptnWorkload for which the KeptnEvaluation is done.
workloadVersion string WorkloadVersion defines the version of the KeptnWorkload for which the KeptnEvaluation is done.
appName string AppName defines the KeptnApp for which the KeptnEvaluation is done.
appVersion string AppVersion defines the version of the KeptnApp for which the KeptnEvaluation is done.
evaluationDefinition string EvaluationDefinition refers to the name of the KeptnEvaluationDefinition which includes the objectives for the KeptnEvaluation. The KeptnEvaluationDefinition can be located in the same namespace as the KeptnEvaluation, or in the KLT namespace.
retries integer Retries indicates how many times the KeptnEvaluation can be attempted in the case of an error or missed evaluation objective, before considering the KeptnEvaluation to be failed.
retryInterval Duration RetryInterval specifies the interval at which the KeptnEvaluation is retried in the case of an error or a missed objective.
failAction string
checkType CheckType Type indicates whether the KeptnEvaluation is part of the pre- or postDeployment phase.

KeptnMetricReference

Appears in:

Field Description
name string Name is the name of the referenced KeptnMetric.
namespace string Namespace is the namespace where the referenced KeptnMetric is located.

KeptnTask

KeptnTask is the Schema for the keptntasks API

Appears in:

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnTask
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata.
spec KeptnTaskSpec Spec describes the desired state of the KeptnTask.

KeptnTaskDefinition

KeptnTaskDefinition is the Schema for the keptntaskdefinitions API

Appears in:

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnTaskDefinition
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata.
spec KeptnTaskDefinitionSpec Spec describes the desired state of the KeptnTaskDefinition.

KeptnTaskDefinitionList

KeptnTaskDefinitionList contains a list of KeptnTaskDefinition

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnTaskDefinitionList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata.
items KeptnTaskDefinition array

KeptnTaskDefinitionSpec

KeptnTaskDefinitionSpec defines the desired state of KeptnTaskDefinition

Appears in:

Field Description
function FunctionSpec Function contains the definition for the function that is to be executed in KeptnTasks based on the KeptnTaskDefinitions.
retries integer Retries specifies how many times a job executing the KeptnTaskDefinition should be restarted in the case of an unsuccessful attempt.
timeout Duration Timeout specifies the maximum time to wait for the task to be completed successfully. If the task does not complete successfully within this time frame, it will be considered to be failed.

KeptnTaskList

KeptnTaskList contains a list of KeptnTask

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnTaskList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata.
items KeptnTask array

KeptnTaskSpec

KeptnTaskSpec defines the desired state of KeptnTask

Appears in:

Field Description
workload string Workload defines the KeptnWorkload for which the KeptnTask is executed.
workloadVersion string WorkloadVersion defines the version of the KeptnWorkload for which the KeptnTask is executed.
app string AppName defines the KeptnApp for which the KeptnTask is executed.
appVersion string AppVersion defines the version of the KeptnApp for which the KeptnTask is executed.
taskDefinition string TaskDefinition refers to the name of the KeptnTaskDefinition which includes the specification for the task to be performed. The KeptnTaskDefinition can be located in the same namespace as the KeptnTask, or in the KLT namespace.
context TaskContext Context contains contextual information about the task execution.
parameters TaskParameters Parameters contains parameters that will be passed to the job that executes the task.
secureParameters SecureParameters SecureParameters contains secure parameters that will be passed to the job that executes the task. These will be stored and accessed as secrets in the cluster.
checkType CheckType Type indicates whether the KeptnTask is part of the pre- or postDeployment phase.
retries integer Retries indicates how many times the KeptnTask can be attempted in the case of an error before considering the KeptnTask to be failed.
timeout Duration Timeout specifies the maximum time to wait for the task to be completed successfully. If the task does not complete successfully within this time frame, it will be considered to be failed.

KeptnWorkload

KeptnWorkload is the Schema for the keptnworkloads API

Appears in:

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnWorkload
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata.
spec KeptnWorkloadSpec Spec describes the desired state of the KeptnWorkload.

KeptnWorkloadInstance

KeptnWorkloadInstance is the Schema for the keptnworkloadinstances API

Appears in:

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnWorkloadInstance
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata.
spec KeptnWorkloadInstanceSpec Spec describes the desired state of the KeptnWorkloadInstance.

KeptnWorkloadInstanceList

KeptnWorkloadInstanceList contains a list of KeptnWorkloadInstance

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnWorkloadInstanceList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata.
items KeptnWorkloadInstance array

KeptnWorkloadInstanceSpec

KeptnWorkloadInstanceSpec defines the desired state of KeptnWorkloadInstance

Appears in:

Field Description
app string AppName is the name of the KeptnApp containing the KeptnWorkload.
version string Version defines the version of the KeptnWorkload.
preDeploymentTasks string array PreDeploymentTasks is a list of all tasks to be performed during the pre-deployment phase of the KeptnWorkload. The items of this list refer to the names of KeptnTaskDefinitions located in the same namespace as the KeptnApp, or in the KLT namespace.
postDeploymentTasks string array PostDeploymentTasks is a list of all tasks to be performed during the post-deployment phase of the KeptnWorkload. The items of this list refer to the names of KeptnTaskDefinitions located in the same namespace as the KeptnWorkload, or in the KLT namespace.
preDeploymentEvaluations string array PreDeploymentEvaluations is a list of all evaluations to be performed during the pre-deployment phase of the KeptnWorkload. The items of this list refer to the names of KeptnEvaluationDefinitions located in the same namespace as the KeptnWorkload, or in the KLT namespace.
postDeploymentEvaluations string array PostDeploymentEvaluations is a list of all evaluations to be performed during the post-deployment phase of the KeptnWorkload. The items of this list refer to the names of KeptnEvaluationDefinitions located in the same namespace as the KeptnWorkload, or in the KLT namespace.
resourceReference ResourceReference ResourceReference is a reference to the Kubernetes resource (Deployment, DaemonSet, StatefulSet or ReplicaSet) the KeptnWorkload is representing.
workloadName string WorkloadName is the name of the KeptnWorkload.
previousVersion string PreviousVersion is the version of the KeptnWorkload that has been deployed prior to this version.
traceId object (keys:string, values:string) TraceId contains the OpenTelemetry trace ID.

KeptnWorkloadList

KeptnWorkloadList contains a list of KeptnWorkload

Field Description
apiVersion string lifecycle.keptn.sh/v1alpha3
kind string KeptnWorkloadList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata.
items KeptnWorkload array

KeptnWorkloadRef

KeptnWorkloadRef refers to a KeptnWorkload that is part of a KeptnApp

Appears in:

Field Description
name string Name is the name of the KeptnWorkload.
version string Version is the version of the KeptnWorkload.

KeptnWorkloadSpec

KeptnWorkloadSpec defines the desired state of KeptnWorkload

Appears in:

Field Description
app string AppName is the name of the KeptnApp containing the KeptnWorkload.
version string Version defines the version of the KeptnWorkload.
preDeploymentTasks string array PreDeploymentTasks is a list of all tasks to be performed during the pre-deployment phase of the KeptnWorkload. The items of this list refer to the names of KeptnTaskDefinitions located in the same namespace as the KeptnApp, or in the KLT namespace.
postDeploymentTasks string array PostDeploymentTasks is a list of all tasks to be performed during the post-deployment phase of the KeptnWorkload. The items of this list refer to the names of KeptnTaskDefinitions located in the same namespace as the KeptnWorkload, or in the KLT namespace.
preDeploymentEvaluations string array PreDeploymentEvaluations is a list of all evaluations to be performed during the pre-deployment phase of the KeptnWorkload. The items of this list refer to the names of KeptnEvaluationDefinitions located in the same namespace as the KeptnWorkload, or in the KLT namespace.
postDeploymentEvaluations string array PostDeploymentEvaluations is a list of all evaluations to be performed during the post-deployment phase of the KeptnWorkload. The items of this list refer to the names of KeptnEvaluationDefinitions located in the same namespace as the KeptnWorkload, or in the KLT namespace.
resourceReference ResourceReference ResourceReference is a reference to the Kubernetes resource (Deployment, DaemonSet, StatefulSet or ReplicaSet) the KeptnWorkload is representing.

Objective

Appears in:

Field Description
keptnMetricRef KeptnMetricReference KeptnMetricRef references the KeptnMetric that should be evaluated.
evaluationTarget string EvaluationTarget specifies the target value for the references KeptnMetric. Needs to start with either ‘<’ or ‘>’, followed by the target value (e.g. ‘<10’).

ResourceReference

Appears in:

Field Description
uid UID
kind string
name string

SecureParameters

Appears in:

Field Description
secret string Secret contains the parameters that will be made available to the job executing the KeptnTask via the ‘SECRET_DATA’ environment variable. The ‘SECRET_DATA’ environment variable’s content will the same as value of the ‘SECRET_DATA’ key of the referenced secret.

TaskContext

Appears in:

Field Description
workloadName string WorkloadName the name of the KeptnWorkload the KeptnTask is being executed for.
appName string AppName the name of the KeptnApp the KeptnTask is being executed for.
appVersion string AppVersion the version of the KeptnApp the KeptnTask is being executed for.
workloadVersion string WorkloadVersion the version of the KeptnWorkload the KeptnTask is being executed for.
taskType string TaskType indicates whether the KeptnTask is part of the pre- or postDeployment phase.
objectType string ObjectType indicates whether the KeptnTask is being executed for a KeptnApp or KeptnWorkload.

TaskParameters

Appears in:

Field Description
map object (keys:string, values:string) Inline contains the parameters that will be made available to the job executing the KeptnTask via the ‘DATA’ environment variable. The ‘DATA’ environment variable’s content will be a json encoded string containing all properties of the map provided.

WorkloadStatus

Appears in:

Field Description
workload KeptnWorkloadRef Workload refers to a KeptnWorkload that is part of the KeptnAppVersion.
Last modified 2023-06-21: releasing documentation v0.8.0 (24f0a46)