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

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 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 ejecutas y de la versión a la que actualizas.

Determina los números de versión actuales

Kubernetes

Para verificar 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}'

Reemplaza lo siguiente:

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

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

Si ejecutas la versión 1.0.0 o posterior del operador de AlloyDB Omni, este comando imprime la versión de AlloyDB Omni que usa tu clúster de base 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 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 Actualiza 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 la versión 1.0.0 o posterior del operador de AlloyDB Omni, los siguientes pasos 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 de 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 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 base de datos. Cada conjunto de versiones de AlloyDB Omni que admite una versión secundaria específica de PostgreSQL tiene su propio número de versión del operador de AlloyDB Omni, que puedes encontrar en la nota de la versión de AlloyDB Omni.

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

Actualiza el operador de AlloyDB Omni

Kubernetes

Para actualizar el operador de AlloyDB Omni, 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 realizas la actualización, por ejemplo, 1.1.0.

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

    gcloud storage 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 del operador de AlloyDB Omni, sigue las instrucciones que se indican en Realiza una actualización directa 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 en 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 muestra 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"
...