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 describe cómo actualizar el operador de AlloyDB Omni. Los pasos para actualizar AlloyDB Omni en Kubernetes dependen de la versión actual de AlloyDB Omni y de la versión a la que actualizas.

Cómo determinar tus versiones actuales

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

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

Realiza los siguientes reemplazos:

  • 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 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 el siguiente 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, el resultado será 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 Verifica los números de versión de destino.

Verifica los números de versión de destino

Si ejecutas la versión 1.0.0 o una versión posterior del operador de AlloyDB Omni, los próximos pasos dependerán de la versión de AlloyDB Omni a la que quieras actualizar. 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.7.0 de AlloyDB Omni admite la versión 15.7 de PostgreSQL y no tiene un parche de lanzamiento de AlloyDB Omni.

Elige la opción de instalación que funcione para tu versión de destino:

Situación de instalación Pasos para actualizar
Quieres actualizar a una versión de AlloyDB Omni que admita una versión más reciente de PostgreSQL. Actualiza el operador de AlloyDB Omni y 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 las notas de la versión de la versión de AlloyDB Omni. Usa la tabla de compatibilidad de versiones del operador de AlloyDB Omni para verificar que la versión del operador de AlloyDB Omni sea compatible con la versión del operador.
Solo deseas actualizar a una versión de parche más reciente de AlloyDB Omni. Actualiza solo tu clúster de base de datos. Consulta la tabla de compatibilidad de versiones del operador de AlloyDB Omni y las notas de la versión antes de realizar la actualización para determinar si también debes actualizar el operador de AlloyDB Omni.
Todas las demás situaciones Sigue los pasos para actualizar el operador de AlloyDB Omni.

Actualiza el operador de AlloyDB Omni

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.3.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

    Para actualizar dbCluster, debes actualizar las versiones de databaseVersion y controlPlaneAgentsVersion en el archivo de manifiesto. A continuación, se muestra parte de un archivo de manifiesto que especifica la versión 15.7.0 de databaseVersion y la versión 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"
...