Crear un clúster y su instancia principal

Consola

1. Ve a la página Clústeres.

   Ir a Clústeres

2. Haz clic en Crear clúster.

3. Elige una configuración de clúster. Para obtener más información sobre las diferencias entre las configuraciones de alta disponibilidad y las básicas, consulta el artículo Nodos e instancias.

   Si no sabes si tu nuevo clúster necesita instancias de grupo de lectura, elige una de las configuraciones sin grupos de lectura. Puedes añadir instancias de grupo de lectura al clúster más adelante, cuando sea necesario.

4. Haz clic en Continuar.

5. En la sección Configurar el clúster, en el campo ID del clúster, introduce un ID para el clúster.

6. En el campo Password (Contraseña), introduce una contraseña inicial para el nuevo clúster. AlloyDB asigna la contraseña proporcionada al usuario de base de datos postgres al crear el clúster.

7. En el campo Versión de la base de datos, seleccione la versión principal de PostgreSQL con la que quiere que sean compatibles los servidores de bases de datos del clúster.

8. Selecciona una región. Para las cargas de trabajo de desarrollo y de pruebas, considera el perfil de 1 vCPU (en vista previa), que está disponible en determinadas regiones. Para obtener más información, consulta Consideraciones al usar 1 vCPU.

9. Selecciona una ruta de red.

10. Opcional: Para aplicar un intervalo de direcciones IP específico a este clúster en lugar de permitir que AlloyDB elija un intervalo de direcciones IP, sigue estos pasos:

    1. Haz clic en Mostrar intervalo de direcciones IP asignado.

    2. En la lista Intervalo de direcciones IP asignado, seleccione un intervalo de direcciones IP.

    Para obtener más información sobre esta opción, consulta Crear un clúster con un intervalo de direcciones IP específico.

11. Opcional: Para cifrar este clúster con una clave de cifrado gestionada por el cliente (CMEK) en lugar del cifrado gestionado por Google, sigue estos pasos adicionales:

    1. Haz clic en Opciones avanzadas de cifrado.

    2. Selecciona Clave de cifrado gestionada por el cliente (CMEK).

    3. En el menú que aparece, selecciona una clave gestionada por el cliente.

       La consola Google Cloud limita esta lista a las claves del mismo Google Cloud proyecto y región que el nuevo clúster. Si quieres usar una llave que no aparece en esta lista, haz clic en ¿No ves tu llave? Introduce el nombre del recurso de la clave y, a continuación, escribe el nombre del recurso de la clave en el cuadro de diálogo que aparece.

       Ten en cuenta que, para usar CMEK con AlloyDB, debes hacer algunos ajustes. Para obtener más información, consulta Usar CMEK con AlloyDB.

    4. Haz clic en Continuar.

12. Configura la instancia principal:

    1. En el campo ID de instancia, introduce un ID para tu instancia principal.

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

    3. 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 basada en Axion C4A, incluido el tipo de máquina de 1 vCPU, consulta Consideraciones al usar la serie de máquinas basada en Axion C4A.

    4. Opcional: Define marcas personalizadas para tu instancia. Sigue estos pasos con cada marca:

       1. Haz clic en Añadir marca.
       2. En la lista New database flag (Nueva marca de base de datos), selecciona una marca.
       3. Indica un valor para la marca.
       4. Haz clic en Listo.

13. Si has elegido un tipo de clúster sin grupos de lectura, haz clic en Crear clúster.

gcloud

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

