Gestisci gruppi di coerenza

Questo documento descrive come gestire i gruppi di coerenza. I gruppi di coerenza sono criteri delle risorse che allineano la replica su più dischi nella stessa regione o zona.

Per scoprire di più sui gruppi di coerenza, consulta Informazioni sulla replica asincrona del disco permanente.

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 di coerenza devono trovarsi nello stesso progetto del criterio delle risorse del gruppo di coerenza.
Tutti i dischi di un gruppo di coerenza devono trovarsi nella stessa zona, per i dischi a livello di zona, o nella stessa coppia di zone, per i dischi a livello di regione.
Un gruppo di coerenza può contenere dischi primari o dischi secondari, ma non entrambi.
Non puoi aggiungere o rimuovere un disco primario da o verso un gruppo di coerenza durante la replica del disco. Se vuoi aggiungere o rimuovere un disco primario da o verso un gruppo di coerenza, devi prima interrompere la replica. Puoi aggiungere o rimuovere dischi secondari a o dai gruppi di coerenza in qualsiasi momento.
Puoi collegare a una VM un massimo di 16 dischi appartenenti a gruppi di coerenza diversi o dischi che non fanno parte di un gruppo di coerenza. I dischi che si trovano nello stesso gruppo di coerenza vengono conteggiati come un solo disco per il limite di 16 dischi.

Prima di iniziare

Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.

Seleziona la scheda relativa a come prevedi di utilizzare gli esempi in questa pagina:
Console

Quando utilizzi la console Google Cloud per accedere ai servizi e alle API di Google Cloud, non devi configurare l'autenticazione.
gcloud
1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
```
gcloud init
```
  Nota: se hai già installato gcloud CLI in precedenza, assicurati di disporre della versione più recente eseguendo gcloud components update.
2. Imposta una regione e una zona predefinite.
REST

Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.

Crea un gruppo con coerenza

Se devi allineare la replica su più dischi, crea un gruppo di coerenza nella stessa regione dei dischi primari. Se devi allineare i cloni dei dischi, crea un gruppo di coerenza nella stessa regione dei dischi secondari.

Crea un gruppo di coerenza utilizzando la console Google Cloud, Google Cloud CLI o REST.

Console

Crea un gruppo di coerenza procedendo nel seguente modo:

Nella console Google Cloud, vai alla pagina Replica asincrona.

Vai alla replica asincrona
Fai clic sulla scheda Gruppi di coerenza.
Fai clic su Crea gruppo di coerenza.
Nel campo Nome, inserisci un nome per il gruppo di coerenza.
Nel campo Regione, seleziona la regione in cui si trovano i tuoi dischi. Se vuoi aggiungere dischi primari al gruppo di coerenza, seleziona la regione principale. Se vuoi aggiungere dischi secondari al gruppo di coerenza, seleziona la regione secondaria.
Fai clic su Crea.

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:

CONSISTENCY_GROUP_NAME: il nome del gruppo di coerenza.
REGION: la regione del gruppo di coerenza. Se vuoi aggiungere dischi primari al gruppo di coerenza, utilizza l'area geografica principale. Se vuoi aggiungere dischi secondari al gruppo di coerenza, utilizza la regione secondaria.

REST

Crea un gruppo di 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 di coerenza.
REGION: la regione del gruppo di coerenza. Se vuoi aggiungere dischi primari al gruppo di coerenza, utilizza la stessa regione dei dischi primari. 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.

Visualizza i dischi in un gruppo di coerenza

Visualizza i dischi in un gruppo di coerenza utilizzando la console Google Cloud, Google Cloud CLI o REST.

Console

Visualizza i dischi inclusi in un gruppo di coerenza nel seguente modo:

Nella console Google Cloud, vai alla pagina Replica asincrona.

Vai alla replica asincrona
Fai clic sulla scheda Gruppi di coerenza.
Fai clic sul nome del gruppo di coerenza di cui vuoi visualizzare i dischi. Viene visualizzata la pagina Gestisci gruppo di coerenza.
Visualizza la sezione Membri del gruppo di coerenza per vedere tutti i dischi inclusi nel gruppo di coerenza.

gcloud

Visualizza i dischi inclusi in un gruppo di 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 località per i dischi nel gruppo di coerenza. Se i dischi nel gruppo di coerenza sono a livello di regione, utilizza --region. Se i dischi del gruppo di coerenza sono a livello di zona, utilizza --zone.
LOCATION: la regione o la zona dei dischi nel gruppo di coerenza. Per i dischi regionali, utilizza la regione. Per i dischi a livello di zona, utilizza la zona.
CONSISTENCY_GROUP_NAME: il nome del gruppo di coerenza.

REST

Visualizza i dischi in un gruppo di coerenza utilizzando un filtro di query con uno dei seguenti metodi:

Visualizza i dischi di zona 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 coerenza
ZONE: la zona dei dischi nel gruppo di coerenza
REGION: la regione dei dischi nel gruppo di coerenza
CONSISTENCY_GROUP_NAME: il nome del gruppo di coerenza

Aggiungi un disco a un gruppo di coerenza

Se vuoi aggiungere dischi primari a un gruppo di coerenza, devi aggiungere dischi 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 di coerenza devono trovarsi nella stessa zona, per i dischi a livello di zona, o nella stessa coppia di zone, per i dischi a livello di regione.

Aggiungi un disco a un gruppo di coerenza utilizzando la console Google Cloud, Google Cloud CLI o REST.

Console

Aggiungi dischi a un gruppo di coerenza nel seguente modo:

Nella console Google Cloud, vai alla pagina Replica asincrona.

Vai alla replica asincrona
Fai clic sulla scheda Gruppi di coerenza.
Fai clic sul nome del gruppo di coerenza a cui vuoi aggiungere dischi. Viene visualizzata la pagina Gestisci gruppo di 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.

gcloud

Aggiungi un disco a un gruppo di coerenza utilizzando il gcloud compute disks add-resource-policiescomando:

gcloud compute disks add-resource-policies DISK_NAME \
    --LOCATION_FLAG=LOCATION \
    --resource-policies=CONSISTENCY_GROUP

Sostituisci quanto segue:

DISK_NAME: il nome del disco da aggiungere al gruppo di coerenza.
LOCATION_FLAG: flag della località per il disco. Per un disco a livello di regione, utilizza --region. Per un disco di zona, utilizza --zone.
LOCATION: la regione o la zona del disco. Per i dischi regionali, utilizza la regione. Per i dischi a livello di zona, utilizza la zona.
CONSISTENCY_GROUP: l'URL del gruppo di coerenza. Ad esempio, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME.

REST

Aggiungi dischi a un gruppo di coerenza utilizzando uno dei seguenti metodi:

Aggiungi dischi di zona 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 a livello di regione 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 a livello di zona, utilizza la zona. Per i dischi regionali, utilizza la regione.
DISK_NAME: il nome del disco da aggiungere al gruppo di coerenza.
CONSISTENCY_GROUP: l'URL del gruppo di coerenza. Ad esempio, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME.

Rimuovi un disco da un gruppo di coerenza

Prima di poter rimuovere un disco da un gruppo di coerenza, devi interrompere la replica del disco.

Rimuovi un disco da un gruppo di coerenza utilizzando la console Google Cloud, Google Cloud CLI o REST.

Console

Rimuovi i dischi primari da un gruppo di coerenza nel seguente modo:

Nella console Google Cloud, vai alla pagina Replica asincrona.

Vai alla replica asincrona
Fai clic sulla scheda Gruppi di coerenza.
Fai clic sul nome del gruppo di coerenza a cui vuoi aggiungere dischi. Viene visualizzata la pagina Gestisci gruppo di coerenza.
Seleziona i dischi da rimuovere dal gruppo di coerenza.
Fai clic su Rimuovi dischi. Quando richiesto, fai clic su Rimuovi.

gcloud

Rimuovi un disco da un gruppo di 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:

DISK_NAME: il nome del disco da rimuovere dal gruppo di coerenza.
LOCATION_FLAG: flag della località per il disco. Per un disco a livello di regione, utilizza --region. Per un disco di zona, utilizza --zone.
LOCATION: la regione o la zona del disco. Per i dischi regionali, utilizza la regione. Per i dischi a livello di zona, utilizza la zona.
CONSISTENCY_GROUP: l'URL del gruppo di coerenza. Ad esempio, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME.

REST

Rimuovi un disco da un gruppo di coerenza utilizzando il metodo disks.removeResourcePolicies per i dischi di zona o il metodo regionDisks.removeResourcePolicies per i dischi a livello di regione.

Rimuovi un disco di zona da un gruppo di coerenza:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/LOCATION/disks/DISK_NAME/removeResourcePolicies

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

Rimuovi un disco di regione da un gruppo di 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 a livello di zona, utilizza la zona. Per i dischi regionali, utilizza la regione.
DISK_NAME: il nome del disco da rimuovere dal gruppo di 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.

Console

Elimina una coerenza procedendo nel seguente modo:

Nella console Google Cloud, vai alla pagina Replica asincrona.

Vai alla replica asincrona
Fai clic sulla scheda Gruppi di coerenza.
Seleziona il gruppo di coerenza che vuoi eliminare.
Fai clic su Elimina. Viene visualizzata la finestra Elimina gruppo di coerenza.
Fai clic su Elimina.

gcloud

Elimina il criterio della risorsa utilizzando il comando gcloud compute resource-policies delete:

gcloud compute resource-policies delete CONSISTENCY_GROUP \
    --region=REGION

Sostituisci quanto segue:

CONSISTENCY_GROUP: il nome del gruppo di coerenza
REGION: la regione del gruppo di coerenza

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:

PROJECT: il progetto che contiene il gruppo di coerenza
REGION: la regione del gruppo di coerenza
CONSISTENCY_GROUP: il nome del gruppo di coerenza

Passaggi successivi

Scopri come gestire i dischi che utilizzano la replica asincrona dei DP.
Scopri come eseguire il failover e il failover.
Scopri come monitorare le prestazioni della replica asincrona del disco permanente.