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 è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi 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:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
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.
CONSISTENCY_GROUP_NAME
: il nome del gruppo con 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.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 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 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.
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 in corso. 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 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
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 coerenzaNella 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.
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 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" }
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
.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.
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 zonale da un gruppo con coerenza:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/LOCATION/disks/DISK_NAME/removeResourcePolicies { "resourcePolicies": "CONSISTENCY_GROUP" }
Per rimuovere 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" }
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
.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.
CONSISTENCY_GROUP
: il nome del gruppo con coerenzaREGION
: la regione del gruppo con coerenzaPROJECT
: il progetto che contiene il gruppo di coerenzaREGION
: la regione del gruppo con coerenzaCONSISTENCY_GROUP
: il nome del gruppo con coerenza- 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.
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 sull'autenticazione di Google Cloud.
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 o REST.
Console
Per creare un gruppo con coerenza:
gcloud
Crea un gruppo di coerenza utilizzando il comando
gcloud compute resource-policies create disk-consistency-group
:gcloud compute resource-policies create disk-consistency-group CONSISTENCY_GROUP_NAME \ --region=REGION
Sostituisci quanto segue:
REST
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:
Visualizzare i dischi in un gruppo con coerenza
Visualizza i dischi in un gruppo di coerenza utilizzando la console Google Cloud, lGoogle Cloud CLI o REST.
Console
Per visualizzare i dischi inclusi in un gruppo di coerenza:
gcloud
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:
REST
Visualizza i dischi in un gruppo di coerenza utilizzando un filtro di query con uno dei seguenti metodi:
Sostituisci quanto segue:
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, lGoogle Cloud CLI o REST.
Console
Aggiungi i dischi a un gruppo di coerenza nel seguente modo:
gcloud
Aggiungi un disco a un gruppo di coerenza utilizzando il comando
gcloud compute disks add-resource-policies
:gcloud compute disks add-resource-policies DISK_NAME \ --LOCATION_FLAG=LOCATION \ --resource-policies=CONSISTENCY_GROUP
Sostituisci quanto segue:
REST
Aggiungi i dischi a un gruppo di coerenza utilizzando uno dei seguenti metodi:
Sostituisci quanto segue:
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 con coerenza utilizzando la console Google Cloud, lGoogle Cloud CLI o REST.
Console
Per rimuovere i dischi principali da un gruppo con coerenza:
gcloud
Rimuovi un disco da un gruppo con coerenza utilizzando il comando
gcloud compute disks remove-resource-policies
:gcloud compute disks remove-resource-policies DISK_NAME \ --LOCATION_FLAG=LOCATION \ --resource-policies=CONSISTENCY_GROUP
Sostituisci quanto segue:
REST
Rimuovi un disco da un gruppo con coerenza utilizzando il metodo
disks.removeResourcePolicies
per i dischi a livello di zona o il metodoregionDisks.removeResourcePolicies
per i dischi a livello di regione.Sostituisci quanto segue:
Elimina un gruppo con coerenza
Elimina un gruppo di coerenza utilizzando la console Google Cloud, Google Cloud CLI o REST.
Console
Per eliminare una coerenza:
gcloud
Elimina il criterio delle risorse utilizzando il comando
gcloud compute resource-policies delete
:gcloud compute resource-policies delete CONSISTENCY_GROUP \ --region=REGION
Sostituisci quanto segue:
REST
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:
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-12-22 UTC.
-