Upgrade Managed Kubernetes cluster on CloudFerro Cloud

You can upgrade your CloudFerro Cloud Managed Kubernetes cluster to the next available minor Kubernetes version. The upgrade is performed in a rolling manner, which helps keep applications and services available while cluster components are being updated.

Before upgrading, review application compatibility with the target Kubernetes version, confirm that backups are in place, and make sure that the cluster is healthy.

What we are going to cover

Prerequisites

1. Hosting account on CloudFerro Cloud

To use CloudFerro Cloud Managed Kubernetes, you need:

No. 2 Supported CloudFerro Cloud Managed Kubernetes region

Upgrade availability is checked in the region where the cluster is running. Make sure that you are working with the correct region in the CloudFerro Cloud Managed Kubernetes dashboard.

Available CloudFerro Cloud Managed Kubernetes regions for CloudFerro Cloud:

  • LCJ1-1

  • FRA1-3

3. Backup

Create or verify a backup before upgrading. See Managed Kubernetes Backups on CloudFerro Cloud.

4. Application compatibility

Review the target Kubernetes version before upgrading. Check whether your workloads, manifests, Helm charts, operators, CRDs, admission webhooks, storage integrations, and ingress configuration are compatible with the target version.

Upgrading to a newer version of Managed Kubernetes

First, check whether a newer Kubernetes version is available for your cluster. If your cluster is already on the highest available version, the upgrade option is not offered.

../_images/cloudferro_cloud_cluster_starting_point.png

If an upgrade is available, open the cluster details page.

../_images/cloudferro_cloud_upgrade_to_cluster_1_31.png

Click Upgrade to <version> and confirm in the modal window.

../_images/cloudferro_cloud_kubernetes_upgrade_window.png

While the upgrade runs, the cluster status changes to UPGRADING.

../_images/cloudferro_cloud_managed_cluster_upgrading.png

When the upgrade completes, the cluster returns to RUNNING and the Kubernetes version is updated in the cluster details.

../_images/cloudferro_cloud_managed_kubernetes_upgraded.png

Note

The Upgrade button remains active only if an even newer version is available.

The downloaded kubeconfig remains valid across upgrades.

After the upgrade

After the cluster returns to RUNNING, verify that the cluster and workloads are healthy.

Check the nodes:

kubectl get nodes -o wide

All nodes should be in the Ready state and should report the expected Kubernetes version.

Check system workloads:

kubectl get pods -A

Verify in particular that DNS, networking, storage-related components, ingress controllers, monitoring agents, and application workloads are running as expected.

Also verify:

  • key applications and ingress endpoints work,

  • persistent volumes are attached and available,

  • application logs do not show new errors,

  • monitoring and backup tools still work,

  • autoscaling and node pools behave as expected.

Troubleshooting

If a workload does not behave as expected after the upgrade:

  • check pod status with kubectl get pods -A,

  • inspect failing pods with kubectl describe pod,

  • review logs with kubectl logs,

  • verify that CRDs, operators, admission webhooks, and Helm releases are compatible with the target Kubernetes version,

  • compare the result with your pre-upgrade backup and application checks.

If the cluster itself does not return to a healthy state, contact Support and provide the cluster name, region, cluster ID, and the time when the upgrade was started.

What To Do Next

After a successful upgrade, keep monitoring the cluster for some time and review your backup policy.

To review responsibilities before future upgrades, see Managed Kubernetes Shared Responsibility Model on CloudFerro Cloud.

To manage backups, see Managed Kubernetes Backups on CloudFerro Cloud.