Creazione di un cluster e della relativa istanza principale

Console

1. Vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su Crea cluster.

3. Scegli una configurazione del cluster. Per ulteriori informazioni sulla differenza tra le configurazioni ad alta disponibilità e di base, consulta la sezione Nodi e istanze.

   Se non sai se il nuovo cluster ha bisogno di istanze del pool di lettura, scegli una delle configurazioni senza pool di lettura. Puoi aggiungere istanze del pool di lettura al cluster in un secondo momento, quando necessario.

4. Fai clic su Continua.

5. Nella sezione Configura il cluster, inserisci un ID per il cluster nel campo ID cluster.

6. Nel campo Password, inserisci una password iniziale per il nuovo cluster. AlloyDB assegna la password fornita all'utente del database postgres durante la creazione del cluster.

7. Nel campo Versione database, seleziona la versione principale di PostgreSQL con cui vuoi che siano compatibili i server di database del cluster.

8. Seleziona una regione. Per i workload di sviluppo e sandbox, prendi in considerazione la forma a 1 vCPU (in anteprima), disponibile in alcune regioni. Per ulteriori informazioni, vedi Considerazioni sull'utilizzo di una vCPU.

9. Seleziona un percorso di rete.

10. (Facoltativo) Per applicare un intervallo di indirizzi IP specifico a questo cluster, anziché consentire ad AlloyDB di scegliere un intervallo di indirizzi IP, segui questi passaggi:

    1. Fai clic su Mostra opzione intervallo IP allocato.

    2. Dall'elenco Intervallo IP allocato, seleziona un intervallo di indirizzi IP.

    Per saperne di più su questa opzione, consulta Creare un cluster con un intervallo di indirizzi IP specifico.

11. (Facoltativo) Per criptare questo cluster utilizzando una chiave di crittografia gestita dal cliente (CMEK) anziché la crittografia gestita da Google, segui questi passaggi aggiuntivi:

    1. Fai clic su Opzioni di crittografia avanzate.

    2. Seleziona Chiave di crittografia gestita dal cliente (CMEK).

    3. Nel menu visualizzato, seleziona una chiave gestita dal cliente.

       La console Google Cloud limita questo elenco alle chiavi all'interno dello Google Cloud stesso progetto e della stessa regione del nuovo cluster. Per utilizzare una chiave non presente in questo elenco, fai clic su Non vedi la tua chiave? Inserisci il nome risorsa della chiave, quindi digita il nome risorsa della chiave nella finestra di dialogo risultante.

       Tieni presente che l'utilizzo di CMEK con AlloyDB richiede una configurazione aggiuntiva. Per ulteriori informazioni, consulta Utilizzo di CMEK con AlloyDB.

    4. Fai clic su Continua.

12. Configura l'istanza principale:

    1. Nel campo ID istanza, inserisci un ID per l'istanza principale.

    2. Seleziona una delle seguenti serie di macchine:

       • C4A (serie di macchine basate su Google Axion) (anteprima)
       • N2 (serie di macchine basate su x86). Questa è la serie di macchine predefinita.

    3. Seleziona un tipo di macchina.

       • C4A supporta 1, 4, 8, 16, 32, 48, 64 e 72 tipi o forme di macchine.
       • N2 supporta 2, 4, 8, 16, 32, 64, 96 e 128 tipi o forme di macchine.

       Per saperne di più sull'utilizzo della serie di macchine C4A basate su Axion, incluso il tipo di macchina con 1 vCPU, consulta Considerazioni sull'utilizzo della serie di macchine C4A basate su Axion.

    4. (Facoltativo) Imposta flag personalizzati per l'istanza. Per ogni segnalazione, segui questi passaggi:

       1. Fai clic su Aggiungi flag.
       2. Nell'elenco Flag nuovo database, seleziona un flag.
       3. Specifica un valore per il flag.
       4. Fai clic su Fine.

13. Se hai scelto un tipo di cluster senza pool di lettura, fai clic su Crea cluster.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

1. Per creare il cluster con l'accesso ai servizi privati o Private Service Connect abilitato, utilizza il comando gcloud alloydb clusters create.

   Accesso privato ai servizi

   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 

   Sostituisci quanto segue:

   • CLUSTER_ID: l'ID del cluster che stai creando. Deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.

   • VERSION: la versione principale di PostgreSQL con cui vuoi che siano compatibili i server di database del cluster. Scegli una delle opzioni seguenti:

     • 14, per la compatibilità con PostgreSQL 14

     • 15, per la compatibilità con PostgreSQL 15

     • 16, per la compatibilità con PostgreSQL 16, che è la versione predefinita di PostgreSQL supportata da AlloyDB.

     • 17, per la compatibilità con PostgreSQL 17 (anteprima)

       Per saperne di più sulle limitazioni che si applicano all'utilizzo di PostgreSQL 17 in anteprima, consulta Compatibilità di PostgreSQL 17 in anteprima.

   • PASSWORD: la password da utilizzare per l'utente postgres predefinito.

   • NETWORK (facoltativo): il nome della rete VPC che hai configurato per l'accesso privato ai servizi ad AlloyDB. Se ometti il flag --network, AlloyDB utilizza la rete default.

   Nel caso della rete VPC condiviso, imposta il percorso completo della rete VPC, ad esempio projects/cymbal-project/global/networks/shared-vpc-network.

   • --enable-private-service-connect (facoltativo): imposta su per abilitare Private Service Connect come metodo di connettività per il cluster e le relative istanze.

   • REGION_ID: la regione in cui vuoi posizionare il cluster.

   • PROJECT_ID: l'ID del progetto in cui vuoi posizionare il cluster.

   Questo comando avvia un'operazione a lunga esecuzione, restituendo un ID operazione.

