Cómo trabajar con la replicación entre regiones

Selecciona una versión de la documentación:

En esta página, se describe cómo usar la replicación entre regiones creando clústeres secundarios y trabajando con ellos.

Para obtener una descripción general conceptual de la replicación entre regiones, consulta Acerca de la replicación entre regiones.

Antes de comenzar

  • El proyecto Google Cloud que usas debe estar habilitado para acceder a AlloyDB Omni.
  • Debes tener uno de estos roles de IAM en el proyecto Google Cloud que estás usando:
    • roles/alloydb.admin (el rol de IAM predefinido de administrador de AlloyDB)
    • roles/owner (el rol de IAM básico 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 tu organización para solicitar acceso.

Crear 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 recuperación de un momento determinado (PITR) y la configuración de copias 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 disponible en el clúster principal.

Para crear un clúster secundario y una instancia secundaria de AlloyDB, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página Clústeres.

    Ir a los clústeres

  2. Haz clic en un clúster en la columna Nombre del recurso.

  3. En la página Descripción general, haz clic en Crear clúster secundario.

  4. Configura tu clúster secundario:

    1. En el campo ID del clúster, ingresa un ID de recurso para tu clúster secundario.
    2. Selecciona una región para tu clúster secundario que sea diferente de la región del clúster principal.
    3. Selecciona la encriptación predeterminada administrada por Google o una clave administrada por el cliente (CMEK) como método de encriptación para encriptar tu clúster secundario.

    Si deseas encriptar este clúster con una clave de CMEK, sigue estos pasos:

    1. Haz clic en Opciones avanzadas de encriptación.
    2. Selecciona Clave de encriptación administrada por el cliente (CMEK).

    3. Selecciona una clave administrada por el cliente en el menú que aparece.

      La consola de Google Cloud limita esta lista a las claves que se encuentran dentro del mismo proyecto y región deGoogle Cloud que el clúster nuevo.

      Para usar una llave que no está en esta lista, sigue estos pasos:

      1. Haz clic en ¿No ves tu llave? Ingresa el nombre del recurso de la clave.
      2. Ingresa el nombre del recurso en el campo Nombre del recurso de la clave.
      3. Haz clic en Guardar.
      4. Haz clic en Continuar.

    El uso de una clave de CMEK con AlloyDB requiere cierta configuración adicional. Para obtener más información, consulta Usa CMEK.

    Si la instancia principal asociada está encriptada con una clave de CMEK, también debes encriptar su clúster secundario con una clave de CMEK.

  5. Configura tu instancia secundaria:

    1. En el campo ID de instancia, ingresa un ID de recurso para tu instancia secundaria. El ID del recurso debe ser único dentro de un clúster.

  6. Haga clic en Crear clúster.

gcloud

Para usar gcloud CLI, puedes instalar y, luego, inicializar Google Cloud CLI, o bien 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_ID \
 gcloud 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.
  • 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 secundario.
  • LOCATION_ID: Es la ubicación de tu clúster principal, por ejemplo, us-central1.
  • PRIMARY_CLUSTER_ID: Es el ID del clúster principal con el que se asocia el clúster secundario.
  • SECONDARY_CLUSTER_ID: Es el ID del clúster secundario con el que se asocia la instancia secundaria.
  • ALLOWED_PROJECT (opcional): Es la lista separada por comas de los IDs o números de proyectos a los que deseas permitir el acceso a la instancia (por ejemplo, my-project-1, 12345, my-project-n). Debes establecer una lista de proyectos o números permitidos si tu clúster usa Private Service Connect como método de conexión a la instancia.

Para crear un clúster secundario y una instancia habilitados para Private Service Connect, agrega la marca --enable-private-service-connect cuando crees un clúster y agrega la marca --allowed-psc-projects para establecer una lista separada por comas de los IDs de proyectos o los números de proyectos a los que deseas permitir el acceso a la instancia (por ejemplo, my-project-1, 12345,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_ID \
 --enable-private-service-connect
 gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
 --cluster=SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --allowed-psc-projects=ALLOWED_PROJECT_LIST

Reemplaza lo siguiente:

  • ALLOWED_PROJECT (opcional): Es la lista separada por comas de los IDs o números de proyectos a los que deseas permitir el acceso a la instancia,por ejemplo, my-project-1,12345, my-project-n. Debes establecer una lista de proyectos o números permitidos si tu clúster usa Private Service Connect como método de conexión a la instancia.

Cómo ver un clúster secundario

Para ver información detallada sobre un clúster secundario de AlloyDB, sigue estos pasos:

  1. En la consola de Google Cloud , ve a la página Clústeres.

    Ir a los clústeres

  2. Haz clic en un clúster secundario en la columna Nombre del recurso.

  3. En la página Descripción general, consulta todos los detalles sobre tu clúster secundario.

Actualiza una instancia secundaria

Puedes actualizar una instancia secundaria para agregar, modificar o borrar marcas de bases 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 bases de datos, completa los siguientes pasos:

Console

  1. En la consola de Google Cloud , ve a la página Clústeres.

    Ir a los clústeres

  2. En la columna Nombre del recurso, haz clic en un clúster secundario que desees modificar.

  3. En la página Overview, ve a Instances in your cluster, selecciona la instancia secundaria y, luego, haz clic en Edit secondary.

  4. Sigue estos pasos para agregar, modificar o borrar una marca de base de datos de tu instancia:

    Cómo agregar una marca

    1. Para agregar una marca de base de datos a tu instancia, haz clic en Agregar marca.
    2. Selecciona una marca de la lista New database flag.
    3. Proporciona un valor para la marca.
    4. Haz clic en Listo.

    Cómo modificar una marca

    1. Para modificar una marca de base de datos presente en tu instancia, expande la marca de base de datos y modifica el valor de la marca existente en la sección Editar marca de base de datos.
    2. Haz clic en Listo.

    Cómo borrar una marca

    1. Para borrar una marca de base de datos de tu instancia, selecciona una marca y haz clic en el ícono de borrar.
    2. Haz clic en Listo.

  5. Haz clic en Actualizar secundaria.

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_ID

Reemplaza 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 bases de datos. Cada especificación consta del nombre de la marca, un signo igual (=) y el valor que se asignará a las marcas. En el caso de las marcas de bases 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.

Cómo escalar el tipo de máquina de tu instancia secundaria

Para ajustar el tipo de máquina de tu instancia secundaria, completa los siguientes pasos:

Console

  1. En la consola de Google Cloud , ve a la página Clústeres.

    Ir a los clústeres

  2. En la columna Nombre del recurso, haz clic en un clúster secundario que desees modificar.

  3. En la página Descripción general, ve a la sección Instancias en tu clúster y haz clic en Editar secundaria.

    Ten en cuenta que esta acción no está disponible si la página informa un Estado del clúster de Mantenimiento. La acción volverá a estar disponible después de que el Estado cambie a Listo.

  4. Selecciona un tipo de máquina.

  5. Haz clic en Actualizar secundaria.

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_ID

Reemplaza lo siguiente:

  • SECONDARY_INSTANCE_ID: ID de la instancia secundaria que actualizas.

  • CPU_COUNT: Es la cantidad de CPU virtuales que deseas para la instancia. Estos son algunos de los valores válidos:

    • 2 (2 CPU virtuales, 16 GB de RAM)
    • 4 (4 CPUs virtuales, 32 GB de RAM)
    • 8 (8 CPUs 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)

  • 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 coloca el clúster.

Si el comando devuelve un mensaje de error que incluye la frase invalid cluster state MAINTENANCE, significa que el clúster está en mantenimiento de rutina. Esto inhabilita temporalmente la reconfiguración de la instancia. Vuelve a ejecutar el comando después de que el clúster vuelva a un estado READY.

Para verificar el estado del clúster, consulta Cómo ver los detalles del clúster.

Agrega instancias del grupo de lectura a un clúster secundario

Para agregar una instancia de grupo de lectura a un clúster secundario, sigue estos pasos:

  1. En la consola de Google Cloud , ve a la página Clústeres.

    Ir a los clústeres

  2. En la columna Nombre del recurso, haz clic en un clúster secundario al que deseas agregar una instancia de grupo de lectura.

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

  4. Configura tu instancia de grupo de lectura:

    1. En el campo ID de instancia de grupo de lectura, ingresa un ID para la instancia de grupo de lectura.
    2. En el campo Cantidad de nodos, ingresa una cantidad de nodos. 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 del grupo de lectura de un clúster.
    3. Selecciona un tipo de máquina.

    4. Opcional: Establece marcas personalizadas en tu instancia. Para cada marca, haz lo siguiente:

      1. Haz clic en Agregar marca.
      2. Selecciona una marca de la lista New database flag.
      3. Proporciona un valor para la marca.
      4. Haz clic en Listo.

  5. Haz clic en Agregar grupo de lectura.

Cómo ascender un clúster secundario

Antes de promover un clúster secundario, realiza los siguientes pasos para verificar que el clúster secundario haya aplicado todas las transacciones recibidas del clúster principal:

  1. Detén todas las operaciones de escritura en el clúster principal.

  2. Para verificar el estado de replicación del clúster secundario, completa los siguientes pasos:

    1. En la consola de Google Cloud , ve a la página Clústeres.

      Ir a los clústeres

    2. En la lista de clústeres, haz clic en el nombre del clúster secundario que deseas promover.

    3. En la página de detalles del clúster, haz clic en Monitoring.

    4. En la lista Monitoring, selecciona la instancia secundaria. Aparece en la lista como Secundaria: INSTANCE_NAME.

    5. En la lista de métricas, busca el gráfico Retraso de la replicación desde la instancia principal.

    6. Confirma que el gráfico muestre un rezago mínimo.

      Un valor de rezago de 0 es ideal. Si el retraso es mayor que 0, aún puedes promover el clúster secundario, con el riesgo de perder algunas transacciones recientes que ya se confirmaron en el clúster principal.

    7. En la lista de métricas, busca el gráfico Estado de replicación.

    8. Confirma que todos los nodos representados en el gráfico tengan un valor de streaming.

Para promover un clúster secundario a clúster principal, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página Clústeres.

    Ir a los clústeres

  2. En la columna Nombre del recurso, haz clic en un clúster secundario que desees promover como clúster principal.

  3. En la página Descripción general, haz clic en Promote cluster.

  4. En el diálogo que aparece, ingresa el ID del clúster secundario para confirmar que deseas promover el clúster.

  5. Haz clic en Ascender.

    Después de promover el clúster, el campo Tipo: Clúster secundario (con alta disponibilidad) de la página Descripción general se actualizará a Tipo: Con alta disponibilidad y grupos de lectura.

gcloud

Usa el comando gcloud alloydb clusters promote:

 gcloud alloydb clusters promote SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --project=PROJECT_ID \

Reemplaza lo siguiente:

  • SECONDARY_CLUSTER_ID: ID del clúster secundario que deseas promover.
  • 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 secundario.

Realiza un cambio

Antes de realizar una conmutación, verifica que ambas regiones a las que pertenecen las instancias principal y secundaria estén en línea y que las instancias estén en buen estado. Para obtener más información, consulta Supervisa una instancia con el panel de Estadísticas del sistema de AlloyDB.

Usa el comando gcloud alloydb clusters switchover:

   gcloud alloydb clusters switchover SECONDARY_CLUSTER_ID \
   --region=REGION_ID \
   --project=PROJECT_ID \

Reemplaza lo siguiente:

  • SECONDARY_CLUSTER_ID: Es el ID del clúster secundario que deseas promover.
  • 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 secundario.

Pasos siguientes