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

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 proyecto Google Cloud que usas debe estar habilitado para acceder a AlloyDB.
  • 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 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 Instances in your cluster y haz clic en Add read pool.

  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) (vista previa)
      • N2 (serie de máquinas basadas en x86) Esta es la serie de máquinas predeterminada.

    4. Selecciona un tipo de máquina.

      • C4A admite 1, 4, 8, 16, 32, 48, 64 y 72 tipos o formas de máquinas.
      • N2 admite 2, 4, 8, 16, 32, 64, 96 y 128 tipos o formas de máquinas.

      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 para usar 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 podría requerir una configuración adicional para garantizar 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 los servicios.

      1. Opcional: Para habilitar y usar la agrupación de conexiones administradas, marca la casilla Habilitar el grupo de conexiones administradas en Grupo de conexiones administradas. Para obtener más información, consulta Cómo configurar el agrupamiento de conexiones administrado.

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

    5. 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 New database flag.
      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 bien 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 \
    --cpu-count=CPU_COUNT \
    --machine-type=MACHINE_TYPE \
    --read-pool-node-count=NODE_COUNT \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --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.

  • CPU_COUNT: Es la cantidad de CPU virtuales de N2 que deseas para la instancia. N2 es el valor predeterminado. Los valores válidos incluyen lo siguiente:

    • 2: 2 CPU virtuales, 16 GB de RAM
    • 4: 4 CPU virtuales y 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 y 512 GB de RAM
    • 96: 96 CPU virtuales, 768 GB de RAM
    • 128: 128 CPU virtuales y 864 GB de RAM

  • MACHINE_TYPE: Este parámetro es opcional cuando implementas máquinas N2. Para implementar la serie de máquinas basadas en Axion C4A (versión preliminar) o migrar entre máquinas C4A y N2, elige este parámetro con los siguientes valores.

    Cuando usas MACHINE_TYPE y CPU_COUNT juntos, los valores de CPU_COUNT y MACHINE_TYPE deben coincidir. De lo contrario, recibirás un error.

    Para la serie de máquinas C4A basadas en Axion, elige el tipo de máquina con los siguientes valores:

    • c4a-highmem-1
    • c4a-highmem-4-lssd
    • c4a-highmem-8-lssd
    • c4a-highmem-16-lssd
    • c4a-highmem-32-lssd
    • c4a-highmem-48-lssd
    • c4a-highmem-64-lssd
    • c4a-highmem-72-lssd

    Para implementar C4A con 4 CPU virtuales o más, usa el sufijo lssd para habilitar la caché ultrarrápida.

    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 para usar la serie de máquinas C4A basadas en Axion.

    Para la serie de máquinas N2 basadas en x86, usa los siguientes valores:

    • N2-highmem-2
    • N2-highmem-4
    • N2-highmem-8
    • N2-highmem-16
    • N2-highmem-32
    • N2-highmem-64
    • N2-highmem-96
    • N2-highmem-128

  • 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 del grupo de lectura de un clúster.

  • REGION_ID: Es la región en la que deseas que se ubique la instancia.

  • CLUSTER_ID: Es el ID del clúster en el que deseas colocar la instancia.

  • PROJECT_ID: Es el ID del proyecto en el que se coloca el clúster.

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 los IDs de proyectos o [números de proyectos](/resource-manager/docs/creating-managing-projects#identifying_projects que deseas permitir que accedan a la instancia, por ejemplo, my-project-1, 12345,my-project-n.

gcloud alloydb instances create INSTANCE_ID \
            --instance-type=READ_POOL \
            --cpu-count=CPU_COUNT \
            --region=REGION_ID \
            --cluster=CLUSTER_ID \
            --project=PROJECT_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.

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

gcloud alpha alloydb instances create INSTANCE_ID \
  --instance-type=READ_POOL \
  --cpu-count=CPU_COUNT \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --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 \
            --cpu-count=CPU_COUNT \
            --region=REGION_ID \
            --cluster=CLUSTER_ID \
            --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.

¿Qué sigue?