Aplicar, ver y quitar la configuración con reconocimiento del estado en grupos de instancias gestionados

Después de crear o actualizar una configuración con reconocimiento del estado de un grupo de instancias gestionado (MIG) con reconocimiento del estado, puedes hacer lo siguiente:

• Aplica la configuración con reconocimiento del estado para que se aplique.
• Consulta la configuración con estado y el estado conservado efectivo de tus instancias gestionadas.
• Quita la configuración con reconocimiento del estado.

Antes de empezar

• Consulta cuándo usar grupos de instancias gestionados con reconocimiento del estado y cómo funcionan.
• 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.

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

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

Aplicar una configuración con reconocimiento del estado a instancias gestionadas

La configuración con reconocimiento del estado se aplicará cuando tú o el MIG la apliquéis.

• Los cambios de configuración de una política con reconocimiento del estado se aplican automáticamente a todas las instancias gestionadas.
• Los cambios de configuración de una configuración por instancia se pueden aplicar de forma manual o automática.

Para obtener más información conceptual, consulta Cómo se aplica la configuración con estado a las instancias gestionadas.

Aplicar la configuración de una política con reconocimiento del estado

Todos los cambios de configuración de una política con reconocimiento del estado se aplican automáticamente a todas las instancias gestionadas. Los cambios en una política con estado no interrumpen las instancias de máquina virtual (VM) en ejecución.

Verificar si se ha aplicado una política con estado

Verificando todas las VMs

Comprueba si los cambios en una política con estado se han aplicado a todas las VMs comprobando si el MIG se ha estabilizado después de los cambios.

Verificar VMs específicas

Para comprobar si los cambios de una política con estado se han aplicado a una VM específica de un MIG, consulta el estado conservado de la instancia gestionada y comprueba si todos los discos de la política con estado están presentes en preservedStateFromPolicy o preservedStateFromConfig de la instancia gestionada.

Aplicar una configuración con reconocimiento del estado a partir de configuraciones por instancia

Puedes aplicar configuraciones por instancia nuevas o actualizadas de forma manual o automática. Sigue uno de estos procedimientos:

• Aplica de forma selectiva las configuraciones actualizadas a instancias específicas: usa este método para controlar las interrupciones, los tiempos y la secuencia de las actualizaciones.
• Aplica automáticamente las configuraciones actualizadas con actualizaciones continuas: usa este método para aplicar cambios de configuración a las instancias gestionadas de forma automática y continua.

Ambos métodos aplican las actualizaciones pendientes de las configuraciones por instancia y las versiones o plantillas de instancia no aplicadas, si procede.

Aplicar de forma selectiva la configuración actualizada a instancias específicas

Para aplicar manualmente configuraciones por instancia a instancias específicas, sigue estos pasos:

1. Configura una política de actualización oportunista para evitar que se produzca una carrera con las actualizaciones proactivas automáticas.
2. Crea o actualiza configuraciones por instancia.
3. Aplica las configuraciones actualizadas a VMs específicas actualizando de forma selectiva esas VMs.

También puedes usar los siguientes métodos:

• Cuando crees o actualices una configuración por instancia con la CLI de gcloud, usa la marca --update-instance para aplicar inmediatamente la configuración a la instancia gestionada asociada.
• Cuando creas nuevas instancias manualmente, especifica sus nombres y configuraciones por instancia en el momento de la creación. El MIG aplica las configuraciones inmediatamente al crear las VMs.

Aplicar automáticamente la configuración actualizada con actualizaciones continuas

Configura actualizaciones continuas proactivas para que tu MIG aplique automáticamente las actualizaciones de configuración a las instancias gestionadas correspondientes de forma continua.

Los MIGs con reconocimiento del estado requieren la siguiente configuración para una política de actualización proactiva:

• Debes definir el método de sustitución como RECREATE.
• Debes definir max surge (máximo de pods de compensación) en 0.
• En el caso de los MIGs regionales, debes inhabilitar la redistribución proactiva de instancias entre zonas.

