Crea una instancia de grupo de lectura en un clúster

Las instancias de grupo de lectura en un clúster de AlloyDB para PostgreSQL te permiten escalar la capacidad de lectura y descargar las cargas de trabajo de consultas de solo lectura de tu instancia principal. Puedes crear una instancia de grupo de lectura con la consola de Google Cloud o Google Cloud CLI.

Una instancia de grupo de lectura puede usar una serie de máquinas y un tipo de máquina diferentes de los de la instancia principal. Todos los nodos dentro de una sola instancia de grupo de lectura usan la misma serie de máquinas y el mismo tipo de máquina. Para atender el tráfico de lectura en varias series de máquinas o diferentes tipos de máquinas al mismo tiempo, implementa instancias de grupos de lectura independientes para cada configuración. Para obtener más información sobre las series de máquinas compatibles, consulta Elige un tipo de máquina de AlloyDB.

De manera opcional, puedes habilitar el reenvío transparente de consultas para optimizar el uso de recursos enrutando automáticamente el tráfico de solo lectura.

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.

Crear una instancia de grupo de lectura

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. 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 Recuento de nodos, ingresa un recuento de nodos.

      La cantidad de nodos en una instancia de grupo de lectura determina la capacidad de procesamiento general de la instancia.

      Nota: Puedes tener un máximo de 20 nodos en todas las instancias del grupo de lectura de un clúster.

   3. Selecciona una de las siguientes series de máquinas para la instancia de grupo de lectura, que puede diferir de la serie de máquinas de tu instancia principal:

      • C4A (serie de máquinas basadas en Google Axion)

      • N2 (serie de máquinas basadas en x86) Esta serie de máquinas es la predeterminada.

      • C4 (serie de máquinas basadas en x86)

      • Z3 (serie de máquinas basadas en Intel Xeon)

   4. Selecciona un tipo de máquina. Todos los nodos de la instancia del grupo de lectura usan la serie de máquinas y el tipo de máquina que selecciones. Los recuentos de CPU virtuales compatibles dependen de la serie de máquinas:

      • C4A admite 1, 2, 4, 8, 16, 32, 48, 64 y 72 CPUs virtuales.

      • N2 admite 2, 4, 8, 16, 32, 64, 96 y 128 CPUs virtuales.

      • C4 admite 4, 8, 16, 24, 32, 48, 96, 144, 192 y 288 CPUs virtuales.

      • Z3 admite 8, 14, 16, 22, 32, 44 y 88 CPUs virtuales.

      Para obtener más información sobre el uso de la serie de máquinas C4A basadas en Axion, incluido el tipo de máquina con 1 CPU virtual, consulta Consideraciones cuando se usa la serie de máquinas C4A basadas en Axion.

   5. Opcional: Para conectar tus aplicaciones y clientes a través de la Internet pública, haz clic en Habilitar IP pública en Conectividad de IP pública. Habilitar la IP pública puede requerir una configuración adicional para proteger la conexión. Para obtener más información, consulta Conéctate con una IP pública.

      De forma predeterminada, la IP privada siempre está habilitada. Para obtener más información, consulta Habilita el acceso privado a servicios.

   6. Opcional: Para habilitar la agrupación de conexiones administradas, selecciona Habilitar el grupo de conexiones administradas en Grupo de conexiones administradas. Para obtener más información, consulta Configura la agrupación de conexiones administradas.

   7. Elige la configuración de seguridad de la red. Para proteger tus datos, usa la encriptación de mTLS con conectores de AlloyDB o la encriptación de SSL.

      Cuando cambias la configuración de seguridad, la instancia sigue disponible para su uso, pero AlloyDB descarta las conexiones existentes que no cumplen con los requisitos.

   8. Opcional: Establece marcas personalizadas en tu instancia. Para cada parámetro, sigue estos pasos:

      1. Haz clic en Advanced Configuration Options.
      2. Haz clic en Agregar una marca de base de datos.
      3. Selecciona una marca de la lista Nueva marca de base de datos.
      4. Proporciona un valor para la marca.
      5. Haz clic en Listo.

5. Haz clic en Agregar grupo de lectura.

gcloud

Para usar gcloud CLI, puedes instalar e inicializar Google Cloud CLI, o bien puedes usar Cloud Shell.

