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

En esta página, se describe cómo crear una instancia de grupo de lectura en un clúster de AlloyDB para PostgreSQL.

Antes de comenzar

  • El Google Cloud proyecto que usas debe haber sido habilitado para acceder a AlloyDB.
  • Debes tener uno de estos roles de IAM en el Google Cloud proyecto que usas:
    • 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 de IAM básico de editor)

    Si no tienes ninguno de estos roles, comunícate con el administrador de tu organización para solicitar acceso.

Crear una instancia de grupo de lectura

Console

  1. En la Google Cloud consola de, 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 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.

    3. Selecciona una de las siguientes series de máquinas:

      • C4A (serie de máquinas basadas en Google Axion)
      • N2 (serie de máquinas basadas en x86). Esta es la serie de máquinas predeterminada.
      • C4 (serie de máquinas basadas en x86)
      • Z3 (serie de máquinas basadas en Intel Xeon)

    4. Elige un tipo de máquina.

      • C4A admite 1, 2, 4, 8, 16, 32, 48, 64 y 72 CPU virtuales.
      • N2 admite 2, 4, 8, 16, 32, 64, 96 y 128 CPU virtuales.
      • C4 admite 4, 8, 16, 24, 32, 48, 96, 144, 192 y 288 tipos o formas de máquinas.
      • Z3 admite 8, 14, 16, 22, 32, 44 y 88 CPU 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 de 1 CPU virtual, consulta Consideraciones cuando se usa la serie de máquinas C4A basadas en Axion.

      1. Opcional: Para conectar tus aplicaciones y clientes a través de Internet pública, haz clic en Habilitar IP pública en Conectividad de IP pública. Habilitar la IP pública puede requerir configuración adicional para asegurarte de tener una conexión segura. 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.

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

      1. Elige la configuración de seguridad de red. Para proteger tus datos, te recomendamos que uses la encriptación de mTLS con conectores de AlloyDB o la encriptación de SSL.

      Cuando cambias la configuración de seguridad, tu instancia está disponible para su uso, pero las conexiones existentes que no cumplen con los requisitos se descartan.

    6. Opcional: Establece marcas personalizadas en tu instancia. Para cada marca, 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 y, luego, inicializar Google Cloud CLI o usar Cloud Shell.

Usa el gcloud alloydb instances create comando 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 de tu 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 CPU 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 CPU virtuales, 512 GB de RAM
      • 96: 96 CPU virtuales, 768 GB de RAM
      • 128: 128 CPU virtuales, 864 GB de RAM
    • Si se proporcionan machine_type y cpu_count, el valor 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: Selecciona de una lista de tipos de máquinas compatibles, como n2-highmem-4, c4-highmem-4-lssd o c4a-highmem-4-lssd. Para obtener más información, 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](/resource-manager/docs/creating-managing-projects#identifying_projects 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 (opcional): Es la 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. 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 habilitar la agrupación de conexiones administradas en tu instancia de grupo de lectura, agrega la --enable-connection-pooling marca al gcloud alloydb instances create comando:

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 --assign-inbound-public-ip=ASSIGN_IPV4 parámetro.

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 establecer redes externas autorizadas en tu instancia.

¿Qué sigue?