Esta configuración asegura que el MIG recree las instancias con estado existentes y no las sustituya por otras.

También puedes asegurarte de que los cambios en las configuraciones por instancia se apliquen sin detener las instancias, si es posible, definiendo la acción mínima en REFRESH en la política de actualización del grupo.

Verificar si se han aplicado las configuraciones por instancia

Verificando todas las configuraciones por instancia

Para comprobar si se han aplicado todas las configuraciones por instancia de un MIG, consulta el estado con reconocimiento del estado del MIG y comprueba lo siguiente:status.stateful.perInstanceConfigs.allEffective

• true: Todas las configuraciones por instancia del grupo se han aplicado y están activas, o el grupo no tiene ninguna configuración por instancia.
• false: El grupo tiene al menos una configuración por instancia que aún no es efectiva. Esto puede deberse a que aún no la has aplicado o a que está en proceso de aplicación.

Verificar una configuración específica por instancia

Para verificar si los cambios de una configuración por instancia específica se han aplicado a su VM correspondiente, consulta todas las configuraciones por instancia y comprueba el campo status de la configuración por instancia específica:

• UNAPPLIED: Se ha creado o actualizado la configuración por instancia y debes aplicarla a la VM con una actualización manual de la instancia.
• APPLYING: El MIG está aplicando la configuración por instancia nueva o actualizada a la VM.
• EFFECTIVE: la configuración por instancia se ha aplicado correctamente a la VM y está en vigor.
• UNAPPLIED_DELETION: La configuración por instancia se eliminará. Debes aplicar esta actualización a la VM con una actualización manual de la instancia para que surta efecto.
• DELETING: Se está eliminando la configuración por instancia y se está aplicando el cambio a la VM.

Ver la configuración con reconocimiento del estado y el estado conservado

Obtén información sobre tus grupos de instancias gestionados con reconocimiento del estado para las siguientes tareas:

• Verificar si un MIG tiene una configuración con reconocimiento del estado y si esta configuración se ha aplicado y es efectiva.
• Ver la configuración con estado que es común a todas las instancias de MIG, almacenada en la política con estado.
• Ver la configuración con reconocimiento del estado específica de instancias concretas, almacenada en configuraciones por instancia, y comprobar si esta configuración se ha aplicado y es efectiva.
• Ver el estado conservado de cada instancia de un MIG en función de su política con reconocimiento del estado y de las configuraciones por instancia aplicadas.

Ver el estado de la configuración con reconocimiento del estado de un MIG

Un MIG se considera con reconocimiento del estado si tiene alguna configuración con reconocimiento del estado, es decir, una política con reconocimiento del estado o al menos una configuración por instancia no vacía.

Si creas una política con estado, el MIG la aplica automáticamente para que sea efectiva. Si creas configuraciones por instancia, puedes decidir aplicarlas más adelante.

Para comprobar si un MIG tiene una configuración con reconocimiento del estado y que se han aplicado todas las configuraciones por instancia, consulta el estado con reconocimiento del estado del MIG mediante la CLI de gcloud o REST.

gcloud compute instance-groups managed describe NAME

baseInstanceName node
...
name example-group
...
status:
  isStable: true
  stateful:
    hasStatefulConfig: true
    perInstanceConfigs:
      allEffective: true
  versionTarget:
    isReached: true
targetSize: 3
...

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

{
  "name": "example-group",
  "baseInstanceName": "node",
  ...
  "status": {
    "isStable": true,
    "stateful": {
      "hasStatefulConfig": true,
      "perInstanceConfigs": {
        "allEffective": true
      }
    },
    "versionTarget": {
      "isReached": true
    }
  },
  "targetSize": 3,
  ...
}

Ver la política con reconocimiento del estado de un MIG

Para ver la política con estado de una MIG, consulta los detalles del grupo con la consola de Google Cloud , la CLI de gcloud o REST.

