Migrar a la versión más reciente del operador de AlloyDB Omni de Kubernetes

Selecciona una versión de la documentación:

En esta página se incluyen instrucciones para actualizar de la versión 1.0.0 a la 1.1.0 del operador AlloyDB Omni.

Los pasos que sigas para actualizar AlloyDB Omni en Kubernetes dependen de la versión de AlloyDB Omni que estés ejecutando y de la versión a la que quieras actualizar.

Determinar los números de versión actuales

Kubernetes

Para comprobar la versión de AlloyDB Omni que usa tu clúster de base de datos, ejecuta este comando:

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

Haz los cambios siguientes:

  • DB_CLUSTER_NAME: el nombre de tu clúster de bases de datos. Es el mismo nombre de clúster de base de datos que declaraste cuando lo creaste.

  • NAMESPACE: el espacio de nombres de Kubernetes de tu clúster de base de datos.

Si ejecutas la versión 1.0.0 o una posterior del operador AlloyDB Omni, este comando imprimirá la versión de AlloyDB Omni que usa tu clúster de base de datos.

Para comprobar la versión del operador AlloyDB Omni instalada en tu clúster de Kubernetes, ejecuta este comando:

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

Si ejecutas la versión 1.0.0 o una posterior del operador AlloyDB Omni, este comando imprimirá el número de versión del operador AlloyDB Omni que se esté ejecutando en tu clúster de Kubernetes.

Si ejecutas una versión de AlloyDB Omni Operator anterior a la 1.0.0, sigue las instrucciones de Actualizar desde una versión de AlloyDB Omni Operator anterior a la 1.0.0.

De lo contrario, ve a la sección Comprobar los números de versión de destino.

Comprobar los números de versión de destino

Kubernetes

Si ejecutas una versión del operador AlloyDB Omni 1.0.0 o posterior, los pasos siguientes dependerán de la versión de AlloyDB Omni a la que quieras actualizar. Para ello, es necesario conocer el número de versión de AlloyDB Omni.

El número de versión de AlloyDB Omni tiene los siguientes componentes:

  • El número de versión principal de su compatibilidad con PostgreSQL
  • El número de versión secundaria de su compatibilidad con PostgreSQL
  • Número de versión del parche de esta versión de AlloyDB Omni.

Por ejemplo, la versión 15.5.5 de AlloyDB Omni es la versión de parche 5 de AlloyDB Omni que admite la versión 15.5 de PostgreSQL.

Si quieres actualizar a una versión de AlloyDB Omni que admita una versión más reciente de PostgreSQL, debes actualizar el operador de AlloyDB Omni junto con tu clúster de base de datos. Cada conjunto de versiones de AlloyDB Omni que admite una versión secundaria concreta de PostgreSQL tiene su propio número de versión del operador de AlloyDB Omni, que puedes encontrar en las notas de la versión de AlloyDB Omni.

Si solo quieres actualizar a una versión de parche más reciente de AlloyDB Omni, puedes actualizar solo tu clúster de base de datos, sin necesidad de actualizar el operador de AlloyDB Omni.

De lo contrario, ve a la sección Actualizar el operador AlloyDB Omni.

Actualizar el operador de AlloyDB Omni

Kubernetes

Para actualizar AlloyDB Omni Operator, sigue estos pasos:

  1. Define las variables de entorno:

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

    Sustituye OPERATOR_VERSION por la versión del operador de AlloyDB Omni a la que vas a actualizar (por ejemplo, 1.1.0).

  2. Descarga la versión más reciente del operador de AlloyDB Omni:

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

  3. Aplica las definiciones de recursos personalizados del operador AlloyDB Omni más recientes:

    kubectl apply -f alloydbomni-operator/crds

  4. Actualiza el gráfico de Helm del operador AlloyDB Omni:

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

Después de completar la actualización de tu operador AlloyDB Omni, sigue las instrucciones de Realizar una actualización in situ para crear un nuevo clúster de base de datos.

Si tu clúster de AlloyDB Omni se creó con el operador de AlloyDB Omni 1.0.0, añade el campo controlPlaneAgentsVersion al manifiesto y asigna el valor 1.1.0 antes de actualizar el clúster a la versión 15.5.5. De lo contrario, se mostrará el siguiente error:

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

Un ejemplo de manifiesto con el campo controlPlaneAgentsVersion tiene el siguiente aspecto:

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