Crea una instancia de grupo de lectura replicada de forma asíncrona con el orquestador de RPM

Selecciona una versión de la documentación:

Para aumentar la capacidad de procesamiento de lectura y la disponibilidad de tu clúster de base de datos, puedes crear una instancia de grupo de lectura asíncrona. Una instancia de grupo de lectura proporciona un clon de solo lectura de tu instancia de base de datos, lo que garantiza el acceso a los datos incluso si tu instancia de base de datos deja de estar disponible.

Puedes definir la configuración de la instancia de grupo de lectura en el archivo de manifiesto de la instancia de base de datos. Cada instancia del grupo de lectura requiere la creación de un archivo de manifiesto único. Puedes implementar varias instancias de grupo de lectura, con un total de hasta 20 nodos de grupo de lectura por clúster de base de datos.

Cada instancia de grupo de lectura ocupa la misma cantidad de almacenamiento que la instancia que replica.

Crea una instancia de grupo de lectura replicada asíncrona

Para crear una instancia de grupo de lectura replicada asíncrona de AlloyDB Omni, completa los siguientes pasos:

  1. Crea el manifiesto de la instancia de base de datos para definir el tipo de instancia de grupo de lectura:

    DBInstance:
      metadata:
        name: READ_POOL_INSTANCE_NAME
      spec:
        instanceType: ReadPool
        nodeCount: READ_POOL_NODE_COUNT
        readPoolPort: READ_POOL_PORT
        dbcParent:
          name: DB_CLUSTER_NAME
    

    Reemplaza lo siguiente:

    • READ_POOL_INSTANCE_NAME: Es un nombre para este recurso, por ejemplo, read-pool-instance-1.

    • DB_CLUSTER_NAME: Es el nombre del clúster de la base de datos al que pertenece la instancia.

    • READ_POOL_NODE_COUNT: (Opcional) Es la cantidad de nodos en una instancia de grupo de lectura. Esto determina la capacidad de procesamiento general de la instancia. Puedes tener un máximo de 20 nodos de grupo de lectura en total por clúster de base de datos.

    • READ_POOL_PORT: (Opcional) Es el puerto del balanceador de cargas (VIP) para enrutar el tráfico de lectura a esta instancia de grupo de lectura. La configuración predeterminada es 5434.

  2. Aplica la especificación DBInstance.

    alloydbctl

    alloydbctl apply -d "DEPLOYMENT_SPECIFICATION_PATH" -r "DBINSTANCE_SPECIFICATION"

    Reemplaza las siguientes variables:

    • DEPLOYMENT_SPECIFICATION_PATH: Es la ruta de acceso a la especificación de implementación que creaste en Instala componentes de AlloyDB Omni.

    • DBINSTANCE_SPECIFICATION: Es la ruta de acceso al archivo de manifiesto DBInstance que creaste en el paso anterior.

    Ansible

    ansible-playbook DBINSTANCE_PLAYBOOK -i "DEPLOYMENT_SPECIFICATION_PATH" \
          -e resource_spec="DBINSTANCE_SPECIFICATION"

    Reemplaza las siguientes variables:

    • DBINSTANCE_PLAYBOOK: Es la ruta de acceso a la guía que creaste para tu especificación DBInstance.

    • DEPLOYMENT_SPECIFICATION_PATH: Es la ruta de acceso a la especificación de implementación que creaste en Instala componentes de AlloyDB Omni.

    • DBINSTANCE_SPECIFICATION: Es la ruta de acceso al archivo de manifiesto DBInstance que creaste en el paso anterior.

Verifica el estado de la instancia

Para verificar la disponibilidad de la instancia de grupo de lectura, obtén el estado del recurso DBInstance:

alloydbctl

alloydbctl get -d "DEPLOYMENT_SPECIFICATION_PATH" -t DBInstance -n "READ_POOL_INSTANCE_NAME" -o yaml

Reemplaza las siguientes variables:

  • DEPLOYMENT_SPECIFICATION_PATH: Es la ruta de acceso a la especificación de implementación que creaste en Instala componentes de AlloyDB Omni.

  • READ_POOL_INSTANCE_NAME: Es el nombre de la instancia de grupo de lectura que especificaste en el manifiesto.

