Crear un clúster y su instancia principal

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 de alta disponibilidad, consulta Nodos e instancias.

   Si no estás seguro de 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 de 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 deseas 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 vCPU (en Versión preliminar), que está disponible en regiones seleccionadas. Para obtener más información, consulta Consideraciones cuando se usa 1 vCPU.

9. Selecciona una ruta 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 de encriptación avanzadas.

    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 del mismo proyecto y la misma región 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 CMEK con AlloyDB requiere una configuración adicional. Para obtener más información, consulta Cómo usar 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 Axion de Google) (versión preliminar)
       • N2 (serie de máquinas basada 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 las series de máquinas basadas en Axion C4A, incluido el tipo de máquina con 1 vCPU, consulta Consideraciones para usar las series de máquinas basadas en Axion C4A.

    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 a servicios privados 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, que es la versión predeterminada de PostgreSQL compatible

     • 16, para la compatibilidad con PostgreSQL 16

   • PASSWORD: Es la 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 a servicios privados a AlloyDB. Si omites la marca --network, AlloyDB usa la red default.

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

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

   • PROJECT_ID: Es el ID del proyecto en el que deseas que se coloque 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 un rango de direcciones IP, 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 a servicios privados.

   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 CMEK que se usará.

   • KEYRING_ID: Es el ID del llavero de claves.

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

   • PROJECT_ID: El ID del proyecto del llavero.

4. Confirma que la operación se realizó 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 \
        --allowed-psc-projects=ALLOWED_PROJECT_LIST

Reemplaza lo siguiente:

• INSTANCE_ID: 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 las series de máquinas basadas en Axion C4A, incluido el tipo de máquina con 1 vCPU, consulta Consideraciones para usar las series de máquinas basadas en Axion C4A.

  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: 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 encuentra el clúster.

• ALLOWED_PROJECT_LIST (opcional): Es la lista de IDs de proyectos o números de proyectos separados por comas a los que deseas permitir el acceso a la instancia, si usas Private Service Connect.

Terraform

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

El siguiente es un fragmento de código para crear un clúster basado en el ejemplo de clúster completo de AlloyDB:

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

  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 de 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 que se aplicarán 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 de 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

En este ejemplo, se crea un clúster. El parámetro network es obligatorio. 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 debes incluir el ID del proyecto en el nombre del clúster. Esto se hace de forma automática cuando es apropiado, por ejemplo, en los archivos de registro.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• CLUSTER_ID: Es el ID del clúster que creaste. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.
• PROJECT_ID: Es el ID del proyecto en el que deseas que se coloque el clúster.

• LOCATION_ID: Es el ID de la región del clúster.

• NETWORK: Es el nombre de la red de VPC que configuraste para el acceso a servicios privados a AlloyDB.

• DATABASE_VERSION: Es la cadena de enumeración de la versión de la base de datos,por ejemplo, POSTGRES_15.

• INITIAL_USERNAME: Es el nombre de usuario que se usará para el usuario postgres predeterminado.

• INITIAL_USER_PASSWORD: La contraseña que se usará para el usuario postgres predeterminado.

El cuerpo JSON de la solicitud se ve de la siguiente manera:

{
  clusterId = "CLUSTER_ID"
  network = "projects/PROJECT_ID/global/networks/NETWORK"
  databaseVersion = "DATABASE_VERSION"

  initialUser {
    user     = "INITIAL_USERNAME"
    password = "INITIAL_USER_PASSWORD"
  }

  continuousBackupConfig {
    enabled              = true
    recoveryWindowDays = 14
  }

  weeklySchedule {
    daysOfWeek = ["MONDAY"]

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

    quantityBasedRetention {
      count = 1
    }

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

Para enviar tu solicitud, guarda el cuerpo de la solicitud en un archivo llamado request.json y usa la siguiente solicitud POST:

  POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters