Gestire i gruppi di coerenza

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 unico 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

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. 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:

  1. Nella console Google Cloud, vai alla pagina Replicazione asincrona.

    Vai a Replica asincrona

  2. Fai clic sulla scheda Gruppi di coerenza.

  3. Fai clic su Crea gruppo con coerenza.

  4. Nel campo Nome, inserisci un nome per il gruppo di coerenza.

  5. 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.

  6. 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 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.

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:

  • 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.

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:

  1. Nella console Google Cloud, vai alla pagina Replicazione asincrona.

    Vai a Replica asincrona

  2. Fai clic sulla scheda Gruppi di coerenza.

  3. Fai clic sul nome del gruppo di coerenza per cui vuoi visualizzare i dischi. Viene visualizzata la pagina Gestisci gruppo con coerenza.

  4. 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 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 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.

REST

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 coerenza
  • ZONE: la zona dei dischi nel gruppo con coerenza
  • REGION: la regione dei dischi nel gruppo con coerenza
  • CONSISTENCY_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, lGoogle Cloud CLI o REST.

Console

Aggiungi i dischi a un gruppo con coerenza nel seguente modo:

  1. Nella console Google Cloud, vai alla pagina Replicazione asincrona.

    Vai a Replica asincrona

  2. Fai clic sulla scheda Gruppi di coerenza.

  3. Fai clic sul nome del gruppo di coerenza a cui vuoi aggiungere i dischi. Viene visualizzata la pagina Gestisci gruppo con coerenza.

  4. Fai clic su Assegna dischi. Viene visualizzata la pagina Assegna dischi.

  5. Seleziona i dischi da aggiungere al gruppo di coerenza.

  6. Fai clic su Assegna dischi. Quando richiesto, fai clic su Aggiungi.

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:

  • 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.

REST

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.

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:

  1. Nella console Google Cloud, vai alla pagina Replicazione asincrona.

    Vai a Replica asincrona

  2. Fai clic sulla scheda Gruppi di coerenza.

  3. Fai clic sul nome del gruppo di coerenza a cui vuoi aggiungere i dischi. Viene visualizzata la pagina Gestisci gruppo con coerenza.

  4. Seleziona i dischi che vuoi rimuovere dal gruppo di coerenza.

  5. Fai clic su Rimuovi dischi. Quando richiesto, fai clic su Rimuovi.

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:

  • DISK_NAME: il nome del disco da rimuovere dal gruppo con coerenza.
  • LOCATION_FLAG: il flag della 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.

REST

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"
}

  • 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"
}

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.

Console

Per eliminare una coerenza:

  1. Nella console Google Cloud, vai alla pagina Replicazione asincrona.

    Vai a Replica asincrona

  2. Fai clic sulla scheda Gruppi di coerenza.

  3. Seleziona il gruppo con coerenza che vuoi eliminare.

  4. Fai clic su Elimina. Si apre la finestra Elimina gruppo con coerenza.

  5. Fai clic su Elimina.

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:

  • CONSISTENCY_GROUP: il nome del gruppo con coerenza
  • REGION: la regione del gruppo con 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 con coerenza
  • CONSISTENCY_GROUP: il nome del gruppo con coerenza

Passaggi successivi