Upgrading Continuous Delivery for PE

Continuous Delivery for Puppet Enterprise — 4.x

Sections

New versions of Continuous Delivery for Puppet Enterprise (PE) are released regularly. Upgrading to the current version ensures you're always taking advantage of the latest features, fixes, and improvements.

Upgrade paths

These are the valid upgrade paths for Continuous Delivery for PE.


If you're on version...	Upgrade to version...	Notes
4.x	You're up to date!
3.13.7	4.x	You must upgrade to the latest 3.13.x version in order to access the 3.x to 4.x data migration tool.
3.13.3 or earlier	3.13.7

Upgrade Continuous Delivery for PE

Check for, download, and deploy updates from the Version history tab in Puppet Application Manager. These instructions apply to installations in online environments.

In Puppet Application Manager, click Version history.
Click Check for updates.
Configure an automatic update check by clicking Configure automatic updates. You can check for updates hourly, every four hours, daily, weekly, or at a custom interval.
If an update is available, Puppet Application Manager downloads it for you and performs preflight checks on your system to make sure your cluster meets system requirements for the new version. Review the outcome of these checks by clicking View preflight.
When you're ready to upgrade to the new version of Continuous Delivery for PE, click Deploy.

What to do next

When the deployment is complete, sign into Continuous Delivery for PE and verify that the new version number is displayed in the bottom left corner of the web UI.

Upgrade Continuous Delivery for PEin an offline environment

Users operating in environments without direct access to the internet must use the links below to upgrade to the latest version of Continuous Delivery for PE.

Download the latest version's airgap bundle from the chart below.


Version	Release date	Airgap bundle
4.7.2	26 July 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.7.2.airgap
4.7.1	12 July 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.7.1.airgap
4.7.0	8 July 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.7.0.airgap
4.6.1	16 June 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.6.1.airgap
4.6.0	3 June 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.6.0.airgap
4.5.2	11 May 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.5.2.airgap
4.5.1	27 April 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.5.1.airgap
4.5.0	22 April 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.5.0.airgap
4.4.2	13 April 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.4.2.airgap
4.4.1	29 March 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.4.1.airgap
4.4.0	11 March 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.4.0.airgap
4.3.3	23 February 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.3.3.airgap
4.3.2	3 February 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.3.2.airgap
4.3.1	26 January 2021	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.3.1.airgap
4.2.4	17 December 2020	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.2.4.airgap
4.2.3	17 November 2020	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.2.3.airgap
4.2.2	12 November 2020	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.2.2.airgap
4.2.1	5 November 2020	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.2.1.airgap
4.2.0	3 November 2020	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.2.0.airgap
4.1.3	15 October 2020	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.1.3.airgap
4.1.2	8 October 2020	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.1.2.airgap
4.1.1	29 September 2020	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.1.1.airgap
4.0.1	14 September 2020	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.0.1.airgap
4.0.0	25 August 2020	https://cd4pe-builds.s3.amazonaws.com/stable/cd4pe-4.0.0.airgap

In Puppet Application Manager click Version history > Upload new version and upload the new .airgap bundle. The upload might take several minutes.
When you're ready to upgrade to the new version of Continuous Delivery for PE, click Deploy.

What to do next

When the deployment is complete, sign into Continuous Delivery for PE and verify that the new version number is displayed in the bottom left corner of the web UI.

Upgrade an automated installation

If you installed Continuous Delivery for PE following the automated installation instructions, run a script to upgrade to the latest version.

From the command line of your primary (control plane) node, run the upgrade script:
```
kubectl kots upstream upgrade cd4pe --namespace default --deploy
```
Wait five minutes to allow the software time to process the change.
Navigate to http://<NODE IP ADDRESS>:8800 and log in with the Puppet Application Manager password.
If preflight checks have passed, the upgraded application is deployed and in the process of starting up. To monitor the deployment's progress, run kubectl get pods --watch.

What to do next

When the deployment is complete, sign into Continuous Delivery for PE and verify that the new version number is displayed in the bottom left corner of the web UI.