Para mantener la disponibilidad en todas las regiones y escalar las cargas de trabajo de lectura de forma global, puedes crear y administrar clústeres secundarios de AlloyDB para PostgreSQL, agregar instancias de grupos de lectura y realizar operaciones de cambio o ascenso.
Para obtener una descripción general conceptual de la replicación entre regiones, consulta Descripción general de la replicación entre regiones.
Antes de comenzar
- El proyecto de Google Cloud que usas debe haber sido habilitado para acceder a AlloyDB.
- Debes tener uno de estos roles de IAM en el proyecto de Google Cloud que estás usando:
roles/alloydb.admin(el rol de IAM predefinido de administrador de AlloyDB)roles/owner(el rol básico de IAM de propietario)roles/editor(el rol básico de IAM de editor)
Si no tienes ninguno de estos roles, comunícate con el administrador de la organización para solicitar acceso.
Crea un clúster secundario
Cuando creas un clúster secundario, AlloyDB copia y aplica parte de la configuración del clúster principal, incluida la configuración de la recuperación de un momento determinado (PITR) y de la copia de seguridad, en el clúster secundario. AlloyDB no agrega ninguna instancia de grupo de lectura al clúster secundario después de crearlo, sin importar cuántas instancias de grupo de lectura existan en el clúster principal.
Si actualizas la configuración del clúster principal después de crear el clúster secundario, los cambios no estarán disponibles en el clúster secundario. Sin embargo, puedes actualizar manualmente el clúster secundario para que tenga la configuración más reciente que esté disponible en el clúster principal.
Puedes crear hasta cinco clústeres secundarios para un clúster principal. Todos los clústeres secundarios se replican desde una sola instancia principal. Si asciendes un clúster secundario, este se convierte en un clúster principal independiente.
En el siguiente diagrama, se ilustra cómo ascender el clúster secundario llamado
cluster-2 en us-east4:

