keptn · odubajDT · Mar 27, 2024 · Mar 27, 2024 · Mar 27, 2024 · Mar 27, 2024
@@ -11,6 +11,7 @@ sonar.cpd.exclusions= **/*_test.go,\
   lifecycle-operator/apis/lifecycle/v1alpha3/**/*.go,\
   lifecycle-operator/apis/lifecycle/v1alpha4/**/*.go,\
   lifecycle-operator/apis/lifecycle/v1beta1/**/*.go,\
+  lifecycle-operator/apis/lifecycle/v1/**/*.go,\
   metrics-operator/api/v1alpha1/**/*.go,\
   metrics-operator/api/v1alpha2/**/*.go,\
   metrics-operator/api/v1alpha3/**/*.go,\

@@ -6,7 +6,7 @@ type: Opaque
 data:
   SECURE_DATA: dG9rZW46IG15dG9rZW4=
 ---
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: pre-deployment-hello

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnEvaluationDefinition
 metadata:
   name: app-pre-deploy-eval-2

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: scheduled-deployment

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: slack-notification-dev

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: hello-keptn-http

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: hello-keptn-inline

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: scheduled-deployment

@@ -6,7 +6,7 @@ type: Opaque
 data:
   SECURE_DATA: dG9rZW46IG15dG9rZW4=
 ---
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: pre-deployment-hello

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: scheduled-deployment-inline

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: python-inline

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: scheduled-deployment-2

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: container-sleep

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnAppVersion
 metadata:
   name: podtato-head-0.1.0-6b86b273
@@ -29,7 +29,7 @@ status:
         name: podtato-head-entry
         version: 0.1.0
 ---
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnWorkloadVersion
 metadata:
   generation: 1

@@ -7,7 +7,7 @@ comments: true
 ## Keptn Workloads
 
 A
