Aplica, visualiza y quita la configuración con estado en los MIG

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

• Aplica la configuración con estado para que entre en vigencia.
• Visualizar la configuración con estado y el estado conservado vigente de tus instancias administradas
• Quitar la configuración con estado

Antes de comenzar

• Revisa cuándo usar MIG con estado y cómo funcionan los MIG con estado.
• Si aún no lo hiciste, configura la autenticación. 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.

  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.

Aplica la configuración con estado a las instancias administradas

Tu configuración con estado es efectiva después de que tú o el MIG la aplican.

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

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

Aplica la configuración a partir de una política con estado

Todos los cambios de configuración en una política con estado se aplican de forma automática a todas las instancias administradas. Cuando se actualiza una política con estado, no se interrumpen las instancias de máquina virtual (VM) en ejecución.

Verifica si se aplicó una política con estado

Verifica todas las VM

Para verificar si los cambios en una política con estado se aplicaron a todas las VM, verifica si el MIG se volvió estable después de los cambios.

Verifica las VM específicas

Puedes verificar si los cambios en la política con estado se aplicaron a una VM específica en un MIG. Para ello, visualiza el estado preservado de la instancia administrada y verifica si todos los discos de la política tienen el estado preservedStateFromPolicy o preservedStateFromConfig para la instancia administrada.

Aplica la configuración con estado a partir de las opciones de configuración por instancia

Puedes aplicar opciones de configuración por instancia nuevas o actualizadas de forma manual o automática. Usa uno de los siguientes enfoques:

• Aplica parámetros de configuración actualizados de forma selectiva a instancias específicas: Usa este enfoque para controlar el nivel de interrupción, el momento y la secuencia de las actualizaciones.
• Aplica de forma automática la configuración actualizada con actualizaciones progresivas: Usa este enfoque para aplicar cambios de configuración a instancias administradas de forma progresiva y automatizada.

Ambos métodos aplican actualizaciones pendientes de la configuración por instancia y de las versiones o la plantilla de instancias sin aplicar, si corresponde.

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

Para aplicar la configuración por instancia de forma manual a instancias específicas, sigue estos pasos:

1. Configura una política de actualización oportunista para evitar una carrera con actualizaciones proactivas automáticas.
2. Crea o actualiza la configuración por instancia.
3. Aplica la configuración actualizada a VM específicas mediante la actualización selectiva de esas VM.

Como alternativa, puedes usar los siguientes enfoques:

• Cuando crees o actualices una configuración por instancia mediante la CLI de gcloud, usa la marca --update-instance para aplicar de inmediato la configuración a la instancia administrada asociada.
• Cuando crees instancias nuevas de forma manual, especifica sus nombres y configuraciones por instancia en el momento de la creación. El MIG aplica la configuración de inmediato en la creación de la VM.

Aplica la configuración actualizada automáticamente con actualizaciones progresivas

Configura actualizaciones progresivas proactivas para que el MIG aplique de forma automática, y progresiva, las actualizaciones de configuración a las instancias administradas correspondientes.

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

• Debes configurar el método de reemplazo como RECREATE.
• Debes configurar el aumento máximo en 0.
• Para los MIG regionales, debes inhabilitar la redistribución proactiva de instancias entre zonas.

Esta configuración garantiza que el MIG vuelva a crear las instancias con estado existentes y no las reemplace por otras diferentes.

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

Verifica si se aplicó la configuración por instancia

Verifica todas las configuraciones por instancia

Para verificar si se aplicaron todas las opciones de configuración por instancia en un MIG, consulta el estado del MIG y verifica status.stateful.perInstanceConfigs.allEffective:

• true: Se aplicaron todas las opciones de configuración por instancia en el grupo y están en vigencia, o el grupo no tiene opciones de configuración por instancia.
• false: El grupo tiene, al menos, una configuración por instancia que todavía no es efectiva debido a que aún no la aplicaste o está en proceso de aplicación.

Verifica una configuración específica por instancia

Para verificar si los cambios en una configuración específica por instancia se aplicaron a la VM correspondiente, consulta todas las opciones de configuración por instancia y verifica el campo status de la configuración específica por instancia:

• UNAPPLIED: La configuración por instancia se creó o actualizó y debes aplicarla a la VM con una actualización manual de la instancia.
• APPLYING: En este momento, el MIG está aplicando la configuración por instancia nueva o actualizada a la VM.
• EFFECTIVE: La configuración por instancia se aplicó de forma correcta a la VM y está en vigencia.
• UNAPPLIED_DELETION: La configuración por instancia se configuró para borrarse. Debes aplicar esta actualización a la VM con una actualización de instancia manual para que entre en vigencia.
• DELETING: La configuración por instancia se borrará y el cambio que se aplicará a la VM.

Visualiza la configuración con estado y el estado conservado

Obtén información sobre los MIG con estado para las siguientes tareas:

• Verificar si un MIG tiene configuración con estado, y si esta configuración se aplica y está en vigencia
• Ver la configuración con estado que es común a todas las instancias en el MIG, que se almacena en la política con estado
• Ver la configuración con estado específica de las instancias individuales, que se almacena en la configuración por instancia, y verificar si esta configuración se aplica y está en vigencia
• Ver el estado conservado vigente de cada instancia en un MIG en función de la política con estado y la configuración por instancia aplicadas

