Configuración de discos persistentes con estado en MIG

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Consola

1. En la consola de Google Cloud, vaya a la página de grupos de instancias .

   Ir a grupos de instancias

2. Seleccione su proyecto y haga clic en Continuar .

3. Haz clic en Crear grupo de instancias .

4. Seleccione Nuevo grupo de instancias administrado (con estado) .

5. Especifique un nombre para el grupo de instancias.

6. Seleccione una plantilla de instancia . Si no hay plantillas disponibles, cree una plantilla de instancia .

7. En Número de instancias , especifique la cantidad de instancias para el grupo de instancias.

8. La sección Configuración con estado muestra los discos especificados en la plantilla de instancia. Haga clic en un disco para editar su configuración con estado.

   1. En Con estado , seleccione Sí .

   2. En el menú desplegable Al eliminar la instancia permanente , seleccione la acción que se realizará en el disco con estado cuando se elimine la instancia de VM. Las opciones disponibles son:

      • Separar disco: (predeterminado). Nunca elimine el disco; desconecte el disco cuando se elimine la VM.
      • Eliminar disco: elimina el disco con estado cuando su VM se elimina permanentemente del grupo de instancias, por ejemplo, cuando la instancia administrada se elimina manualmente o cuando se reduce el tamaño del grupo.

   3. Después de finalizar la configuración con estado, haga clic en Listo .

9. Haga clic en Crear .

nube de gcloud

Para especificar qué discos de una plantilla de instancia deben tener estado en la creación de MIG, usa la marca --stateful-disk con el gcloud compute instance-groups managed create :

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --stateful-disk device-name=DEVICE_NAME[,auto-delete=DELETE_RULE]

Reemplace lo siguiente:

• INSTANCE_GROUP_NAME : el nombre del grupo de instancias administrado que se creará.
• INSTANCE_TEMPLATE : el nombre de la plantilla de instancia que se utilizará al crear instancias.
• SIZE : la cantidad inicial de máquinas virtuales que necesita en este grupo.
• DEVICE_NAME : el nombre del dispositivo de un disco especificado en la plantilla de instancia.

• DELETE_RULE : un valor que prescribe lo que debe suceder con un disco con estado cuando se elimina una máquina virtual. Las opciones disponibles son:

  • never : (predeterminado). Nunca elimine el disco; en su lugar, desconecte el disco cuando se elimine su VM.
  • on-permanent-instance-deletion : elimina el disco cuando su instancia de VM se elimina permanentemente del grupo de instancias, por ejemplo, cuando la instancia administrada se elimina manualmente o cuando se reduce el tamaño del grupo.

  Independientemente del valor de la regla de eliminación, los discos con estado siempre se conservan en las operaciones de recuperación, actualización y recreación automática de la máquina virtual.

Ejemplo

Quiere implementar una base de datos con 12 fragmentos, cada uno con un disco de arranque sin estado que contiene el sistema operativo y los archivos binarios de la base de datos, y cada uno con un disco de datos con estado. Utilice los siguientes pasos:

1. Cree una plantilla de instancia con un disco de arranque sin estado basado en la imagen img-example-db-v01 , que tiene un sistema operativo y una base de datos preinstalados, y con un disco de datos con estado:

   gcloud compute instance-templates create example-database-template-v01 \
       --image img-example-db-v01 \
       --create-disk device-name=data-disk,mode=rw,image=empty10GBext4
   

   El indicador --create-disk le indica al MIG que:

   1. Cree un nuevo disco de 10 GB para cada instancia de VM a partir de una imagen ext4 vacía, preparada de antemano.
   2. Conecte el disco a su VM en modo lectura/escritura usando el nombre del dispositivo data-disk .

2. Cree un MIG a partir de la plantilla de instancia y defina el disco de datos como con estado:

   gcloud compute instance-groups managed create example-database-group \
     --template example-database-template-v01 \
     --base-instance-name shard \
     --size 12 \
     --stateful-disk device-name=data-disk,auto-delete=on-permanent-instance-deletion
   

   El nombre del dispositivo data-disk se toma de la plantilla de instancia. El disco de datos está configurado para eliminarse junto con la instancia de VM cuando la VM se elimina permanentemente (ya sea debido a la eliminación manual de la instancia o a la disminución manual del tamaño del grupo). El disco de datos se conserva durante la recuperación automática, las actualizaciones y la recreación de la máquina virtual.

3. Verifique que el disco de datos esté configurado en la política con estado:

   gcloud compute instance-groups managed describe example-database-group
   
   
   baseInstanceName: shard
   ...
   name: example-database-group
   ...
   statefulPolicy:
     preservedState:
       disks:
         data-disk:
           autoDelete: ON_PERMANENT_INSTANCE_DELETION
   ...
   

   Puede ver que la política con estado declara los discos con nombre de dispositivo data-disk como con estado, con una regla para eliminar dichos discos en la eliminación permanente de la máquina virtual.

Terraformar

Si aún no ha creado una plantilla de instancia, que especifica el tipo de máquina, la imagen del disco de arranque, la red y otras propiedades de VM que desea para cada VM en su MIG, cree una plantilla de instancia .

El siguiente ejemplo crea un MIG zonal con un disco con estado. Para especificar qué disco de la plantilla de instancia debe tener estado en la creación de MIG, incluya el bloque stateful_disk . Para obtener más información sobre el recurso utilizado en el ejemplo, consulte recurso google_compute_instance_group_manager . Para crear un MIG regional, utilice el recurso google_compute_region_instance_group_manager .

resource "google_compute_instance_group_manager" "default" {
  name               = "example-database-group"
  base_instance_name = "shard"
  target_size        = 12
  zone               = "us-central1-f"
  version {
    instance_template = google_compute_instance_template.default.id
    name              = "primary"
  }
  stateful_disk {
    device_name = "data-disk"
    delete_rule = "ON_PERMANENT_INSTANCE_DELETION"
  }
}

