Upgrade Keptn

Upgrade from Keptn 0.11.x to Keptn 0.11.4

Expand to see upgrade instructions:

  • Step 1. To download and install the Keptn CLI for version 0.11.4, you can choose between:

    • Automatic installation of the Keptn CLI (Linux and Mac):

      • The next command will download the 0.11.4 release from GitHub, unpack it, and move it to /usr/local/bin/keptn.

        curl -sL https://get.keptn.sh | KEPTN_VERSION=0.11.4 bash
        
      • Verify that the installation has worked and that the version is correct by running:

        keptn version
        
    • Manual installation of the Keptn CLI:

      • Download the release for your platform from the GitHub
      • Unpack the binary and move it to a directory of your choice (e.g., /usr/local/bin/)
      • Verify that the installation has worked and that the version is correct by running: console keptn version
  • Step 2. To upgrade your Keptn installation from 0.11.x to 0.11.4, the Keptn CLI offers the command:

   keptn upgrade
   keptn set config KubeContextCheck true
  • If the CLI still complains about the context, please use the Helm approach to upgrade your cluster:
   helm upgrade keptn keptn --install -n keptn --create-namespace --repo=https://charts.keptn.sh --version=0.11.4 --reuse-values --wait
  • ⚠️ Step 3. If you are using the jmeter-service or helm-service, upgrade them to 0.11.4 using the following commands:
   helm repo update
   helm upgrade jmeter-service https://github.com/keptn/keptn/releases/download/0.11.4/jmeter-service-0.11.4.tgz -n keptn --create-namespace --wait --reuse-values
   helm upgrade helm-service https://github.com/keptn/keptn/releases/download/0.11.4/helm-service-0.11.4.tgz -n keptn --create-namespace --wait --reuse-values

Upgrade from Keptn 0.10.x to 0.11.x

❗️CAUTION: This release requires a manual migration of all data in the Keptn MongoDB. Therefore, please execute all 4 steps mentioned in the upgrade instructions❗️

Expand to see upgrade instructions:

  • Step 1. Before starting the update, it is mandatory to create a backup of your Keptn projects. To do so, please follow the instructions in the 0.10.x backup guide.

  • Step 2. To download and install the Keptn CLI for version 0.11.x, you can choose between:

    • Automatic installation of the Keptn CLI (Linux and Mac):

      • The next command will download the 0.11.4 release from GitHub, unpack it, and move it to /usr/local/bin/keptn.

        curl -sL https://get.keptn.sh | KEPTN_VERSION=0.11.4 bash
        
      • Verify that the installation has worked and that the version is correct by running:

        keptn version
        
    • Manual installation of the Keptn CLI:

      • Download the release for your platform from the GitHub
      • Unpack the binary and move it to a directory of your choice (e.g., /usr/local/bin/)
      • Verify that the installation has worked and that the version is correct by running: console keptn version
  • Step 3. To upgrade your Keptn installation from 0.10.x to 0.11.x, the Keptn CLI offers the command:

    keptn upgrade
    
  • Step 4. Restore your Mongo DB and configuration service data according to the steps in the restore guide.

  • ⚠️ Step 5. If you are using the jmeter-service or helm-service, upgrade them to 0.11.4 using the following commands:

    helm repo update
    helm upgrade jmeter-service https://github.com/keptn/keptn/releases/download/0.11.4/jmeter-service-0.11.4.tgz -n keptn --create-namespace --wait --reuse-values
    helm upgrade helm-service https://github.com/keptn/keptn/releases/download/0.11.4/helm-service-0.11.4.tgz -n keptn --create-namespace --wait --reuse-values
    

Note: If you have manually modified your Keptn deployment, e.g., you deleted the Kubernetes Secret bridge-credentials for disabling basic auth, the keptn upgrade command will not detect the modification. Please re-apply your modification after performing the upgrade.