Upgrade keptn

For upgrading an existing keptn 0.2.0, 0.2.1 or 0.2.2 installation, an upgrade script is provided. This will update all keptn core components to their new version and installs the keptn’s bridge.


  • Please note that all command line tools are needed when upgrading keptn.

    • Additionally, yq is required.
  • Furthermore, please note that we increased the GKE cluster size to one n1-standard-16 node.

  • Make sure you are connected with the cluster running the keptn installation, which should be upgraded. Verify the connection by using the following command:

  kubectl config current-context

Upgrade keptn CLI

  • Download the version for your operating system from https://github.com/keptn/keptn/releases/tag/0.3.0
  • Unpack the download
  • Find the keptn binary in the unpacked directory.

    • Linux / macOS

      add executable permissions (chmod +x keptn), and move it to the desired destination (e.g. mv keptn /usr/local/bin/keptn)

    • Windows

      move/copy the executable to the desired folder and, optionally, add the executable to your PATH environment variable for a more convenient experience.

  • For double checking the version of the CLI, run the version command in the CLI:

    • Linux / macOS
    keptn version
    CLI version: 0.3.0
    • Windows
    .\keptn.exe version
    CLI version: 0.3.0

Upgrade keptn from 0.2.x to 0.3.0

  • Clone the keptn installer repository of the latest release:
  git  clone --branch 0.3.0 https://github.com/keptn/installer
  • Navigate to the scripts folder:
  cd  ./installer/scripts
  • Run the keptn upgrade script:
  ./upgradeKeptn.sh <github_username> <github_access_token>
  • Note: As of version 0.3.0, keptn does not require the Jenkins installation that was part of previous versions. The upgrade script will not remove the Jenkins deployment from the keptn namespace in your cluster, but it will remove the subscriptions of the Jenkins service. This means that from v0.3.0 on, the deployment, testing, and promotion of an artifact to the next stage will be performed by the helm-service, jmeter-service, and gatekeeper-service, respectively.

  • Note: In future releases of the keptn CLI, a command keptn upgrade will be added, which replaces the shell script upgradeKeptn.sh.

Create project and onboard services

Due to a breaking change from keptn 0.2.x to 0.3.0 regarding the naming convention of Kubernetes namespaces, it is necessary to re-create a keptn project and to onboard your services again.

  • Delete your configuration repository in your GitHub organization.

  • Delete your releases using Helm:

  helm ls
  NAME               	REVISION	UPDATED                 	STATUS  	CHART         	APP VERSION	NAMESPACE 
  sockshop-dev       	1       	Wed May 29 10:59:56 2019	DEPLOYED	sockshop-0.1.0	           	dev       
  sockshop-production	1       	Wed May 29 11:12:44 2019	DEPLOYED	sockshop-0.1.0	           	production
  sockshop-staging   	1       	Wed May 29 11:07:16 2019	DEPLOYED	sockshop-0.1.0	           	staging 
  helm delete --purge sockshop-dev
  helm delete --purge sockshop-production
  helm delete --purge sockshop-staging
  release "sockshop-dev" deleted
  release "sockshop-staging" deleted
  release "sockshop-production" deleted
  • Instructions for creating a project are provided here.

  • Instructions for onboarding a service are provided here.