Para aprender a aplicar o eliminar una configuración de Terraform, consulte Comandos básicos de Terraform .

DESCANSAR

Para especificar qué discos de la plantilla de instancia deben tener estado en la creación de MIG, inclúyalos en el campo statefulPolicy en el cuerpo de la solicitud del método instanceGroupManagers.insert :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instanceGroupManagers

{
  "name": "NAME",
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/TEMPLATE"
    }
  ],
  "targetSize": SIZE,
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "DEVICE_NAME": {"autoDelete": "DELETE_RULE" },
        "DEVICE_NAME": {"autoDelete": "DELETE_RULE" }
      }
    }
  }
}

Reemplace lo siguiente:

• PROJECT : El ID del proyecto para la solicitud.
• ZONE : La zona donde se encuentra el MIG (aplica a un MIG zonal).
  • Para un MIG regional, reemplace zones/ ZONE con regions/ REGION y especifique la región del MIG.
• NAME : El nombre del MIG a crear.
• TEMPLATE : El nombre de la plantilla de instancia que se utilizará al crear instancias.
• SIZE : El número inicial de instancias que necesita en este grupo.
• DEVICE_NAME : el nombre del dispositivo de un disco especificado en la plantilla de instancia.

• DELETE_RULE : un valor que prescribe lo que debe suceder con el disco con estado cuando se elimina la instancia de VM. Las opciones disponibles son:

  • never : (predeterminado). Nunca elimine el disco; desconecte el disco cuando se elimine la VM.
  • on_permanent_instance_deletion : elimina el disco con estado cuando su VM se elimina permanentemente del grupo de instancias, por ejemplo, cuando la instancia administrada se elimina manualmente o cuando se reduce el tamaño del grupo.

Ejemplo

Quiere implementar una base de datos con 12 fragmentos, cada uno con un disco de arranque sin estado que contiene el sistema operativo y los archivos binarios de la base de datos, y cada uno con un disco de datos con estado. Utilice los siguientes pasos.

1. Cree una plantilla de instancia con un disco de arranque sin estado basado en la imagen img-example-db-v01 , con sistema operativo y base de datos preinstalados, y con un disco de datos con estado, usando el método instanceTemplates.insert :

   POST https://compute.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates
   
   {
     "name": "example-database-template-v01",
     "properties": {
       "machineType":"e2-standard-2",
       "disks": [
         {
           "boot": true,
           "deviceName": "boot-disk",
           "initializeParams": {
             "sourceImage": "projects/example-project/global/images/mg-example-db-v01"
           }
         },
         {
           "deviceName": "data-disk",
           "mode": "READ_WRITE",
           "initializeParams": {
             "sourceImage": "projects/example-project/global/images/empty10GBext4"
           }
         }
       ],
       "networkInterfaces": [
         {
           "network": "global/networks/default"
         }
       ]
     }
   }
   

   El disco de datos en la plantilla de instancia tiene el nombre de dispositivo data-disk y está configurado para crearse a partir de una imagen ext4 vacía, preparada de antemano y adjuntarse en modo de lectura/escritura.

2. Cree un MIG a partir de la plantilla de instancia y defina el disco de datos como con estado mediante el método instanceGroupManagers.insert :

   POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers
   
   {
     "name": "example-database-group",
     "baseInstanceName": "shard",
     "versions": [
       {
         "instanceTemplate": "global/instanceTemplates/example-database-template-v01"
       }
     ],
     "targetSize": 12,
     "statefulPolicy": {
       "preservedState": {
         "disks": {
           "data-disk": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
         }
       }
     }
   }
   

   El MIG crea 12 instancias, cada una con un disco con las siguientes propiedades:

   • Un nombre de dispositivo, data-disk , tomado de la plantilla de instancia.
   • Una regla de eliminación para eliminar el disco de datos cuando se elimina la VM (ya sea debido a la eliminación manual de la instancia o debido a la disminución manual del tamaño del grupo).
   • Una entrada en el estado preservado de la política ( preservedStateFromPolicy ) de cada instancia administrada para que el disco de datos se conserve en la recuperación automática, las actualizaciones y la recreación de la instancia.

3. Utilice el método instanceGroupManagers.get para verificar que el disco de datos esté configurado en la política con estado del nuevo recurso instanceGroupManagers :

   GET https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-group
   

   
   {
     "name": "example-database-group",
     "baseInstanceName": "shard",
     ...
     "statefulPolicy": {
       "preservedState": {
         "disks": {
           "data-disk": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
         }
       }
     }
     ...
   }
   

   Puede ver que la política con estado declara los discos con nombre de dispositivo data-disk como con estado con la regla para eliminar dichos discos en la eliminación permanente de la instancia.

Consola

1. En la consola de Google Cloud, vaya a la página de grupos de instancias .

   Ir a grupos de instancias

2. Haga clic en el nombre del grupo de instancias en el que desea especificar la configuración con estado para el disco.

3. Haga clic en Editar para modificar el grupo de instancias administrado.

4. En Configuración con estado , expanda el disco que desea convertir en estado.

   1. En Con estado , seleccione Sí .

   2. En el menú desplegable Al eliminar la instancia permanente , seleccione la acción que se realizará en el disco con estado cuando se elimine la instancia de VM.

      • Separar disco: (predeterminado). Nunca elimine el disco; desconecte el disco cuando se elimine la VM.

      • Eliminar disco: elimina el disco con estado cuando su VM se elimina permanentemente del grupo de instancias, por ejemplo, cuando la instancia administrada se elimina manualmente o cuando se reduce el tamaño del grupo.

   3. Después de actualizar la configuración con estado, haga clic en Listo .