Figura 1. Ejemplo de ascenso de un clúster secundario.
Para crear un clúster y una instancia secundarios de AlloyDB, sigue estos pasos:
De forma predeterminada, AlloyDB crea instancias secundarias con la misma configuración de máquina que la instancia principal en el momento de la creación. Sin embargo, si escalas verticalmente la instancia principal después de crear la secundaria, AlloyDB no escala verticalmente la instancia secundaria de forma automática, sino que debes hacerlo de forma manual.
Console
En la consola de Google Cloud , ve a la página Clústeres.
En la columna Nombre del recurso, haz clic en un clúster.
En la página Descripción general, haz clic en Crear clúster secundario.
Configura el clúster secundario:
- En el campo ID del clúster, ingresa un ID de recurso para tu clúster secundario.
- En el menú Región, selecciona una región para el clúster secundario que sea diferente de la región del clúster principal.
Configura la encriptación para tu clúster secundario:
- Si el clúster principal usa la encriptación administrada por Google: De forma predeterminada, AlloyDB encripta el clúster secundario con la encriptación administrada por Google. Para encriptar el clúster secundario con una clave de encriptación administrada por el cliente (CMEK), haz clic en Opciones de configuración avanzadas, luego en Opciones de encriptación avanzadas y, por último, selecciona Clave de Cloud KMS.
- Si el clúster principal usa CMEK, también debes encriptar el clúster secundario con CMEK. En la sección Encriptación, se selecciona automáticamente Clave de Cloud KMS.
Si usas la clave de Cloud KMS, selecciona una clave en la misma región que el clúster secundario:
- Opcional: En el menú Tipo de administración de claves, selecciona un tipo de administración de claves (el valor predeterminado es Cloud KMS).
Haz clic en Seleccionar una clave de Cloud KMS y elige una clave del menú.
La consola de Google Cloud limita este menú a las claves dentro del proyecto de Google Cloud actual y la región seleccionada. Para usar una clave que no esté en esta lista, elige una de las opciones que se encuentran en la parte inferior del menú Selecciona una clave de Cloud KMS:
- Para explorar las claves de otro proyecto, haz clic en Cambiar proyecto y selecciona el proyecto.
- Para especificar una clave por su nombre de recurso, haz clic en Ingresar la clave manualmente. En el cuadro de diálogo Ingresa el nombre del recurso de la clave, en el campo Nombre del recurso de la clave, ingresa el nombre del recurso de la clave y, luego, haz clic en Guardar.
El uso de CMEK con AlloyDB requiere una configuración adicional. Para obtener más información, consulta Protege los datos con claves de encriptación.
Haz clic en Continuar.
Configura la instancia secundaria. En el campo ID de instancia, ingresa un ID de recurso para tu instancia secundaria. El ID del recurso debe ser único en un clúster.
Haga clic en Crear clúster.
gcloud
Para usar gcloud CLI, puedes instalar e inicializar Google Cloud CLI, o bien puedes usar Cloud Shell.
Usa el comando gcloud alloydb clusters create-secondary.
gcloud alloydb clusters create-secondary SECONDARY_CLUSTER_ID \ --region=REGION_ID \ --primary-cluster=projects/PROJECT_ID/locations/LOCATION_ID/clusters/PRIMARY_CLUSTER_IDgcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \ --cluster=SECONDARY_CLUSTER_ID \ --region=REGION_ID
Reemplaza lo siguiente:
SECONDARY_CLUSTER_ID: Es el ID del clúster secundario que deseas crear y con el que quieres asociar la instancia secundaria.SECONDARY_INSTANCE_ID: Es el ID de la instancia secundaria que deseas crear.REGION_ID: Es el ID de la región del clúster secundario, por ejemplo,us-central1.PROJECT_ID: Es el ID del proyecto del clúster principal.LOCATION_ID: Es la ubicación en la que se encuentra tu clúster principal, por ejemplo,us-central1.PRIMARY_CLUSTER_ID: Es el ID del clúster principal con el que está asociado el clúster secundario.
Para inhabilitar la creación de copias de seguridad automáticas en el clúster secundario, pasa la
marca --no-enable-automated-backup al comando
gcloud alloydb clusters create-secondary.
Para crear una instancia secundaria habilitada para Private Service Connect,
agrega la marca --allowed-psc-projects para establecer una lista separada por comas de los IDs
o números de proyecto
a los que deseas permitir el acceso a la instancia, por ejemplo,
my-project-1, 12345 y my-project-n.
gcloud alloydb clusters create-secondary SECONDARY_CLUSTER_ID \ --region=REGION_ID \ --primary-cluster=projects/PROJECT_ID/locations/LOCATION_ID/clusters/PRIMARY_CLUSTER_IDgcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \ --cluster=SECONDARY_CLUSTER_ID \ --region=REGION_ID \ --allowed-psc-projects=ALLOWED_PSC_PROJECTS
Reemplaza lo siguiente:
ALLOWED_PSC_PROJECTS(opcional): Es la lista separada por comas de los ID de proyectos o números de proyectos a los que deseas permitir el acceso a la instancia, por ejemplo,my-project-1,12345ymy-project-n. Si tu clúster usa Private Service Connect como método para conectarse a la instancia, debes establecer una lista de proyectos o números permitidos.
Para crear una instancia secundaria para un clúster con IP pública habilitada, agrega la
marca --assign-inbound-public-ip=ASSIGN_IPV4:
gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
--cluster=SECONDARY_CLUSTER_ID \
--region=REGION_ID \
--assign-inbound-public-ip=ASSIGN_IPV4De manera opcional, pasa una lista separada por comas de bloques CIDR, como
64.233.160.0/16, a la marca --authorized-external-networks para configurar
redes externas autorizadas en tu instancia.
Visualiza un clúster secundario
Para ver información detallada sobre un clúster secundario de AlloyDB, sigue estos pasos:
En la consola de Google Cloud , ve a la página Clústeres.
En la columna Nombre del recurso, haz clic en un clúster secundario.
En la página Descripción general, consulta los detalles sobre tu clúster secundario.
Actualiza una instancia secundaria
Puedes actualizar una instancia secundaria para agregar, modificar o borrar marcas de base de datos. También puedes escalar el tipo de máquina de tu instancia secundaria.
Configura marcas de base de datos en una instancia secundaria
Para agregar, modificar o borrar marcas de base de datos, completa los siguientes pasos:
Console
En la consola de Google Cloud , ve a la página Clústeres.
En la columna Nombre del recurso, haz clic en el clúster secundario que deseas modificar.
En la página Descripción general, ve a la sección Instancias en tu clúster, busca la instancia secundaria y haz clic en Editar instancia secundaria.
Haz clic en Mostrar opciones avanzadas y, luego, expande Marcas.
Agrega, modifica o borra una marca de base de datos en tu instancia:
Cómo agregar una marca
- Haz clic en Agregar una marca de base de datos.
- En el menú Elige una marca, selecciona una marca.
- En Valor, ingresa o selecciona un valor para el parámetro.
- Haz clic en Listo.
Modifica una marca
- Expande la marca de base de datos que deseas modificar.
- En la sección Editar marca de base de datos, actualiza el valor de la marca.
- Haz clic en Listo.
Cómo borrar una marca
- En la marca de base de datos que deseas quitar, haz clic en Borrar.
Haz clic en Actualizar instancia.
gcloud
Usa el comando gcloud alloydb instances update
para cambiar las marcas de la base de datos de una instancia secundaria.
gcloud alloydb instances update SECONDARY_INSTANCE_ID \
--database-flags FLAGS_LIST \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_IDReemplaza lo siguiente:
SECONDARY_INSTANCE_ID: Es el ID de la instancia secundaria.FLAGS_LIST: Es una lista separada por comas de una o más especificaciones de marcas de base de datos. Cada especificación consta del nombre de la marca, un signo igual (=) y el valor que se asignará a las marcas. Para las marcas de base de datos que no toman valores, proporciona el nombre de la marca seguido de un signo igual (=).REGION_ID: Es la región en la que se coloca la instancia secundaria, por ejemplo,us-central1.CLUSTER_ID: Es el ID del clúster en el que se coloca la instancia secundaria.PROJECT_ID: Es el ID del proyecto en el que se coloca el clúster secundario.
Escala el tipo de máquina de tu instancia secundaria
Para escalar el tipo de máquina de tu instancia secundaria, completa los siguientes pasos:
Console
En la consola de Google Cloud , ve a la página Clústeres.
En la columna Nombre del recurso, haz clic en el clúster secundario que deseas modificar.
En la página Descripción general, ve a la sección Instancias en tu clúster y haz clic en Editar instancia secundaria.
Esta acción no está disponible si el Estado del clúster es Mantenimiento. Espera hasta que el Estado cambie a Listo.
En la sección Máquina, selecciona de forma opcional una serie en el menú Serie de máquinas y, luego, una configuración en el menú Tipo de máquina.
Haz clic en Actualizar instancia.
gcloud
Usa el comando
gcloud alloydb instances update
para cambiar el tipo de máquina de la instancia secundaria:
gcloud alloydb instances update SECONDARY_INSTANCE_ID \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_IDReemplaza lo siguiente:
SECONDARY_INSTANCE_ID: Es el ID de la instancia secundaria que estás actualizando.CPU_COUNT: Es la cantidad de CPU virtuales que deseas para la instancia. Los valores válidos incluyen lo siguiente:2(2 CPU virtuales, 16 GB de RAM)4(4 CPU virtuales, 32 GB de RAM)8(8 CPU virtuales, 64 GB de RAM)16(16 CPU virtuales, 128 GB de RAM)32(32 CPU virtuales, 256 GB de RAM)64(64 CPU virtuales, 512 GB de RAM)96(96 CPUs virtuales, 768 GB de RAM)128(128 CPU virtuales, 864 GB de RAM)
REGION_ID: Es la región en la que se coloca la instancia.CLUSTER_ID: Es el ID del clúster en el que se coloca la instancia.PROJECT_ID: Es el ID del proyecto en el que se encuentra el clúster.
Si el comando devuelve un mensaje de error que incluye la frase
invalid cluster state MAINTENANCE, el clúster se encuentra en mantenimiento
de rutina. El mantenimiento impide temporalmente que se vuelva a configurar la instancia. Vuelve a ejecutar
el comando después de que el clúster vuelva al estado READY.
Para verificar el estado del clúster, consulta Visualiza los detalles del clúster.
Agrega instancias de grupo de lectura a un clúster secundario
Para agregar una instancia de grupo de lectura a un clúster secundario, sigue estos pasos:
En la consola de Google Cloud , ve a la página Clústeres.
En la columna Nombre del recurso, haz clic en el clúster secundario al que deseas agregar una instancia de grupo de lectura.
En la página Descripción general, ve a la sección Instancias en tu clúster y haz clic en Agregar grupo de lectura.
Configura tu instancia de grupo de lectura:
- En el campo ID de instancia del grupo de lectura, ingresa un ID para la instancia del grupo de lectura.
En la sección Modo de escalamiento, mantén seleccionada la opción Manual y, luego, ingresa un recuento de nodos en el campo Recuento de nodos (o selecciona Escalado automático para configurar los recuentos de nodos Mínimo y Máximo).
La cantidad de nodos en una instancia de grupo de lectura determina la capacidad de procesamiento general de la instancia. Puedes tener un máximo de 20 nodos en todas las instancias de grupos de lectura de un clúster.
En la sección Máquina, selecciona de forma opcional una serie en el menú Serie de máquinas y, luego, una configuración en el menú Tipo de máquina.
Opcional: Para establecer marcas personalizadas en tu instancia, haz clic en Mostrar opciones avanzadas, expande Marcas y haz lo siguiente para cada marca:
- Haz clic en Agregar una marca de base de datos.
- En el menú Elige una marca, selecciona una marca.
- En Valor, ingresa o selecciona un valor para el parámetro.
- Haz clic en Listo.
Haz clic en Crear grupo de lectura.
Recuperación ante desastres avanzada
Para situaciones de recuperación ante desastres avanzadas, AlloyDB admite el cambio y la conmutación por error entre regiones:
Realiza un cambio
El cambio te permite revertir las funciones de tus clústeres principal y secundario sin pérdida de datos. Usa esta operación para migraciones planificadas, mantenimiento de rutina o simulacros de recuperación ante desastres. Cuando completes el cambio, se revertirá la dirección de la replicación.
Si realizas un cambio cuando tienes varios clústeres secundarios, se producen los siguientes cambios:
- El clúster secundario que recibe el comando de cambio se convierte en un clúster principal.
- El clúster principal anterior se convierte en un clúster secundario y se replica desde el nuevo clúster principal.
- Todos los demás clústeres secundarios cambian para replicar desde el clúster principal nuevo.
En el siguiente diagrama, se ilustra un cambio de cluster-1 en us-central1
a cluster-2 en us-east4:

