Crear un MIG con discos con reconocimiento del estado

En este documento se describe cómo crear un grupo de instancias gestionado (MIG) que conserve los datos de los discos con un nombre de dispositivo determinado para todas las VMs del MIG, incluso en caso de que se recree una VM (por ejemplo, cuando se repare automáticamente, se actualice o se recree una VM del MIG). Conservar los discos es útil para determinadas cargas de trabajo, como las bases de datos o las aplicaciones antiguas.

Además de conservar los discos de todas las VMs del grupo, también puedes configurar un MIG con reconocimiento del estado para lo siguiente:

  • Puedes añadir y conservar discos específicos de la instancia.
  • Puedes añadir y conservar metadatos específicos de la instancia.
  • Puedes añadir y conservar direcciones IP.

Para obtener más información, consulta la descripción general de las MIGs con estado.

También puedes consultar otros casos prácticos básicos para crear un MIG.

Antes de empezar

  • Crea una plantilla de instancia, que es necesaria para crear un grupo de instancias gestionado.
  • Si aún no lo has hecho, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    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. Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    2. Set a default region and zone.

    Terraform

    Para usar las muestras de Terraform de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Para obtener más información, consulta Set up authentication for a local development environment.

    REST

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

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Limitaciones

Un MIG con configuración con reconocimiento del estado (un MIG con reconocimiento del estado) tiene las siguientes limitaciones:

  • No puedes usar el autoescalado si tu MIG tiene una configuración con reconocimiento del estado.
  • Si quieres usar actualizaciones continuas automatizadas, debes definir el método de sustitución en RECREATE.
  • En el caso de los MIGs regionales con reconocimiento del estado, debes inhabilitar la redistribución proactiva (establecer el tipo de redistribución en NONE) para evitar que se eliminen instancias con reconocimiento del estado mediante la redistribución automática entre zonas.
  • Si usas una configuración de todas las instancias para anular las propiedades de la plantilla de instancia, no puedes especificar esas propiedades en ninguna configuración por instancia y, al mismo tiempo, en la configuración de todas las instancias del grupo.

Para ver la lista completa de limitaciones de MIG, que varía en función de la configuración que utilices, consulta el artículo sobre las limitaciones de MIG.

Crear un MIG con discos con reconocimiento del estado

Usa la Google Cloud console, la CLI de gcloud, Terraform o REST.

Consola

  1. Ve a la página Grupos de instancias.

    Ir a Grupos de instancias

    Los pasos restantes aparecen en la Google Cloud consola.

  2. Haz clic en Crear grupo de instancias.
  3. Selecciona la opción Nuevo grupo de instancias gestionado (con reconocimiento del estado).
  4. Asigna un nombre y, si quieres, una descripción al grupo de instancias.
  5. Elige una plantilla de instancia para el grupo de instancias o crea una.
  6. En el campo Número de instancias, especifica el número inicial de VMs que necesitas en este grupo.
  7. En la sección Configuración con estado, en Configuración de grupo, haz clic en el disco que quieras convertir en un disco con estado y, a continuación, sigue estos pasos.
    1. En la sección Con estado, selecciona Sí.
    2. En la lista Al eliminar la instancia de forma permanente, elige si quieres desvincular el disco o eliminarlo cuando elimines la VM de forma permanente.
    3. Para guardar los ajustes, haz clic en Hecho.
  8. Para crear el MIG, haz clic en Crear.

gcloud

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

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