5. Haga clic en Guardar para completar la actualización.

nube de gcloud

Para especificar qué discos de la plantilla de instancia deben tener estado o actualizar la configuración del disco con estado para un MIG existente, usa una o varias marcas --stateful-disk con el comando gcloud compute instance-groups managed update :

gcloud compute instance-groups managed update NAME \
  --stateful-disk device-name=DEVICE_NAME[,auto-delete=DELETE_RULE]

Reemplace lo siguiente:

• NAME : el nombre del grupo de instancias administrado que se actualizará.
• DEVICE_NAME : el nombre del dispositivo de un disco que se especifica en la plantilla de instancia.

• DELETE_RULE : un valor que prescribe lo que debe suceder con el disco con estado cuando se elimina una instancia de VM. Las opciones disponibles son:

  • never : (predeterminado). Nunca elimine el disco, desconecte el disco cuando se elimine su instancia.
  • on-permanent-instance-deletion : elimina el disco con estado cuando su instancia se elimina permanentemente del grupo de instancias, por ejemplo, cuando la instancia administrada se elimina manualmente o cuando se reduce el tamaño del grupo.

Si un nombre de dispositivo específico ya está configurado en la política con estado, el comando actualiza la configuración.

Ejemplo

Ejecuta una base de datos con varios fragmentos en un MIG denominado example-database- group . Cada VM en el MIG almacena un fragmento en un disco adicional con el nombre del dispositivo data-disk , que está definido por la plantilla de instancia. El MIG no tiene una configuración con estado y es necesario conservar los discos de datos en la recreación, la recuperación automática y las actualizaciones de la instancia. También desea proteger los discos de datos para que no se eliminen cuando se elimina una máquina virtual.

1. Actualice el MIG para definir el disco de datos como con estado mediante el siguiente comando:

   gcloud compute instance-groups managed update example-database-group \
     --stateful-disk device-name=data-disk,auto-delete=never
   

   Como resultado, MIG aplica las actualizaciones de configuración de políticas con estado de forma automática y asincrónica a los discos de datos para todas las instancias. Los discos de datos ahora se conservan en la recuperación automática, las actualizaciones y la recreación de instancias, y los discos de datos se desconectan al eliminar la instancia porque la regla auto-delete está configurada en never .

2. Verifica que el disco de datos esté configurado en la política con estado ejecutando el comando gcloud compute instance-groups managed describe example-database-group .

DESCANSAR

Para especificar qué discos de la plantilla de instancia deben tener estado o actualizar la configuración del disco con estado para un MIG existente, configure los discos en la política con estado del MIG utilizando el método instanceGroupManagers.patch :

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instanceGroupManagers/NAME

{
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "DEVICE_NAME": {"autoDelete": "DELETE_RULE" },
        "DEVICE_NAME": {"autoDelete": "DELETE_RULE" }
      }
    }
  }
}

Reemplace lo siguiente:

• PROJECT : El ID del proyecto para la solicitud.
• ZONE : La zona donde se encuentra el MIG (aplica a un MIG zonal).
  • Para un MIG regional, reemplace zones/ ZONE con regions/ REGION y especifique la región del MIG.
• NAME : El nombre del MIG a actualizar.
• DEVICE_NAME : el nombre del dispositivo de un disco, especificado en la plantilla de instancia, para el cual desea actualizar la configuración con estado.

• DELETE_RULE : un valor que prescribe lo que debe suceder con el disco con estado cuando se elimina una instancia de VM. Las opciones disponibles son:

  • never : (predeterminado). Nunca elimine el disco, desconecte el disco cuando se elimine su instancia.
  • on-permanent-instance-deletion : elimina el disco con estado cuando su instancia se elimina permanentemente del grupo de instancias, por ejemplo, cuando la instancia se elimina manualmente o cuando se reduce el tamaño del grupo.

Si el nombre del dispositivo especificado ya está configurado en la política con estado, el método patch actualiza su configuración.

Ejemplo

Ejecuta una base de datos con varios fragmentos en un MIG denominado example-database- group . Cada VM en el MIG almacena un fragmento en un disco adicional con el nombre del dispositivo data-disk , que está definido por la plantilla de instancia. El MIG no tiene una configuración con estado y es necesario conservar los discos de datos en la recreación, la recuperación automática y las actualizaciones de la instancia. También desea proteger los discos de datos para que no se eliminen cuando se elimina una máquina virtual.

1. Parchee el MIG para definir el disco de datos como con estado:

   PATCH https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-group
   
   {
     "statefulPolicy": {
       "preservedState": {
         "disks": {
           "data-disk": {"autoDelete": "NEVER" }
         }
       }
     }
   }
   

   El MIG aplica esta configuración con estado de forma automática y asincrónica a los discos de datos para todas las instancias. Los discos de datos se conservarán durante la recuperación automática, las actualizaciones y la recreación de instancias. Los discos de datos se desconectarán al eliminar la instancia porque la regla autoDelete está configurada en NEVER .

2. Verifique que el disco de datos esté configurado en la política con estado viendo el recurso instanceGroupManagers , devuelto por el método instanceGroupManagers.get .

Consola

1. En la consola de Google Cloud, vaya a la página de grupos de instancias .

   Ir a grupos de instancias

2. Haga clic en el nombre del grupo de instancias del que desea eliminar la configuración con estado de los discos.

3. Haga clic en Editar para modificar el grupo de instancias administrado.

4. En Configuración con estado , expanda los discos con estado que desea convertir en sin estado.

   1. Cambie la opción Con estado a No.
   2. Haga clic en Listo .

5. Después de realizar los cambios, haga clic en Guardar .

nube de gcloud

Para especificar qué discos de la política con estado de un MIG se deben convertir en sin estado, usa la marca --remove-stateful-disks con el comando gcloud compute instance-groups managed update :

