En esta página, se describe cómo usar la replicación entre centros de datos creando clústeres de bases de datos secundarios y trabajando con ellos en Kubernetes.
Para obtener una descripción general conceptual de la replicación entre centros de datos, consulta Acerca de la replicación entre centros de datos.
Antes de comenzar
- Confirma que tienes una conectividad de red confiable y de baja latencia entre los centros de datos principal y secundario, lo que es fundamental para que la replicación entre centros de datos funcione de manera eficaz.
- Instala la versión más reciente del operador de AlloyDB Omni para implementar AlloyDB Omni en un clúster de Kubernetes en el centro de datos principal y en un clúster de Kubernetes en el centro de datos secundario. La replicación entre centros de datos es compatible con la versión 1.5.0 y posteriores del operador de AlloyDB Omni.
- Crea un clúster de base de datos de AlloyDB Omni en el clúster de Kubernetes en el centro de datos principal.
- Asegúrate de que los servidores de bases de datos principal y en espera de tu clúster de base de datos principal tengan un espacio adecuado de registro de escritura anticipada (WAL) que pueda alojar los archivos WAL necesarios para la replicación en el clúster secundario. Los datos que aún no se replican en el clúster secundario se almacenan en el clúster principal como archivos WAL. Según la velocidad de conexión entre los clústeres principal y secundario, es posible que necesites espacio en el disco adicional para este propósito.
- Ten en cuenta la siguiente información sobre las bases de datos secundarias en espera de alta disponibilidad (versión preliminar):
si la versión del operador de AlloyDB Omni y la versión del agente del plano de control
son 1.7.0 o posteriores, el clúster de la base de datos secundaria puede admitir
bases de datos en espera de alta disponibilidad (HA).
A diferencia de las instancias en espera de alta disponibilidad en el clúster de la base de datos principal, las instancias en espera de alta disponibilidad en el clúster de la base de datos secundaria son asíncronas hasta que el clúster de la base de datos secundaria se asciende a una base de datos principal. Las instancias en espera de alta disponibilidad se vuelven síncronas o asíncronas automáticamente si se cambia el rol del clúster de la base de datos durante un cambio.
Crea un clúster de base de datos secundario
Para crear un clúster de base de datos secundario de AlloyDB Omni y habilitar la replicación desde tu clúster de base de datos principal, sigue estos pasos:
Verifica que la conectividad externa esté habilitada en tu clúster de base de datos principal de AlloyDB Omni. Si la conectividad externa no está habilitada, agrega lo siguiente a la sección spec del manifiesto del clúster de la base de datos:
... spec: ... allowExternalIncomingTraffic: true
Para usar la replicación entre centros de datos con un clúster de base de datos principal que tenga habilitada la alta disponibilidad (HA), confirma que el campo
replayReplicationSlotsOnStandbysesté habilitado en el clúster de base de datos principal:... spec: ... availability: ... replayReplicationSlotsOnStandbys: true
Si habilitas este campo, junto con el
logReplicationSlotsque se explica en el siguiente paso, se sincroniza la ranura de replicación que usa el clúster de la base de datos secundaria con todas las instancias en espera de alta disponibilidad. Esta configuración ayuda a que la nueva instancia principal de alta disponibilidad conserve los archivos de registro de escritura anticipada (WAL) que el clúster de base de datos secundario aún no haya consumido después de una conmutación por error o un cambio, lo que permite que el clúster de base de datos secundario reanude la replicación sin interrupciones.Para habilitar la replicación en tu clúster de base de datos principal, aplica un manifiesto similar al siguiente a tu clúster de Kubernetes en el centro de datos principal:
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-DB_CLUSTER_NAME namespace: DB_CLUSTER_NAMESPACE type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: REPLICATION_NAME namespace: DB_CLUSTER_NAMESPACE spec: dbcluster: name: DB_CLUSTER_NAME upstream: password: name: ha-rep-pw-DB_CLUSTER_NAME logReplicationSlot: true
Reemplaza lo siguiente:
DB_CLUSTER_NAME: Es el nombre del clúster de base de datos, por ejemplo,dbc-1.ENCODED_PASSWORD: Es la contraseña del usuario de la base de datos que se usará para la replicación desde bases de datos secundarias, codificada como una cadena base64 (por ejemplo,Q2hhbmdlTWUxMjM= for ChangeMe123). El valor predeterminado esalloydbreplica.REPLICATION_NAME: Es el nombre de la replicación, por ejemplo,replication-1.LOG_REPLICATION_SLOT: Registra los datos de la ranura de replicación en los archivos WAL. Para habilitar esta opción, establece su valor entrue. El valor predeterminado esfalse.
Te recomendamos que habilites la opción
logReplicationSlotcon un clúster de base de datos principal que tenga habilitada la alta disponibilidad (HA) para asegurarte de que la replicación pueda seguir funcionando después de una conmutación por error o un cambio.Espera a que el estado de replicación esté listo.
Para obtener la información de conexión ascendente que se usa para configurar la replicación en el clúster de base de datos secundario, ejecuta el siguiente comando:
kubectl get replication REPLICATION_NAME kubectl get replication REPLICATION_NAME -o json | jq .status.upstream
El resultado de ejemplo es similar al siguiente:
{ "host": "35.230.32.36", "password": { "name": "ha-rep-pw-dbc-1" }, "port": 5432, "replicationSlotName": "dbc_1_replication_1", "username": "alloydbreplica" }- Toma nota del resultado, ya que lo necesitarás para habilitar la replicación en el clúster de la base de datos secundaria en el siguiente paso.
- Crea un clúster de AlloyDB Omni en tu clúster de Kubernetes en el centro de datos secundario con una configuración idéntica a la de tu clúster de base de datos principal.
- Verifica que la conectividad externa esté habilitada en tu clúster de base de datos secundario de AlloyDB Omni
Si la conectividad externa no está habilitada, agrega lo siguiente a la sección de especificaciones de su manifiesto:
... spec: ... allowExternalIncomingTraffic: true
- Para habilitar la replicación en tu clúster de base de datos secundario, aplica un manifiesto similar al siguiente a tu clúster de Kubernetes en el centro de datos secundario:
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME namespace: SECONDARY_DB_CLUSTER_NAMESPACE type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: SECONDARY_REPLICATION_NAME namespace: SECONDARY_DB_CLUSTER_NAMESPACE spec: dbcluster: name: SECONDARY_DB_CLUSTER_NAME downstream: host: PRIMARY_HOST port: PRIMARY_PORT username: alloydbreplica password: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME replicationSlotName: PRIMARY_REPLICATION_SLOT control: setup
Reemplaza lo siguiente:
SECONDARY_DB_CLUSTER_NAME: Es el nombre del clúster de base de datos secundario, por ejemplo,dbc-2.ENCODED_PASSWORD: Es la contraseña del usuario de la base de datos que se usará para la replicación desde el clúster de la base de datos principal, codificada como una cadena base64 (por ejemplo,Q2hhbmdlTWUxMjM= for ChangeMe123). El valor predeterminado esalloydbreplica.SECONDARY_REPLICATION_NAME: Es el nombre de la replicación, por ejemplo, "replication-2".PRIMARY_HOST: Es el extremo de conexión del clúster de base de datos principal del resultado del paso 4 al que puede acceder la base de datos secundaria para la replicación.PRIMARY_PORT: Es el puerto de conexión del clúster de la base de datos principal del resultado del paso 4 al que puede acceder la base de datos secundaria para la replicación.PRIMARY_REPLICATION_SLOT: Es el nombre de la ranura de replicación en el clúster de la base de datos principal del resultado del paso 4 que la base de datos secundaria puede usar para la replicación.
Visualiza la replicación en el clúster de base de datos secundario
Para ver información detallada sobre un clúster de base de datos secundario de AlloyDB Omni y su estado de replicación, ejecuta los siguientes comandos:
kubectl get dbcluster SECONDARY_DB_CLUSTER_NAME kubectl get replication SECONDARY_REPLICATION_NAME
Cuando el clúster de la base de datos secundaria se configura correctamente y tiene replicación de transmisión desde el clúster de la base de datos principal, el estado de la replicación es listo y en buen estado.
Asciende un clúster de base de datos secundario
Cuando asciendes un clúster de base de datos secundario, primero debes verificar que este haya aplicado todas las transacciones recibidas del clúster de base de datos principal.
- Verifica que el estado de replicación del clúster de base de datos secundario esté
listo y en buen estado:
kubectl get replication SECONDARY_REPLICATION_NAME
- Detén todas las operaciones de escritura en el clúster de la base de datos principal. Ejecuta un punto de control en el clúster de base de datos principal y, luego, ejecuta la siguiente consulta en el clúster de base de datos principal para verificar el retraso de replicación de la base de datos secundaria. Confirma que el resultado muestre un retraso mínimo.
-
Ejecuta un punto de control para vaciar la memoria en el disco.
psql -h PRIMARY_HOST -U postgres -d postgres -c 'CHECKPOINT;'
- Verifica el retraso de replicación. Un valor de rezago de
0es óptimo. Si el retraso es superior a0, puedes ascender el clúster de base de datos secundario. Sin embargo, existe el riesgo de perder las transacciones recientes que ya se confirmaron en el clúster de la base de datos principal.
psql -h PRIMARY_HOST -U postgres -d postgres -c 'SELECT application_name, pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS replay_lag FROM pg_stat_replication;'
-
Ejecuta un punto de control para vaciar la memoria en el disco.
-
Asciende un clúster de base de datos secundario a un clúster de base de datos principal. Para ello, actualiza el campo
controldel manifiesto de replicación del clúster de base de datos secundario apromote. Luego, aplica el manifiesto de replicación actualizado en tu clúster de Kubernetes en el centro de datos secundario.apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME namespace: SECONDARY_DB_CLUSTER_NAMESPACE type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: SECONDARY_REPLICATION_NAME namespace: SECONDARY_DB_CLUSTER_NAMESPACE spec: dbcluster: name: SECONDARY_DB_CLUSTER_NAME downstream: host: PRIMARY_HOST port: PRIMARY_PORT username: alloydbreplica password: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME replicationSlotName: PRIMARY_REPLICATION_SLOT control: promote
Realiza un cambio
Antes de realizar un cambio, verifica que los clústeres de bases de datos principal y secundario en ambos centros de datos estén en línea y en buen estado.
Para mantener la coherencia de los datos entre tus clústeres de bases de datos principal y secundario, y realizar un cambio, sigue estos pasos:
- Verifica que el estado de replicación del clúster de base de datos secundario esté
listo y en buen estado:
kubectl get replication SECONDARY_REPLICATION_NAME
- Detén todas las operaciones de escritura en el clúster de base de datos principal y, luego, haz lo siguiente
en ese clúster:
-
Ejecuta un punto de control para vaciar la memoria en el disco:
psql -h PRIMARY_HOST -U postgres -d postgres -c 'CHECKPOINT;'
-
Verifica el retraso de replicación del clúster de la base de datos secundaria y confirma
que el resultado muestre un valor de retraso de
0:psql -h PRIMARY_HOST -U postgres -d postgres -c 'SELECT application_name, pg_wal_lsn_diff(pg_current_wal_lsn(), replay_lsn) AS replay_lag FROM pg_stat_replication;'
-
Ejecuta un punto de control para vaciar la memoria en el disco:
-
Para ascender el clúster de base de datos secundario a un clúster de base de datos principal y convertir el clúster de base de datos principal anterior en un clúster de base de datos secundario, sigue estos pasos:
-
Para convertir tu clúster de base de datos secundario de AlloyDB Omni en un clúster de base de datos principal, actualiza su manifiesto de replicación en tu clúster de Kubernetes en el centro de datos secundario de la siguiente manera:
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME namespace: SECONDARY_DB_CLUSTER_NAMESPACE type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: SECONDARY_REPLICATION_NAME namespace: SECONDARY_DB_CLUSTER_NAMESPACE spec: dbcluster: name: SECONDARY_DB_CLUSTER_NAME upstream: password: name: ha-rep-pw-SECONDARY_DB_CLUSTER_NAME
Reemplaza
SECONDARY_DB_CLUSTER_NAMEpor el nombre de tu clúster de base de datos secundario, por ejemplo,dbc-2.Espera a que el estado de replicación esté listo.
Para obtener la información de conexión ascendente para la replicación, ejecuta el siguiente comando:
kubectl get replication SECONDARY_REPLICATION_NAME kubectl get replication SECONDARY_REPLICATION_NAME -o json | jq .status.upstream
El resultado de ejemplo es similar al siguiente:
{ "host": "34.23.207.137", "password": { "name": "ha-rep-pw-dbc-2" }, "port": 5432, "replicationSlotName": "dbc_2_replication_2", "username": "alloydbreplica" }-
Para convertir tu clúster de base de datos principal de AlloyDB Omni en un clúster de base de datos secundario, actualiza su manifiesto de replicación en tu clúster de Kubernetes en el centro de datos principal:
apiVersion: v1 kind: Secret metadata: name: ha-rep-pw-DB_CLUSTER_NAME namespace: DB_CLUSTER_NAMESPACE type: Opaque data: rep-user-pw: "ENCODED_PASSWORD" --- apiVersion: alloydbomni.dbadmin.goog/v1 kind: Replication metadata: name: REPLICATION_NAME namespace: DB_CLUSTER_NAMESPACE spec: dbcluster: name: DB_CLUSTER_NAME downstream: host: SECONDARY_HOST port: SECONDARY_PORT username: alloydbreplica password: name: ha-rep-pw-DB_CLUSTER_NAME replicationSlotName: SECONDARY_REPLICATION_SLOT control: rewind
Espera a que el estado de replicación sea listo y correcto.
Verifica el estado de la replicación:
kubectl get replication REPLICATION_NAME
-
Realiza una recuperación ante desastres no planificada
Si tu centro de datos principal o clúster de base de datos principal deja de estar disponible de forma inesperada, puedes realizar una conmutación por error de recuperación ante desastres no planificada. Para ello, asciende el clúster de base de datos secundario y, luego, vuelve a configurar el clúster de base de datos principal anterior después de que vuelva a estar en línea:
- Ascender tu clúster de base de datos secundario de AlloyDB Omni a un clúster de base de datos principal Actualiza el manifiesto de replicación del clúster de la base de datos secundaria en tu clúster de Kubernetes en el centro de datos secundario, como se describe en el paso 3a de Realiza un cambio.
- Después de que el centro de datos principal original esté disponible, convierte el
clúster de base de datos principal anterior en un clúster de base de datos secundario que
se replique desde el nuevo principal. Sigue los pasos 3b, 3c y 3d en
Realiza un cambio, con un cambio en
el paso 3c. En el paso 3c, configura
control: setupen lugar decontrol: rewindpara reinicializar el clúster desde la nueva instancia principal. No usescontrol: rewindporque el clúster de base de datos principal anterior podría contener cambios que no se sincronizaron antes de la conmutación por error.