1. Para crear el clúster con el acceso a servicios privados o Private Service Connect habilitados, usa el comando gcloud alloydb clusters create.

   Acceso a servicios privados

   gcloud alloydb clusters create CLUSTER_ID \
       --database-version=POSTGRES_VERSION \
       --password=PASSWORD \
       --region=REGION_ID \
       --project=PROJECT_ID \
       --network=NETWORK

   Private Service Connect

   gcloud alloydb clusters create CLUSTER_ID \
       --database-version=POSTGRES_VERSION \
       --password=PASSWORD \
       --region=REGION_ID \
       --project=PROJECT_ID \
       --enable-private-service-connect 

   Haz los cambios siguientes:

   • CLUSTER_ID: el ID del clúster que vas a crear. Debe empezar por una letra minúscula y puede contener letras minúsculas, números y guiones.

   • VERSION: la versión principal de PostgreSQL con la que quieres que sean compatibles los servidores de bases de datos del clúster. Elige una de estas opciones:

     • 14, para que sea compatible con PostgreSQL 14

     • 15 para que sea compatible con PostgreSQL 15.

     • 16 para que sea compatible con PostgreSQL 16, que es la versión predeterminada de PostgreSQL compatible con AlloyDB.

     • 17, para la compatibilidad con PostgreSQL 17 (vista previa)

       Para obtener más información sobre las restricciones que se aplican al usar PostgreSQL 17 en vista previa, consulta Compatibilidad con la vista previa de PostgreSQL 17.

   • PASSWORD: la contraseña que se usará para el usuario postgres predeterminado.

   • NETWORK (Opcional): el nombre de la red VPC que has configurado para el acceso a servicios privados a AlloyDB. Si omite la marca --network, AlloyDB usará la red default.

   En el caso de una red de VPC compartida, se debe definir la ruta completa de la red de VPC. Por ejemplo, projects/cymbal-project/global/networks/shared-vpc-network.

   • --enable-private-service-connect (Opcional): se define para habilitar Private Service Connect como método de conectividad del clúster y sus instancias.

   • REGION_ID: la región en la que quieras colocar el clúster.

   • PROJECT_ID: el ID del proyecto en el que quieres colocar el clúster.

   Este comando inicia una operación de larga duración y devuelve un ID de operación.

2. Opcional: Para aplicar un intervalo de direcciones IP específico a este clúster en lugar de permitir que AlloyDB elija un intervalo de direcciones IP, proporciona el siguiente argumento:

   --allocated-ip-range-name=RANGE
   

   Sustituye RANGE por el nombre del intervalo de direcciones IP que quieras que use este clúster para acceder a los servicios privados.

   Para obtener más información sobre esta opción, consulta Crear un clúster con un intervalo de direcciones IP específico.

3. Opcional: Para cifrar este clúster con una clave de cifrado gestionada por el cliente (CMEK) en lugar del cifrado gestionado por Google predeterminado, proporciona los siguientes argumentos:

   --kms-key=KEY_ID \
   --kms-keyring=KEYRING_ID \
   --kms-location=LOCATION_ID \
   --kms-project=PROJECT_ID
   

   Haz los cambios siguientes:

   • KEY_ID: el ID de la clave CMEK que se va a usar.

   • KEYRING_ID: el ID del conjunto de claves de la clave.

   • LOCATION_ID: el ID de la región del conjunto de claves, que debe ser el mismo que el de la región del clúster.

   • PROJECT_ID: el ID del proyecto del conjunto de claves.

4. Confirma que la operación se ha realizado correctamente.

   gcloud alloydb operations describe OPERATION_ID \
       --region=REGION_ID \
       --project=PROJECT_ID

   Sustituye OPERATION_ID por el ID de operación que se ha devuelto en el paso anterior.

Después de crear el clúster principal, debes crear una instancia principal.

Crear una instancia principal

Para crear una instancia principal, usa el comando gcloud alloydb instances create.

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

Haz los cambios siguientes:

• INSTANCE_ID: el ID de la instancia que vas a crear. Debe empezar por una letra minúscula y puede contener letras minúsculas, números y guiones.

• CPU_COUNT: número de vCPUs N2 que quieres asignar a la instancia. N2 es el valor predeterminado. Entre los valores válidos se incluyen los siguientes:

  • 2: 2 vCPUs, 16 GB de RAM
  • 4: 4 vCPUs, 32 GB de RAM
  • 8: 8 vCPUs, 64 GB de RAM
  • 16: 16 vCPUs y 128 GB de RAM
  • 32: 32 vCPUs, 256 GB de RAM
  • 64: 64 vCPUs, 512 GB de RAM
  • 96: 96 vCPUs, 768 GB de RAM
  • 128: 128 vCPUs, 864 GB de RAM

• MACHINE_TYPE: este parámetro es opcional cuando implementas máquinas N2. Para desplegar la serie de máquinas basada en C4A Axion (vista previa) o para migrar entre máquinas C4A y N2, elija este parámetro con los siguientes valores.

  Si usas MACHINE_TYPE y CPU_COUNT juntos, los valores de CPU_COUNT y MACHINE_TYPE deben coincidir. De lo contrario, se producirá un error.

  En 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 desplegar C4A con 4 vCPUs 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 basada en Axion C4A, incluido el tipo de máquina de 1 vCPU, consulta Consideraciones al usar la serie de máquinas basada en Axion C4A.

  En el caso de la serie de máquinas N2 basadas en x86, usa el tipo de máquina con 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