Visualiza el estado de la configuración con estado de un MIG

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

Si creas una política con estado, el MIG la aplica de forma automática para que entre en vigencia. Si creas opciones de configuración por instancia, puedes decidir aplicarlas más tarde.

Para verificar si un MIG tiene una configuración con estado y que se apliquen todas las opciones de configuración por instancia, consulta el MIG con estado mediante gcloud CLI 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,
  ...
}

Visualiza la política con estado de un MIG

Para ver la política con estado de un MIG, verifica los detalles del grupo mediante la consola de Google Cloud, gcloud CLI 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,
  ...
}

Visualiza la configuración por instancia de un MIG

Para ver las opciones de configuración por instancia, enumera todas las opciones de configuración por instancia en un MIG. Usa gcloud CLI o REST.

Si decides aplicar las opciones de configuración por instancia de forma manual, es posible que algunas no se apliquen a las instancias asociadas y, por lo tanto, los estados conservados de las instancias podrían no reflejar aún tus opciones de configuración por instancia. Para obtener más información, consulta Aplica opciones de configuración por instancia y Verifica si se aplicaron las 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" : {
        ...
      }
      ...
    },
    ...
  ]
}

Visualiza los estados preservados de las instancias administradas

Cuando la configuración con estado se aplica, el MIG genera y establece el estado preservado vigente en cada instancia administrada en dos campos:

• preservedStateFromPolicy: Contiene el estado preservado que se generó en función de una política con estado, sin incluir cualquier configuración con estado que se vea anulada por opciones configuración por instancia.
• preservedStateFromConfig: Contiene el estado preservado que se generó en función de una configuración por instancia que ya se aplicó a la instancia administrada.

Para ver el estado preservado vigente de cada instancia administrada en un MIG, enumera las instancias administradas con gcloud CLI 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": {
        ...
      }
    },
    ...
  ]
}

Visualiza los recursos de dirección IP estática asociados

Para recuperar direcciones IP estáticas (recursos Address) que se asignan a las instancias administradas en un MIG, ve los estados preservados de esas instancias. Puedes ver direcciones estáticas en los campos ipAddress.address.

Si un MIG o las instancias ya no existen, pero las reservas de las direcciones IP aún existen, puedes generar una lista de las reservas de direcciones estáticas internas o externas.

Quita la configuración con estado

Quitar la configuración con estado es útil en las siguientes situaciones:

• Migraste VM independientes a un MIG con estado y ahora deseas mover la configuración con estado desde las configuraciones por instancia hacia una política con estado común.
• Rediseñaste la carga de trabajo y ya no necesitas conservar ningún estado en las instancias de VM.
• Creaste una configuración con estado para realizar pruebas y ahora deseas limpiarla.

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

• Declara como sin estado a los discos persistentes que tenían estado para todas las VM en un MIG.
• Declara como sin estado interfaces de red que tenían estado para todas las VM de un MIG.
• Desconecta un disco con estado o decláralo sin estado para una VM específica en un MIG.
• Quita metadatos con estado de una VM específica en un MIG.
• Desasocia una dirección IP estática de una VM específica en un MIG.

Quita una política con estado

Cuando quitas una política con estado, afectas a todas las VM de un MIG. El MIG trata como sin estado a todos los recursos con estado que se configuraron en la política, a menos que esos recursos también estén configurados en las opciones de configuración por instancia en instancias individuales. En las operaciones subsiguientes de recreación, reparación automática o actualización de instancias, los recursos que ahora no tienen estado pueden perder su estado:

• Los discos se pueden borrar y volver a crear desde la fuente, que se define en la plantilla de instancias.
• Las direcciones IP pueden cambiar.

Para obtener información conceptual, consulta cómo quitar un recurso de la política con estado afecta el estado preservado.

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
}

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

La eliminación de la configuración con estado de una VM específica se realiza en dos pasos:

1. Borra la configuración por instancia asociada.
2. Aplica el cambio a la instancia administrada. Puedes elegir si el cambio debe aplicarse de forma manual o automática.

Después de aplicar el cambio, todos los elementos con estado que se configuraron con anterioridad en la configuración por instancia ahora se tratan como sin estado, a menos que también estén configurados en la política con estado del grupo. Cuando se actualiza o se vuelve a crear la VM, se pierde el estado de los elementos:

• Los discos se pueden separar o volver a crear desde la fuente en la plantilla de instancias.
• Los metadatos se quitan o se restablecen a los valores definidos en la plantilla de instancias.
• Las direcciones IP pueden cambiar.

Para obtener más información, consulta cómo influye la eliminación de elementos de las configuraciones por instancia en el 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 de uso, desafíos y comentarios sobre los MIG con estado. Comparte tus comentarios con nuestro equipo en [email protected].

¿Qué sigue?

• Configura un MIG con estado.
• Obtén información sobre un MIG específico y sus instancias administradas, incluido el estado y las propiedades de la VM.
• Obtén más información sobre los MIG con estado.
• Obtén más información sobre los MIG y cómo trabajar con instancias administradas.