gcloud compute instance-groups managed update NAME \
  --remove-stateful-disks DEVICE_NAME[,DEVICE_NAME,...]

Reemplace lo siguiente:

• NAME : El nombre del MIG a actualizar.
• DEVICE_NAME : el nombre del dispositivo de un disco que se eliminará de la política con estado y se tratará como sin estado. Puede proporcionar uno o varios nombres de dispositivos en la lista.

Ejemplo

Ejecuta una aplicación heredada con múltiples nodos en un MIG llamado example-legacy-group . Cada VM en el MIG almacena datos de la aplicación en un disco de inicio con el nombre del dispositivo boot-disk , que configuró como con estado en la política con estado del MIG. Ha movido los datos de la aplicación a un disco adicional y ahora desea que el disco de inicio no tenga estado para facilitar la actualización a nuevas imágenes.

Para eliminar la configuración con estado del disco de arranque, actualice el grupo de instancias administrado:

gcloud compute instance-groups managed update example-legacy-group \
  --remove-stateful-disks boot-disk

El MIG elimina la configuración con estado para el nombre del dispositivo boot-disk de forma automática y asincrónica para los discos de arranque de todas las instancias del grupo. Los discos de arranque permanecen conectados a las instancias pero ya no tienen estado. Cuando recrea o actualiza las instancias, o cuando las instancias se reparan automáticamente, el MIG recrea los discos de arranque a partir de la imagen especificada en la plantilla de instancia.

DESCANSAR

Para especificar qué discos de la política con estado de un MIG se deben convertir en sin estado, elimine la configuración de cada disco de la política con estado de MIG utilizando el método instanceGroupManagers.patch :

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instanceGroupManagers/NAME

{
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "DEVICE_NAME": null,
        ...
      }
    }
  }
}

Reemplace lo siguiente:

• PROJECT : El ID del proyecto para la solicitud.
• ZONE : La zona donde se encuentra el MIG (aplica a un MIG zonal).
  • Para un MIG regional, reemplace zones/ ZONE con regions/ REGION y especifique la región del MIG.
• NAME : El nombre del MIG a actualizar.
• DEVICE_NAME : el nombre del dispositivo de un disco que desea eliminar de la política con estado. Proporcionar un valor null provoca la eliminación de la configuración con estado de ese disco. Puede proporcionar uno o varios nombres de dispositivos para eliminar.

Ejemplo

Ejecuta una aplicación heredada con múltiples nodos en un MIG llamado example-legacy-group . Cada VM en el MIG almacena datos de la aplicación en un disco de inicio con el nombre del dispositivo boot-disk , que configuró como con estado en la política con estado del MIG. Ha movido los datos de la aplicación a un disco adicional y ahora desea que el disco de inicio no tenga estado para facilitar la actualización a nuevas imágenes.

Para eliminar la configuración con estado del disco de arranque, parchee el grupo de instancias administrado:

PATCH https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-legacy-group

{
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "boot-disk": null
      }
    }
  }
}

El MIG elimina la configuración con estado para el nombre del dispositivo boot-disk de forma automática y asincrónica para los discos de arranque de todas las instancias del grupo. Los discos de arranque permanecen conectados a las instancias pero ya no tienen estado. Cuando recrea o actualiza las instancias, o cuando las instancias se reparan automáticamente, el MIG recrea los discos de arranque a partir de la imagen especificada en la plantilla de instancia.

nube de gcloud

Para crear una máquina virtual con un nombre personalizado y adjuntar uno o más discos con estado existentes a esa máquina virtual, use el comando gcloud compute instance-groups managed create-instance con uno o varios indicadores --stateful-disk .

gcloud compute instance-groups managed create-instance NAME \
  --instance VM_NAME \
  [--zone ZONE | --region REGION] \
  --stateful-disk device-name=DEVICE_NAME,source=DISK[,mode=MODE][,auto-delete=DELETE_RULE]

Reemplace lo siguiente:

• NAME : El nombre del MIG en el que necesita crear una instancia.
• VM_NAME : el nombre de la nueva instancia a crear.
• ZONE : La zona donde se encuentra el MIG (aplica a un MIG zonal).
• REGION : La región donde está ubicado el MIG (se aplica a un MIG regional).
• DEVICE_NAME : el nombre del dispositivo que se utilizará al conectar el disco.
• DISK : el URI de un disco persistente existente para adjuntar bajo el DEVICE_NAME especificado en el formato projects/ project-id /zones/ zone /disks/ disk-name para un disco zonal y projects/ project-id /regions/ region /disks/ disk-name para un disco regional.
• MODE : Especifica el modo del disco. Las opciones admitidas son:
  • ro : Sólo lectura.
  • rw : (Predeterminado). Lectura/escritura.

• DELETE_RULE : un valor que prescribe lo que debe suceder con un disco con estado cuando se elimina una instancia de VM. Las opciones disponibles son:

  • never : (predeterminado). Nunca elimine el disco; en su lugar, desconecte el disco cuando se elimine su instancia.
  • on-permanent-instance-deletion : elimina el disco con estado cuando su instancia se elimina permanentemente del grupo de instancias, por ejemplo, cuando la instancia se elimina manualmente o cuando se reduce el tamaño del grupo.

  Independientemente del valor de la regla de eliminación, los discos con estado siempre se conservan en las operaciones de recuperación automática, actualización y recreación de la instancia.

Ejemplo

Desea tener recuperación automática para un servidor de base de datos que se ejecuta actualmente en una máquina virtual independiente llamada db-instance y que actualmente almacena datos en un disco llamado db-data-disk-1 .

Cree un MIG con estado con recuperación automática, cree una máquina virtual similar dentro del MIG y adjunte el disco de datos existente db-data-disk-1 a la nueva instancia como un disco con estado:

