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

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

Los pasos que debes seguir para actualizar AlloyDB Omni en Kubernetes dependen de la versión de AlloyDB Omni que ejecutes y de la versión a la que te actualices.

Determina los números de versión actuales

Kubernetes

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

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

Reemplaza lo siguiente:

  • DB_CLUSTER_NAME: Es el nombre del clúster de tu base 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 bases de datos.

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

Para verificar la versión del operador de 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 de AlloyDB Omni, este comando imprime el número de versión del operador de AlloyDB Omni que se ejecuta en tu clúster de Kubernetes.

Si ejecutas una versión del operador de AlloyDB Omni anterior a la 1.0.0, sigue las instrucciones que se indican en Cómo actualizar desde un operador de AlloyDB Omni anterior a la versión 1.0.0.

De lo contrario, continúa con la sección Verifica los números de versión de destino.

Verifica los números de versión de destino

Kubernetes

Si ejecutas una versión del operador de AlloyDB Omni 1.0.0 o posterior, los pasos que debes seguir dependen de la versión de AlloyDB Omni a la que deseas actualizar. Esto, a su vez, requiere comprender 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
  • El 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 5 del parche de AlloyDB Omni que admite la versión 15.5 de PostgreSQL.

Si deseas 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 bases de datos. Cada conjunto de versiones de AlloyDB Omni que admiten una versión secundaria de PostgreSQL en particular tiene su propio número de versión del operador de AlloyDB Omni, que puedes encontrar en la nota de la versión de la versión de AlloyDB Omni.

Si deseas actualizar solo 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, continúa con la sección Cómo actualizar el operador de AlloyDB Omni.

Actualiza el operador de AlloyDB Omni

Kubernetes

Para actualizar el operador Omni de AlloyDB, 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

    Reemplaza OPERATOR_VERSION por la versión del operador de AlloyDB Omni a la que te actualizas, por ejemplo, 1.1.0.

  2. Descarga el operador de AlloyDB Omni más reciente:

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

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

    kubectl apply -f alloydbomni-operator/crds

  4. Actualiza el gráfico de Helm del operador de 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 de AlloyDB Omni, sigue las instrucciones que se indican en Realiza una actualización sin interrumpir el servicio para crear un clúster de base de datos nuevo.

Si tu clúster de AlloyDB Omni se creó con el operador de AlloyDB Omni 1.0.0, agrega el campo controlPlaneAgentsVersion al manifiesto y configúralo como 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 manifiesto de ejemplo con el campo controlPlaneAgentsVersion se ve de la siguiente manera:

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