Questa pagina è stata tradotta dall'API Cloud Translation.

Crea un'istanza principale

Questa pagina descrive come creare l'istanza principale in un cluster AlloyDB.

Prima di iniziare

Il Google Cloud progetto che utilizzi deve essere stato abilitato per accedere ad AlloyDB.
Devi disporre di uno di questi ruoli IAM nel progetto Google Cloud che stai utilizzando:
- roles/alloydb.admin (il ruolo IAM predefinito AlloyDB Admin)
- roles/owner (il ruolo IAM di base Proprietario)
- roles/editor (il ruolo IAM di base Editor)
Se non disponi di nessuno di questi ruoli, contatta l'Amministratore organizzazione per richiedere l'accesso.

Crea un'istanza principale AlloyDB

Console

Vai alla pagina Cluster.

Vai a Cluster
Fai clic su un cluster nella colonna Nome risorsa.
Nella pagina Panoramica, vai a Istanze nel cluster e fai clic su Crea istanza primaria.
Configura l'istanza principale:
1. Nel campo ID istanza, inserisci un ID per l'istanza principale.
2. In Disponibilità a livello di zona, seleziona una delle seguenti opzioni:
  1. Per creare un'istanza di produzione ad alta disponibilità con failover automatico, seleziona Più zone (alta disponibilità).
  2. Per creare un'istanza di base che non deve essere a disponibilità elevata, seleziona Zona singola.
3. 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.
4. 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.
5. (Facoltativo) Per connettere applicazioni e client tramite la rete internet pubblica, seleziona la casella Abilita IP pubblico in Connettività IP pubblico. L'attivazione dell'IP pubblico potrebbe richiedere un'ulteriore configurazione per garantire una connessione sicura. Per ulteriori informazioni, vedi Connettersi utilizzando l'IP pubblico.
  
  Per impostazione predefinita, l'IP privato è sempre abilitato. Per ulteriori informazioni, vedi Attivare l'accesso privato ai servizi.
6. (Facoltativo) Per attivare e utilizzare il pool di connessioni gestito, seleziona la casella Abilita pool di connessioni gestito in Pool di connessioni gestito. Per ulteriori informazioni, vedi Configurare il pool di connessioni gestito.
7. (Facoltativo) Per impostare flag personalizzati per la tua istanza, espandi Opzioni di configurazione avanzate, poi segui questi passaggi per ogni flag:
  1. Fai clic su Aggiungi flag.
  2. Seleziona un flag dall'elenco Nuovo flag database.
  3. Specifica un valore per il flag.
  4. Fai clic su Fine.
8. (Facoltativo) Per configurare i requisiti SSL o del connettore sull'istanza, espandi Opzioni di configurazione avanzata, quindi procedi nel seguente modo:
  1. Per impostazione predefinita, le istanze AlloyDB richiedono che tutte le connessioni utilizzino la crittografia SSL. Per consentire connessioni non SSL, deseleziona la casella di controllo Consenti solo connessioni SSL.
  2. Per richiedere che tutte le connessioni al database all'istanza utilizzino il proxy di autenticazione AlloyDB o le librerie di connettori sicuri fornite da Google, seleziona Richiedi connettori.
Fai clic su Crea istanza.

gcloud

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

Utilizza il comando gcloud alloydb instances create per creare un'istanza primaria.

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

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 esegui il deployment di macchine N2. Per eseguire il deployment della serie di macchine basate su Axion C4A (anteprima) o per eseguire la migrazione tra macchine C4A e N2, scegli questo parametro con i seguenti valori.

Nota: esegui il deployment di C4A 1 vCPU solo per i workload di sviluppo e sandbox. 1 vCPU non ha il suffisso lssd. Puoi anche scegliere di utilizzare solo CPU_COUNTper il deployment di C4A 1 vCPU.

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 C4A basata su Axion, 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 basate su x86 N2, utilizza 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
  
  Nota :quando utilizzi i deployment N2, puoi scegliere di utilizzare solo il parametro CPU_COUNT.
AVAILABILITY: indica se questa istanza deve essere ad alta affidabilità, con nodi in più zone. I valori validi includono:
- REGIONAL: crea un'istanza HA con nodi attivo e di standby separati e failover automatico tra di loro. Questo è il valore predefinito, adatto agli ambienti di produzione.
- ZONAL: crea un'istanza di base, contenente un solo nodo e nessun failover automatico.
REGION_ID: la regione in cui vuoi posizionare l'istanza. Ad esempio, us-central1.
CLUSTER_ID: l'ID del cluster in cui vuoi inserire l'istanza.
PROJECT_ID: l'ID del progetto in cui si trova il cluster.