1. Detenga la máquina virtual, db-instance , durante un período de mantenimiento.
2. Cree una plantilla de instancia denominada db-template usando la configuración de db-instance .
3. Separe db-data-disk-1 de db-instance y elimine db-instance .
4. Cree un MIG vacío, example-database-mig , desde db-template y configure la reparación automática.

5. Cree una instancia administrada con el nombre de db-instance original y adjunte db-data-disk-1 como un disco con estado:

   gcloud compute instance-groups managed create-instance example-database-mig \
     --instance db-instance \
     --zone us-east1-c \
     --stateful-disk device-name=data-disk,source=projects/example-project/zones/us-east1-c/disks/db-data-disk-1,auto-delete=never
   

   El comando crea una instancia, db-instance , en el MIG, crea una configuración por instancia correspondiente con el disco con estado db-data-disk-1 y conecta el disco a la nueva VM, usando data-disk como nombre del dispositivo.

DESCANSAR

Para crear una o varias instancias en un MIG, establecer nombres de VM personalizados y adjuntar uno o varios discos con estado existentes a estas instancias, utilice el método instanceGroupManagers.createInstances .

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/createInstances

{
  "instances": [
    {
      "name": "VM_NAME",
      "preservedState" : {
        "disks": {
          "DEVICE_NAME" : {
            "source": "DISK",
            "mode": "MODE",
            "autoDelete": "DELETE_RULE"
          },
          ...
        }
      }
    },
    ...
  ]
}

Reemplace lo siguiente:

• PROJECT_ID : ID del proyecto para la solicitud.
• ZONE : La zona donde se encuentra el MIG (aplica a un MIG zonal).
  • Para un MIG regional, reemplace zones/ ZONE con regions/ REGION y especifique la región del MIG.
• NAME : El nombre del MIG en el que crear una instancia.
• VM_NAME : el nombre de la instancia a crear.
• DEVICE_NAME : el nombre del dispositivo que se utilizará al conectar el disco.
• DISK : el URI de un disco persistente existente para adjuntar bajo el DEVICE_NAME especificado en el formato projects/ project-id /zones/ zone /disks/ disk-name para un disco zonal o projects/ project-id /regions/ region /disks/ disk-name para un disco regional.
• MODE : Especifica el modo del disco. Las opciones admitidas son:
  • READ_ONLY : Sólo lectura.
  • READ_WRITE : (Predeterminado). Lectura/escritura.

• DELETE_RULE : un valor que prescribe lo que debe suceder con un disco con estado cuando se elimina una máquina virtual. Las opciones disponibles son las siguientes:

  • never : (predeterminado). Nunca elimine el disco; en su lugar, desconecte el disco cuando se elimine su VM.
  • on-permanent-instance-deletion : elimina el disco con estado cuando su instancia se elimina permanentemente del grupo de instancias, por ejemplo, cuando la instancia se elimina manualmente o cuando se reduce el tamaño del grupo.

  Independientemente del valor de la regla de eliminación, los discos con estado siempre se conservan en las operaciones de recuperación automática, actualización y recreación de la instancia.

Ejemplo

Desea tener recuperación automática para un servidor de base de datos que se ejecuta actualmente en una máquina virtual independiente llamada db-instance y que actualmente almacena datos en un disco llamado db-data-disk-1 .

Cree un MIG con estado con recuperación automática, cree una instancia similar dentro del MIG y adjunte el disco de datos existente db-data-disk-1 a la nueva VM como un disco con estado:

1. Detenga la máquina virtual, db-instance , durante un período de mantenimiento.
2. Cree una plantilla de instancia denominada db-template usando la configuración de db-instance .
3. Separe db-data-disk-1 de db-instance y elimine db-instance .
4. Cree un MIG vacío, example-database-mig , desde db-template y configure la reparación automática.

5. Cree una instancia con el nombre de db-instance original y adjunte db-data-disk-1 como un disco con estado:

   POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-mig/createInstances
   
   {
     "instances": [
       {
         "name": "db-instance",
         "preservedState" : {
           "disks": {
             "data-disk" : {
               "source": "projects/example-project/zones/us-east1-c/disks/db-data-disk-1",
               "mode": "READ_WRITE",
               "autoDelete": "never"
             }
           }
         }
       }
     ]
   }
   

   El método crea una instancia, db-instance , en el MIG, crea una configuración por instancia correspondiente con el disco con estado db-data-disk-1 y adjunta el disco a la nueva instancia, usando data-disk como nombre del dispositivo.

nube de gcloud

Para configurar discos con estado individualmente para una VM en un MIG, agregue o actualice la configuración de disco con estado en la configuración asociada por interestancia. Luego, actualice la instancia para aplicar la configuración .

Si una configuración por instancia aún no existe para la instancia, use los gcloud compute instance-groups managed instance-configs create comando con uno o múltiples indicadores --stateful-disk :

gcloud compute instance-groups managed instance-configs create NAME \
--instance VM_NAME \
--stateful-disk device-name=DEVICE_NAME[,source=DISK][,mode=MODE][,auto-delete=DELETE_RULE] \
[--no-update-instance | --update-instance] \
[--instance-update-minimal-action MINIMAL_ACTION]

Si ya existe una configuración por instancia para la instancia, use el comando gcloud compute instance-groups managed instance-configs update Greups de instancia con uno o múltiples --stateful-disk .

El indicador --update-instance (predeterminado) aplica los cambios inmediatamente a la instancia. Si usa --no-update-instance , los cambios permanecen sin aplicar y se aplican cuando luego recrea o actualiza la instancia.

gcloud compute instance-groups managed instance-configs update NAME \
--instance VM_NAME \
--stateful-disk device-name=DEVICE_NAME[,source=DISK][,mode=MODE][,auto-delete=DELETE_RULE] \
[--no-update-instance | --update-instance] \
[--instance-update-minimal-action MINIMAL_ACTION]