-[KeptnWorkload](../../reference/api-reference/lifecycle/v1beta1/index.md#keptnworkload)
+[KeptnWorkload](../../reference/api-reference/lifecycle/v1/index.md#keptnworkload)
 resource augments a Kubernetes
 [Workload](https://kubernetes.io/docs/concepts/workloads/)
 with the ability to handle extra phases.

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnAppContext
 metadata:
   name: keptndemoapp

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTask
 metadata:
   name: runsendevent1

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: send-event

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: promotion

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnApp
 metadata:
   name: podtato-head

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnAppContext
 metadata:
   name: keptndemoapp

@@ -41,7 +41,7 @@ spec:
     app: podtato-head-frontend
   type: ClusterIP
 ---
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnAppContext
 metadata:
   name: podtato-head
@@ -54,7 +54,7 @@ spec:
   metadata:
     commitID: {{.Values.commitID}}
 ---
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: post-deployment
@@ -65,7 +65,7 @@ spec:
       code: |
         console.log("deployment completed");
 ---
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: promote

@@ -41,7 +41,7 @@ spec:
     app: podtato-head-frontend
   type: ClusterIP
 ---
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnAppContext
 metadata:
   name: podtato-head

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnAppContext
 metadata:
   name: keptndemoapp

@@ -5,7 +5,7 @@ metadata:
   annotations:
     keptn.sh/lifecycle-toolkit: "enabled"
 ---
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnAppContext
 metadata:
   name: podtato-head
@@ -14,7 +14,7 @@ spec:
   preDeploymentTasks:
     - pre-deployment-check
 ---
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: pre-deployment-check

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: pre-deployment-check

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnApp
 metadata:
   name: podtato-head

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnApp
 metadata:
   name: podtato-head

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: dummy-task

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: dummy-task

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: slack-notification-dev

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnTaskDefinition
 metadata:
   name: deployment-hello

@@ -113,7 +113,7 @@ Note the following:
   has no effect on whether other evaluations are completed.
 - The results of each evaluation
   are written to a
-  [KeptnEvaluation](../reference/api-reference/lifecycle/v1beta1/index.md#keptnevaluation)
+  [KeptnEvaluation](../reference/api-reference/lifecycle/v1/index.md#keptnevaluation)
   resource.
 
 ## Annotate the workload resource for workload level evaluations

@@ -37,7 +37,7 @@ To integrate Keptn with your workloads:
       feature.
 
 Keptn uses these annotations to the Kubernetes workloads to create the
-[KeptnWorkload](../reference/api-reference/lifecycle/v1beta1/index.md#keptnworkload)
+[KeptnWorkload](../reference/api-reference/lifecycle/v1/index.md#keptnworkload)
 and
 [KeptnApp](../reference/crd-reference/app.md)
 resources that it uses to provide observability
@@ -66,7 +66,7 @@ resources in the namespaces where Keptn is enabled.
 If Keptn finds any of these resources and the resource has either
 the `keptn.sh` or the `kubernetes` annotations/labels,
 it creates appropriate
-[KeptnWorkload](../reference/api-reference/lifecycle/v1beta1/index.md#keptnworkload)
+[KeptnWorkload](../reference/api-reference/lifecycle/v1/index.md#keptnworkload)
 and
 [KeptnApp](../reference/crd-reference/app.md)
 resources for the version it detects.
@@ -94,7 +94,7 @@ These keys are defined as:
 
 - `keptn.sh/workload` or `app.kubernetes.io/name`: Determines the name
   of the generated
-  [KeptnWorkload](../reference/api-reference/lifecycle/v1beta1/index.md#keptnworkload)
+  [KeptnWorkload](../reference/api-reference/lifecycle/v1/index.md#keptnworkload)
   resource.
 - `keptn.sh/version` or `app.kubernetes.io/version`:
   Determines the version of the `KeptnWorkload`

@@ -76,7 +76,7 @@ This way, after the re-deployment, the workload trace will contain the `stage=de
 ## Include metadata in application traces
 
 Similar to the previous step, custom metadata can also be added to application traces via the
-[KeptnAppContext](../reference/api-reference/lifecycle/v1beta1/index.md#keptnappcontext) CRD.
+[KeptnAppContext](../reference/api-reference/lifecycle/v1/index.md#keptnappcontext) CRD.
 
 `KeptnAppContext` is a custom resource definition in Keptn that allows you to add metadata
 and links to traces for a specific application.

@@ -11,7 +11,7 @@ resource defines one or more "executables"
 that Keptn runs
 as part of the pre- and post-deployment phases of a
 [KeptnApp](../reference/crd-reference/app.md) or
-[KeptnWorkload](../reference/api-reference/lifecycle/v1beta1/index.md#keptnworkload).
+[KeptnWorkload](../reference/api-reference/lifecycle/v1/index.md#keptnworkload).
 
 - pre-deployment (before the pod is scheduled)
 - post-deployment (after the pod is scheduled)
@@ -22,7 +22,7 @@ These `KeptnTask` resources and the
 are part of the Keptn Release Lifecycle Management.
 
 A
-[KeptnTask](../reference/api-reference/lifecycle/v1beta1/index.md#keptntask)
+[KeptnTask](../reference/api-reference/lifecycle/v1/index.md#keptntask)
 executes as a runner in an application
 [container](https://kubernetes.io/docs/concepts/containers/),
 which runs as part of a Kubernetes

@@ -24,7 +24,7 @@ If you installed your Keptn instance from the Manifest,
 additional steps are required to use the Helm Chart to upgrade.
 Contact us on Slack for assistance.
 
-## Upgrade to v1beta1 version
+## Upgrade to v1 version
 
 If you have previously used Keptn Lifecycle Operator with API
 resources of version `v1alpha3` and `v1alpha4`, you need to

@@ -1,4 +1,4 @@
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnApp
 metadata:
   name: "some-keptn-app"
@@ -12,7 +12,7 @@ spec:
       version: 0.2.7
 # removed pre/post-deployment tasks and evaluations
 ---
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnAppContext
 metadata:
   name: "some-keptn-app" # created a resource with the same name as KeptnApp

@@ -2,16 +2,18 @@
 
 The
 [KeptnAppContext](../../reference/crd-reference/appcontext.md)
-resource is new in the `v1beta1` API version.
+resource was introduced in the `v1beta1` API version.
 Existing
 [KeptnApp](../../reference/crd-reference/app.md)
 resources that were generated manually must be migrated
 because of this new feature.
 This page gives instructions for doing that.
+Versions `v1beta1` and `v1` are fully compatible.
 
 > **Note**
 > Manual migration is only required for:
 >
+> * `KeptnApp` resources with older versions than `v1beta1`
 > * Manually created `KeptnApp` resources
 > * Automatically created `KeptnApp` resources with
 >   manually edited pre/post-deployment tasks or evaluations**

@@ -12,7 +12,7 @@ to the workloads.
 ## Synopsis
 
 ```yaml
-apiVersion: lifecycle.keptn.sh/v1beta1
+apiVersion: lifecycle.keptn.sh/v1
 kind: KeptnApp
 metadata:
   name: <app-name>
@@ -51,7 +51,7 @@ when the app discovery feature generates the `KeptnApp` resource:
       it must have the same `namespace` as this `KeptnApp`.
     - **labels**
         - **app-kubernetes.io/managed-by: keptn** --
-          Tells Keptn that this resource was autogenerated, which is always the case for the `v1beta1` version.
+          Tells Keptn that this resource was autogenerated, which is always the case for the `v1` version.
 - **spec**
     - **version** (required) -- version of the Keptn application.
     - **revision** -- revision of a `version`.
@@ -94,7 +94,7 @@ you can code them all into a single `KeptnTaskDefinition`.
 
 ## Example
 
-This shows an example `v1beta1` `KeptnApp` resource with the corresponding [KeptnAppContext](appcontext.md) resource.
+This shows an example `v1` `KeptnApp` resource with the corresponding [KeptnAppContext](appcontext.md) resource.
 
 ```yaml
 {% include "../../migrate/keptnapp/assets/keptnapp-migrated.yaml" %}
@@ -104,12 +104,11 @@ This shows an example `v1beta1` `KeptnApp` resource with the corresponding [Kept
 
 ## Differences between versions
 
-The synopsis of the `KeptnApp` resource is changed in the `v1beta1` API version:
+The synopsis of the `KeptnApp` resource is changed in the `v1beta1` and newer API versions:
 
-- The `apiVersion` field now references the `v1beta1` version of the `lifecycle.keptn.sh` API.
 - `KeptnApp` is [autogenerated](../../guides/auto-app-discovery.md);
   you cannot create it manually by applying a manifest.
-- The `app.kubernetes.io/managed-by: keptn` label or annotation is always used for the `v1beta1` library
+- The `app.kubernetes.io/managed-by: keptn` label or annotation is always used for the `v1beta1` and newer versions
   because the `KeptnApp` resource is always autogenerated.
   In earlier releases, this label was not included in `KeptnApp` resources that were created by applying a manifest
   that had been created manually.