liveBook · Manning

Software upgrade

As explained in Google Anthos in Action

Cluster upgrading is the process of changing a cluster's software or platform components to a newer version.

Cluster upgrading changes Anthos cluster software or platform components to newer versions. In nonstandalone Anthos on bare metal installations, upgrade the admin or hybrid cluster before its user clusters. section 5.2.1 section 17.5

A practical upgrade sequence is:

  • Review compatibility and run available prechecks before changing the cluster. section 5.2.1
  • Modify the cluster configuration to replace the existing Anthos version with the target version. section 17.5.1 section 17.5.2
  • Download the matching bmctl version and run bmctl upgrade cluster against the cluster name and administrative kubeconfig. section 17.5.1 section 17.5.2
  • Upgrade user clusters only after the admin or hybrid cluster has completed successfully. section 17.5 section 17.5.2

Reducing production upgrade risk

Keep spare hardware for a parallel new cluster, move workloads from the old cluster, and place a load balancer before both clusters so traffic can shift back if the upgrade fails. section 5.2.1

apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
name: admin-cluster
namespace: cluster-admin-cluster
spec:
type: hybrid
# Anthos cluster version.
anthosBareMetalVersion: 1.13.0

A cluster configuration declares the target Anthos on bare metal version before the upgrade command runs. section 17.5.1

How Google Anthos in Action covers it

How deep it goes
Explains configuration edits, tool selection, sequencing, prechecks, compatibility risks, and parallel-cluster rollback planning.
Examples
Uses Anthos version YAML, bmctl, gkectl, administrative kubeconfig files, and parallel clusters behind a load balancer.
What it assumes
Assumes cluster configuration files, kubeconfig files, administrative and user cluster roles, and the relevant Anthos CLI tools.
What you can do after
Operate/configure Anthos cluster upgrades while preserving upgrade order and preparing a rollback path for production failures.
How it connects
Connects Anthos upgrades with Kubernetes, Anthos Service Mesh, Istio, admin clusters, user clusters, and load balancers.

Also explained in

Compare how 5 books explain software upgrade →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Google Anthos in Action. The section links point to the parts of the book it draws on.