Reemplace lo siguiente:

• NAME : El nombre del grupo de instancia administrado.
• VM_NAME : el nombre de la instancia de VM para la cual configurar discos con estado.
• DEVICE_NAME : el nombre del dispositivo utilizado para conectar el disco.

• DISK : el URI de un disco persistente existente para adjuntar bajo el DEVICE_NAME especificado, en los projects/ project-id /zones/ zone /disks/ disk-name para un disco zonal y projects/ project-id /regions/ region /disks/ disk-name para un disco regional.

  El subflag source= DISK es opcional si el dispositivo ya está definido en la configuración de la instancia de la instancia. De lo contrario es necesario.

  Si se omite, el URI de disco actualmente configurado permanece sin cambios.

• MODE : especifica el modo del disco. Solo puede especificar mode si también especifica source . Las opciones compatibles son:

  • ro : Solo lectura.
  • rw : (predeterminado.) Leer/escribir.

  Si se omite, el valor predeterminado se establece para una nueva configuración de disco de estado; El valor permanece sin cambios en una configuración existente.

• DELETE_RULE : un valor que prescribe lo que debería suceder a un disco con estado cuando se elimina una VM. Las opciones disponibles son las siguientes:

  • never : (predeterminado). Nunca elimine el disco; En su lugar, separe el disco cuando se elimine su instancia.
  • on-permanent-instance-deletion : elimine el disco con estado cuando su instancia se elimine permanentemente del grupo de instancias, por ejemplo, cuando la instancia se elimina manualmente o cuando el tamaño del grupo disminuye.

  Si se omite, el valor predeterminado se establece para una nueva configuración de disco de estado; El valor permanece sin cambios en una configuración existente.

  Independientemente del valor de la regla Eliminar, los discos con estado siempre se conservan en las operaciones de autohealing, actualización y recreación de instancias.

• MINIMAL_ACTION : realice al menos la acción especificada al aplicar la actualización de configuración por instancia a la instancia. Debe usarse junto con la bandera --update-instance . El valor debe ser uno de:

  • none : Sin acción.
  • refresh : aplique actualizaciones que sean posibles para aplicar sin detener la VM.
  • restart : Detén la VM y luego comience de nuevo.
  • replace : Recree la VM.

  Si se omite, se utiliza la acción menos disruptiva requerida por la actualización.

Ejemplo

Los datos en un disco de estado adjunto actualmente, data-disk-1 , se corrompieron y desea restaurarlo desde la última copia de seguridad. Creó un disco, data-disk-2 , desde una instantánea para reemplazar el disco corrupto en el caso, db-instance-1 , administrado por un MIG con estado, example-database-mig . El disco original data-disk-1 , se adjunta bajo el nombre del dispositivo data-disk con una regla de delega automática para nunca eliminar el disco.

Para reemplazar data-disk-1 con data-disk-2 , ejecute el siguiente comando:

gcloud compute instance-groups managed instance-configs update example-database-mig \
  --instance db-instance-1 \
  --stateful-disk device-name=data-disk,source=projects/example-project/zones/us-east1-c/disks/data-disk-2 \
  --update-instance \
  --instance-update-minimal-action restart

El comando hace lo siguiente:

1. Actualiza la configuración por instancia para db-instance-1 :
   1. Actualiza la fuente del disco con el nombre del nombre del dispositivo data-disk de data-disk-1 (última configuración) a data-disk-2 (nueva configuración).
   2. Mantiene la regla de la delega automática para nunca eliminar el disco porque el parámetro auto-delete se omite en el indicador --stateful-disk y, de forma predeterminada, la regla de eliminación never es.
2. Aplica la actualización de configuración por instancia a la VM db-instance-1 inmediatamente porque se incluye el indicador --update-instance . El MIG separa data-disk-1 y adjunta data-disk-2 bajo el mismo nombre del dispositivo, data-disk .
3. Debido a que la acción mínima se establece para restart , el MIG reinicia la instancia db-instance-1 para actualizar la VM, que ayuda a la aplicación de la base de datos a comenzar a usar el nuevo disco.

Terraformar

Para configurar discos con estado individualmente para una VM en un MIG, agregue la configuración de disco con estado en la configuración asociada por instancia. Luego, actualice la instancia para aplicar la configuración .

Para agregar la configuración por instancia para una VM, use el recurso google_compute_per_instance_config e incluya el bloque preserved_state como se muestra en la siguiente muestra.

resource "google_compute_per_instance_config" "default" {
  instance_group_manager = google_compute_instance_group_manager.default.name
  zone                   = google_compute_instance_group_manager.default.zone
  name                   = "db-instance"
  preserved_state {
    disk {
      device_name = "data-disk"
      source      = google_compute_disk.default.id
      delete_rule = "NEVER"
    }
  }
}

Para aprender a aplicar o eliminar una configuración de Terraform, consulte Comandos básicos de Terraform .

DESCANSAR

Para configurar discos con estado individualmente para las máquinas virtuales en un MIG, agregue o actualice la configuración de disco con estado en las configuraciones asociadas por instancia. Luego, actualice las instancias para aplicar la configuración .

Si las configuraciones por instancia aún no existen para las máquinas virtuales dadas, use instanceGroupManagers.updatePerInstanceConfigs Method o regionInstanceGroupManagers.updatePerInstanceConfigs Método con configuración con estado para uno o múltiples discos:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/updatePerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "VM_NAME",
      "preservedState" : {
        "disks": {
          "DEVICE_NAME" : {
            "source": "DISK",
            "mode": "MODE",
            "autoDelete": "DELETE_RULE"
          },
          ...
        }
      },
      "fingerprint: "FINGERPRINT"
    },
    ...
  ]
}

