Criar um cluster e a instância principal

Console

1. Acessar a página Clusters.

   Acessar Clusters

2. Clique em Criar cluster.

3. Escolha uma configuração de cluster. Para mais informações sobre a diferença entre configurações básicas e de alta disponibilidade, consulte Nós e instâncias.

   Se você não tiver certeza se o novo cluster precisa de instâncias de pool de leitura, escolha uma das configurações sem pools de leitura. É possível adicionar instâncias de pool de leitura ao cluster posteriormente, sempre que necessário.

4. Clique em Continuar.

5. Na seção Configurar seu cluster, no campo ID do cluster, insira um ID para o cluster.

6. No campo Senha, insira uma senha inicial para o novo cluster. O AlloyDB atribui a senha fornecida ao usuário do banco de dados postgres ao criar o cluster.

7. No campo Versão do banco de dados, selecione a versão principal do PostgreSQL com que você quer que os servidores de banco de dados do cluster sejam compatíveis.

8. Selecione uma região. Para cargas de trabalho de desenvolvimento e sandbox, considere o formato de 1 vCPU (em Pré-lançamento), que está disponível em regiões selecionadas. Para mais informações, consulte Considerações ao usar 1 vCPU.

9. Selecione um caminho de rede.

10. Opcional: para aplicar um intervalo de endereços IP específico a esse cluster em vez de permitir que o AlloyDB escolha um intervalo de endereços IP, siga estas etapas:

    1. Clique em Mostrar opção de intervalo de IP alocado.

    2. Na lista Intervalo de IP alocado, selecione um intervalo de endereços IP.

    Para mais informações sobre essa opção, consulte Criar um cluster com um intervalo de endereços IP específico.

11. Opcional: para criptografar esse cluster usando uma chave de criptografia gerenciada pelo cliente (CMEK) em vez da criptografia gerenciada pelo Google, siga estas etapas adicionais:

    1. Clique em Opções avançadas de criptografia.

    2. Selecione Chave de criptografia gerenciada pelo cliente (CMEK).

    3. No menu exibido, selecione uma chave gerenciada pelo cliente.

       O console Google Cloud limita essa lista a chaves no mesmo projeto Google Cloud e região do novo cluster. Para usar uma chave que não está nessa lista, clique em Não encontra sua chave? Insira o nome do recurso da chave e digite o nome do recurso da chave na caixa de diálogo resultante.

       O uso da CMEK com o AlloyDB requer mais algumas configurações. Para mais informações, consulte Como usar a CMEK com o AlloyDB.

    4. Clique em Continuar.

12. Configure a instância principal:

    1. No campo ID da instância, insira um ID para a instância principal.

    2. Selecione uma das seguintes séries de máquinas:

       • C4A (série de máquinas baseadas no Google Axion) (prévia)
       • N2 (série de máquinas baseadas em x86). Essa é a série de máquinas padrão.

    3. Selecione um tipo de máquina.

       • O C4A é compatível com 1, 4, 8, 16, 32, 48, 64 e 72 tipos ou formatos de máquina.
       • O N2 oferece suporte a 2, 4, 8, 16, 32, 64, 96 e 128 tipos ou formatos de máquina.

       Para mais informações sobre o uso da série de máquinas C4A baseada em Axion, incluindo o tipo de máquina de 1 vCPU, consulte Considerações ao usar a série de máquinas C4A baseada em Axion.

    4. Opcional: defina flags personalizadas para sua instância. Para cada flag, siga estas etapas:

       1. Clique em Adicionar flag.
       2. Na lista Nova flag de banco de dados, selecione uma opção.
       3. Informe um valor para a flag.
       4. Clique em Concluído.

13. Se você escolheu um tipo de cluster sem pools de leitura, clique em Criar cluster.

gcloud

Para usar a CLI gcloud, instale e inicialize a Google Cloud CLI ou use o Cloud Shell.

1. Para criar o cluster com o acesso a serviços particulares ou o Private Service Connect ativado, use o comando gcloud alloydb clusters create.

   Acesso privado a serviços

   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 

   Substitua:

   • CLUSTER_ID: o ID do cluster que você está criando. Ele precisa começar com uma letra minúscula e pode conter letras minúsculas, números e hífens.

   • VERSION: a versão principal do PostgreSQL com que você quer que os servidores de banco de dados do cluster sejam compatíveis. Escolha uma destas opções:

     • 14, para compatibilidade com o PostgreSQL 14

     • 15, para compatibilidade com o PostgreSQL 15

     • 16, para compatibilidade com o PostgreSQL 16, que é a versão padrão do PostgreSQL compatível com o AlloyDB.

     • 17, para compatibilidade com o PostgreSQL 17 (visualização)

       Para mais informações sobre as restrições que se aplicam ao uso do PostgreSQL 17 em prévia, consulte Compatibilidade da prévia do PostgreSQL 17.

   • PASSWORD: a senha a ser usada para o usuário padrão postgres.

   • NETWORK (opcional): o nome da rede VPC que você configurou para o acesso a serviços particulares do AlloyDB. Se você omitir a flag --network, o AlloyDB usará a rede default.

   No caso de uma rede VPC compartilhada, defina o caminho totalmente qualificado da rede VPC. Por exemplo, projects/cymbal-project/global/networks/shared-vpc-network.

   • --enable-private-service-connect (opcional): defina como para ativar o Private Service Connect como o método de conectividade do cluster e das instâncias dele.

   • REGION_ID: a região em que você quer colocar o cluster.

   • PROJECT_ID: o ID do projeto em que você quer colocar o cluster.

   Esse comando inicia uma operação de longa duração, retornando um ID de operação.

