Aplicar, ver y eliminar configuración con estado en MIG

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

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

• Aplique la configuración con estado para que surta efecto.
• Vea la configuración con estado, así como el estado preservado efectivo de sus instancias administradas.
• Elimine la configuración con estado.

Antes de comenzar

• Revise cuándo utilizar MIG con estado y cómo funcionan .
• Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras 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. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  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.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Aplicar configuración con estado a instancias administradas

Su configuración con estado es efectiva después de que usted o el MIG la apliquen.

• Los cambios de configuración en una política con estado se aplican automáticamente 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, lea Cómo se aplica la configuración con estado a instancias administradas .

Aplicar la configuración desde una política con estado

Todos los cambios de configuración en una política con estado se aplican automáticamente a todas las instancias administradas. Las actualizaciones de una política con estado no interrumpen la ejecución de instancias de máquinas virtuales (VM).

Verificar si se ha aplicado una política con estado

Verificando todas las máquinas virtuales

Verifique si los cambios a una política con estado se han aplicado a todas las máquinas virtuales verificando si el MIG se ha vuelto estable después de los cambios.

Verificación de máquinas virtuales específicas

Verifique si los cambios a una política con estado se han aplicado a una máquina virtual específica en un MIG viendo el estado preservado de la instancia administrada y verificando si todos los discos de la política con estado están presentes en preservedStateFromPolicy o preservedStateFromConfig para la instancia administrada.

Aplicar configuración con estado desde configuraciones por instancia

Puede aplicar configuraciones por instancia nuevas o actualizadas de forma manual o automática. Utilice uno de los siguientes enfoques:

• Aplique selectivamente configuraciones actualizadas a instancias específicas : utilice este enfoque para controlar la interrupción, el tiempo y la secuencia de las actualizaciones.
• Aplicar automáticamente configuraciones actualizadas con actualizaciones continuas : utilice este enfoque para aplicar cambios de configuración a instancias administradas de forma automatizada y continua.

Ambos métodos aplican actualizaciones pendientes tanto de configuraciones por instancia como de versiones no aplicadas o plantillas de instancia, si corresponde.

Aplicar selectivamente la configuración actualizada a instancias específicas

Para aplicar manualmente configuraciones por instancia a instancias específicas, siga los siguientes pasos:

1. Configure una política de actualización oportunista para evitar una carrera con actualizaciones proactivas automáticas.
2. Cree o actualice configuraciones por instancia.
3. Aplique configuraciones actualizadas a máquinas virtuales específicas actualizándolas selectivamente .

Alternativamente, puede utilizar los siguientes enfoques:

• Al crear o actualizar una configuración por instancia con la CLI de gcloud, use la marca --update-instance para aplicar inmediatamente la configuración a la instancia administrada asociada.
• Cuando crea manualmente nuevas instancias , especifique sus nombres y configuraciones por instancia en el momento de la creación. El MIG aplica las configuraciones inmediatamente después de la creación de la VM.

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

Configure actualizaciones continuas proactivas para que su MIG aplique automáticamente actualizaciones de configuración a las instancias administradas correspondientes de forma continua.

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

• Debe configurar el método de reemplazo en RECREATE .
• Debes establecer el aumento máximo en 0 .
• Para MIG regionales, debe deshabilitar la redistribución proactiva de instancias entre zonas.

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

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

Verificar si se han aplicado configuraciones por instancia

Verificar todas las configuraciones por instancia

Para verificar si se han aplicado todas las configuraciones por instancia en un MIG, vea el estado del MIG y verifique status.stateful.perInstanceConfigs.allEffective :

• true : todas las configuraciones por instancia del grupo se han aplicado y son efectivas, o el grupo no tiene configuraciones por instancia.
• false : el grupo tiene al menos una configuración por instancia que aún no es efectiva: o aún no la ha aplicado o está en proceso de aplicación.

Verificar una configuración específica por instancia

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

• UNAPPLIED : La configuración por instancia se creó o actualizó y debe aplicarla a la VM con una actualización de instancia manual.
• APPLYING : El MIG está aplicando actualmente 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 es efectiva.
• UNAPPLIED_DELETION : la configuración por instancia está configurada para eliminarse. Debe aplicar esta actualización a la VM con una actualización de instancia manual para que surta efecto.
• DELETING : La configuración por instancia se elimina y el cambio se aplica a la VM.

