Administra grupos de coherencia

En este documento, se describe cómo administrar grupos de coherencia. Los grupos de coherencia son políticas de recursos que alinean la replicación en varios discos en la misma región o zona.

Para obtener más información sobre los grupos de coherencia, consulta Información sobre la replicación asíncrona del disco persistente.

Limitaciones

  • Los grupos de coherencia no son compatibles con los discos en nodos de usuario único.
  • Los grupos de coherencia pueden tener un máximo de 128 discos.
  • Todos los discos de un grupo de coherencia deben estar en el mismo proyecto que la política de recursos del grupo de coherencia.
  • Todos los discos en un grupo de coherencia deben estar en la misma zona, para los discos zonales, o en el mismo par de zonas, para los discos regionales.
  • Un grupo de coherencia puede contener discos principales o secundarios, pero no ambos.
  • No puedes agregar ni quitar un disco principal desde o hacia un grupo de coherencia mientras el disco se replica. Si deseas agregar o quitar un disco principal hacia o desde un grupo de coherencia, primero debes detener la replicación. Puedes agregar o quitar discos secundarios hacia o desde grupos de coherencia en cualquier momento.
  • Puedes conectar un máximo de 16 discos que estén en diferentes grupos de coherencia o discos que no estén en un grupo de coherencia a una VM. Los discos que se encuentran en el mismo grupo de coherencia cuentan como un disco para el límite de 16 discos.

Antes de comenzar

  • Configura la autenticación si aún no lo hiciste. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.

    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

      Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.

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

        gcloud init

      Si deseas obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud.

Crea un grupo de coherencia

Si necesitas alinear la replicación en varios discos, crea un grupo de coherencia en la misma región que los discos principales. Si necesitas alinear las clonaciones de discos, crea un grupo de coherencia en la misma región que los discos secundarios.

Crea un grupo de coherencia con la consola de Google Cloud, Google Cloud CLI o REST.

Console

Para crear un grupo de coherencia, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Replicación asíncrona.

    Ir a Replicación asíncrona

  2. Haz clic en la pestaña Grupos de coherencia.

  3. Haz clic en Crear grupo de coherencia.

  4. En el campo Nombre, escribe un nombre para el grupo de coherencia.

  5. En el campo Región, elige la región en la que se encuentran los discos. Si deseas agregar discos principales al grupo de coherencia, elige la región principal. Si deseas agregar discos secundarios al grupo de coherencia, elige la región secundaria.

  6. Haz clic en Crear.

gcloud

Crea un grupo de coherencia con el comando gcloud compute resource-policies create disk-consistency-group:

gcloud compute resource-policies create disk-consistency-group CONSISTENCY_GROUP_NAME \
    --region=REGION

Reemplaza lo siguiente:

  • CONSISTENCY_GROUP_NAME: es el nombre del grupo de coherencia.
  • REGION: Es la región para el grupo de coherencia. Si quieres agregar discos principales al grupo de coherencia, usa la región principal. Si deseas agregar discos secundarios al grupo de coherencia, usa la región secundaria.

REST

Crea un grupo de coherencia con el método resourcePolicies.insert:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies
{
 "name": "CONSISTENCY_GROUP_NAME",
 "diskConsistencyGroupPolicy": {
  }
}

Reemplaza lo siguiente:

  • PROJECT: el proyecto que contiene el grupo de coherencia.
  • REGION: Es la región para el grupo de coherencia. Si quieres agregar discos principales al grupo de coherencia, usa la misma región que los discos principales. Si quieres agregar discos secundarios al grupo de coherencia, usa la misma región que los discos secundarios.
  • CONSISTENCY_GROUP_NAME: es el nombre del grupo de coherencia.

Visualiza discos en un grupo de coherencia

Visualiza discos en un grupo de coherencia con la consola de Google Cloud, Google Cloud CLI o REST.

Console

Para ver los discos incluidos en un grupo de coherencia, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Replicación asíncrona.

    Ir a Replicación asíncrona

  2. Haz clic en la pestaña Grupos de coherencia.

  3. Haz clic en el nombre del grupo de coherencia del que deseas ver los discos. Se abrirá la página Administrar grupo de coherencia.

  4. Consulta la sección Miembros del grupo de coherencia para ver todos los discos incluidos en el grupo de coherencia.

gcloud

Visualiza los discos incluidos en un grupo de coherencia con el comando gcloud compute disks list:

gcloud compute disks list \
    --LOCATION_FLAG=LOCATION \
    --filter=resourcePolicies=CONSISTENCY_GROUP_NAME

Reemplaza lo siguiente:

  • LOCATION_FLAG: la marca de ubicación para los discos en el grupo de coherencia. Si los discos del grupo de coherencia son regionales, usa --region. Si los discos del grupo de coherencia son zonales, usa --zone.
  • LOCATION: Es la región o la zona de los discos en el grupo de coherencia. Para los discos regionales, usa la región. Para los discos zonales, usa la zona.
  • CONSISTENCY_GROUP_NAME: el nombre del grupo de coherencia.

REST

Visualiza los discos en un grupo de coherencia mediante un filtro de consulta con uno de los siguientes métodos:

  • Consulta los discos zonales en un grupo de coherencia con el método disks.get:

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME

  • Puedes ver los discos regionales en un grupo de coherencia con el método regionDisks.get:

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME

Reemplaza lo siguiente:

  • PROJECT: el proyecto que contiene el grupo de coherencia
  • ZONE: la zona de los discos en el grupo de coherencia
  • REGION: la región de los discos en el grupo de coherencia
  • CONSISTENCY_GROUP_NAME: el nombre del grupo de coherencia

