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

Cette page explique comment mettre à niveau l'opérateur AlloyDB Omni. La procédure de mise à niveau d'AlloyDB Omni dans Kubernetes dépend de votre version actuelle d'AlloyDB Omni et de la version vers laquelle vous effectuez la mise à niveau.

Déterminer vos versions actuelles

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

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

Effectuez les remplacements suivants :

  • DB_CLUSTER_NAME : nom de votre cluster de bases de données. Il s'agit du même nom de cluster de bases de données que celui que vous avez déclaré lorsque vous l'avez créé.

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

Si vous exécutez la version 1.0.0 ou une version ultérieure de l'opérateur AlloyDB Omni, cette commande affiche la version d'AlloyDB Omni utilisée par votre cluster de bases 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 version ultérieure de l'opérateur AlloyDB Omni, le résultat correspond au numéro de version de l'opérateur AlloyDB Omni exécuté sur votre cluster Kubernetes.

Si vous exécutez une version de l'opérateur AlloyDB Omni antérieure à la version 1.0.0, suivez les instructions de la section Mettre à niveau depuis un opérateur AlloyDB Omni antérieur à la version 1.0.0. Sinon, passez à l'étape Vérifier les numéros de version cible.

Vérifier les numéros de version cible

Si vous exécutez une version de l'opérateur AlloyDB Omni 1.0.0 ou version ultérieure, les étapes suivantes dépendent de la version d'AlloyDB Omni vers laquelle vous souhaitez effectuer la mise à niveau. Le numéro de version d'AlloyDB Omni comprend les composants suivants :

  • Numéro de version majeure de sa 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, AlloyDB Omni version 15.7.0 est compatible avec PostgreSQL version 15.7 et ne dispose pas de correctif de version AlloyDB Omni.

Choisissez l'option d'installation qui correspond à votre version cible :

Scénario d'installation Étapes de mise à jour
Vous souhaitez passer à une version d'AlloyDB Omni compatible avec une version plus récente de PostgreSQL. Mettez à niveau l'opérateur AlloyDB Omni et votre cluster de bases de données. Chaque ensemble de versions AlloyDB Omni compatibles avec une version mineure spécifique de PostgreSQL possède son propre numéro de version d'opérateur AlloyDB Omni, que vous trouverez dans les notes de version de la version AlloyDB Omni. Consultez le tableau de compatibilité des versions de l'opérateur AlloyDB Omni pour vérifier que votre version de l'opérateur AlloyDB Omni est compatible avec votre version de l'opérateur.
Vous souhaitez effectuer une mise à niveau uniquement vers une version de correctif plus récente d'AlloyDB Omni. Mettez à niveau uniquement votre cluster de bases de données. Consultez le tableau de compatibilité des versions de l'opérateur AlloyDB Omni et les notes de version avant de procéder à la mise à niveau pour déterminer si vous devez également mettre à jour l'opérateur AlloyDB Omni.
Tous les autres scénarios Suivez les étapes de la section Mettre à niveau l'opérateur AlloyDB Omni.

Mettre à niveau l'opérateur AlloyDB Omni

Pour mettre à niveau l'opérateur AlloyDB Omni, procédez comme suit :

  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.3.0).

  2. Téléchargez l'opérateur AlloyDB Omni le plus récent :

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

  3. Appliquez les définitions de ressources personnalisées de l'opérateur AlloyDB Omni les plus récentes :

    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

    Pour mettre à jour dbCluster, vous devez mettre à jour les versions databaseVersion et controlPlaneAgentsVersion dans le fichier manifeste. Voici la partie d'un fichier manifeste qui spécifie la version 15.7.0 de databaseVersion et la version 1.3.0 de controlPlaneAgentsVersion :

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