Per applicare un intervallo di indirizzi IP specifico a questa istanza, anziché consentire ad AlloyDB di scegliere un intervallo di indirizzi IP, 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.

Per impostazione predefinita, le nuove istanze richiedono che tutte le connessioni utilizzino la crittografia SSL. Per consentire connessioni non SSL all'istanza, aggiungi il flag --ssl-mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED al comando:

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 \
  --ssl-mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED

Per forzare una connessione sicura tra il client e un'istanza AlloyDB tramite il proxy di autenticazione o altre applicazioni che utilizzano librerie di connettori fornite da Google, aggiungi il flag --require-connectors al comando:

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 \
  --require-connectors

Per abilitare il pool di connessioni gestito nell'istanza AlloyDB, aggiungi il flag --enable-connection-pooling al comando gcloud alpha alloydb instances create:

gcloud alpha alloydb instances create INSTANCE_ID \
  --instance-type=PRIMARY \
  --cpu-count=CPU_COUNT \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --project=PROJECT_ID \
  --enable-connection-pooling

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'istanza all'interno del cluster di database, utilizza una risorsa Terraform.

resource "google_alloydb_instance" "default" {
  cluster       = google_alloydb_cluster.default.name
  instance_id   = "alloydb-instance"
  instance_type = "PRIMARY"

  machine_config {
    cpu_count = 2
  }

  network_config {
    allocated_ip_range_override = google_compute_global_address.private_ip_alloc_2.name
  }

  depends_on = [google_service_networking_connection.vpc_connection]
}

resource "google_alloydb_cluster" "default" {
  cluster_id = "alloydb-cluster"
  location   = "us-central1"
  network_config {
    network = google_compute_network.default.id
    allocated_ip_range = google_compute_global_address.private_ip_alloc_1.name
  }

  initial_user {
    password = "alloydb-cluster"
  }
}

data "google_project" "project" {}

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

resource "google_compute_global_address" "private_ip_alloc" {
  name          =  "alloydb-address-range-1"
  address_type  = "INTERNAL"
  purpose       = "VPC_PEERING"
  prefix_length = 16
  network       = google_compute_network.default.id
}

resource "google_compute_global_address" "private_ip_alloc_2" {
  name          =  "alloydb-address-range-2"
  address_type  = "INTERNAL"
  purpose       = "VPC_PEERING"
  prefix_length = 16
  network       = google_compute_network.default.id
}

resource "google_service_networking_connection" "vpc_connection" {
  network                 = google_compute_network.default.id
  service                 = "servicenetworking.googleapis.com"
  reserved_peering_ranges = [google_compute_global_address.private_ip_alloc_1.name,google_compute_global_address.private_ip_alloc_2.name]
}

Prepara Cloud Shell

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

Avvia Cloud Shell.
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.

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
```
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.
```
git clone https://github.com/terraform-google-modules/terraform-docs-samples
```
Nella directory terraform-docs-samples, vai alla directory alloydb.
```
cd terraform-docs-samples/alloydb
```
Copia il codice campione nel main.tf appena creato.
```
cp SAMPLE_FILE
```
Sostituisci <var>SAMPLE_FILE</var> con il nome del file di esempio da copiare, ad esempio main.tf.
Rivedi e modifica i parametri di esempio da applicare al tuo ambiente.
Salva le modifiche.
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

Rivedi la configurazione per verificare che gli aggiornamenti di Terraform corrispondano alle tue aspettative:
```
terraform plan
```
Apporta le correzioni necessarie alla configurazione.
Applica la configurazione di Terraform eseguendo il comando seguente e inserendo yes al prompt:
```
terraform apply
```
Attendi che Terraform visualizzi il messaggio Apply complete!.

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

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. Questa operazione viene eseguita automaticamente, se appropriato, ad esempio nei file di log.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

CLUSTER_ID: l'ID del cluster che crei. Deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.
PROJECT_ID: l'ID del progetto in cui vuoi posizionare il cluster.
LOCATION_ID: l'ID della regione del cluster.
INSTANCE_ID: il nome dell'istanza primaria che vuoi creare.
vCPU_COUNT: il numero di core della CPU visibili nell'istanza che vuoi creare.

Il corpo JSON della richiesta ha il seguente aspetto:

{
  instanceId   = "INSTANCE_ID"
  instanceType = "PRIMARY"
  machineConfig {
    cpuCount = vCPU_COUNT
  }
  databaseFlags = {
    "key1" : "value1",
    "key2" : "value2"
  }
}

Per inviare la richiesta, salva il corpo della richiesta in un file denominato request.json e utilizza la seguente richiesta POST:

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