gcloud compute instance-groups managed describe NAME

baseInstanceName node
...
name example-group
...
statefulPolicy:
  preservedState:
    disks:
      data-disk:
        autoDelete: NEVER
      logs-disk:
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
    internalIPs:
      nic0:
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
    externalIPs:
      nic0:
        autoDelete: NEVER
status:
  isStable: true
  stateful:
    hasStatefulConfig: true
    perInstanceConfigs:
      allEffective: true
  versionTarget:
    isReached: true
targetSize: 3
...

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

{
  "name": "example-group",
  "baseInstanceName": "node",
  ...
  "status": {
      "isStable": true,
      "versionTarget": {
        "isReached": true
      },
      "stateful": {
        "hasStatefulConfig": true,
        "perInstanceConfigs": {
          "allEffective": true
        }
      }
  ...
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "data-disk": { "autoDelete": "NEVER" },
        "logs-disk": { "autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
      },
      "internalIPs": {
         "nic0" : { "autoDelete": "ON_PERMANENT_INSTANCE_DELETION"}
      },
      "externalIPs": {
         "nic0" : { "autoDelete": "NEVER"}
      },
    }
  },
  "targetSize": 3,
  ...
}

Ver las configuraciones por instancia de un MIG

Para ver las configuraciones por instancia, muestra todas las configuraciones por instancia de un MIG. Usa la CLI de gcloud o REST.

Si decides aplicar las configuraciones por instancia manualmente, es posible que algunas de ellas aún no se hayan aplicado a las instancias asociadas y, por lo tanto, que los estados conservados de las instancias aún no reflejen tus configuraciones por instancia. Para obtener más información, consulta Aplicar configuraciones por instancia y Verificar si se han aplicado configuraciones por instancia.

gcloud compute instance-groups managed instance-configs list NAME

gcloud compute instance-groups managed instance-configs list example-group
---
fingerprint: JxPvsKOywuY=
name: node-1
preservedState:
  disks:
    data-disk:
      autoDelete: NEVER
      mode: rw
      source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/disks/data-disk-1
  metadata:
    role: primary
  internalIPs:
    nic0:
      ipAddress:
        address: /projects/example-project/regions/us-east1/addresses/node-1-int-ip
      autoDelete: ON_PERMANENT_INSTANCE_DELETION
  externalIPs:
    nic0:
      ipAddress:
        literal: 130.211.181.55
      autoDelete: NEVER
status: EFFECTIVE
---
fingerprint: IbGmJBqqEkk=
name: node-2
preservedState:
...

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

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

{
  "items": [
    {
      "fingerprint": "JxPvsKOywuY=",
      "name": "node-1",
      "preservedState" : {
        "disks": {
          "data-disk" : {
            "source": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/disks/data-disk-1",
            "mode": "READ_WRITE",
            "autoDelete": "NEVER"
          }
        },
        "metadata": {
          "role": "primary"
        },
        "internalIPs": {
         "nic0" : {
           "ipAddress" : {
             "address":  "/projects/example-project/regions/us-east1/addresses/node-1-int-ip"
           },
           "autoDelete": "ON_PERMANENT_INSTANCE_DELETION"
         }
        },
        "externalIPs": {
         "nic0": {
           "ipAddress" : {
             "literal": "54.2.3.4"
           },
           "autoDelete": "NEVER"
         }
        }
      },
      "status": "EFFECTIVE"
    },
    {
      "fingerprint": "IbGmJBqqEkk=",
      "name": "node-2",
      "preservedState" : {
        ...
      }
      ...
    },
    ...
  ]
}

Ver los estados conservados de las instancias gestionadas

Cuando se aplica la configuración con reconocimiento del estado, el MIG genera y define el estado conservado efectivo de cada instancia gestionada en dos campos:

• preservedStateFromPolicy: contiene el estado conservado que se genera en función de una política con reconocimiento del estado, excluyendo cualquier configuración con reconocimiento del estado que se haya anulado mediante configuraciones por instancia.
• preservedStateFromConfig: contiene el estado conservado que se genera en función de una configuración por instancia que ya se ha aplicado a la instancia gestionada.

Para ver el estado conservado efectivo de cada instancia gestionada de un MIG, enumera las instancias gestionadas mediante la CLI de gcloud o REST.

gcloud compute instance-groups managed list-instances NAME

NAME    ZONE        STATUS   HEALTH_STATE  ACTION  PRESERVED_STATE  INSTANCE_TEMPLATE  ...
node-1  us-east1-c  RUNNING                NONE    POLICY,CONFIG    example-template
node-2  us-east1-c  RUNNING                NONE    POLICY,CONFIG    example-template

gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \
  --instance INSTANCE_NAME

gcloud compute instance-groups managed describe-instance example-group \
  --instance node-1
instance: .../example-project/zones/us-east1-c/instances/node-1
instanceStatus: RUNNING
currentAction: NONE
id: 123456789012345678
version:
  instanceTemplate: .../example-project/global/instanceTemplates/example-template
preservedStateFromPolicy:
  disks:
    data-disk:
      autoDelete: NEVER
      mode: rw
      source: .../example-project/zones/us-east1-c/disks/data-disk-1
    internalIPs:
      nic0:
        ipAddress:
          literal: 10.0.0.1
          address: .../example-project/regions/us-east1/addresses/node-1-int-ip
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
preservedStateFromConfig:
  metadata:
    role: primary
    my-key: my-value
  externalIPs:
    nic0:
      ipAddress:
        literal: 130.211.181.55
        address: .../example-project/regions/us-east1/addresses/node-1-nat-ip
      autoDelete: NEVER

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

{
  "managedInstances": [
    {
      "instance": ".../example-project/zones/us-east1-c/instances/node-1",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "id": "123456789012345678",
      "version": {
         "instanceTemplate":".../example-project/global/instanceTemplates/example-template"
      },
      "preservedStateFromPolicy": {
        "disks": {
          "data-disk" : {
            "source": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/disks/data-disk-1",
            "mode": "rw",
            "autoDelete": "NEVER"
          },
        },
        "internalIPs": {
          "nic0" : {
            "ipAddress": {
              "literal": "10.0.0.1",
              "address":  "/projects/example-project/regions/us-east1/addresses/node-1-int-ip"
            },
            "autoDelete": "ON_PERMANENT_INSTANCE_DELETION"
          }
        },
      },
      "preservedStateFromConfig": {
        "metadata": {
          "role": "primary",
          "my-key": "my-value"
        },
        "externalIPs": {
          "nic0": {
            "ipAddress": {
              "literal": "130.211.181.55",
              "address":  "/projects/example-project/regions/us-east1/addresses/node-1-nat-ip"
            },
            "autoDelete": "NEVER"
          }
        },
      }
    },
    {
      "instance": ".../example-project/zones/us-east1-c/instances/node-2",
      "instanceStatus": "RUNNING",
      ...
      "preservedStateFromPolicy": {
        ...
      },
      "preservedStateFromConfig": {
        ...
      }
    },
    ...
  ]
}

Ver los recursos de direcciones IP estáticas asociadas

Para obtener las direcciones IP estáticas (recursos Address) asignadas a las instancias gestionadas de un MIG, consulta los estados conservados de estas instancias. Puedes ver las direcciones estáticas en los campos ipAddress.address.

Si un MIG o las instancias ya no existen, pero las reservas de direcciones IP sí, puedes enumerar las reservas de direcciones internas o externas estáticas.

Quitar la configuración con reconocimiento del estado

Quitar la configuración con reconocimiento del estado es útil en los siguientes casos:

• Has migrado máquinas virtuales independientes a un MIG con reconocimiento del estado y ahora quieres mover la configuración con reconocimiento del estado de las configuraciones por instancia a una política con reconocimiento del estado común.
• Has rediseñado tu carga de trabajo y ya no necesitas mantener ningún estado en las instancias de VM.
• Has creado una configuración con estado para hacer pruebas y ahora quieres eliminarla.

