Jump to contentJump to page navigation: previous page [access key p]/next page [access key n]
documentation.suse.com › SUSE Cloud Application Platform 2.1.1 Documentation › Deployment, Administration, and User Guides › SUSE Cloud Application Platform Administration › Upgrading SUSE Cloud Application Platform
ContentsContents
Deployment, Administration, and User Guides
  1. About This Guide
  2. I Overview of SUSE Cloud Application Platform
    1. 1 About SUSE Cloud Application Platform
    2. 2 Other Kubernetes Systems
  3. II Deploying SUSE Cloud Application Platform
    1. 3 Deployment and Administration Notes
    2. 4 Deploying SUSE Cloud Application Platform on SUSE CaaS Platform
    3. 5 Deploying SUSE Cloud Application Platform on Microsoft Azure Kubernetes Service (AKS)
    4. 6 Deploying SUSE Cloud Application Platform on Amazon Elastic Kubernetes Service (EKS)
    5. 7 Deploying SUSE Cloud Application Platform on Google Kubernetes Engine (GKE)
    6. 8 Installing the Stratos Web Console
    7. 9 Eirini
    8. 10 Deploying SUSE Cloud Application Platform Using Terraform
    9. 11 Setting Up a Registry for an Air Gapped Environment
    10. 12 SUSE Private Registry
  4. III SUSE Cloud Application Platform Administration
    1. 13 Upgrading SUSE Cloud Application Platform
    2. 14 Configuration Changes
    3. 15 Creating Admin Users
    4. 16 Managing Passwords
    5. 17 Accessing the UAA User Interface
    6. 18 Container Memory Limits and Requests
    7. 19 Cloud Controller Database Secret Rotation
    8. 20 Rotating Automatically Generated Secrets
    9. 21 Backup and Restore
    10. 22 Service Brokers
    11. 23 App-AutoScaler
    12. 24 Integrating CredHub with SUSE Cloud Application Platform
    13. 25 Buildpacks
  5. IV SUSE Cloud Application Platform User Guide
    1. 26 Deploying and Managing Applications with the Cloud Foundry Client
  6. V Troubleshooting
    1. 27 Troubleshooting
  7. A Appendix
  8. B GNU Licenses
Navigation←→
documentation.suse.com › SUSE Cloud Application Platform 2.1.1 Documentation › Deployment, Administration, and User Guides › SUSE Cloud Application Platform Administration › Upgrading SUSE Cloud Application Platform
Top
←→
Applies to SUSE Cloud Application Platform 2.1.1

13 Upgrading SUSE Cloud Application Platform

13.1 Important Considerations
13.2 Upgrading SUSE Cloud Application Platform

SUSE Cloud Application Platform upgrades are delivered as container images from the SUSE registry and applied with Helm.

For additional upgrade information, always review the release notes published at https://www.suse.com/releasenotes/x86_64/SUSE-CAP/2/.

13.1 Important Considerations

Before performing an upgrade, be sure to take note of the following:

Perform Upgrades in Sequence

Cloud Application Platform only supports upgrading releases in sequential order. If there are any intermediate releases between your current release and your target release, they must be installed. Skipping releases is not supported.

Preserve Helm Value Changes during Upgrades

During a helm upgrade, always ensure your kubecf-config-values.yaml file is passed. This will preserve any previously set Helm values while allowing additional Helm value changes to be made.

helm rollback Is Not Supported

helm rollback is not supported in SUSE Cloud Application Platform or in upstream Cloud Foundry, and may break your cluster completely, because database migrations only run forward and cannot be reversed. Database schema can change over time. During upgrades both pods of the current and the next release may run concurrently, so the schema must stay compatible with the immediately previous release. But there is no way to guarantee such compatibility for future upgrades. One way to address this is to perform a full raw data backup and restore. (See Section 21.2, “Disaster Recovery through Raw Data Backup and Restore”)

13.2 Upgrading SUSE Cloud Application Platform

The supported upgrade method is to install all upgrades, in order. Skipping releases is not supported. This table matches the Helm chart versions to each release:

CAP Releasecf-operator Helm Chart VersionKubeCF Helm Chart VersionStratos Helm Chart VersionStratos Metrics Helm Chart VersionMinimum Kubernetes Version RequiredCF API ImplementedKnown Compatible CF CLI VersionCF CLI URL
2.1.1 (current release)7.2.1+0.gaeb6ef32.7.134.4.11.3.01.142.144.06.49.0https://github.com/cloudfoundry/cli/releases/tag/v6.49.0
2.1.06.1.17+0.gec409fd72.5.84.2.01.3.01.142.144.06.49.0https://github.com/cloudfoundry/cli/releases/tag/v6.49.0
2.0.14.5.13+.gd47387122.2.34.0.11.2.11.142.144.06.49.0https://github.com/cloudfoundry/cli/releases/tag/v6.49.0
2.04.5.6+0.gffc6f9422.2.23.2.11.2.11.142.144.06.49.0https://github.com/cloudfoundry/cli/releases/tag/v6.49.0

Use helm list to see the version of your installed release . Perform sequential upgrades until you reach the desired SUSE Cloud Application Platform release.

The example procedure below demonstrates how to upgrade to the current release. If you are not upgrading to the current release, replace the version with the version you intend to upgrade to.

  1. Begin by upgrading cf-operator. 

    tux > helm upgrade cf-operator suse/cf-operator \
--namespace cf-operator \
--set "global.singleNamespace.name=kubecf" \
--version 7.2.1+0.gaeb6ef3

  2. Wait until cf-operator is successfully upgraded before proceeding. Monitor the status of your cf-operator upgrade using the watch command. 

    tux > watch --color 'kubectl get pods --namespace cf-operator'

  3. When the cf-operator upgrade is completed, upgrade KubeCF. 

    tux > helm upgrade kubecf suse/kubecf \
--namespace kubecf \
--values kubecf-config-values.yaml \
--version 2.7.13

  4. Monitor the status of your KubeCF upgrade using the watch command. 

    tux > watch --color 'kubectl get pods --namespace kubecf'
→Chapter 14 Configuration Changes←Part III SUSE Cloud Application Platform Administration
Print this page

© 2021 SUSE