Migrer vers la dernière version de l'opérateur Kubernetes AlloyDB Omni

Cette page explique comment passer de la version 1.0.0 à la version 1.1.0 de l'opérateur AlloyDB Omni.

La procédure de mise à niveau d'AlloyDB Omni dans Kubernetes dépend de la version d'AlloyDB Omni que vous exécutez et de la version vers laquelle vous effectuez la mise à niveau.

Déterminer vos numéros de version actuels

Kubernetes

Pour vérifier la version d'AlloyDB Omni utilisée par votre cluster de base de données, exécutez la commande suivante:

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentDatabaseVersion}'

Remplacez les éléments suivants :

  • DB_CLUSTER_NAME: nom de votre cluster de bases de données. Il s'agit du même nom de cluster de base de données que vous avez déclaré lors de sa création.

  • NAMESPACE: espace de noms Kubernetes de votre cluster de base de données.

Si vous exécutez la version 1.0.0 ou ultérieure de l'opérateur AlloyDB Omni, cette commande affiche la version d'AlloyDB Omni utilisée par votre cluster de base de données.

Pour vérifier la version de l'opérateur AlloyDB Omni installé sur votre cluster Kubernetes, exécutez la commande suivante:

kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -n NAMESPACE -o jsonpath='{.status.primary.currentControlPlaneAgentsVersion}'

Si vous exécutez la version 1.0.0 ou ultérieure de l'opérateur AlloyDB Omni, cette commande affiche le numéro de version de l'opérateur AlloyDB Omni exécuté sur votre cluster Kubernetes.

Si vous exécutez une version antérieure à la version 1.0.0 de l'opérateur AlloyDB Omni, suivez les instructions de la section Mettre à niveau à partir d'un opérateur AlloyDB Omni antérieur à la version 1.0.0.

Sinon, passez à la section Vérifier vos numéros de version cible.

Vérifier les numéros de version cibles

Kubernetes

Si vous exécutez une version de l'opérateur AlloyDB Omni 1.0.0 ou ultérieure, les étapes suivantes dépendent de la version d'AlloyDB Omni vers laquelle vous souhaitez effectuer la mise à niveau. Pour ce faire, vous devez comprendre le numéro de version d'AlloyDB Omni.

Le numéro de version d'AlloyDB Omni se compose des éléments suivants:

  • Numéro de version majeure de la compatibilité avec PostgreSQL
  • Numéro de version mineure de sa compatibilité avec PostgreSQL
  • Numéro de version du correctif de cette version d'AlloyDB Omni

Par exemple, la version 15.5.5 d'AlloyDB Omni correspond à la version 5 du correctif d'AlloyDB Omni compatible avec la version 15.5 de PostgreSQL.

Si vous souhaitez passer à une version d'AlloyDB Omni compatible avec une version plus récente de PostgreSQL, vous devez mettre à niveau l'opérateur AlloyDB Omni lui-même, ainsi que votre cluster de base de données. Chaque ensemble de versions AlloyDB Omni compatibles avec une version mineure PostgreSQL particulière possède son propre numéro de version de l'opérateur AlloyDB Omni, que vous trouverez dans la note de version de la version AlloyDB Omni.

Si vous ne souhaitez passer qu'à une version de correctif plus récente d'AlloyDB Omni, vous ne pouvez mettre à niveau que votre cluster de base de données, sans avoir à mettre à niveau l'opérateur AlloyDB Omni lui-même.

Sinon, passez à la section Mettre à niveau l'opérateur AlloyDB Omni.

Mettre à niveau l'opérateur AlloyDB Omni

Kubernetes

Pour mettre à niveau l'opérateur AlloyDB Omni:

  1. Définissez les variables d'environnement:

    export GCS_BUCKET=alloydb-omni-operator
export OPERATOR_VERSION=OPERATOR_VERSION
export HELM_PATH=$OPERATOR_VERSION/alloydbomni-operator-$OPERATOR_VERSION.tgz

    Remplacez OPERATOR_VERSION par la version de l'opérateur AlloyDB Omni vers laquelle vous effectuez la mise à niveau (par exemple, 1.1.0).

  2. Téléchargez le dernier opérateur AlloyDB Omni:

    gsutil cp -r gs://$GCS_BUCKET/$HELM_PATH ./
tar -xvzf alloydbomni-operator-${OPERATOR_VERSION}.tgz

  3. Appliquez les dernières définitions de ressources personnalisées de l'opérateur AlloyDB Omni:

    kubectl apply -f alloydbomni-operator/crds

  4. Mettez à niveau le chart Helm de l'opérateur AlloyDB Omni:

    helm upgrade alloydbomni-operator alloydbomni-operator-${OPERATOR_VERSION}.tgz \
--namespace alloydb-omni-system \
--atomic \
--timeout 5m

Une fois la mise à niveau de votre opérateur AlloyDB Omni terminée, suivez les instructions de la section Effectuer une mise à niveau sur place pour créer un cluster de base de données.

Si votre cluster AlloyDB Omni a été créé avec l'opérateur AlloyDB Omni 1.0.0, ajoutez le champ controlPlaneAgentsVersion au fichier manifeste et définissez-le sur 1.1.0 avant de mettre à niveau le cluster vers la version 15.5.5. Sinon, l'erreur suivante s'affiche:

admission webhook "vdbcluster.alloydbomni.dbadmin.goog" denied the request: unsupported database version 15.5.5 and/or control plane agents version 1.0.0

Voici un exemple de fichier manifeste avec le champ controlPlaneAgentsVersion:

apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
spec:
  databaseVersion: "15.5.5"
  controlPlaneAgentsVersion: "1.1.0"
...