Crear un clúster y su instancia principal

Console

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

   Ir a los clústeres

2. Haga clic en Crear clúster.

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

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

4. Haz clic en Continuar.

5. En la sección Configura tu clúster, en el campo ID del clúster, ingresa un ID para tu clúster.

6. En el campo Contraseña, ingresa una contraseña inicial para el clúster nuevo. AlloyDB asigna la contraseña proporcionada al usuario de la base de datos postgres mientras crea el clúster.

7. En el campo Versión de la base de datos, selecciona la versión principal de PostgreSQL con la que quieres 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 zona de pruebas, considera la forma de 1 CPU virtual (en versión preliminar), que está disponible en regiones seleccionadas. Para obtener más información, consulta Consideraciones cuando se usa 1 CPU virtual.

9. Selecciona una ruta de acceso de red.

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

    1. Haz clic en Mostrar la opción de rango de IP asignado.

    2. En la lista Rango de IP asignado, selecciona un rango de direcciones IP.

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

11. Opcional: Para encriptar este clúster con una clave de encriptación administrada por el cliente (CMEK) en lugar de la encriptación administrada por Google, sigue estos pasos adicionales:

    1. Haz clic en Opciones avanzadas de encriptación.

    2. Selecciona Clave de encriptación administrada por el cliente (CMEK).

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

       La consola de Google Cloud limita esta lista a las claves que se encuentran dentro del mismo proyecto y región de Google Cloud que el clúster nuevo. Para usar una clave que no está en esta lista, haz clic en ¿No ves tu clave? Ingresa el nombre del recurso de la clave y, luego, escribe el nombre del recurso de la clave en el diálogo resultante.

       Ten en cuenta que usar la CMEK con AlloyDB requiere una configuración adicional. Para obtener más información, consulta Usa CMEK con AlloyDB.

    4. Haz clic en Continuar.

12. Configura tu instancia principal:

    1. En el campo ID de instancia, ingresa 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 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.

    4. Opcional: Establece marcas personalizadas para tu instancia. Para cada marca, sigue estos pasos:

       1. Haz clic en Agregar marca.
       2. En la lista New database flag, selecciona una marca.
       3. Proporciona un valor para la marca.
       4. Haz clic en Listo.

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

gcloud

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

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

   Acceso privado a servicios

   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 

   Reemplaza lo siguiente:

   • CLUSTER_ID: Es el ID del clúster que creas. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.

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

     • 14, para la compatibilidad con PostgreSQL 14

     • 15, para la compatibilidad con PostgreSQL 15

     • 16, para la compatibilidad 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 uso de PostgreSQL 17 en versión preliminar, consulta Compatibilidad de la versión preliminar de PostgreSQL 17.

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

   • NETWORK (opcional): Es el nombre de la red de VPC que configuraste para el acceso privado a servicios a AlloyDB. Si omites la marca --network, AlloyDB usa la red default.

   En el caso de una red de VPC compartida, se debe establecer en la ruta de acceso completamente calificada de la red de VPC, por ejemplo, projects/cymbal-project/global/networks/shared-vpc-network.

   • --enable-private-service-connect (opcional): Se establece para habilitar Private Service Connect como el método de conectividad para el clúster y sus instancias.

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

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

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

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

   --allocated-ip-range-name=RANGE
   

   Reemplaza RANGE por el nombre del rango de direcciones IP que deseas que use este clúster para el acceso privado a servicios.

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

3. Opcional: Para encriptar este clúster con una clave de encriptación administrada por el cliente (CMEK) en lugar de la encriptación predeterminada administrada por Google, proporciona los siguientes argumentos:

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

   Reemplaza lo siguiente:

   • KEY_ID: Es el ID de la clave de CMEK que se usará.

   • KEYRING_ID: Es el ID del llavero de claves de la clave.

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

   • PROJECT_ID: Es el ID del proyecto del llavero de claves.

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

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

   Reemplaza OPERATION_ID por el ID de operación que se mostró en el paso anterior.

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

Crea 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 \

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 vCPU 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 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: Es la región en la que deseas que se ubique la instancia.