2. Opcional: para aplicar um intervalo de endereços IP específico a esse cluster, em vez de permitir que o AlloyDB escolha um intervalo, forneça o seguinte argumento:

   --allocated-ip-range-name=RANGE
   

   Substitua RANGE pelo nome do intervalo de endereços IP que você quer que o cluster use para acesso a serviços particulares.

   Para mais informações sobre essa opção, consulte Criar um cluster com um intervalo de endereços IP específico.

3. Opcional: para criptografar esse cluster usando uma chave de criptografia gerenciada pelo cliente (CMEK) em vez da criptografia padrão gerenciada pelo Google, forneça os seguintes argumentos:

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

   Substitua:

   • KEY_ID: o ID da chave CMEK a ser usada.

   • KEYRING_ID: o ID do keyring da chave.

   • LOCATION_ID: o ID da região do keyring, que precisa ser igual à região do cluster.

   • PROJECT_ID: o ID do projeto do keyring.

4. Confirme se a operação foi bem-sucedida.

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

   Substitua OPERATION_ID pelo ID da operação retornado na etapa anterior.

Depois de criar o cluster principal, você precisa criar uma instância principal.

Criar uma instância principal

Para criar uma instância principal, use o 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 \

Substitua:

• INSTANCE_ID: o ID da instância que você está criando. Ele precisa começar com uma letra minúscula e pode conter letras minúsculas, números e hifens.

• CPU_COUNT: o número de vCPUs N2 que você quer para a instância. N2 é o padrão. Os valores válidos incluem:

  • 2: 2 vCPUs, 16 GB de RAM
  • 4: 4 vCPUs, 32 GB de RAM
  • 8: 8 vCPUs, 64 GB de RAM
  • 16: 16 vCPUs, 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: esse parâmetro é opcional ao implantar máquinas N2. Para implantar a série de máquinas C4A baseada em Axion (pré-lançamento) ou migrar entre máquinas C4A e N2, escolha esse parâmetro com os seguintes valores.

  Quando você usa MACHINE_TYPE e CPU_COUNT juntos, os valores em CPU_COUNT e MACHINE_TYPE precisam corresponder. Caso contrário, um erro será gerado.

  Para a série de máquinas C4A baseada em Axion, escolha o tipo de máquina com os seguintes 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 implantar C4A com 4 vCPUs ou mais, use o sufixo lssd para ativar o cache ultrarrápido.

  Para mais informações sobre o uso da série de máquinas C4A baseada em Axion, incluindo o tipo de máquina de 1 vCPU, consulte Considerações ao usar a série de máquinas C4A baseada em Axion.

  Para a série de máquinas N2 baseada em x86, use o tipo de máquina com os seguintes 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: a região em que você quer que a instância esteja localizada.

• CLUSTER_ID: o ID do cluster que você criou anteriormente.

• PROJECT_ID: o ID do projeto em que o cluster foi criado.

Opcional: para aplicar um intervalo de endereços IP específico a essa instância e substituir todas as alocações de intervalo de endereços IP configuradas no nível do cluster, forneça o seguinte argumento:

    --allocated-ip-range-override=OVERRIDE_RANGE_NAME

Substitua OVERRIDE_RANGE_NAME pelo nome do intervalo de endereços IP que você quer que essa instância use para acesso a serviços particulares. Por exemplo: google-managed-services-default. O nome do intervalo precisa estar em conformidade com a RFC 1035. O nome precisa ter de 1 a 63 caracteres e corresponder à expressão regular [a-z]([-a-z0-9]*[a-z0-9])?.

Para mais informações sobre essa opção, consulte Criar uma instância com um intervalo de endereços IP específico.

Também é possível criar uma instância do AlloyDB com o Private Service Connect ativado. Para informações sobre como criar uma instância principal para um cluster com o Private Service Connect ativado, consulte Criar uma instância do AlloyDB.

Terraform

Para criar um cluster, use um recurso do Terraform.

Confira a seguir um snippet de código para criar um cluster com base no exemplo AlloyDB cluster full:

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 o Cloud Shell

