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 primario per da un gruppo di coerenza, devi prima interrompi la replica. Puoi aggiungere o rimuovere dischi secondari dai gruppi di coerenza in qualsiasi momento.
  • Puoi collegare al massimo 16 dischi si trovano in gruppi di coerenza diversi, o dischi che non fanno parte di un gruppo di coerenza su una VM. 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 già fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine come segue.

    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, vedi Esegui 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 oppure REST.

Console

Crea un gruppo di coerenza seguendo questi passaggi:

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

    Vai a Replica asincrona

  2. Fai clic sulla scheda Gruppi con 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 tuoi dischi. Se vuoi aggiungere dischi primari al gruppo di coerenza, seleziona la regione principale. Se vuoi aggiungere dischi secondari alla coerenza gruppo, 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 di coerenza. Se vuoi aggiungere dischi primari al gruppo di coerenza, utilizza il modello regione. Se vuoi aggiungere dischi secondari al gruppo di coerenza, utilizza la regione secondaria.

REST

Crea un gruppo di coerenza utilizzando 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 di coerenza. Se vuoi aggiungere dischi primari al gruppo di coerenza, usa la stessa regione sui dischi primari. Se vuoi aggiungere dischi secondari alla 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, Google Cloud CLI o REST.

Console

Per visualizzare i dischi inclusi in un gruppo di coerenza:

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

    Vai alla replica asincrona

  2. Fai clic sulla scheda Gruppi con 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 in il gruppo di coerenza. Se i dischi nel gruppo di coerenza sono a livello di regione, usa --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 di 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 la coerenza gruppo
  • 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 primari a un gruppo di coerenza, devi aggiungerli a il 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, l'interfaccia a riga di comando Google Cloud o REST.

Console

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

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

    Vai alla replica asincrona

  2. Fai clic sulla scheda Gruppi con coerenza.

  3. Fai clic sul nome del gruppo di coerenza a cui vuoi aggiungere i dischi. Si apre la pagina Gestisci gruppo di coerenza.

  4. Fai clic su Assegna dischi. Si apre 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 metodo 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 con coerenza.
  • LOCATION_FLAG: il flag della posizione del disco. Per un disco regionale, 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 zonali, 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 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 a livello di zona, usa 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.

Rimuovi un disco da un gruppo di 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, l'interfaccia a riga di comando Google Cloud o REST.

Console

Per rimuovere i dischi principali da un gruppo con coerenza:

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

    Vai alla replica asincrona

  2. Fai clic sulla scheda Gruppi con coerenza.

  3. Fai clic sul nome del gruppo di coerenza a cui vuoi aggiungere i dischi. Si apre la pagina Gestisci gruppo di 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 dalla gruppo di coerenza.
  • LOCATION_FLAG: il flag della posizione del disco. Per un disco di una regione, usa --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 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 di coerenza utilizzando il metodo Metodo disks.removeResourcePolicies per i dischi a livello di zona 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"
}

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

Console

Elimina una coerenza procedendo nel seguente modo:

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

    Vai alla replica asincrona

  2. Fai clic sulla scheda Gruppi con coerenza.

  3. Seleziona il gruppo di coerenza che vuoi eliminare.

  4. Fai clic su Elimina. Si apre la finestra Elimina gruppo di 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 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 la coerenza gruppo
  • REGION: la regione del gruppo con coerenza
  • CONSISTENCY_GROUP: il nome della coerenza gruppo

Passaggi successivi