Questo documento descrive come gestire i gruppi di coerenza. I gruppi di coerenza sono criteri di risorse che allineano la replica su più dischi nella stessa regione o zona.
Per saperne di più sui gruppi di coerenza, consulta Informazioni sulla replica asincrona dei dischi permanenti.
Limitazioni
- I gruppi di coerenza non sono supportati per i dischi nei nodi single-tenant.
- I gruppi di coerenza possono avere un massimo di 128 dischi.
- Tutti i dischi di un gruppo con coerenza devono trovarsi nello stesso progetto del piano di risorse del gruppo con coerenza.
- Tutti i dischi di un gruppo con coerenza devono trovarsi nella stessa zona, per i dischi zonali, o nella stessa coppia di zone, per i dischi regionali.
- Un gruppo di coerenza può contenere dischi principali o secondari, ma non entrambi.
- Non puoi aggiungere o rimuovere un disco principale da o in un gruppo di coerenza durante la replica del disco. Se vuoi aggiungere o rimuovere un disco principale da un gruppo di coerenza o in un gruppo di coerenza, devi prima interrompere la replica. Puoi aggiungere o rimuovere dischi secondari dai gruppi di coerenza in qualsiasi momento.
- Puoi collegare a una VM un massimo di 16 dischi che appartengono a gruppi di coerenza diversi o che non fanno parte di un gruppo di coerenza. I dischi nello stesso gruppo di coerenza vengono conteggiati come un disco ai fini del limite di 16 dischi.
Prima di iniziare
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API. Google Cloud
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:
Select the tab for how you plan to use the samples on this page:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
Terraform
Per utilizzare gli esempi di Terraform in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le credenziali predefinite dell'applicazione con le tue credenziali utente.
Per ulteriori informazioni, consulta Set up authentication for a local development environment.
REST
Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione Google Cloud sull'autenticazione.
-
Crea un gruppo con coerenza
Se devi allineare la replica su più dischi, crea un gruppo con coerenza nella stessa regione dei dischi principali. Se devi allineare i cloni dei dischi, crea un gruppo con coerenza nella stessa regione dei dischi secondari.
Crea un gruppo di coerenza utilizzando la console Google Cloud, Google Cloud CLI, REST o Terraform.
Per creare un gruppo con coerenza:
Nella console Google Cloud, vai alla pagina Replicazione asincrona.
Fai clic sulla scheda Gruppi di coerenza.
Fai clic su Crea gruppo con coerenza.
Nel campo Nome, inserisci un nome per il gruppo di coerenza.
Nel campo Regione, seleziona la regione in cui si trovano i dischi. Se vuoi aggiungere dischi principali al gruppo con coerenza, seleziona la regione principale. Se vuoi aggiungere dischi secondari al gruppo di coerenza, seleziona la regione secondaria.
Fai clic su Crea.
Crea un gruppo di coerenza utilizzando il
comando gcloud compute resource-policies create disk-consistency-group
:
gcloud compute resource-policies create disk-consistency-groupCONSISTENCY_GROUP_NAME \ --region=REGION
Sostituisci quanto segue:
CONSISTENCY_GROUP_NAME
: il nome del gruppo di coerenza.REGION
: la regione per il gruppo con coerenza. Se vuoi aggiungere dischi principali al gruppo con coerenza, utilizza la regione principale. Se vuoi aggiungere dischi secondari al gruppo con coerenza, utilizza la regione secondaria.
Crea un gruppo con coerenza utilizzando il
metodo resourcePolicies.insert
:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT /regions/REGION /resourcePolicies { "name": "CONSISTENCY_GROUP_NAME ", "diskConsistencyGroupPolicy": { } }
Sostituisci quanto segue:
PROJECT
: il progetto che contiene il gruppo con coerenza.REGION
: la regione per il gruppo con coerenza. Se vuoi aggiungere dischi principali al gruppo di coerenza, utilizza la stessa regione dei dischi principali. Se vuoi aggiungere dischi secondari al gruppo di coerenza, utilizza la stessa regione dei dischi secondari.CONSISTENCY_GROUP_NAME
: il nome del gruppo di coerenza.
Per creare un gruppo con coerenza, utilizza la risorsa compute_resource_policy
.
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
Visualizzare i dischi in un gruppo con coerenza
Visualizza i dischi in un gruppo di coerenza utilizzando la console Google Cloud, l'interfaccia a riga di comando Google Cloud o REST.
Per visualizzare i dischi inclusi in un gruppo di coerenza:
Nella console Google Cloud, vai alla pagina Replicazione asincrona.
Fai clic sulla scheda Gruppi di coerenza.
Fai clic sul nome del gruppo di coerenza per cui vuoi visualizzare i dischi. Viene visualizzata la pagina Gestisci gruppo con coerenza.
Visualizza la sezione Membri del gruppo di coerenza per vedere tutti i dischi inclusi nel gruppo di coerenza.
Visualizza i dischi inclusi in un gruppo con coerenza utilizzando il
comando gcloud compute disks list
:
gcloud compute disks list \ --LOCATION_FLAG =LOCATION \ --filter=resourcePolicies=CONSISTENCY_GROUP_NAME
Sostituisci quanto segue:
LOCATION_FLAG
: il flag della posizione per i dischi nel gruppo di coerenza. Se i dischi nel gruppo di coerenza sono a livello di regione, utilizza--region
. Se i dischi nel gruppo di coerenza sono zonali, utilizza--zone
.LOCATION
: la regione o la zona dei dischi nel gruppo con coerenza. Per i dischi regionali, utilizza la regione. Per i dischi zonali, utilizza la zona.CONSISTENCY_GROUP_NAME
: il nome del gruppo con coerenza.
Visualizza i dischi in un gruppo di coerenza utilizzando un filtro di query con uno dei seguenti metodi:
Visualizza i dischi zonali in un gruppo di coerenza utilizzando il metodo
disks.get
:GET https://compute.googleapis.com/compute/v1/projects/
PROJECT /zones/ZONE /disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME Visualizza i dischi regionali in un gruppo di coerenza utilizzando il metodo
regionDisks.get
:GET https://compute.googleapis.com/compute/v1/projects/
PROJECT /regions/REGION /disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME
Sostituisci quanto segue:
PROJECT
: il progetto che contiene il gruppo di coerenzaZONE
: la zona dei dischi nel gruppo con coerenzaREGION
: la regione dei dischi nel gruppo con coerenzaCONSISTENCY_GROUP_NAME
: il nome del gruppo di coerenza
Aggiungere un disco a un gruppo con coerenza
Se vuoi aggiungere dischi principali a un gruppo di coerenza, devi aggiungerli al gruppo di coerenza prima di avviare la replica. Puoi aggiungere dischi secondari a un gruppo di coerenza in qualsiasi momento. Tutti i dischi di un gruppo con coerenza devono trovarsi nella stessa zona, per i dischi zonali, o nella stessa coppia di zone, per i dischi regionali.
Aggiungi un disco a un gruppo di coerenza utilizzando la console Google Cloud, gcloud CLI, REST o Terraform.
Aggiungi i dischi a un gruppo di coerenza nel seguente modo:
Nella console Google Cloud, vai alla pagina Replicazione asincrona.
Fai clic sulla scheda Gruppi di coerenza.
Fai clic sul nome del gruppo di coerenza a cui vuoi aggiungere i dischi. Viene visualizzata la pagina Gestisci gruppo con coerenza.
Fai clic su Assegna dischi. Viene visualizzata la pagina Assegna dischi.
Seleziona i dischi da aggiungere al gruppo di coerenza.
Fai clic su Assegna dischi. Quando richiesto, fai clic su Aggiungi.
Aggiungi un disco a un gruppo di coerenza utilizzando il
comando gcloud compute disks add-resource-policies
:
gcloud compute disks add-resource-policiesDISK_NAME \ --LOCATION_FLAG =LOCATION \ --resource-policies=CONSISTENCY_GROUP
Sostituisci quanto segue:
DISK_NAME
: il nome del disco da aggiungere al gruppo con coerenza.LOCATION_FLAG
: il flag di posizione del disco. Per un disco regionale, utilizza--region
. Per un disco zonale, utilizza--zone
.LOCATION
: la regione o la zona del disco. Per i dischi regionali, utilizza la regione. Per i dischi zonali, utilizza la zona.CONSISTENCY_GROUP
: l'URL del gruppo di coerenza. Ad esempio,projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME
.
Aggiungi i dischi a un gruppo di coerenza utilizzando uno dei seguenti metodi:
Aggiungi i dischi zonali a un gruppo di coerenza utilizzando il metodo
disks.addResourcePolicies
:POST https://compute.googleapis.com/compute/v1/projects/
PROJECT /zones/LOCATION /disks/DISK_NAME /addResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP " }Aggiungi dischi regionali a un gruppo di coerenza utilizzando il metodo
regionDisks.addResourcePolicies
:POST https://compute.googleapis.com/compute/v1/projects/
PROJECT /regions/LOCATION /disks/DISK_NAME /addResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP " }
Sostituisci quanto segue:
PROJECT
: il progetto che contiene il disco.LOCATION
: la zona o la regione del disco. Per i dischi zonali, utilizza la zona. Per i dischi regionali, utilizza la regione.DISK_NAME
: il nome del disco da aggiungere al gruppo con coerenza.CONSISTENCY_GROUP
: l'URL del gruppo di coerenza. Ad esempio,projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME
.
Per aggiungere il disco al gruppo di coerenza, utilizza la risorsa compute_disk_resource_policy_attachment
.
In caso di disco regionale, specifica la regione al posto della zona.
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
Rimuovere un disco da un gruppo con coerenza
Prima di poter rimuovere un disco da un gruppo con coerenza, devi interrompere la replica per il disco.
Rimuovi un disco da un gruppo di coerenza utilizzando la console Google Cloud, l'interfaccia a riga di comando Google Cloud o REST.
Per rimuovere i dischi principali da un gruppo con coerenza:
Nella console Google Cloud, vai alla pagina Replicazione asincrona.
Fai clic sulla scheda Gruppi di coerenza.
Fai clic sul nome del gruppo di coerenza a cui vuoi aggiungere i dischi. Viene visualizzata la pagina Gestisci gruppo con coerenza.
Seleziona i dischi che vuoi rimuovere dal gruppo di coerenza.
Fai clic su Rimuovi dischi. Quando richiesto, fai clic su Rimuovi.
Rimuovi un disco da un gruppo con coerenza utilizzando il
comando gcloud compute disks remove-resource-policies
:
gcloud compute disks remove-resource-policiesDISK_NAME \ --LOCATION_FLAG =LOCATION \ --resource-policies=CONSISTENCY_GROUP
Sostituisci quanto segue:
DISK_NAME
: il nome del disco da rimuovere dal gruppo con coerenza.LOCATION_FLAG
: il flag di posizione del disco. Per un disco regionale, utilizza--region
. Per un disco zonale, utilizza--zone
.LOCATION
: la regione o la zona del disco. Per i dischi regionali, utilizza la regione. Per i dischi zonali, utilizza la zona.CONSISTENCY_GROUP
: l'URL del gruppo di coerenza. Ad esempio,projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME
.
Rimuovi un disco da un gruppo con coerenza utilizzando il
metodo disks.removeResourcePolicies
per i dischi a livello di zona o il
metodo regionDisks.removeResourcePolicies
per i dischi a livello di regione.
Per rimuovere un disco zonale da un gruppo con coerenza:
POST https://compute.googleapis.com/compute/v1/projects/
PROJECT /zones/LOCATION /disks/DISK_NAME /removeResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP " }Rimuovi un disco regionale da un gruppo con coerenza:
POST https://compute.googleapis.com/compute/v1/projects/
PROJECT /regions/LOCATION /disks/DISK_NAME /removeResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP " }
Sostituisci quanto segue:
PROJECT
: il progetto che contiene il disco.LOCATION
: la zona o la regione del disco. Per i dischi zonali, utilizza la zona. Per i dischi regionali, utilizza la regione.DISK_NAME
: il nome del disco da rimuovere dal gruppo con coerenza.CONSISTENCY_GROUP
: l'URL del gruppo di coerenza. Ad esempio,projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME
.
Elimina un gruppo con coerenza
Elimina un gruppo di coerenza utilizzando la console Google Cloud, Google Cloud CLI o REST.
Per eliminare una coerenza:
Nella console Google Cloud, vai alla pagina Replicazione asincrona.
Fai clic sulla scheda Gruppi di coerenza.
Seleziona il gruppo di coerenza che vuoi eliminare.
Fai clic su Elimina. Si apre la finestra Elimina gruppo con coerenza.
Fai clic su Elimina.
Elimina il criterio delle risorse utilizzando il
comando gcloud compute resource-policies delete
:
gcloud compute resource-policies deleteCONSISTENCY_GROUP \ --region=REGION
Sostituisci quanto segue:
CONSISTENCY_GROUP
: il nome del gruppo con coerenzaREGION
: la regione del gruppo con coerenza
Elimina una coerenza utilizzando il
metodo resourcePolicies.delete
:
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT /regions/REGION /resourcePolicies/CONSISTENCY_GROUP_NAME
Sostituisci quanto segue:
PROJECT
: il progetto che contiene il gruppo di coerenzaREGION
: la regione del gruppo con coerenzaCONSISTENCY_GROUP
: il nome del gruppo con coerenza
Passaggi successivi
- Scopri come gestire i dischi che utilizzano la replica asincrona di PD.
- Scopri come eseguire il failover e il failback.
- Scopri come monitorare le prestazioni della replica asincrona dei dischi permanenti.