Haz los cambios siguientes:

  • INSTANCE_GROUP_NAME: nombre del grupo de instancias gestionado que se va a crear.
  • INSTANCE_TEMPLATE_URL: la URL de la plantilla de instancia que quieres usar para crear VMs en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancia. Especifica uno de los siguientes valores:
    • En el caso de una plantilla de instancia regional, haz lo siguiente: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • En el caso de una plantilla de instancia global, haz lo siguiente: INSTANCE_TEMPLATE_ID
  • SIZE: número inicial de VMs que necesitas en este grupo.
  • DEVICE_NAME: el nombre del dispositivo de un disco especificado en la plantilla de instancia.

  • DELETE_RULE: valor que indica qué debe ocurrir con un disco con estado cuando se elimina una máquina virtual. Las opciones disponibles son las siguientes:

    • never: (predeterminado). No elimines nunca el disco. En su lugar, desvincula el disco cuando se elimine su VM.
    • on-permanent-instance-deletion: Elimina el disco cuando la instancia de VM se elimine de forma permanente del grupo de instancias; por ejemplo, cuando la instancia gestionada se elimine manualmente o cuando se reduzca el tamaño del grupo.

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

Terraform

Si aún no has creado una plantilla de instancia, que especifica el tipo de máquina, la imagen del disco de arranque, la red y otras propiedades de la VM que quieres que tengan todas las VMs de tu MIG, crea una plantilla de instancia.

Para especificar qué discos de la plantilla de instancia deben tener estado en la creación de MIG, incluya el bloque stateful_disk. En el siguiente ejemplo se crea un MIG zonal con discos con reconocimiento del estado. Para obtener más información sobre el recurso que se usa en el ejemplo, consulta el google_compute_instance_group_managerrecurso.

resource "google_compute_instance_group_manager" "default" {
  name               = "igm-stateful-disk-basic"
  zone               = "us-central1-f"
  base_instance_name = "instance"
  target_size        = 1

  version {
    instance_template = google_compute_instance_template.default.id
  }

  stateful_disk {
    device_name = "example-disk"
    delete_rule = "NEVER"
  }

}

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

REST

Para especificar qué discos de la plantilla de instancia deben tener estado en la creación de MIG, inclúyalos en el campo statefulPolicy del cuerpo de la solicitud. En el caso de los MIGs zonales, usa el método instanceGroupManagers.insert. En el caso de los MIGs regionales, usa el método regionInstanceGroupManagers.insert.

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

{
  "name": "NAME",
  "versions": [
    {
      "instanceTemplate": "INSTANCE_TEMPLATE_URL"
    }
  ],
  "targetSize": SIZE,
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "DEVICE_NAME": {"autoDelete": "DELETE_RULE" },
        "DEVICE_NAME": {"autoDelete": "DELETE_RULE" }
      }
    }
  }
}

Haz los cambios siguientes:

  • PROJECT: el ID del proyecto de la solicitud.
  • ZONE: la zona en la que se encuentra el MIG (se aplica a un MIG zonal).
    • En el caso de un MIG regional, sustituye zones/ZONE por regions/REGION y especifica la región del MIG.
  • NAME: el nombre del MIG que se va a crear.
  • INSTANCE_TEMPLATE_URL: la URL de la plantilla de instancia que quieres usar para crear VMs en el MIG. La URL puede contener el ID o el nombre de la plantilla de instancia. Especifica uno de los siguientes valores:
    • En el caso de una plantilla de instancia regional, haz lo siguiente: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • En el caso de una plantilla de instancia global, haz lo siguiente: INSTANCE_TEMPLATE_ID
  • SIZE: número inicial de instancias que necesitas en este grupo.
  • DEVICE_NAME: el nombre del dispositivo de un disco especificado en la plantilla de instancia.

  • DELETE_RULE: valor que indica qué debe ocurrir con el disco con estado cuando se elimine la instancia de VM. Estas son las opciones disponibles:

    • never: (predeterminado). No elimines nunca el disco. Desvincula el disco cuando se elimine la VM.
    • on_permanent_instance_deletion: elimina el disco con estado cuando la VM se elimine de forma permanente del grupo de instancias; por ejemplo, cuando la instancia gestionada se elimine manualmente o cuando se reduzca el tamaño del grupo.

    Independientemente del valor de la regla de eliminación, los discos con reconocimiento del estado siempre se conservan en las operaciones de reparación, actualización y recreación automáticas de instancias.

Siguientes pasos