En esta sección se describe cómo eliminar por completo una política con estado en una configuración por instancia. Si solo necesitas quitar un subconjunto de una política con estado o una configuración por instancia, consulta las siguientes secciones:

• Declarar discos persistentes con estado como sin estado para todas las VMs de un MIG.
• Declarar como sin estado las interfaces de red con estado de todas las VMs de un MIG.
• Desconectar un disco con estado o declararlo sin estado para una VM específica de un MIG.
• Eliminar metadatos con estado de una VM específica de un MIG
• Desasociar una dirección IP estática de una VM específica de un MIG.

Eliminar una política con estado

Cuando eliminas una política con estado, se ven afectadas todas las VMs de un MIG. El MIG trata todos los recursos con reconocimiento del estado que se hayan configurado en la política con reconocimiento del estado como recursos sin reconocimiento del estado, a menos que esos recursos también se hayan configurado en configuraciones por instancia para instancias concretas. En las operaciones posteriores de recreación, reparación automática o actualización de instancias, los recursos que ya no tienen estado pueden perderlo:

• Los discos se pueden eliminar y volver a crear a partir del origen, que se define en la plantilla de instancia.
• Las direcciones IP pueden cambiar.

Para obtener información conceptual, consulta cómo afecta al estado conservado la eliminación de un recurso de una política con estado.

gcloud compute instance-groups managed update example-group \
    --zone us-east1-c \
    --remove-stateful-disks data-disk,logs-disk \
    --remove-stateful-internal-ips nic0 \
    --remove-stateful-external-ips nic0

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

{
  "statefulPolicy": null
}

Eliminar la configuración con estado de una VM específica

Para eliminar la configuración con estado de una VM específica, sigue estos dos pasos:

1. Elimina la configuración por instancia asociada.
2. Aplica el cambio a la instancia gestionada. Puedes elegir si el cambio se debe aplicar de forma manual o automática.

Una vez aplicado el cambio, todos los elementos con estado que se hayan configurado anteriormente en la configuración por instancia se tratarán como elementos sin estado, a menos que también se hayan configurado en la política con estado del grupo. Cuando la VM se vuelve a crear o se actualiza, se pierde el estado de los elementos:

• Los discos se pueden separar o volver a crear a partir de su origen en la plantilla de instancia.
• Los metadatos se eliminan o se restablecen a los valores definidos en la plantilla de instancia.
• Las direcciones IP pueden cambiar.

Para obtener más información, consulta cómo afecta la eliminación de elementos de las configuraciones por instancia al estado conservado.

gcloud compute instance-groups managed instance-configs delete INSTANCE_GROUP_NAME \
  --instances INSTANCE_NAME[,INSTANCE_NAME,...] \
  [--no-update-instance | --update-instance] \
  [--instance-update-minimal-action MINIMAL_ACTION]

gcloud compute instance-groups managed instance-configs delete example-group \
  --instances node-1 \
  --update-instance

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/deletePerInstanceConfigs

{
  "names": ["INSTANCE_NAME",...]
}

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

{
  "names": ["node-1"]
}

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

{
  "instances": ["/zones/us-east1-c/instances/node-1"]
}

Comentarios

Queremos conocer tus casos prácticos, tus retos y tus comentarios sobre los MIGs con estado. Envíanos tus comentarios a nuestro equipo a la dirección mig-discuss@google.com.

Siguientes pasos

• Configura un MIG con reconocimiento del estado.
• Obtener información sobre un MIG específico y sus instancias gestionadas, incluido el estado y las propiedades de las VMs.
• Consulta más información sobre los grupos de instancias gestionados con reconocimiento del estado.
• Consulta más información sobre los grupos de instancias gestionadas y sobre cómo trabajar con instancias gestionadas.