2. (Facoltativo) Per applicare un intervallo di indirizzi IP specifico a questo cluster, anziché consentire ad AlloyDB di scegliere un intervallo di indirizzi IP, fornisci il seguente argomento:

   --allocated-ip-range-name=RANGE
   

   Sostituisci RANGE con il nome dell'intervallo di indirizzi IP che vuoi che questo cluster utilizzi per l'accesso al servizio privato.

   Per saperne di più su questa opzione, vedi Creare un cluster con un intervallo di indirizzi IP specifico.

3. (Facoltativo) Per criptare questo cluster utilizzando una chiave di crittografia gestita dal cliente (CMEK) anziché la crittografia gestita da Google predefinita, fornisci i seguenti argomenti:

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

   Sostituisci quanto segue:

   • KEY_ID: l'ID della chiave CMEK da utilizzare.

   • KEYRING_ID: l'ID del portachiavi della chiave.

   • LOCATION_ID: l'ID della regione del portachiavi, che deve corrispondere a quella del cluster.

   • PROJECT_ID: l'ID del progetto del portachiavi.

4. Verifica che l'operazione sia riuscita.

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

   Sostituisci OPERATION_ID con l'ID operazione restituito dal passaggio precedente.

Dopo aver creato il cluster primario, devi creare un'istanza principale.

Crea un'istanza principale

Per creare un'istanza primaria, utilizza il 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 \

Sostituisci quanto segue:

• INSTANCE_ID: l'ID dell'istanza che stai creando. Deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.

• CPU_COUNT: il numero di vCPU N2 che vuoi per l'istanza. N2 è il valore predefinito. I valori validi includono:

  • 2: 2 vCPU, 16 GB di RAM
  • 4: 4 vCPU, 32 GB di RAM
  • 8: 8 vCPU, 64 GB di RAM
  • 16: 16 vCPU, 128 GB di RAM
  • 32: 32 vCPU, 256 GB di RAM
  • 64: 64 vCPU, 512 GB di RAM
  • 96: 96 vCPU, 768 GB di RAM
  • 128: 128 vCPU, 864 GB di RAM

• MACHINE_TYPE: questo parametro è facoltativo quando implementi macchine N2. Per eseguire il deployment della serie di macchine basata su Axion C4A (anteprima) o per eseguire la migrazione tra macchine C4A e N2, scegli questo parametro con i seguenti valori.

  Quando utilizzi MACHINE_TYPE e CPU_COUNT insieme, i valori in CPU_COUNT e MACHINE_TYPE devono corrispondere, altrimenti viene visualizzato un errore.

  Per la serie di macchine basata su Axion C4A, scegli il tipo di macchina con i seguenti valori:

  • 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

  Per eseguire il deployment di C4A con 4 vCPU e versioni successive, utilizza il suffisso lssd per attivare la cache ultra veloce.

  Per saperne di più sull'utilizzo della serie di macchine C4A basate su Axion, incluso il tipo di macchina con 1 vCPU, consulta Considerazioni sull'utilizzo della serie di macchine C4A basate su Axion.

  Per la serie di macchine N2 basate su x86, utilizza il tipo di macchina con i seguenti valori:

  • 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 regione in cui vuoi che si trovi l'istanza.

• CLUSTER_ID: l'ID del cluster che hai creato in precedenza.

• PROJECT_ID: l'ID del progetto in cui è stato creato il cluster.

(Facoltativo) Per applicare un intervallo di indirizzi IP specifico a questa istanza e sostituire le allocazioni di intervalli di indirizzi IP configurate a livello di cluster, fornisci il seguente argomento:

    --allocated-ip-range-override=OVERRIDE_RANGE_NAME

Sostituisci OVERRIDE_RANGE_NAME con il nome dell'intervallo di indirizzi IP che vuoi che questa istanza utilizzi per l'accesso ai servizi privati, ad esempio google-managed-services-default. Il nome dell'intervallo deve essere conforme a RFC 1035. Nello specifico, il nome deve avere una lunghezza compresa tra 1 e 63 caratteri e corrispondere all'espressione regolare [a-z]([-a-z0-9]*[a-z0-9])?.

Per saperne di più su questa opzione, vedi Crea un'istanza con un intervallo di indirizzi IP specifico.

Puoi anche creare un'istanza AlloyDB con Private Service Connect abilitato. Per informazioni sulla creazione di un'istanza principale per un cluster abilitato a Private Service Connect, consulta Creare un'istanza AlloyDB.

Terraform

Per creare un cluster, utilizza una risorsa Terraform.