Ansible

Ejecuta la guía google.alloydbomni_orchestrator.status. Para obtener más información, consulta Obtén el estado del clúster.

ansible-playbook STATUS_PLAYBOOK_PATH -i "DEPLOYMENT_SPECIFICATION_PATH" \
      -e resource_type="DBInstance" -e resource_name="READ_POOL_INSTANCE_NAME"

Reemplaza las siguientes variables:

  • STATUS_PLAYBOOK_PATH: Es la ruta de acceso a la guía que creaste para obtener el estado de tu clúster.

  • DEPLOYMENT_SPECIFICATION_PATH: Es la ruta de acceso a la especificación de implementación que creaste en Instala componentes de AlloyDB Omni.

  • READ_POOL_INSTANCE_NAME: Es el nombre de la instancia de grupo de lectura que especificaste en el manifiesto.

Verifica la sección .status.conditions de la respuesta para lo siguiente:

  • Si el estado de la condición Available es true, indica que la instancia de grupo de lectura puede atender consultas, pero es posible que no esté replicando datos de tu instancia de base de datos.
  • Si el estado de la condición Streaming es true, indica que la instancia de grupo de lectura está conectada a tu instancia de base de datos y transmite cambios de forma activa.

Cuando no se puede acceder a la instancia de base de datos, la instancia de grupo de lectura sigue atendiendo las consultas. En este caso, el estado de disponibilidad será true y el estado de transmisión será false.

Después de configurar la instancia de grupo de lectura, todas las inserciones, actualizaciones y eliminaciones de filas en tu instancia de base de datos principal se pueden leer en tu instancia de grupo de lectura.

Conéctate a la instancia de grupo de lectura

Después de que la instancia de grupo de lectura se vuelve Available, el balanceador de cargas configura automáticamente un frontend dedicado de solo lectura que enruta el tráfico a los nodos de grupo de lectura.

Para ver el extremo de conexión, consulta status.endpoints en el resultado de estado de DBInstance. El extremo de solo lectura, por ejemplo, VIP_IP:5434, distribuye las consultas entrantes de solo lectura en todos los nodos en buen estado del grupo de lectura.

Para conectarte a la instancia de grupo de lectura, usa la herramienta cliente psql con la dirección IP y el puerto del extremo:

psql -h VIP_IP -p READ_POOL_PORT -U postgres

Reemplaza lo siguiente:

  • VIP_IP: Es la dirección IP del extremo de solo lectura.
  • READ_POOL_PORT: Es el puerto del extremo de solo lectura.

Si intentas realizar operaciones de escritura en este extremo, las operaciones fallan de inmediato con un error que indica que no puedes ejecutar inserciones en una transacción de solo lectura.

Administra la instancia de grupo de lectura

El orquestador de RPM admite el ajuste de escala dinámico y el borrado de instancias de grupo de lectura sin tiempo de inactividad del clúster.

Escalar una instancia de grupo de lectura

Para agregar o quitar nodos de un grupo de lectura existente, actualiza el campo nodeCount en tu archivo de manifiesto DBInstance.

  1. Abre tu archivo de manifiesto DBInstance y modifica el valor nodeCount para reflejar la cantidad de nodos seleccionada.

  2. Aplica el manifiesto de actualización con tu método de implementación preferido, el comando alloydbctl apply o tu playbook de Ansible.

El orquestador de RPM aprovisiona o quita automáticamente los nodos de réplica de lectura, y el balanceador de cargas se actualiza de forma dinámica para enrutar el tráfico a los nodos disponibles en el grupo.

Borra una instancia de grupo de lectura

Para borrar una instancia de grupo de lectura, usa el comando alloydbctl delete:

alloydbctl delete -t DBInstance -n READ_POOL_INSTANCE_NAME

Reemplaza READ_POOL_INSTANCE_NAME por el nombre de la instancia de grupo de lectura que deseas borrar.

Cuando borras una instancia de grupo de lectura, el orquestador detiene el servicio de réplica de lectura y limpia los nodos. El balanceador de cargas quita automáticamente el enrutamiento sin causar interbloqueos de ascenso ni afectar el tráfico a tus instancias principales o en espera.