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 de Google Cloud que usas debe estar habilitado para acceder a AlloyDB.
  • Debes tener uno de estos roles de IAM en el proyecto de Google Cloud 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 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 del 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 Axion de Google) (versión preliminar)
      • N2 (serie de máquinas basada 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 basadas en Axion C4A, incluido el tipo de máquina con 1 vCPU, consulta Consideraciones para usar la serie de máquinas basadas en Axion C4A.

      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 una configuración adicional para garantizar una conexión segura. Para obtener más información, consulta Cómo conectarse con una IP pública.

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

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

      2. Elige la configuración de seguridad de la 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 se descartan las conexiones existentes que no cumplen con los requisitos.

    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 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 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 la opción predeterminada. Los valores válidos incluyen lo siguiente:

    • 2: 2 CPU virtuales, 16 GB de RAM
    • 4: 4 vCPU, 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

  • MACHINE_TYPE: Este parámetro es opcional cuando implementas máquinas N2. Para implementar la serie de máquinas basada en Axion de 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, se muestra 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 vCPU y versiones posteriores, 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 basadas en Axion C4A, incluido el tipo de máquina con 1 vCPU, consulta Consideraciones para usar la serie de máquinas basadas en Axion C4A.

    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 entre 1 y 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 que se coloque la instancia.

  • PROJECT_ID: Es el ID del proyecto en el que se encuentra 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 IDs de proyecto o [números de proyecto](/resource-manager/docs/creating-managing-projects#identifying_projects 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 \
            --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 configurar una lista de proyectos o números permitidos si tu clúster usa Private Service Connect como método para conectarse a la instancia.

Para habilitar el grupo de conexiones administrado 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 de bloques CIDR separados por comas, como 64.233.160.0/16, al parámetro --authorized-external-networks para establecer redes externas autorizadas en tu instancia.

¿Qué sigue?