Usa el comando gcloud alloydb instances create para crear una instancia de grupo de lectura.

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --read-pool-node-count=NODE_COUNT \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID

Reemplaza lo siguiente:

• INSTANCE_ID: Es el ID de la instancia que estás creando. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.

• NODE_COUNT: Es la cantidad de nodos en la instancia. Especifica un número del 1 al 20, inclusive. Ten en cuenta que no puedes tener más de 20 nodos en todas las instancias de grupo de lectura de un clúster.

• REGION_ID: Es la región del clúster existente en la que deseas crear la instancia de grupo de lectura.

• CLUSTER_ID: Es el ID de tu clúster existente, en el que deseas crear la instancia de grupo de lectura.

• CPU_COUNT: Es la cantidad de CPUs virtuales que deseas para la instancia.

  • Debes especificar cpu_count o machine_type.
  • Si solo se proporciona cpu_count, se crea una instancia N2 con las siguientes especificaciones:
    • 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 CPUs virtuales, 512 GB de RAM
    • 96: 96 CPUs virtuales, 768 GB de RAM
    • 128: 128 CPU virtuales, 864 GB de RAM
  • Si se proporcionan machine_type y cpu_count, el valor de cpu_count debe alinearse con la cantidad de CPU virtuales especificadas en machine_type. Por ejemplo, si machine_type es n2-highmem-4, debes establecer cpu_count en 4.

• MACHINE_TYPE: Es un tipo de máquina compatible para la instancia del grupo de lectura, como n2-highmem-4, c4-highmem-4-lssd, c4a-highmem-4-lssd o z3-highmem-14-standardlssd. La instancia del grupo de lectura puede usar una serie de máquinas y un tipo de máquina diferentes de los de la instancia principal, y todos los nodos de la instancia del grupo de lectura usan este tipo de máquina. Para obtener más información sobre los tipos de máquinas compatibles, consulta Elige un tipo de máquina de AlloyDB.

• PROJECT_ID: Es el ID del proyecto en el que se encuentra tu clúster existente.

Para crear una instancia de grupo de lectura para un clúster habilitado para Private Service Connect, agrega la marca --allowed-psc-projects para establecer una lista separada por comas de IDs de proyectos o 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 instances create INSTANCE_ID \
   --instance-type=READ_POOL \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --cpu-count=CPU_COUNT \
   --machine-type=MACHINE_TYPE \
   --project=PROJECT_ID \
   --allowed-psc-projects=ALLOWED_PROJECT_LIST

Reemplaza lo siguiente:

• ALLOWED_PROJECT_LIST (opcional): Es la lista separada por comas de los ID de proyecto 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 el método para conectarse a la instancia.

Para habilitar la reducción de conexiones administradas en tu instancia de grupo de lectura, agrega la marca --enable-connection-pooling al comando gcloud alloydb instances create:

gcloud alloydb instances create INSTANCE_ID \
 --instance-type=READ_POOL \
 --region=REGION_ID \
 --cluster=CLUSTER_ID \
 --cpu-count=CPU_COUNT \
 --machine-type=MACHINE_TYPE \
 --project=PROJECT_ID \
 --enable-connection-pooling

Para crear una instancia de grupo de lectura para un clúster habilitado para IP pública, agrega el parámetro --assign-inbound-public-ip=ASSIGN_IPV4.

gcloud alloydb instances create INSTANCE_ID \
   --instance-type=READ_POOL \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --cpu-count=CPU_COUNT \
   --machine-type=MACHINE_TYPE \
   --project=PROJECT_ID \
   --assign-inbound-public-ip=ASSIGN_IPV4

De manera opcional, puedes pasar la lista separada por comas de bloques CIDR, como 64.233.160.0/16, al parámetro --authorized-external-networks para configurar redes externas autorizadas en tu instancia.

Nota: Para las instancias habilitadas para Private Service Connect, se requieren parámetros de configuración adicionales. Para obtener más información, consulta Conéctate a una instancia con Private Service Connect.

¿Qué sigue?

• Obtén información sobre las opciones para conectar tu instancia de grupo de lectura.
• Consulta los detalles de la instancia.
• Escala una instancia.
• Reinicia una instancia o nodos de grupo de lectura.
• Solucionar problemas de consultas de grupos de lectura.
• Obtén más información sobre las recomendaciones de dimensionamiento.