• REGION_ID: la región en la que quieres que se encuentre la instancia.

• CLUSTER_ID: el ID del clúster que has creado anteriormente.

• PROJECT_ID: el ID del proyecto en el que se creó el clúster.

Opcional: Para aplicar un intervalo de direcciones IP específico a esta instancia y anular las asignaciones de intervalos de direcciones IP configuradas a nivel de clúster, proporciona el siguiente argumento:

    --allocated-ip-range-override=OVERRIDE_RANGE_NAME

Sustituye OVERRIDE_RANGE_NAME por el nombre del intervalo de direcciones IP que quieras que use esta instancia para acceder a servicios privados. Por ejemplo: google-managed-services-default. El nombre del intervalo debe cumplir la RFC 1035. En concreto, el nombre debe tener entre 1 y 63 caracteres, y coincidir con la expresión regular [a-z]([-a-z0-9]*[a-z0-9])?.

Para obtener más información sobre esta opción, consulta Crear una instancia con un intervalo de direcciones IP específico.

También puedes crear una instancia de AlloyDB con Private Service Connect habilitado. Para obtener información sobre cómo crear una instancia principal para un clúster habilitado para Private Service Connect, consulta Crear una instancia de AlloyDB.

Terraform

Para crear un clúster, usa un recurso de Terraform.

A continuación, se muestra un fragmento de código para crear un clúster basado en el ejemplo AlloyDB cluster full (Clúster de AlloyDB completo):

resource "google_alloydb_cluster" "cluster_abc" {
  cluster_id = "alloydb-cluster"
  location   = "us-central1"
  network_config {
    network = google_compute_network.default.id
  }
  database_version = "POSTGRES_16"

  initial_user {
    user     = "postgres"
    password = "postgres"
  }

  continuous_backup_config {
    enabled              = true
    recovery_window_days = 14
  }

  automated_backup_policy {
    location      = "us-central1"
    backup_window = "1800s"
    enabled       = true

    weekly_schedule {
      days_of_week = ["MONDAY"]

      start_times {
        hours   = 23
        minutes = 0
        seconds = 0
        nanos   = 0
      }
    }

    quantity_based_retention {
      count = 1
    }

    labels = {
      test = "alloydb-cluster-backup-policy-labels"
    }
  }

  labels = {
    test = "alloydb-cluster-labels"
  }
}

data "google_project" "project" {}

resource "google_compute_network" "default" {
  name = "alloydb-cluster-network"
}

Preparar Cloud Shell

Para aplicar la configuración de Terraform en un Google Cloud proyecto, prepara Cloud Shell de la siguiente manera:

1. Abre Cloud Shell.

2. Define el Google Cloud proyecto predeterminado en el que quieras aplicar tus configuraciones de Terraform.

   Solo tiene que ejecutar este comando una vez por proyecto y puede hacerlo en cualquier directorio.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Las variables de entorno se anulan si defines valores explícitos en el archivo de configuración de Terraform.

Preparar el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio, también llamado módulo raíz.

1. En Cloud Shell, crea un directorio y un archivo nuevo en ese directorio. El nombre del archivo debe ser un archivo TF, por ejemplo, main.tf. En este documento, el archivo se denomina main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Copia el código de ejemplo en el archivo main.tf que acabas de crear. También puedes copiar el código de GitHub. Se recomienda usar esta opción cuando el fragmento de Terraform forme parte de una solución integral.
3. Revisa el archivo main.tf y modifica los parámetros de ejemplo para que se apliquen a tu entorno.
4. Guarda los cambios.
5. Inicializa Terraform. Solo tienes que hacerlo una vez por directorio.

   terraform init

   Opcional: Para usar la versión más reciente del proveedor de Google, incluye la opción -upgrade:

   terraform init -upgrade

Aplica los cambios

1. Revisa la configuración para confirmar que las actualizaciones de Terraform se ajustan a tus expectativas:

   terraform plan

   Haga las correcciones necesarias en la configuración.
2. Aplica la configuración de Terraform ejecutando el siguiente comando e introduciendo yes en la petición:

   terraform apply

   Espera hasta que Terraform muestre el mensaje Apply complete!.
3. Abre tu Google Cloud proyecto para ver los resultados. En la Google Cloud consola, vaya a sus recursos en la interfaz de usuario para asegurarse de que Terraform los ha creado o actualizado.