Figura 2. Ejemplo de cómo realizar un cambio a uno de los dos clústeres secundarios.
Antes de realizar un cambio, verifica que todas las regiones a las que pertenecen las instancias principal y secundaria estén en línea y que las instancias estén en un estado correcto. Para obtener más información, consulta Supervisa una instancia con el panel de Estadísticas del sistema de AlloyDB.
Para realizar un cambio, sigue estos pasos:
Console
En la consola de Google Cloud , ve a la página Clústeres.
En la columna Nombre del recurso, haz clic en el clúster secundario que deseas cambiar.
En la página Descripción general, haz clic en Cambiar.
En el cuadro de diálogo ¿Cambiar clúster?, en el campo ID del clúster, ingresa el ID del clúster principal asociado para confirmar que deseas cambiar el clúster.
Haz clic en Cambio.
Después de que se complete el cambio, el campo Tipo de clúster en la página Descripción general se actualizará a Clúster principal para el clúster cambiado y a Clúster secundario para el clúster principal anterior.
gcloud
Usa el comando de gcloud alloydb clusters switchover:
gcloud alloydb clusters switchover SECONDARY_CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_IDReemplaza lo siguiente:
SECONDARY_CLUSTER_ID: el ID del clúster secundario al que deseas cambiar.REGION_ID: Es el ID de la región del clúster secundario, por ejemplo,us-central1.PROJECT_ID: el ID del proyecto del clúster secundario.
Opcional: Verifica el estado de la replicación
Para ayudar a que el cambio se complete con un retraso mínimo y sin pérdida de datos, confirma que el clúster secundario haya aplicado todas las transacciones recibidas del clúster principal:
- Detén todas las operaciones de escritura en el clúster principal.
Verifica el estado de replicación del clúster secundario:
En la consola de Google Cloud , ve a la página Clústeres.
En la columna Nombre del recurso, haz clic en el clúster secundario que deseas cambiar.
En el menú de navegación de AlloyDB, haz clic en Estadísticas del sistema.
En el menú Instancia, selecciona Secundaria: SECONDARY_INSTANCE_ID, donde
SECONDARY_INSTANCE_IDes el ID de tu instancia secundaria.Busca el gráfico Lapso de replicación desde la instancia principal y confirma que el gráfico muestre un retraso mínimo.
Un valor de rezago de
0es óptimo. Si el retraso es superior a0, la operación de cambio puede tardar más en completarse mientras se aplican las transacciones restantes.Busca el gráfico Estado de replicación y confirma que todos los nodos representados en el gráfico estén en el estado
streaming.
Asciende un clúster secundario
Cuando asciendes un clúster secundario, se convierte en un clúster principal independiente con capacidades completas de lectura y escritura. Usa esta operación principalmente para la recuperación ante desastres cuando la región que aloja tu clúster principal no esté disponible.
De forma predeterminada, el ascenso convierte el clúster secundario en uno principal independiente. Sin embargo, puedes habilitar la conmutación por error entre regiones (versión preliminar) de forma opcional para automatizar la recreación de la instancia principal original. La conmutación por error entre regiones solo se admite para topologías con un solo clúster principal y un solo clúster secundario.
Para ascender un clúster secundario a un clúster principal o, de manera opcional, agregar la organización de la conmutación por error, sigue estos pasos:
Console
En la consola de Google Cloud , ve a la página Clústeres.
En la columna Nombre del recurso, haz clic en el clúster secundario que deseas ascender.
En la página Descripción general, elige si deseas realizar un ascenso independiente o un ascenso con organización de conmutación por error:
- Ascender a un clúster principal independiente:
- Haz clic en Ascender.
- En el cuadro de diálogo que aparece, en el campo ID del clúster, ingresa el ID del clúster secundario y, luego, haz clic en Ascender.
- Promueve con la organización de conmutación por error
(versión preliminar):
- Haz clic en Conmutación por error.
- En el cuadro de diálogo que aparece, en el campo ID del clúster, ingresa el ID del clúster secundario y, luego, haz clic en Activar conmutación por error.
Después de que se complete el ascenso, el campo Tipo de clúster en la página Descripción general se actualiza de Clúster secundario a Clúster principal. Si seleccionaste Conmutación por error, AlloyDB vuelve a crear el clúster principal original en segundo plano cuando su región esté disponible. Durante este proceso, su Estado muestra Volviendo a crear, y su Tipo de clúster se actualiza a Clúster secundario cuando finaliza la recreación.
- Ascender a un clúster principal independiente:
gcloud
Para ascender un clúster secundario a un clúster principal independiente, usa el comando
gcloud alloydb clusters promote:
gcloud alloydb clusters promote SECONDARY_CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_IDPara realizar un ascenso con organización de conmutación por error
(vista previa), agrega la marca opcional
--failover. Esta marca vuelve a crear automáticamente el clúster principal original como secundario
y actualiza los extremos asociados para enrutar el tráfico al nuevo clúster
principal.
gcloud beta alloydb clusters promote SECONDARY_CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--failoverReemplaza lo siguiente:
SECONDARY_CLUSTER_ID: Es el ID del clúster secundario que deseas ascender.REGION_ID: Es el ID de la región del clúster secundario, por ejemplo,us-central1.PROJECT_ID: el ID del proyecto del clúster secundario.
Usa extremos de escritura para evitar el cerebro dividido
Para simplificar aún más tu flujo de trabajo de recuperación ante desastres durante una conmutación por error entre regiones, Google recomienda que administres las conexiones de la base de datos con extremos de escritura para conectarte a tu clúster.
Cuando realizas una conmutación por error entre regiones, AlloyDB actualiza automáticamente el registro DNS de tu extremo de escritura para que apunte al nuevo clúster principal. Esto garantiza que el tráfico de escritura nuevo se dirija fuera de la instancia principal original y hacia la nueva.
Antes de usar extremos de escritura durante una conmutación por error entre regiones, ten en cuenta lo siguiente:
- Actualización inmediata de DNS: El registro DNS del extremo de escritura se actualiza de inmediato después de la promoción.
- Actualización retrasada de metadatos: Es posible que los metadatos del extremo de escritura sigan mostrando la dirección de la instancia principal original hasta que se recupere la región del clúster principal original.
Recuperación de datos durante la conmutación por error entre regiones
Cuando realizas una conmutación por error entre regiones, AlloyDB crea automáticamente una copia de seguridad del clúster principal original antes de volver a crearlo como un clúster secundario. Se produce una situación de cerebro dividido cuando los clústeres principal original y principal nuevo aceptan operaciones de escritura de forma simultánea. Para evitar estas situaciones, las operaciones de escritura en la instancia principal original se detienen antes de que se realice esta copia de seguridad. Usa esta copia de seguridad para recuperar las transacciones que no se replicaron en el clúster secundario debido al retraso durante la conmutación por error.
Esta copia de seguridad se crea automáticamente como parte de la organización de la conmutación por error y es distinta de las copias de seguridad automáticas programadas con regularidad y las copias de seguridad a pedido. Puedes usarla para crear un clúster temporal nuevo y conciliar manualmente los datos faltantes.
Esta copia de seguridad captura las escrituras que la instancia principal original aceptó antes de detenerse, pero no las combina automáticamente en el nuevo clúster principal.