Visualización de la configuración con estado y el estado conservado

Obtenga información sobre sus MIG con estado para las siguientes tareas:

• Verificar si un MIG tiene configuración con estado y si esta configuración está aplicada y es efectiva.
• Ver la configuración con estado que es común a todas las instancias del MIG, almacenada en la política con estado.
• Ver la configuración con estado que es específica de instancias individuales, almacenada en configuraciones por instancia, y verificar si esta configuración se aplica y es efectiva.
• Ver el estado preservado efectivo para cada instancia en un MIG en función de su política de estado y las configuraciones aplicadas por instancia.

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

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

Si crea una política con estado, MIG la aplica automáticamente para hacerla efectiva. Si crea configuraciones por instancia, puede decidir aplicarlas más adelante.

Para verificar si un MIG tiene una configuración con estado y que se aplican todas las configuraciones por instancia, consulte el estado con 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 estado de un MIG

Vea la política con estado de un MIG verificando 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

Vea las configuraciones por instancia enumerando todas las configuraciones por instancia en un MIG. Usa la CLI de gcloud o REST.

Si decide aplicar configuraciones por instancia manualmente, es posible que algunas configuraciones por instancia aún no se apliquen a las instancias asociadas y, por lo tanto, es posible que los estados conservados de las instancias aún no reflejen sus configuraciones por instancia. Para obtener más información, consulte 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 instancias administradas

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

• preservedStateFromPolicy : contiene el estado preservado que se genera en función de una política con estado, excluyendo cualquier configuración con estado que sea anulada por configuraciones por instancia.
• preservedStateFromConfig : contiene el estado preservado que se genera en función de una configuración por instancia que ya se ha aplicado a la instancia administrada.

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

Visualización de recursos de direcciones IP estáticas asociadas

Para recuperar direcciones IP estáticas (recursos Address ) asignadas a instancias administradas en un MIG, vea los estados conservados de estas instancias. Puede ver direcciones estáticas en los campos ipAddress.address .

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

Eliminando la configuración con estado

Eliminar la configuración con estado es útil en los siguientes escenarios:

• Ha migrado máquinas virtuales independientes a un MIG con estado y ahora desea mover la configuración con estado de configuraciones por instancia a una política con estado común.
• Ha rediseñado su carga de trabajo y ya no necesita mantener ningún estado en las instancias de VM.
• Creó una configuración con estado para fines de prueba y ahora desea limpiarla.

Esta sección describe cómo eliminar por completo una política con estado en una configuración por instancia. Si solo necesita eliminar un subconjunto de una política con estado o una configuración por instancia, consulte las siguientes secciones:

• Declarar discos persistentes que previamente tenían estado como sin estado para todas las máquinas virtuales en un MIG.
• Declarar interfaces de red que previamente tenían estado como sin estado para todos los VMS en un MIG.
• Separar un disco con estado o declararlo sin estado para una VM específica en un MIG.
• Eliminar metadatos con estado de una VM específica en un MIG
• Desasociar una dirección IP estática de una VM específica en un MIG.

Eliminar una política con estado

Cuando elimina una política con estado, afecta a todas las máquinas virtuales en un MIG. El MIG trata todos los recursos con estado que se configuraron en la política con estado como sin estado, a menos que esos recursos también estén configurados en configuraciones por instancia para instancias individuales. En operaciones posteriores de recreación, reparación automática o actualización de instancias, los recursos ahora sin estado pueden perder su estado:

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

Para obtener información conceptual, consulte cómo la eliminación de 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
}

Eliminar la configuración con estado para una máquina virtual específica

La eliminación de la configuración con estado para una máquina virtual específica se realiza en dos pasos:

1. Elimine la configuración por instancia asociada.
2. Aplique el cambio a la instancia administrada. Puede 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 previamente 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 posteriormente se recrea o actualiza la VM, se pierde el estado de los elementos:

• Los discos se pueden desconectar o recrear desde 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, consulte cómo la eliminación de elementos de las configuraciones por instancia afecta el estado preservado .

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"]
}

Comentario

Queremos conocer sus casos de uso, desafíos y comentarios sobre los MIG con estado. Comparta sus comentarios con nuestro equipo en mig-discuss@google.com .

¿Qué sigue?

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