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 el operador de AlloyDB Omni de la versión 1.0.0 a la 1.1.0.

Los pasos que sigues 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.

Cómo determinar 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 del 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 una posterior del operador de AlloyDB Omni, este comando imprimirá 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 instalado 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 imprimirá 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 una versión del operador de AlloyDB Omni 1.0.0 o posterior, los próximos pasos dependerán de la versión de AlloyDB Omni a la que quieras 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:

  • Número de versión principal de su compatibilidad con PostgreSQL
  • Número de versión secundaria de su compatibilidad con PostgreSQL
  • 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 bases 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 las notas de la versión 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 deseas actualizar, 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 del operador de AlloyDB Omni más recientes:

    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 en Realiza una actualización en el lugar para crear un nuevo clúster de base de datos.

Si tu clúster de AlloyDB Omni se creó con AlloyDB Omni Operator 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"
...