REST v1

Crear un clúster

En este ejemplo se crea un clúster. Para ver la lista completa de parámetros de esta llamada, consulta Method: projects.locations.clusters.create. Para obtener información sobre la configuración de clústeres, consulta Ver la configuración de clústeres e instancias.

No incluyas información sensible ni información personal identificable en el ID de tu clúster, ya que es visible externamente. No es necesario que incluyas el ID de proyecto en el nombre del clúster. Esto se hace automáticamente cuando procede, por ejemplo, en los archivos de registro.

Para enviar la solicitud, guarda el cuerpo de la solicitud en un archivo llamado cluster_request.json:

{
  "databaseVersion": "DATABASE_VERSION",
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  },
  "labels": {
    "test": "alloydb-cluster-full"
  }
}

Haz las siguientes sustituciones:

• DATABASE_VERSION: cadena de enumeración de la versión de la base de datos. Por ejemplo, POSTGRES_16.
• INITIAL_USERNAME: el nombre de usuario que usas para el usuario predeterminado de Postgres.
• INITIAL_USER_PASSWORD: la contraseña que usas para el usuario predeterminado de Postgres.

Usa el siguiente método HTTP y la siguiente URL:

POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID

Haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto en el que quieres que se encuentre el clúster.
• LOCATION_ID: el ID de la región del clúster.
• CLUSTER_ID: el ID del clúster que crees. El ID del clúster debe empezar por una letra minúscula y puede contener letras minúsculas, números y guiones.

Puedes usar el siguiente curl para ejecutar la solicitud anterior:

curl -X POST   -H "Authorization: Bearer $(gcloud auth print-access-token)"   -H "Content-Type: application/json"   https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID   -d @cluster_request.json

Crear una instancia principal

En este ejemplo se crea una instancia principal. Para ver la lista completa de parámetros de esta llamada, consulta Method: projects.locations.clusters.instances.create. Para obtener información sobre la configuración de clústeres, consulta Ver la configuración de clústeres e instancias.

No incluyas información sensible ni información personal identificable en el ID de tu clúster, ya que es visible externamente. No es necesario que incluyas el ID del proyecto en el nombre del clúster, ya que se hace automáticamente cuando es necesario (por ejemplo, en los archivos de registro).

Para enviar la solicitud, guarda el siguiente cuerpo de la solicitud en un archivo llamado instance_request.json.

{
  "instance_type": "PRIMARY",
  "machine_config": {
    "cpu_count": "vCPU_COUNT"
  }
}

Haz la siguiente sustitución:

• VCPU_COUNT: el número de núcleos de CPU visibles en la instancia que quieres crear.

En el ejemplo anterior se crea una instancia N2 con las siguientes especificaciones:

• 2: 2 vCPUs, 16 GB de RAM
• 4: 4 vCPUs, 32 GB de RAM
• 8: 8 vCPUs, 64 GB de RAM
• 16: 16 vCPUs y 128 GB de RAM
• 32: 32 vCPUs y 256 GB de RAM
• 64: 64 vCPUs, 512 GB de RAM
• 96: 96 vCPUs, 768 GB de RAM
• 128: 128 vCPUs y 864 GB de RAM

Para crear una instancia de C4A, usa el campo machine_type en lugar de cpu_count en la estructura machine_config, como se muestra en el siguiente ejemplo:

machine_config: {
  machine_type : MACHINE_TYPE,
},

En el caso de la serie de máquinas C4A basada en Axion, usa los siguientes valores válidos:

• 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

En el caso de la serie de máquinas N2, los valores válidos son los siguientes:

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

Usa el siguiente método HTTP y la siguiente URL:

POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances?instance_id=INSTANCE_ID

Haz las siguientes sustituciones:

• PROJECT_ID: el ID del proyecto en el que quieres que se encuentre el clúster.
• LOCATION_ID: el ID de la región del clúster.
• CLUSTER_ID: el ID del clúster que crees. El ID debe empezar por una letra minúscula y puede contener letras minúsculas, números y guiones.
• INSTANCE_ID: el nombre de la instancia principal que quieras crear.

Puedes usar curl para ejecutar la solicitud, tal como se muestra en el siguiente ejemplo:

curl -X POST   -H "Authorization: Bearer $(gcloud auth print-access-token)"   -H "Content-Type: application/json"   https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances?instance_id=INSTANCE_ID   -d @instance_request.json