Si ya existen configuraciones por instancia para las máquinas virtuales dadas, use el método instanceGroupManagers.patchPerInstanceConfigs regionInstanceGroupManagers.patchPerInstanceConfigs .

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "VM_NAME",
      "preservedState" : {
        "disks": {
          "DEVICE_NAME" : {
            "source": "DISK",
            "mode": "MODE",
            "autoDelete": "DELETE_RULE"
          },
          ...
        }
      },
      "fingerprint: "FINGERPRINT"
    },
    ...
  ]
}

Reemplace lo siguiente:

• PROJECT_ID : la identificación del proyecto para la solicitud.
• ZONE : la zona donde se encuentra el MIG (se aplica a un MIG zonal).
  • Para un MIG regional, reemplace zones/ ZONE con regions/ REGION y especifique la región del MIG.
• NAME : El nombre del MiG.
• VM_NAME : el nombre de la VM, para el cual configurar discos con estado.
• DEVICE_NAME : el nombre del dispositivo utilizado para conectar el disco.

• DISK : el URI de un disco persistente existente para adjuntar bajo el DEVICE_NAME especificado, en los projects/ project-id /zones/ zone /disks/ disk-name para un disco zonal y projects/ project-id /regions/ region /disks/ disk-name para un disco regional.

  El campo "source": " DISK " es opcional si el dispositivo ya está definido en la configuración de la instancia de la instancia. De lo contrario es necesario.

  Si se omite el campo source , el URI de disco actualmente configurado permanece sin cambios.

• MODE : (Opcional.) Especifica el modo del disco. mode solo se puede especificar si se da source . Las opciones compatibles son:

  • READ_ONLY : solo lectura.
  • READ_WRITE : (predeterminado.) Leer/escribir.

  Si se omite, el valor predeterminado se establece para una nueva configuración de disco de estado; El valor permanece sin cambios en una configuración existente.

• DELETE_RULE : (opcional.) Un valor que prescribe lo que debería suceder a un disco con estado cuando se elimina una VM. Las opciones disponibles son las siguientes:

  • nunca: (predeterminado). Nunca elimine el disco; En su lugar, separe el disco cuando se elimine su instancia.
  • on-permanent-instance-deletion : elimine el disco con estado cuando su instancia se elimine permanentemente del grupo de instancias, por ejemplo, cuando la instancia se elimina manualmente o cuando el tamaño del grupo disminuye.

  Si se omite el campo autoDelete , el valor predeterminado se establece para una nueva configuración de disco de estado; El valor permanece sin cambios en una configuración existente.

  Independientemente del valor de la regla Eliminar, los discos con estado siempre se conservan en las operaciones de autohealing, actualización y recreación de instancias.

• FINGERPRINT : (opcional). La huella digital para la configuración dada si ya existe. Utilizado para bloqueo optimista. Para ver la última huella digital, haga una solicitud get() para recuperar el recurso.

Los métodos updatePerInstanceConfigs y patchPerInstanceConfigs actualizan las configuraciones especificadas por instancia, pero no aplican las actualizaciones de configuración a las máquinas virtuales administradas asociadas. Los cambios se aplican a una instancia en la que se instruye al MIG para recrear o actualizar la instancia. También puede actualizar selectivamente la instancia para aplicar los cambios.

Ejemplo

Los datos en un disco de estado adjunto actualmente, data-disk-1 , se corrompieron y desea restaurarlo desde la última copia de seguridad. Creó un disco, data-disk-2 , desde una instantánea para reemplazar el disco corrupto en el caso, db-instance-1 , administrado por un MIG con estado, example-database-mig . El disco original data-disk-1 , se adjunta bajo el nombre del dispositivo data-disk con una regla de delega automática para nunca eliminar el disco.

Para actualizar la configuración por instancia para db-instance-1 con el nuevo disco, llame al método patchPerInstanceConfigs :

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-mig/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "db-instance-1",
      "preservedState" : {
        "disks": {
          "data-disk" : {
            "source": "projects/example-project/zones/us-east1-c/disks/data-disk-2"
          }
        }
      }
    }
  ]
}

El método parche la configuración por instancia para db-instance-1 :

1. Actualiza el source para un disco con el disco data-disk de data-disk-1 (última configuración) a data-disk-2 (nueva configuración).
2. Guardar mode y los parámetros autoDelete sin cambios porque los parámetros se omiten en la solicitud.

La actualización de configuración aún no se aplica a la VM db-instance-1 . El MIG aplica la actualización de configuración cuando recrea o actualiza la instancia.

Para aplicar la actualización de configuración por instancia al db-instance-1 VM, llame al método de instanceGroupManagers.applyUpdatesToInstances para la instancia:

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-mig/applyUpdatesToInstances
{
  "instances": ["/zones/us-east1-c/instances/db-instance-1"],
  "minimalAction": "RESTART"
}

El método actualiza el estado preservado de la instancia administrada, separando data-disk-1 y adjunta data-disk-2 en el mismo data-disk del nombre del dispositivo. Debido a que la minimalAction se establece para RESTART , el método reinicia la VM db-instance-1 , que permite que la aplicación de la base de datos comience usando el nuevo disco.

nube de gcloud

Para separar los discos con estado o declararlos estatales individualmente para una VM en un MIG, elimine la configuración de disco con estado de la configuración asociada por instancia o elimine la configuración completa por instancia si no contiene ningún otro estado. Actualice la instancia para aplicar la configuración.

Para eliminar una configuración de disco con estado de la configuración asociada por instancia, use el comando gcloud compute instance-groups managed instance-configs update con el indicador --remove-stateful-disks . El indicador --update-instance (predeterminado) aplica los cambios inmediatamente a la instancia. Si usa --no-update-instance , los cambios permanecen sin aplicar y se aplican cuando luego recrea o actualiza la instancia.

