En esta página, se describe cómo realizar una actualización de versión secundaria de la base de datos para AlloyDB Omni en Kubernetes.
Para realizar una actualización de la versión secundaria de la base de datos, hay dos opciones:
- Actualización con poco tiempo de inactividad (LDTM): En entornos de alta disponibilidad (HA), el operador de AlloyDB Omni actualiza primero las instancias en espera. Una vez que todas las instancias en espera se actualizan correctamente, el operador realiza un cambio y asciende una de las instancias en espera actualizadas para que sea tu nueva instancia principal. Después de que el cambio se realiza correctamente, se actualiza la instancia principal anterior. Este proceso progresivo secuencial garantiza un tiempo de inactividad mínimo y mantiene la instancia principal activa en la versión anterior hasta que se valide por completo la actualización del entorno en espera.
- Actualización simultánea: En entornos que no son de alta disponibilidad o si el LDTM está inhabilitado de forma explícita, el operador de AlloyDB Omni actualiza todas las instancias de la base de datos de forma simultánea. Este método provoca un tiempo de inactividad de la base de datos durante el proceso de actualización.
Limitaciones
Durante el proceso de actualización con poco tiempo de inactividad, cada instancia en espera se actualiza de forma secuencial y no está disponible temporalmente mientras se actualiza.
Para garantizar que tu clúster de base de datos mantenga un objetivo de punto de recuperación (RPO) de cero y no corra el riesgo de perder datos durante la actualización de la instancia en espera, se recomienda tener al menos dos instancias en espera. Esta configuración actúa como una configuración de HA de tres nodos.
Las actualizaciones con poco tiempo de inactividad no se admiten en clústeres de bases de datos secundarios en una configuración de
replicación entre centros de datos. Antes de actualizar un clúster de base de datos secundario con instancias en espera de alta disponibilidad,
inhabilita de forma explícita la LDTM configurando dbcluster.dbadmin.goog/enableLDTM=false.
Antes de comenzar
- Si tu clúster es de alta disponibilidad y la versión de AlloyDB Omni es anterior a la 15.7.1, sigue los pasos que se indican en Actualiza los clústeres de bases de datos antes de seguir este proceso de actualización de la versión secundaria.
- Para evitar la pérdida de datos, crea una copia de seguridad.
- Mientras se realiza la operación de actualización con poco tiempo de inactividad, la redundancia de HA del clúster de base de datos se degrada temporalmente mientras se actualiza una instancia en espera. Sin embargo, la base de datos sigue disponible para el tráfico de lectura y escritura en la instancia principal activa.
Habilita el proceso de actualización de la versión secundaria de la base de datos con poco tiempo de inactividad
El proceso de actualización con poco tiempo de inactividad (LDTM) se habilita automáticamente de forma predeterminada si tu clúster de base de datos tiene dos o más instancias en espera.
Si tu clúster de base de datos tiene solo una instancia en espera, debes habilitar LDTM de forma manual agregando la anotación dbcluster.dbadmin.goog/enableLDTM=true a tu clúster de base de datos:
kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME dbcluster.dbadmin.goog/enableLDTM=true
Reemplaza la siguiente variable:
DB_CLUSTER_NAME: Es el nombre de tu clúster de base de datos. Es el mismo nombre del clúster de bases de datos que proporcionaste cuando lo creaste. Para obtener más información, consulta Instala AlloyDB Omni en Kubernetes.
Actualiza tu versión de AlloyDB Omni
Para actualizar la versión 18.4.0, actualiza los campos
databaseVersion y controlPlaneAgentsVersion en el archivo de manifiesto del clúster
y, luego, vuelve a aplicar el archivo.
A continuación, se muestra el comienzo de un archivo de manifiesto que especifica la versión
18.4.0 para databaseVersion y la versión
1.9.0 para controlPlaneAgentsVersion:
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
name: DB_CLUSTER_NAME
spec:
databaseVersion: "DB_VERSION"
controlPlaneAgentsVersion: "CONTROL_PLANE_AGENTS_VERSION"
# It is recommended to switch to UBI9 for improved security and
# compatibility.
# If you need to stick to Debian, set this field to "Debian".
databaseImageOSType: "OS_TYPE"
...
Reemplaza la siguiente variable:
DB_CLUSTER_NAME: Es el nombre de tu clúster de base de datos. Es el mismo nombre del clúster de bases de datos que proporcionaste cuando lo creaste. Para obtener más información, consulta Instala AlloyDB Omni en Kubernetes.DB_VERSION: Es la versión de la base de datos a la que actualizarás.CONTROL_PLANE_AGENTS_VERSION: Es la versión de los agentes del plano de control.OS_TYPE: Opcional Es el sistema operativo base de la imagen de la base de datos. Los valores válidos sonDebianyUBI9. Si no especificas este parámetro, el operador lo establece automáticamente enDebiansidatabaseVersiones anterior a16.9.0, y enUBI9sidatabaseVersiones16.9.0o posterior.
Supervisa el proceso de actualización
Después de actualizar el archivo de manifiesto, el operador de AlloyDB Omni inicia
el proceso de actualización. Para supervisar el proceso de actualización, verifica la
condición DBCUpgradeInProgress.
kubectl get dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -o yaml | yq '.status.conditions[] | select(.type == "DBCUpgradeInProgress")'
Reemplaza la siguiente variable:
DB_CLUSTER_NAME: Es el nombre de tu clúster de base de datos. Es el mismo nombre del clúster de bases de datos que proporcionaste cuando lo creaste. Para obtener más información, consulta Instala AlloyDB Omni en Kubernetes.
Mientras el proceso está en curso, el estado de la condición es true. Cuando se completa el proceso, el estado de la condición cambia a false y el motivo se actualiza a UpgradeComplete o UpgradeFailed.
Soluciona problemas
Si recibes algún mensaje de error durante el proceso de actualización, consulta las siguientes secciones:
Fallas previas a la actualización
Si recibes un error previo a la actualización en tu clúster de base de datos, verifica el mensaje y soluciona el problema según corresponda.
Si quieres omitir el mensaje de error previo a la actualización, puedes habilitar
la anotación force-upgrade.
kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME upgrade.alloydbomni.dbadmin.google/force-upgrade=true
Reemplaza la siguiente variable:
DB_CLUSTER_NAME: Es el nombre de tu clúster de base de datos. Es el mismo nombre del clúster de bases de datos que proporcionaste cuando lo creaste. Para obtener más información, consulta Instala AlloyDB Omni en Kubernetes.
Una vez que se complete el proceso de actualización, establece la anotación force-upgrade en
false.
Errores de actualización
Durante el proceso de actualización automática, hay varios puntos en los que puede fallar en entornos de alta disponibilidad. Para obtener más información sobre cada situación de falla y las acciones posteriores que realiza el operador de AlloyDB Omni, consulta la siguiente tabla.
| Mensaje de error | Descripción | Acciones obligatorias del usuario |
|---|---|---|
Standby instance upgrade succeeded but its replication lag is too high to be promoted to a synchronous standby. Please monitor replication status.
|
La instancia en espera se actualizó correctamente, pero no pudo ponerse al día con la instancia principal con la rapidez suficiente para alcanzar el umbral de replicación síncrona antes de que se agotara el tiempo de espera. Por lo general, esto se debe a un tráfico de escritura intenso en la instancia principal. |
Para permitir que la instancia en espera se sincronice, haz lo siguiente:
|
All standbys upgrade succeeded but the switchover instance failed to promote an upgraded standby.
|
Tus instancias en espera se actualizaron correctamente, pero falló el proceso de conmutación por error automática diseñado para ascender una instancia en espera actualizada a principal. |
Para investigar y resolver la falla del cambio, sigue estos pasos:
|
Standby instance upgrade failed but rollback to the previous versions succeeded
|
No se pudo actualizar la instancia en espera, pero el operador de AlloyDB Omni revirtió correctamente la instancia a su versión de trabajo anterior. Como nunca se modificó la instancia principal, la base de datos permanece en buen estado en la versión anterior. |
Para diagnosticar el problema subyacente y aplicar una solución, sigue estos pasos:
|
Standby instance upgrade failed and rollback to the previous versions failed
|
No se pudo actualizar la instancia en espera, y también falló el intento automático del operador de AlloyDB Omni de revertirla a la versión anterior. La instancia en espera queda en un estado incorrecto o inutilizable (lo que reduce la redundancia de la HA), mientras que la instancia principal sigue controlando el tráfico de lectura y escritura en la versión anterior. |
Para restablecer el estado del clúster, vuelve a aprovisionar el nodo en espera de la siguiente manera:
|
Corrige las instancias principal y en espera con diferentes versiones secundarias
Para resolver este problema, elige una de las siguientes opciones:
Si se resolvió el problema subyacente que causó la falla de la actualización, puedes volver a iniciarla. Quita la anotación
start-timede la actualización de tu DBCluster para que el operador de AlloyDB Omni genere una nueva hora de inicio y vuelva a intentarlo:kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME upgrade.alloydbomni.dbadmin.google/start-time-
Reemplaza
DB_CLUSTER_NAMEpor el nombre de tu clúster de base de datos. Es el mismo nombre del clúster de bases de datos que proporcionaste cuando lo creaste. Para obtener más información, consulta Instala AlloyDB Omni en Kubernetes.Si el problema que causó la falla de la actualización persiste y prefieres mantener el clúster en la versión anterior, no es necesario que realices un procedimiento de cambio a una versión anterior. Debido a que la actualización falló durante la fase de espera, tu instancia principal nunca se actualizó.
Para borrar el estado
UpgradeFailedy volver a un estado estable que no se esté actualizando, vuelve a cambiar los camposdatabaseVersionycontrolPlaneAgentsVersiondel manifiesto de DBCluster a las versiones que se usaban antes del intento de actualización y, luego, vuelve a aplicar el archivo.Si la actualización o el cambio a una versión inferior se detiene en
DBCUpgradeInProgress=True(DBCUpgradeFlowBegins) después de que se actualiza la primera instancia en espera en un clúster de base de datos secundario de replicación entre centros de datos, verifica si la actualización con poco tiempo de inactividad está habilitada (dbcluster.dbadmin.goog/enableLDTM=true) en el clúster de base de datos secundario. Inhabilita LDTM en el clúster de la base de datos secundaria para que el operador de AlloyDB Omni complete la actualización o la versión anterior con la ruta de actualización simultánea:kubectl annotate dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME dbcluster.dbadmin.goog/enableLDTM=false
Reemplaza
DB_CLUSTER_NAMEpor el nombre de tu clúster de base de datos secundario.