Di seguito è riportato lo snippet di codice per la creazione di un cluster basato sull'esempio 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"
}

Prepara Cloud Shell

Per applicare la configurazione Terraform in un progetto Google Cloud , prepara Cloud Shell nel seguente modo:

1. Avvia Cloud Shell.

2. Imposta il progetto Google Cloud predefinito in cui vuoi applicare le configurazioni Terraform.

   Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione di Terraform deve avere la propria directory, chiamata anche modulo principale.

1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve essere un file TF, ad esempio main.tf. In questo documento, il file è denominato main.tf.

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

2. Copia il codice campione nel main.tf appena creato. (Facoltativo) Copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.
3. Esamina il file main.tf e modifica i parametri di esempio da applicare al tuo ambiente.
4. Salva le modifiche.
5. Inizializza Terraform. Devi effettuare questa operazione una sola volta per directory.

   terraform init

   (Facoltativo) Per utilizzare l'ultima versione del provider Google, includi l'opzione -upgrade:

   terraform init -upgrade

Applica le modifiche

1. Rivedi la configurazione per verificare che gli aggiornamenti di Terraform corrispondano alle tue aspettative:

   terraform plan

   Apporta le correzioni necessarie alla configurazione.
2. Applica la configurazione di Terraform eseguendo il comando seguente e inserendo yes al prompt:

   terraform apply

   Attendi che Terraform visualizzi il messaggio Apply complete!.
3. Apri il tuo Google Cloud progetto per visualizzare i risultati. Nella console Google Cloud , vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

REST v1

Crea un cluster

Questo esempio crea un cluster. Per un elenco completo dei parametri per questa chiamata, consulta Metodo: projects.locations.clusters.create. Per informazioni sulle impostazioni del cluster, vedi Visualizzare le impostazioni dei cluster e delle istanze.

Non includere informazioni sensibili o che consentono l'identificazione personale nell'ID cluster perché è visibile esternamente. Non è necessario includere l'ID progetto nel nome del cluster. Questa operazione viene eseguita automaticamente, se appropriato, ad esempio nei file di log.

Per inviare la richiesta, salva il corpo della richiesta in un file denominato cluster_request.json:

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

Effettua le seguenti sostituzioni:

• DATABASE_VERSION: stringa enum della versione del database, ad esempio POSTGRES_16.
• INITIAL_USERNAME: il nome utente che utilizzi per l'utente postgres predefinito.
• INITIAL_USER_PASSWORD: la password che utilizzi per l'utente postgres predefinito.

Utilizza il seguente metodo HTTP e URL:

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

Effettua le seguenti sostituzioni:

• PROJECT_ID: l'ID del progetto in cui vuoi che si trovi il cluster.
• LOCATION_ID: l'ID della regione del cluster.
• CLUSTER_ID: l'ID del cluster che crei. L'ID cluster deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.

Puoi utilizzare il seguente comando curl per eseguire la richiesta precedente:

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 un'istanza principale

Questo esempio crea un'istanza principale. Per un elenco completo dei parametri per questa chiamata, consulta Metodo: projects.locations.clusters.instances.create. Per informazioni sulle impostazioni del cluster, vedi Visualizzare le impostazioni dei cluster e delle istanze.

Non includere informazioni sensibili o che consentono l'identificazione personale nell'ID cluster, perché è visibile esternamente. Non è necessario includere l'ID progetto nel nome del cluster perché questa operazione viene eseguita automaticamente, se necessario, ad esempio nei file di log.

Per inviare la richiesta, salva il seguente corpo della richiesta in un file denominato instance_request.json.

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

Esegui la seguente sostituzione:

• VCPU_COUNT: il numero di core della CPU visibili nell'istanza che vuoi creare.

L'esempio precedente crea un'istanza N2 con le seguenti specifiche:

• 2: 2 vCPU, 16 GB di RAM
• 4: 4 vCPU, 32 GB di RAM
• 8: 8 vCPU, 64 GB di RAM
• 16: 16 vCPU, 128 GB di RAM
• 32: 32 vCPU, 256 GB di RAM
• 64: 64 vCPU, 512 GB di RAM
• 96: 96 vCPU, 768 GB di RAM
• 128: 128 vCPU, 864 GB di RAM

Per creare un'istanza C4A, utilizza il campo machine_type anziché cpu_count nella struttura machine_config, come mostrato nell'esempio seguente:

machine_config: {
  machine_type : MACHINE_TYPE,
},

Per la serie di macchine basate su Axion C4A, utilizza i seguenti valori validi:

• 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

Per la serie di macchine N2, i seguenti valori sono validi:

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

Utilizza il seguente metodo HTTP e URL:

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

Effettua le seguenti sostituzioni:

• PROJECT_ID: l'ID del progetto in cui vuoi che si trovi il cluster.
• LOCATION_ID: l'ID della regione del cluster.
• CLUSTER_ID: l'ID del cluster che crei. L'ID deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.
• INSTANCE_ID: il nome dell'istanza primaria che vuoi creare.

Puoi utilizzare curl per eseguire la richiesta, come mostrato nell'esempio seguente:

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