• CLUSTER_ID: Es el ID del clúster que creaste antes.

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

Opcional: Para aplicar un rango de direcciones IP específico a esta instancia y anular cualquier asignación de rango de direcciones IP configurada a nivel del clúster, proporciona el siguiente argumento:

    --allocated-ip-range-override=OVERRIDE_RANGE_NAME

Reemplaza OVERRIDE_RANGE_NAME por el nombre del rango de direcciones IP que deseas que use esta instancia para el acceso privado a servicios, por ejemplo, google-managed-services-default. El nombre del rango debe cumplir con RFC 1035. Específicamente, 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 Crea una instancia con un rango 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 Crea 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 de 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"
}

Prepara Cloud Shell

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

1. Inicia Cloud Shell

2. Establece el proyecto Google Cloud predeterminado en el que deseas aplicar tus configuraciones de Terraform.

   Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

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

Prepara 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 dentro de 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 muestra en el main.tf recién creado. De manera opcional, copia el código de GitHub. Esto se recomienda cuando el fragmento de Terraform es parte de una solución de extremo a extremo.
3. Revisa el archivo main.tf y modifica los parámetros de muestra para que se apliquen a tu entorno.
4. Guarda los cambios.
5. Inicializa Terraform. Solo debes 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

Aplique los cambios

1. Revisa la configuración para confirmar que las actualizaciones de Terraform coincidan con tus expectativas:

   terraform plan

   Corrige la configuración según sea necesario.
2. Para aplicar la configuración de Terraform, ejecuta el siguiente comando y, luego, escribe yes cuando se te solicite:

   terraform apply

   Espera hasta que Terraform muestre el mensaje Apply complete!.
3. Abre tu proyecto Google Cloud para ver los resultados. En la consola de Google Cloud , navega a tus recursos en la IU para asegurarte de que Terraform los haya creado o actualizado.

REST v1

Crea un clúster

En este ejemplo, se crea un clúster. Para ver una lista completa de los parámetros de esta llamada, consulta Método: projects.locations.clusters.create. Para obtener información sobre la configuración del clúster, consulta Consulta la configuración del clúster y de la instancia.

No incluyas información sensible o de identificación personal en el ID de tu clúster, ya que es visible de forma externa. No es necesario que incluyas el ID del proyecto en el nombre del clúster. Esto se hace de manera automática cuando corresponde, por ejemplo, en los archivos de registro.

Para enviar tu 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"
  }
}

Realiza los siguientes reemplazos:

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

Usa el siguiente método y URL HTTP:

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

Realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto en el que deseas que se ubique el clúster.
• LOCATION_ID: Es el ID de la región del clúster.
• CLUSTER_ID: Es el ID del clúster que creas. El ID del clúster debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.

Puedes usar el siguiente comando 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

Crea una instancia principal

En este ejemplo, se crea una instancia principal. Para ver una lista completa de los parámetros de esta llamada, consulta Método: projects.locations.clusters.instances.create. Para obtener información sobre la configuración del clúster, consulta Consulta la configuración del clúster y de la instancia.

No incluyas información sensible o de identificación personal en el ID de tu clúster, ya que es visible de forma externa. No es necesario que incluyas el ID del proyecto en el nombre del clúster, ya que esto se hace automáticamente cuando es apropiado, por ejemplo, en los archivos de registro.

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

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

Realiza el siguiente reemplazo:

• VCPU_COUNT: Es la cantidad de núcleos de CPU visibles en la instancia que deseas crear.

En el ejemplo anterior, 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

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,
},

Para la serie de máquinas basadas en Axion de C4A, 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

Para la serie de máquinas N2, los siguientes son valores válidos:

• 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 y URL HTTP:

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

Realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto en el que deseas que se ubique el clúster.
• LOCATION_ID: Es el ID de la región del clúster.
• CLUSTER_ID: Es el ID del clúster que creas. El ID debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.
• INSTANCE_ID: Es el nombre de la instancia principal que deseas crear.

Puedes usar curl para ejecutar la solicitud, 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