Agrega un disco a un grupo de coherencia

Si deseas agregar discos principales a un grupo de coherencia, debes agregar discos al grupo de coherencia antes de comenzar la replicación. Puedes agregar discos secundarios a un grupo de coherencia en cualquier momento. Todos los discos en un grupo de coherencia deben estar en la misma zona, para los discos zonales, o en el mismo par de zonas, para los discos regionales.

Agrega un disco a un grupo de coherencia con la consola de Google Cloud, Google Cloud CLI o REST.

Console

Para agregar discos a un grupo de coherencia, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Replicación asíncrona.

    Ir a Replicación asíncrona

  2. Haz clic en la pestaña Grupos de coherencia.

  3. Haz clic en el nombre del grupo de coherencia al que deseas agregar los discos. Se abrirá la página Administrar grupo de coherencia.

  4. Haz clic en Asignar discos. Se abrirá la página Asignar discos.

  5. Elige los discos que deseas agregar al grupo de coherencia.

  6. Haz clic en Asignar discos. Cuando se te solicite, haz clic en Agregar.

gcloud

Agrega un disco a un grupo de coherencia con el comando gcloud compute disks add-resource-policies:

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

Reemplaza lo siguiente:

  • DISK_NAME: el nombre del disco que se agregará al grupo de coherencia
  • LOCATION_FLAG: la marca de ubicación para el disco. Para un disco regional, usa --region. Para un disco zonal, usa --zone.
  • LOCATION: la región o la zona del disco. Para los discos regionales, usa la región. Para los discos zonales, usa la zona.
  • CONSISTENCY_GROUP: la URL del grupo de coherencia. Por ejemplo, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME

REST

Agrega discos a un grupo de coherencia mediante uno de los siguientes métodos:

  • Agrega discos zonales a un grupo de coherencia con el método disks.addResourcePolicies:

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

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

  • Agrega discos regionales a un grupo de coherencia con el método regionDisks.addResourcePolicies:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/LOCATION/disks/DISK_NAME/addResourcePolicies

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

Reemplaza lo siguiente:

  • PROJECT: el proyecto que contiene el disco.
  • LOCATION: la zona o la región del disco. Para los discos zonales, usa la zona. Para los discos regionales, usa la región.
  • DISK_NAME: el nombre del disco que se agregará al grupo de coherencia.
  • CONSISTENCY_GROUP: la URL del grupo de coherencia. Por ejemplo, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME

Quita un disco de un grupo de coherencia

Antes de quitar un disco de un grupo de coherencia, debes detener la replicación del disco.

Quita un disco de un grupo de coherencia con la consola de Google Cloud, Google Cloud CLI o REST.

Console

Para quitar discos principales de un grupo de coherencia, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Replicación asíncrona.

    Ir a Replicación asíncrona

  2. Haz clic en la pestaña Grupos de coherencia.

  3. Haz clic en el nombre del grupo de coherencia al que deseas agregar los discos. Se abrirá la página Administrar grupo de coherencia.

  4. Elige los discos que deseas quitar del grupo de coherencia.

  5. Haz clic en Quitar discos. Cuando se te solicite, haz clic en Quitar.

gcloud

Quita un disco de un grupo de coherencia con el comando gcloud compute disks remove-resource-policies:

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

Reemplaza lo siguiente:

  • DISK_NAME: el nombre del disco que se quitará del grupo de coherencia.
  • LOCATION_FLAG: la marca de ubicación para el disco. Para un disco regional, usa --region. Para un disco zonal, usa --zone.
  • LOCATION: la región o la zona del disco. Para los discos regionales, usa la región. Para los discos zonales, usa la zona.
  • CONSISTENCY_GROUP: la URL del grupo de coherencia. Por ejemplo, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME

REST

Quita un disco de un grupo de coherencia con el método disks.removeResourcePolicies para discos zonales o el método regionDisks.removeResourcePolicies para discos regionales.

  • Quita un disco zonal de un grupo de coherencia:

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

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

  • Quita un disco regional de un grupo de coherencia:

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

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

Reemplaza lo siguiente:

  • PROJECT: el proyecto que contiene el disco.
  • LOCATION: la zona o la región del disco. Para los discos zonales, usa la zona. Para los discos regionales, usa la región.
  • DISK_NAME: el nombre del disco que se quitará del grupo de coherencia.
  • CONSISTENCY_GROUP: la URL del grupo de coherencia. Por ejemplo, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME

Borrar un grupo de coherencia

Borra un grupo de coherencia con la consola de Google Cloud, Google Cloud CLI o REST.

Console

Para borrar un grupo de coherencia, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Replicación asíncrona.

    Ir a Replicación asíncrona

  2. Haz clic en la pestaña Grupos de coherencia.

  3. Elige el grupo de coherencia que deseas borrar.

  4. Haz clic en Borrar. Se abrirá la ventana Borrar grupo de coherencia.

  5. Haz clic en Borrar.

gcloud

Borra la política de recursos mediante el comando gcloud compute resource-policies delete:

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

Reemplaza lo siguiente:

  • CONSISTENCY_GROUP: el nombre del grupo de coherencia.
  • REGION: la región del grupo de coherencia.

REST

Borra un grupo de coherencia con el método resourcePolicies.delete:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME

Reemplaza lo siguiente:

  • PROJECT: el proyecto que contiene el grupo de coherencia
  • REGION: la región del grupo de coherencia.
  • CONSISTENCY_GROUP: el nombre del grupo de coherencia.

¿Qué sigue?