Keptn v1 reached EOL December 22, 2023. For more information see https://bit.ly/keptn
This documentation is for an older Keptn release. Please consider the newest one when working with the latest Keptn.

Upgrade Keptn

Upgrade from Keptn 0.13.x to Keptn 0.14.x

With Keptn 0.14.x, we upgraded the NATS cluster and with that, we changed its name. For existing integration that are not yet updated to use a 0.14.x distributor, please update the distributor PUBSUB_URL environment variable and set it to nats://keptn-nats. Please, refer to the distributor documentation for further details.

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

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

      • The next command will download the 0.14.1 release from GitHub, unpack it, and move it to /usr/local/bin/keptn.
      curl -sL https://get.keptn.sh | KEPTN_VERSION=0.14.1 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:
      keptn version
      
  • Step 2. To upgrade your Keptn installation from 0.13.x to 0.14.x, 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 get values keptn -n keptn > MY_VALUES.yaml
    helm upgrade keptn keptn --install -n keptn --create-namespace --repo=https://charts.keptn.sh --version=0.14.1 --wait --values=MY_VALUES.yaml
    
  • ⚠️ Step 3. If you are using the jmeter-service or helm-service, upgrade them to 0.14.1 using the following commands:

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