gcloud compute instance-groups managed instance-configs update NAME \
  --instance VM_NAME \
  --remove-stateful-disks DEVICE_NAME[,DEVICE_NAME,...] \
  [--no-update-instance | --update-instance] \
  [--instance-update-minimal-action MINIMAL_ACTION]

Reemplace lo siguiente:

• NAME : El nombre del MiG.
• VM_NAME : Nombre de la VM desde el cual eliminar la configuración con estado.
• DEVICE_NAME : el nombre del dispositivo utilizado para conectar el disco.

• MINIMAL_ACTION : realice al menos la acción especificada al actualizar la VM con su configuración por instancia. Solo se puede usar junto con --update-instance . El valor debe ser uno lo siguiente:

  • none : Sin acción.
  • refresh : aplique actualizaciones que sean posibles para aplicar sin detener la VM.
  • restart : Detén la VM y luego comience de nuevo.
  • replace : Recree la VM.

  Si se omite, se utiliza la acción menos disruptiva requerida por la actualización.

Ejemplo

Ejecuta una aplicación heredada en un MIG llamado example-legacy-group . Cada VM en el MIG almacena datos de aplicaciones en un disco de arranque con nombre del dispositivo, boot-disk . Usando configuraciones por instancia, configuró cada disco de arranque para que sea con estado. Ahora ha trasladado los datos de la aplicación a un disco adicional, y desea hacer que el disco de arranque sea apacionado para cada VM para facilitar la actualización de nuevas imágenes.

Para cada instancia, por ejemplo, para node-1 , ejecute el comando:

gcloud compute instance-groups managed instance-configs update example-legacy-group \
  --instance node-1 \
  --remove-stateful-disks boot-disk \
  --update-instance

El comando hace lo siguiente:

1. Elimine la configuración para el disco con el disco boot-disk del dispositivo de la configuración por instancia para node-1 .
2. Aplica la actualización de configuración por instancia a la VM node-1 inmediatamente porque se incluye el indicador --update-instance . El MIG elimina el disco de arranque del estate de la instancia administrada de preservedStateFromConfig y trata el disco de arranque como estatuto, lo que significa que el MIG recrea el disco desde su imagen de arranque en la plantilla de instancia en la recreación de instancias posterior, actualización o eventos automáticos.

DESCANSAR

Para separar los discos con estado o declararlos estatales individualmente para una VM en un MIG, elimine la configuración de disco con estado de la configuración asociada por instancia o elimine la configuración completa por instancia si no contiene ningún otro estado. Luego actualice la instancia para aplicar la configuración .

Para eliminar una configuración de disco con estado de la configuración asociada por instancia , use el método de instanceGroupManagers.patchPerInstanceConfigs o el método regionInstanceGroupManagers.patchPerInstanceConfigs :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "VM_NAME",
      "preservedState" : {
        "disks": {
          "DEVICE_NAME" : null
        },
        ...
      },
      "fingerprint: "FINGERPRINT"
      ...
    }
  ]
}

Reemplace lo siguiente:

• PROJECT_ID : la identificación del proyecto para la solicitud.
• ZONE : la zona donde se encuentra el MIG (se aplica a un MIG zonal).
  • Para un MIG regional, reemplace zones/ ZONE con regions/ REGION y especifique la región del MIG.
• NAME : El nombre del MiG.
• VM_NAME : el nombre de la VM desde el cual eliminar la configuración con estado.
• DEVICE_NAME : el nombre del dispositivo utilizado para conectar el disco.
• FINGERPRINT : la huella digital para la configuración dada si ya existe. Utilizado para bloqueo optimista. Para ver la última huella digital, haga una solicitud get() para recuperar el recurso.

El método patchPerInstanceConfigs parche las configuraciones especificadas por instancia, pero no aplica los cambios a las máquinas virtuales asociadas. Los cambios se aplican a una VM cuando recrea o actualiza la instancia. Puede aplicar los cambios manualmente o utilizar actualizaciones automatizadas .

Ejemplo

Ejecuta una aplicación heredada en un MIG llamado example-legacy-group . Cada VM en el MIG almacena los datos de la aplicación en un disco de arranque con el nombre de boot-disk del dispositivo. Configuró el disco de arranque como estado en las configuraciones de la instancia del MIG al migrar las máquinas virtuales independientes al MIG. Ha trasladado los datos de la aplicación a un disco adicional y ahora desea que el disco de arranque sin estado para cada VM sea fácil de actualizar a nuevas imágenes.

1. Llame al método patchPerInstanceConfigs para las instancias, por ejemplo, para node-1 con un valor null para el disco de arranque:

   POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-legacy-group/patchPerInstanceConfigs
   
   {
     "perInstanceConfigs": [
       {
         "name": "node-1",
         "preservedState" : {
           "disks": {
             "boot-disk" : null
           }
         }
       }
     ]
   }
   

   El método elimina la configuración para el disco con boot- disk de nombre del dispositivo de la configuración por instancia para node-1 . La actualización de configuración aún no se aplica a la instancia de VM node-1 . La actualización de configuración se aplicará en la próxima recreación o actualización de instancia.

2. Para aplicar la actualización de configuración por instancia a la instancia de VM node-1 , llame al método de instanceGroupManagers.applyUpdatesToInstances para la instancia:

   POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-legacy-group/applyUpdatesToInstances
   {
     "instances": ["/zones/us-east1-c/instances/node-1"]
   }
   

   El MIG elimina el disco de arranque del preservedStateFromConfig para la instancia node-1 y trata el disco como estatoso. Es decir, el MIG recrea el disco desde su imagen de arranque en la plantilla de instancia en eventos posteriores de recreación, actualización o autohealing de instancia.