Para aplicar a configuração do Terraform em um projeto Google Cloud , prepare o Cloud Shell da seguinte maneira:

1. Inicie o Cloud Shell.

2. Defina o projeto Google Cloud padrão em que você quer aplicar as configurações do Terraform.

   Você só precisa executar esse comando uma vez por projeto, e ele pode ser executado em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   As variáveis de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.

Preparar o diretório

Cada arquivo de configuração do Terraform precisa ter o próprio diretório, também chamado de módulo raiz.

1. No Cloud Shell, crie um diretório e um novo arquivo dentro dele. O nome do arquivo precisa ser um arquivo TF, por exemplo, main.tf. Neste documento, o arquivo é chamado de main.tf.

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

2. Copie o exemplo de código no main.tf recém-criado. Se preferir, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução de ponta a ponta.
3. Revise o arquivo main.tf e modifique os parâmetros de amostra para aplicar ao seu ambiente.
4. Salve as alterações.
5. Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.

   terraform init

   Opcional: para usar a versão mais recente do provedor do Google, inclua a opção -upgrade:

   terraform init -upgrade

Aplique as alterações

1. Revise a configuração para confirmar se as atualizações do Terraform correspondem às suas expectativas:

   terraform plan

   Faça as correções necessárias na configuração.
2. Para aplicar a configuração do Terraform, execute o comando a seguir e digite yes no prompt:

   terraform apply

   Aguarde até que o Terraform mostre a mensagem Apply complete!.
3. Abra seu Google Cloud projeto para conferir os resultados. No console Google Cloud , navegue até seus recursos na UI para verificar se foram criados ou atualizados pelo Terraform.

REST v1

Criar um cluster

Este exemplo cria um cluster. Para uma lista completa de parâmetros dessa chamada, consulte Método: projects.locations.clusters.create. Para informações sobre as configurações do cluster, consulte Ver as configurações do cluster e da instância.

Não inclua informações sensíveis ou de identificação pessoal no ID do cluster, porque ele é visível externamente. Não é necessário incluir o ID do projeto no nome do cluster. Isso é feito automaticamente quando necessário, como nos arquivos de registros.

Para enviar sua solicitação, salve o corpo da solicitação em um arquivo chamado cluster_request.json:

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

Faça as seguintes substituições:

• DATABASE_VERSION: string de enumeração da versão do banco de dados, por exemplo, POSTGRES_16.
• INITIAL_USERNAME: o nome de usuário que você usa para o usuário postgres padrão.
• INITIAL_USER_PASSWORD: a senha que você usa para o usuário postgres padrão.

Use o método HTTP e o URL a seguir:

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

Faça as seguintes substituições:

• PROJECT_ID: o ID do projeto em que você quer que o cluster esteja localizado.
• LOCATION_ID: o ID da região do cluster.
• CLUSTER_ID: o ID do cluster que você criou. O ID do cluster precisa começar com uma letra minúscula e pode conter letras minúsculas, números e hifens.

Use o seguinte curl para executar a solicitação 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

Criar uma instância principal

Este exemplo cria uma instância principal. Para uma lista completa de parâmetros dessa chamada, consulte Método: projects.locations.clusters.instances.create. Para informações sobre as configurações do cluster, consulte Ver as configurações do cluster e da instância.

Não inclua informações sensíveis ou de identificação pessoal no ID do cluster, porque ele é visível externamente. Não é necessário incluir o ID do projeto no nome do cluster, porque isso é feito automaticamente quando apropriado, por exemplo, nos arquivos de registro.

Para enviar sua solicitação, salve o corpo da solicitação a seguir em um arquivo chamado instance_request.json.

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

Faça a seguinte substituição:

• VCPU_COUNT: o número de núcleos de CPU visíveis na instância que você quer criar.

O exemplo anterior cria uma instância N2 com as seguintes especificações:

• 2: 2 vCPUs, 16 GB de RAM
• 4: 4 vCPUs, 32 GB de RAM
• 8: 8 vCPUs, 64 GB de RAM
• 16: 16 vCPUs, 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

Para criar uma instância do C4A, use o campo machine_type em vez de cpu_count na estrutura machine_config, conforme mostrado no exemplo a seguir:

machine_config: {
  machine_type : MACHINE_TYPE,
},

Para a série de máquinas C4A baseada em Axion, use os seguintes 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 a série de máquinas N2, use os seguintes 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

Use o método HTTP e o URL a seguir:

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

Faça as seguintes substituições:

• PROJECT_ID: o ID do projeto em que você quer que o cluster esteja localizado.
• LOCATION_ID: o ID da região do cluster.
• CLUSTER_ID: o ID do cluster que você criou. O ID precisa começar com uma letra minúscula e pode conter letras minúsculas, números e hifens.
• INSTANCE_ID: o nome da instância principal que você quer criar.

É possível usar curl para executar a solicitação, conforme mostrado no exemplo a seguir:

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