Configuración de direcciones IP 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 .

7. En Número de instancias , especifique la cantidad de instancias que desea incluir en el grupo de instancias administrado.

8. En Configuración con estado , expanda la IP externa y la IP interna que desea que tenga 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 la dirección IP con estado cuando se elimine la instancia de VM. Las opciones disponibles son:
      • Separar IP: (predeterminado). Desasignar la dirección al eliminar la instancia y mantener la dirección reservada.
      • Eliminar IP: elimine la reserva de dirección IP estática cuando una instancia se elimina permanentemente del grupo de instancias (por ejemplo, cuando elimina una instancia manualmente o 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

Al crear un MIG, para especificar qué direcciones IP en las interfaces de red de la plantilla de instancia deben tener estado, use una o varias de las siguientes marcas con el comando gcloud compute instance-groups managed create :

• --stateful-internal-ip para marcar una dirección IP interna de una interfaz de red determinada como con estado.
• --stateful-external-ip para marcar una dirección IP externa de una interfaz de red determinada como con estado.

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --instance-redistribution-type NONE \
    --stateful-internal-ip [enabled | interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    --stateful-external-ip [enabled | interface-name=NI_NAME][,auto-delete=DELETE_RULE]

Reemplace lo siguiente:

• INSTANCE_GROUP_NAME : el nombre del MIG a crear.
• INSTANCE_TEMPLATE : el nombre de la plantilla de instancia que se utilizará al crear nuevas instancias.
• SIZE : El número inicial de instancias que necesita en este grupo.
• NI_NAME : (Opcional.) Nombre de la interfaz de red. Si no se proporciona, entonces se requiere la opción enabled y la interfaz de red principal denominada nic0 se asume de forma predeterminada. Si tiene varias interfaces de red, puede especificar este indicador para cada IP en cada interfaz de red.

• DELETE_RULE : (Opcional). Prescribe lo que debe suceder con el recurso de dirección estática asociado cuando una instancia de VM se elimina permanentemente. Las opciones disponibles son las siguientes:

  • never : (predeterminado). Nunca elimine la dirección IP estática. En su lugar, anule la asignación de la dirección al eliminar la instancia y mantenga la dirección reservada.
  • on-permanent-instance-deletion : elimina la reserva de dirección IP estática cuando una instancia se elimina permanentemente del grupo de instancias, por ejemplo, cuando eliminas una instancia manualmente o disminuyes el tamaño del grupo.

  Independientemente del valor de la regla de eliminación, el grupo siempre conserva las direcciones IP con estado en las operaciones de recuperación, actualización y recreación automática de la instancia.

Ejemplo

Debe crear un grupo regional de instancias de VM con direcciones IP internas estáticas para las redes predeterminadas y personalizadas y direcciones IP externas estáticas solo para la red predeterminada. Quiere que las direcciones se asignen automáticamente, pero necesita que se conserven mediante la reparación automática de instancias, actualizaciones y eventos de recreación. La configuración de la instancia se almacena en una plantilla de instancia denominada node-template .

Para crear el grupo, ejecute el siguiente comando:

gcloud compute instance-groups managed create example-group \
    --region us-east1 \
    --template node-template \
    --base-instance-name node \
    --instance-redistribution-type NONE \
    --size 3 \
    --stateful-internal-ip interface-name=nic0,auto-delete=on-permanent-instance-deletion
    --stateful-internal-ip interface-name=nic1,auto-delete=on-permanent-instance-deletion
    --stateful-external-ip enabled,auto-delete=on-permanent-instance-deletion

Las IP internas dentro de las interfaces de red nic0 y nic1 y la IP externa dentro de la interfaz de red nic0 se configuran como con estado para todas las instancias del grupo. El grupo reserva automáticamente direcciones IP estáticas internas y externas para cada instancia. Debido a que el indicador auto-delete está configurado on-permanent-instance-deletion , el grupo eliminará automáticamente las reservas de direcciones IP estáticas cuando elimine las instancias asociadas o todo el grupo.

Para verificar que las IP internas dentro de las interfaces de red nic0 y nic1 y la IP externa dentro de la interfaz de red nic0 estén configuradas como con estado, ejecute el siguiente comando:

gcloud compute instance-groups managed describe example-group \
    --zone us-east1-c

El resultado es similar al siguiente:

baseInstanceName: node
...
name: example-group
...
statefulPolicy:
  preservedState:
    internalIPs:
      nic0:
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
      nic1:
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
    externalIPs:
      nic0:
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
...

Puede ver que la política con estado del grupo declara las IP internas dentro de las interfaces de red nic0 y nic1 y las IP externas dentro de la interfaz de red nic0 como con estado con la regla para eliminar reservas de IP estáticas en la eliminación permanente de la instancia.

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 .

Al crear un MIG, para especificar qué direcciones IP dentro de las interfaces de red de la plantilla de instancia deben tener estado, utilice uno o varios de los siguientes bloques:

• stateful_internal_ip para marcar una dirección IP interna de una interfaz de red determinada como con estado.
• stateful_external_ip para marcar una dirección IP externa de una interfaz de red determinada como con estado.

El siguiente ejemplo configura direcciones IP con estado al crear un MIG regional. Para obtener más información sobre el recurso utilizado en el ejemplo, consulte recurso google_compute_region_instance_group_manager .

resource "google_compute_region_instance_group_manager" "default" {
  name               = "example-group"
  base_instance_name = "node"
  target_size        = 3
  region             = "us-east1"

  version {
    instance_template = google_compute_instance_template.default.id
    name              = "primary"
  }
  update_policy {
    type                         = "OPPORTUNISTIC"
    minimal_action               = "REFRESH"
    instance_redistribution_type = "NONE"
    max_unavailable_fixed        = 3
  }
  stateful_internal_ip {
    interface_name = "nic0"
    delete_rule    = "ON_PERMANENT_INSTANCE_DELETION"
  }
  stateful_internal_ip {
    interface_name = "nic1"
    delete_rule    = "ON_PERMANENT_INSTANCE_DELETION"
  }
  stateful_external_ip {
    interface_name = "nic0"
    delete_rule    = "ON_PERMANENT_INSTANCE_DELETION"
  }
}

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

DESCANSAR

Al crear un MIG, para especificar qué direcciones IP dentro de las interfaces de red de la plantilla de instancia deben tener estado, inclúyalas en el campo statefulPolicy en el cuerpo de la solicitud del método instanceGroupManagers.insert o regionInstanceGroupManagers.insert :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/instanceGroupManagers

{
  "name": "INSTANCE_GROUP_NAME",
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/INSTANCE_TEMPLATE"
    }
  ],
  "targetSize": SIZE,
  "statefulPolicy": {
    "preservedState": {
      "internalIPs": {
        "NI_NAME": {"autoDelete": "DELETE_RULE" }
      },
      "externalIPs": {
        "NI_NAME": {"autoDelete": "DELETE_RULE" }
      }
    }
  },
  "updatePolicy": {
    "instanceRedistributionType": "NONE"
  }
}

Reemplace lo siguiente:

• PROJECT : El ID del proyecto para la solicitud.
• REGION : Para MIG regionales, la región donde se encuentra el grupo. Para MIG zonales, reemplace regions/ REGION con zones/ ZONE y especifique la zona donde se encuentra el MIG.
• NAME : El nombre del MIG a crear.
• INSTANCE_TEMPLATE : el nombre de la plantilla de instancia que se utilizará al crear nuevas instancias.
• SIZE : El número inicial de instancias que necesita en este grupo.
• NI_NAME : (Opcional.) Nombre de la interfaz de red. Si no se proporciona, entonces se requiere la opción enabled y la interfaz de red principal denominada nic0 se asume de forma predeterminada. Si tiene varias interfaces de red, puede especificar varios NI_NAMES .

• DELETE_RULE : (Opcional) Prescribe lo que debe suceder con un recurso de dirección estática asociado cuando una instancia de VM se elimina permanentemente. Las opciones disponibles son las siguientes:

  • NEVER : (Predeterminado) Nunca elimine la dirección IP estática. En su lugar, anule la asignación de la dirección al eliminar la instancia y mantenga la dirección reservada.
  • ON_PERMANENT_INSTANCE_DELETION : Elimina la reserva de dirección IP estática cuando una instancia se elimina permanentemente del grupo de instancias, por ejemplo, cuando eliminas una instancia manualmente o disminuyes el tamaño del grupo.

  Independientemente del valor de la regla de eliminación, el grupo siempre conserva direcciones IP con estado en las operaciones de recuperación automática, actualización y recreación de la instancia.

Ejemplo

Debe crear un grupo regional de instancias de VM con direcciones IP internas estáticas para las redes predeterminadas y personalizadas y direcciones IP externas estáticas solo para la red predeterminada. Quiere que las direcciones se asignen automáticamente, pero necesita que se conserven mediante la reparación automática de instancias, actualizaciones y eventos de recreación. La configuración de la instancia se almacena en una plantilla de instancia denominada node-template .

Para crear el grupo, utilice el método regionInstanceGroupManagers.insert :

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers

{
  "name": "example-group",
  "baseInstanceName": "node",
  "versions": [
    {
      "instanceTemplate": "global/instanceTemplates/node-template"
    }
  ],
  "targetSize": 3,
  "statefulPolicy": {
    "preservedState": {
      "internalIPs": {
        "nic0": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" },
        "nic1": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
      }
      "externalIPs": {
        "nic0": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
      }
    }
  },
  "updatePolicy": {
    "instanceRedistributionType": "NONE"
  }
}

Las IP internas dentro de las interfaces de red nic0 y nic1 y las IP externas dentro de la interfaz de red nic0 están configuradas como con estado para todas las instancias del grupo. El grupo reserva automáticamente direcciones IP estáticas internas y externas para cada instancia. Debido a que el campo auto-delete está configurado en ON_PERMANENT_INSTANCE_DELETION , el grupo eliminará automáticamente las reservas de direcciones IP estáticas cuando elimine instancias asociadas o todo el grupo.

Utilice el método regionInstanceGroupManagers.get para verificar que las IP internas dentro de las interfaces de red nic0 y nic1 y las IP externas dentro de la interfaz de red nic0 estén configuradas en la política con estado del nuevo recurso regionInstanceGroupManagers :

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

La respuesta contiene la política con estado configurada:

{
  "name": "example-group",
  "baseInstanceName": "node",
  ...
  "statefulPolicy": {
    "preservedState": {
      "internalIPs": {
        "nic0": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" },
        "nic1": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
      }
      "externalIPs": {
        "nic0": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
      }
    }
  }
  ...
}

Puede ver que la política con estado del grupo declara las IP internas dentro de las interfaces de red nic0 y nic1 y las IP externas dentro de la interfaz de red nic0 como con estado con la regla para eliminar las reservas de direcciones IP estáticas asociadas 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 para el que desea especificar direcciones IP con estado.

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

4. En Configuración con estado , expanda la IP externa y la IP interna que desea que tenga 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 la dirección IP con estado cuando se elimine la instancia de VM. Las opciones disponibles son:
      • Separar IP: (predeterminado). Desasignar la dirección al eliminar la instancia y mantener la dirección reservada.
      • Eliminar IP: elimine la reserva de dirección IP estática cuando una instancia se elimina permanentemente del grupo de instancias (por ejemplo, cuando elimina una instancia manualmente o disminuye el tamaño del grupo).
   3. Después de actualizar la configuración con estado, haga clic en Listo .
   4. Haga clic en Guardar para completar la actualización.

nube de gcloud

Para especificar qué direcciones IP deben tener estado o actualizar la configuración de IP con estado para un MIG existente, usa una o varias marcas --stateful-internal-ip o --stateful-external-ip con el comando gcloud compute instance-groups managed update .

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --stateful-internal-ip [enabled | interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    --stateful-external-ip [enabled | interface-name=NI_NAME][,auto-delete=DELETE_RULE]

Reemplace lo siguiente:

• INSTANCE_GROUP_NAME : el nombre del MIG a actualizar.
• NI_NAME : (Opcional.) Nombre de la interfaz de red. Si no se proporciona, entonces se requiere la opción enabled y la interfaz de red principal denominada nic0 se asume de forma predeterminada. Si tiene varias interfaces de red, puede especificar este indicador para cada IP en cada interfaz de red.

• DELETE_RULE : (Opcional). Prescribe lo que debe suceder con un recurso de dirección estática asociado cuando una instancia de VM se elimina permanentemente. Las opciones disponibles son las siguientes:

  • never : (predeterminado). Nunca elimine la dirección IP estática. En su lugar, anule la asignación de la dirección al eliminar la instancia y mantenga la dirección reservada.
  • on-permanent-instance-deletion : Elimina la reserva de dirección IP estática cuando una instancia se elimina permanentemente del grupo de instancias, por ejemplo, cuando eliminas una instancia manualmente o disminuyes el tamaño del grupo.

  Independientemente del valor de la regla de eliminación, el grupo siempre conserva las direcciones IP con estado en las operaciones de recuperación, actualización y recreación automática de la instancia.

Si una dirección IP especificada ya está configurada en la política con estado para una interfaz de red determinada, el comando actualiza la configuración.

Ejemplo

Debe exponer un servidor de archivos, que se ejecuta en un MIG con estado llamado example-fs-group , a usuarios externos a través de direcciones IP externas estáticas. Las instancias del grupo tienen direcciones IP externas efímeras. Debe asegurarse de que las direcciones IP se conserven en la reparación automática y las actualizaciones de la instancia para que los usuarios externos tengan acceso continuo a los servidores a través de las direcciones IP publicadas. También debe mantener las direcciones IP reservadas para garantizar la continuidad en caso de eliminación involuntaria del grupo.

Actualice el MIG para definir las direcciones IP externas como con estado mediante el siguiente comando:

gcloud compute instance-groups managed update example-fs-group \
    --stateful-external-ip enabled

Como resultado, el grupo promueve direcciones IP externas efímeras dentro de la interfaz de red nic0 a direcciones IP estáticas para todas las instancias administradas de forma asíncrona.

Las direcciones IP externas ahora se conservan en eventos de recreación, actualización y reparación automática de instancias. Las reservas de direcciones IP estáticas asociadas no se asignan y se conservan al eliminar la instancia porque la regla auto-delete no especificada está configurada en never de forma predeterminada.

Puedes verificar que la IP externa con estado esté configurada en la política con estado ejecutando el comando gcloud compute instance-groups managed describe example-fs-group .

DESCANSAR

Para especificar qué direcciones IP deben tener estado o actualizar la configuración de IP con estado para un MIG existente, utilice el método instanceGroupManagers.patch o regionInstanceGroupManagers.patch :

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "statefulPolicy": {
    "preservedState": {
      "internalIPs": {
        "NI_NAME": {"autoDelete": "DELETE_RULE" }
      },
      "externalIPs": {
        "NI_NAME": {"autoDelete": "DELETE_RULE" }
      }
    }
  }
}

Reemplace lo siguiente:

• PROJECT : El ID del proyecto para la solicitud.
• REGION : Para MIG regionales, la región donde se encuentra el grupo. Para MIG zonales, reemplace regions/ REGION con zones/ ZONE y especifique la zona donde se encuentra el MIG.
• NAME : El nombre del MIG a crear.
• NI_NAME : (Obligatorio) Nombre de la interfaz de red. La interfaz de red principal se denomina nic0 . Si tiene varias interfaces de red, puede especificar varios NI_NAMES .

• DELETE_RULE : (Opcional) Prescribe lo que debe suceder con un recurso de dirección estática asociado cuando una instancia de VM se elimina permanentemente. Las opciones disponibles son las siguientes:

  • NEVER : (Predeterminado) Nunca elimine la dirección IP estática. En su lugar, anule la asignación de la dirección al eliminar la instancia y mantenga la dirección reservada.
  • ON_PERMANENT_INSTANCE_DELETION : elimina la reserva de dirección IP estática cuando una instancia se elimina permanentemente del grupo de instancias, por ejemplo, cuando elimina una instancia manualmente o disminuye el tamaño del grupo.

  Independientemente del valor de la regla de eliminación, el grupo siempre conserva las direcciones IP con estado en las operaciones de recuperación, actualización y recreación automática de la instancia.

Si una dirección IP especificada ya está configurada en la política con estado, el método parchea la configuración.

Ejemplo

Debe exponer un servidor de archivos, que se ejecuta en un MIG con estado llamado example-fs-group , a usuarios externos a través de direcciones IP externas estáticas. Las instancias del grupo tienen direcciones IP externas efímeras. Debe asegurarse de que las direcciones IP se conserven en la reparación automática y las actualizaciones de la instancia para que los usuarios externos tengan acceso continuo a los servidores a través de la interfaz de red publicada. También debe mantener las direcciones IP reservadas para garantizar la continuidad en caso de eliminación involuntaria del grupo.

Parchee el MIG para definir las direcciones IP externas como con estado:

PATCH https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/example-fs-group

{
  "statefulPolicy": {
    "preservedState": {
      "externalIPs": {
        "nic0": {"autoDelete": "NEVER" }
      }
    }
  }
}

Como resultado, el grupo promueve direcciones IP externas efímeras dentro de la interfaz de red nic0 a direcciones IP estáticas para todas las instancias administradas de forma asíncrona.

Las direcciones IP externas ahora se conservan en eventos de recreación, actualización y reparación automática de instancias. Las reservas de direcciones IP estáticas asociadas se desasignarán y se conservarán al eliminar la instancia porque la regla autoDelete está configurada en NEVER .

Verifique que la dirección IP externa esté configurada en la política con estado viendo el recurso regionInstanceGroupManagers , devuelto por el método regionInstanceGroupManagers.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 para las direcciones IP.

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

4. En Configuración con estado , expanda la IP externa y la IP interna 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é direcciones IP de la política con estado de un MIG se deben convertir en efímeras, usa la marca --remove-stateful-internal-ips o --remove-stateful-external-ips con el comando gcloud compute instance-groups managed update :

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --remove-stateful-internal-ips NI_NAME[,NI_NAME,...] \
    --remove-stateful-external-ips NI_NAME[,NI_NAME,...]

Reemplace lo siguiente:

• INSTANCE_GROUP_NAME : el nombre del MIG a actualizar.
• NI_NAME : (Obligatorio). Nombre de la interfaz de red. La interfaz de red principal se denomina nic0 . Si tiene varias interfaces de red, puede especificar varios NI_NAMES .

Si necesita convertir una dirección IP con estado de la interfaz de red primaria predeterminada llamada nic0 en una dirección IP efímera, también puede usar el siguiente comando:

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --stateful-internal-ip disabled \
    --stateful-external-ip disabled

Ejemplo

Su aplicación ha estado expuesta a los usuarios a través de direcciones IP externas estáticas publicadas de las instancias de VM en un MIG llamado example-group . Ha rediseñado su servicio implementando un equilibrador de carga frente al MIG y enrutando el tráfico a las máquinas virtuales administradas a través de él. Ya no necesita mantener las direcciones IP externas estáticas y le gustaría que las direcciones IP externas de las máquinas virtuales sean efímeras.

Para hacer que las direcciones IP externas con estado de las máquinas virtuales en un MIG sean efímeras, ejecute el siguiente comando:

gcloud compute instance-groups managed update example-group \
    --remove-stateful-external-ips nic0

El MIG elimina las direcciones IP externas estáticas de la interfaz de red nic0 de forma automática y asíncrona del estado preservado de todas las instancias del grupo. Las direcciones IP externas permanecen activas en las instancias, pero ya no tienen estado. Cuando vuelve a crear o actualiza las instancias, o cuando las instancias se reparan automáticamente, el MIG desasigna las direcciones IP estáticas asociadas y asigna automáticamente direcciones efímeras. Si ya no necesita conservar las reservas de direcciones IP externas estáticas, ahora puede liberarlas .

DESCANSAR

Para especificar qué direcciones IP de la política con estado de un MIG se deben convertir en efímeras, elimine la configuración de cada IP de la política con estado del MIG mediante el método instanceGroupManagers.patch o regionInstanceGroupManagers.patch :

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "statefulPolicy": {
    "preservedState": {
      "internalIPs": {
        "NI_NAME": null
      },
      "externalIPs": {
        "NI_NAME": null
      }
    }
  }
}

Reemplace lo siguiente:

• PROJECT : El ID del proyecto para la solicitud.
• REGION : Para MIG regionales, la región donde se encuentra el grupo. Para MIG zonales, reemplace regions/ REGION con zones/ ZONE y especifique la zona donde se encuentra el MIG.
• INSTANCE_GROUP_NAME : el nombre del MIG a crear.
• NI_NAME : (Obligatorio) Nombre de la interfaz de red. La interfaz de red principal se denomina nic0 . Si tiene varias interfaces de red, puede especificar varios NI_NAMES .

Ejemplo

Su aplicación ha estado expuesta a los usuarios a través de direcciones IP externas estáticas publicadas de las instancias de VM en un MIG llamado example-group . Ha rediseñado su servicio implementando un equilibrador de carga frente al MIG y enrutando el tráfico a las máquinas virtuales administradas a través de él. Ya no necesita mantener las direcciones IP externas estáticas y le gustaría que las direcciones IP externas de las máquinas virtuales sean efímeras.

Para hacer que las direcciones IP externas con estado de las VM en un MIG sean efímeras, parchee el MIG:

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

{
  "statefulPolicy": {
    "preservedState": {
      "externalIPs": {
        "nic0": null
      }
    }
  }
}

El MIG elimina las direcciones IP externas estáticas de la interfaz de red nic0 de forma automática y asíncrona del estado preservado de todas las instancias del grupo. Las direcciones IP externas permanecen activas en las instancias, pero ya no tienen estado. Cuando vuelve a crear o actualiza las instancias, o cuando las instancias se reparan automáticamente, el MIG desasigna las direcciones IP estáticas asociadas y asigna automáticamente direcciones efímeras. Si ya no necesita conservar las reservas de direcciones IP externas estáticas, ahora puede liberarlas .

nube de gcloud

Para crear una instancia con una dirección IP estática predefinida, usa el comando gcloud compute instance-groups managed create-instance con una o varias de las siguientes marcas:

• --stateful-internal-ip para establecer una dirección IP interna estática de una interfaz de red determinada.
• --stateful-external-ip para establecer una dirección IP externa estática de una interfaz de red determinada.

gcloud compute instance-groups managed create-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    --stateful-internal-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    --stateful-external-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE]

Reemplace lo siguiente:

• INSTANCE_GROUP_NAME : El nombre del MIG.
• INSTANCE_NAME : el nombre de la instancia a crear.
• NI_NAME : (Opcional.) Nombre de la interfaz de red. Si no se proporciona, la interfaz de red principal denominada nic0 se asume de forma predeterminada. Si tiene varias interfaces de red, puede especificar este indicador para cada IP en cada interfaz de red.

• ADDRESS : (Requerido). Dirección IP estática para asignar a la instancia en uno de los siguientes formatos:

  • DIRECCIÓN. URL de una reserva de dirección IP estática, por ejemplo: "projects/example-project/regions/us-east1/addresses/example-ip-name" .
  • Literal - Por ejemplo: "130.211.181.55" .
    • Si la dirección IP proporcionada aún no está reservada, el MIG crea automáticamente una reserva de dirección IP correspondiente.
    • Si la dirección IP proporcionada está reservada, el MIG asigna la reserva a la instancia.

• DELETE_RULE : (opcional) prescribe lo que debería suceder a un recurso de dirección estática asociada cuando una instancia de VM se elimina permanentemente. Las opciones disponibles son las siguientes:

  • never : (predeterminado). Nunca elimine la dirección IP estática. En su lugar, desassee la dirección en la eliminación de instancias y mantenga la dirección reservada.
  • on-permanent-instance-deletion : elimine la reserva de dirección IP estática cuando una instancia se elimina permanentemente del grupo de instancias, por ejemplo, cuando elimina una instancia manualmente o disminuye el tamaño del grupo.

  Independientemente del valor de la regla de eliminación, el grupo siempre preserva las direcciones IP con estado en las operaciones de autohealing, actualización y recreación de instancias.

Ejemplo

Debe agregar una instancia de VM más a su clúster Proxy Server, que se ejecuta en un MIG llamado proxy-cluster . Ha creado una reserva de dirección IP interna estática llamada proxy-node-03-ip y necesita asignarla al nuevo nodo. Desea mantener la reserva de dirección IP incluso si decide eliminar el nodo en el futuro.

Ejecute el siguiente comando para crear el nodo:

gcloud compute instance-groups managed create-instance proxy-cluster \
    --instance proxy-node-03 \
    --stateful-internal-ip address="projects/example-project/regions/us-east1/addresses/proxy-node-03-ip",auto-delete=never

El comando crea una instancia llamada proxy-node-03 , asigna la dirección IP interna estática proporcionada llamada proxy-node-03-ip a la instancia, y almacena la configuración de estado para la IP en la configuración correspondiente por instancia . Debido a que el indicador auto-delete se establece para never , la IP permanece reservada si elimina la instancia más adelante.

Terraformar

Para crear una VM con una dirección IP estática predefinida, use uno o múltiples de los siguientes bloques:

• preserved_state.internal_ip para marcar una dirección IP interna de una interfaz de red dada como con estado.
• preserved_state.external_ip para marcar una dirección IP externa de una interfaz de red dada como con estado.

La siguiente muestra configura direcciones IP estáticas en la creación de VM en un MIG regional. Para obtener más información sobre el recurso utilizado en la muestra, consulte google_compute_region_per_instance_config Resource . Para un MIG zonal, use el recurso google_compute_per_instance_config .

resource "google_compute_region_per_instance_config" "default" {
  region_instance_group_manager = google_compute_region_instance_group_manager.default.name
  region                        = google_compute_region_instance_group_manager.default.region
  name                          = "proxy-node-03-ip"
  preserved_state {
    internal_ip {
      interface_name = "nic0"
      auto_delete    = "NEVER"
      ip_address {
        address = google_compute_address.default.id
      }
    }
  }
}

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

DESCANSAR

Para crear una o múltiples instancias en un MIG, establecer nombres de instancias personalizados y asignar direcciones IP estáticas predefinidas a estas instancias, use el Método de instanceGroupManagers.createInstances o regionInstanceGroupManagers.createInstances .

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/createInstances

{
  "instances": [
    {
      "name": "INSTANCE_NAME",
      "preservedState" : {
        "internalIPs": {
          "NI_NAME" : {
            "ipAddress": {
              "address": "ADDRESS",
              "literal": "LITERAL"
            },
            "autoDelete": "DELETE_RULE"
          },
          ...
        },
        "externalIPs": {
          "NI_NAME" : {
            "ipAddress": {
              "address": "ADDRESS",
              "literal": "LITERAL"
            },
            "autoDelete": "DELETE_RULE"
          },
          ...
        },
        ...
      }
    },
    ...
  ]
}

Reemplace lo siguiente:

• PROJECT_ID : el ID del proyecto para la solicitud.
• NAME : El nombre del MIG.
• REGION : para los MIG regionales, la región donde se encuentra el grupo. Para los MIG zonales, reemplace regions/ REGION con zones/ ZONE y especifique la zona donde se encuentra el MIG.
• INSTANCE_NAME : el nombre de la instancia para crear.
• NI_NAME : (requerido.) Nombre de la interfaz de red. La interfaz de red primaria se llama nic0 . Si tiene múltiples interfaces de red, puede especificar múltiples NI_NAMES .
• ADDRESS : (Opcional.) Dirección IP estática para asignar a la instancia en el formato de una URL de una reserva de dirección IP estática, por ejemplo: "projects/example-project/regions/us-east1/addresses/example-ip-name" . Debe y solo puede establecer un campo a la vez, ya sea address o literal , al asignar una dirección IP estática.
• LITERAL : (Opcional.) Dirección IP estática para asignar a la instancia en el formato literal, por ejemplo: "130.211.181.55" . Debe y solo puede establecer un campo a la vez, ya sea address o literal , al asignar una dirección IP estática.
  • Si la dirección IP literal proporcionada aún no está reservada, el MIG crea automáticamente una reserva de dirección IP correspondiente.
  • Si se reserva la dirección IP literal proporcionada, el MIG asigna la reserva a la instancia.

• DELETE_RULE : (opcional) prescribe lo que debería suceder a un recurso de dirección estática asociada cuando una instancia de VM se elimina permanentemente. Las opciones disponibles son las siguientes:

  • NEVER : (predeterminado). Nunca elimine la dirección IP estática. En su lugar, desassee la dirección en la eliminación de instancias y mantenga la dirección reservada.
  • ON_PERMANENT_INSTANCE_DELETION : elimine la reserva de dirección IP estática cuando una instancia se elimina permanentemente del grupo de instancia, por ejemplo, cuando elimina una instancia manualmente o disminuye el tamaño del grupo.

  Independientemente del valor de la regla de eliminación, el grupo siempre preserva las direcciones IP con estado en las operaciones de autohealing, actualización y recreación de instancias.

Ejemplo

Debe agregar una instancia de VM más a su clúster Proxy Server, que se ejecuta en un MIG llamado proxy-cluster . Ha creado una reserva de dirección IP interna estática llamada proxy-node-03-ip y necesita asignarla al nuevo nodo. Desea mantener la reserva de dirección IP incluso si decide eliminar el nodo en el futuro.

Llame al Método regionInstanceGroupManagers.createInstances para crear una instancia adicional:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/proxy-cluster/createInstances

{
  "instances": [
    {
      "name": "proxy-node-03",
      "preservedState" : {
        "internalIPs": {
          "nic0" : {
            "ipAddress": {
              "address": "projects/example-project/regions/us-east1/addresses/proxy-node-03-ip"
            },
            "autoDelete": "NEVER"
          }
        }
      }
    }
  ]
}

El método crea una instancia llamada proxy-node-03 , asigna la dirección IP interna estática proporcionada llamada proxy-node-03-ip a la instancia, y almacena la configuración de estado para la IP en la configuración correspondiente por instancia . Debido a que el campo autoDelete se establece para NEVER , la IP permanece reservada si elimina la instancia más adelante.

nube de gcloud

Para configurar una dirección IP con estado individualmente para una instancia de VM en un MIG, agregue o actualice la configuración IP con estado en la configuración asociada por instancia.

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

• --stateful-internal-ip para establecer una dirección IP interna estática de una interfaz de red dada.
• --stateful-external-ip para establecer una dirección IP externa estática de una interfaz de red dada.

gcloud compute instance-groups managed instance-configs create INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    --stateful-internal-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    --stateful-external-ip address=ADDRESS[,interface-name=NI_NAME][,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 con una o múltiples --stateful-internal-ip o --stateful-external-ip :

gcloud compute instance-groups managed instance-configs update INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    --stateful-internal-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    --stateful-external-ip address=ADDRESS[,interface-name=NI_NAME][,auto-delete=DELETE_RULE] \
    [--no-update-instance | --update-instance]
    [--instance-update-minimal-action MINIMAL_ACTION]

Reemplace lo siguiente:

• INSTANCE_GROUP_NAME : el nombre del MIG.
• INSTANCE_NAME : el nombre de la instancia para la cual configurar direcciones IP con estado.
• NI_NAME : (Opcional.) Nombre de la interfaz de red. Si no se proporciona, la interfaz de red primaria llamada nic0 se supone de forma predeterminada. Si tiene múltiples interfaces de red, puede especificar este indicador para cada IP en cada interfaz de red.
• ADDRESS : dirección IP estática para asignar a la instancia en uno de los siguientes formatos:
  • DIRECCIÓN. URL de una reserva de dirección IP estática, por ejemplo: "projects/example-project/regions/us-east1/addresses/example-ip-name" .
  • Literal. Por ejemplo: "130.211.181.55" .
    • Si la dirección IP proporcionada aún no está reservada, el MIG crea automáticamente una reserva de dirección IP correspondiente.
    • Si la dirección IP proporcionada está reservada, el MIG asigna la reserva a la instancia.
  • Este subflag es opcional si la dirección ya está definida en la configuración de la instancia de la instancia. En caso contrario se requiere.
  • Si se omite, la dirección configurada permanece sin cambios.

• DELETE_RULE : (opcional) prescribe lo que debería suceder a un recurso de dirección estática asociada cuando una instancia de VM se elimina permanentemente. Las opciones disponibles son las siguientes:

  • never : (predeterminado). Nunca elimine la dirección IP estática. En su lugar, desassee la dirección en la eliminación de instancias y mantenga la dirección reservada.
  • on-permanent-instance-deletion : elimine la reserva de dirección IP estática cuando una instancia se elimina permanentemente del grupo de instancias, por ejemplo, cuando elimina una instancia manualmente o disminuye el tamaño del grupo.
  • Si se omite, el valor predeterminado se establece para una nueva configuración de IP con estado; el valor permanece sin cambios en una configuración existente.

  Independientemente del valor de la regla de eliminación, el grupo siempre preserva las direcciones IP con estado en las operaciones de autohealing, actualización y recreación de instancias.

• --update-instance : (Opcional. Default.) Aplique los cambios inmediatamente a la instancia. Si usa el indicador --no-update-instance , los cambios permanecen sin aplicar y se aplicarán cuando recreará o aplique la actualización a la instancia más adelante.

• MINIMAL_ACTION : (Opcional.) 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 los siguientes:

  • none : ninguna acción.
  • refresh : aplique actualizaciones que sean posibles para aplicar sin detener la instancia.
  • restart : detén la instancia y luego comience nuevamente.
  • replace : Recree la instancia.

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

Ejemplo

Tiene una instancia del servidor de archivos llamado file-server , que es una sola instancia en un MIG con estado llamado fs-group . El grupo tiene una configuración correspondiente por instancia, donde se configura un disco de datos con estado. El servidor de archivos solo ha sido accesible internamente, pero ahora tiene usuarios que necesitan acceder a él externamente a través de una dirección IP estática. Ha reservado la IP externa estática creando reserva de dirección file-server-ip . Ahora debe asignar esta IP a la instancia del servidor de archivos.

Ejecute el siguiente comando para configurar la IP externa con estado para la instancia del servidor de archivos:

gcloud compute instance-groups managed instance-configs update fs-group \
    --instance file-server \
    --stateful-external-ip interface-name=nic0,address="projects/example-project/regions/us-east1/addresses/file-server-ip",auto-delete=never \
    --update-instance

El comando hace lo siguiente:

1. Actualiza la configuración por instancia para la instancia file-server :
   1. Agrega una configuración de IP externa con estado, señalando la reserva de dirección file-server-ip .
   2. Mantiene la configuración de disco de datos estatal existente sin cambios.
2. Aplica la actualización de configuración por instancia a la instancia file-server inmediatamente porque se incluye el indicador --update-instance : actualiza la instancia y asigna la dirección IP externa estática desde la reserva de file-server-ip .

DESCANSAR

Para configurar IPS con estado individualmente para instancias de VM en un MIG, agregue o actualice la configuración IP con estado en las configuraciones asociadas por instancia.

Si las configuraciones por instancia aún no existen para las instancias dadas, use el método de instanceGroupManagers.updatePerInstanceConfigs o el método regionInstanceGroupManagers.updatePerInstanceConfigs con configuración con estado para una o múltiples direcciones IP:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/updatePerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "INSTANCE_NAME",
      "preservedState" : {
        "internalIPs": {
          "NI_NAME" : {
            "ipAddress": {
              "address": "ADDRESS",
              "literal": "LITERAL"
            },
            "autoDelete": "DELETE_RULE"
          },
          ...
        },
        "externalIPs": {
          "NI_NAME" : {
            "ipAddress": {
              "address": "ADDRESS",
              "literal": "LITERAL"
            },
            "autoDelete": "DELETE_RULE"
          },
          ...
        },
        ...
      },
      "fingerprint: "FINGERPRINT"
    },
    ...
  ]
}

Si ya existen configuraciones por instancia para las instancias dadas, use el método de instanceGroupManagers.patchPerInstanceConfigs o el método regionInstanceGroupManagers.patchPerInstanceConfigs con configuración estatal para una o múltiples direcciones IP:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "INSTANCE_NAME",
      "preservedState" : {
        "internalIPs": {
          "NI_NAME" : {
            "ipAddress": {
              "address": "ADDRESS",
              "literal": "LITERAL"
            },
            "autoDelete": "DELETE_RULE"
          },
          ...
        },
        "externalIPs": {
          "NI_NAME" : {
            "ipAddress": {
              "address": "ADDRESS",
              "literal": "LITERAL"
            },
            "autoDelete": "DELETE_RULE"
          },
          ...
        },
        ...
      },
      "fingerprint: "FINGERPRINT"
    },
    ...
  ]
}

Reemplace lo siguiente:

• PROJECT_ID : el ID del proyecto para la solicitud.
• NAME : El nombre del MIG.
• REGION : para los MIG regionales, la región donde se encuentra el grupo. Para los MIG zonales, reemplace regions/ REGION con zones/ ZONE y especifique la zona donde se encuentra el MIG.
• INSTANCE_NAME : (requerido.) El nombre de la instancia para configurar IPS con estado.
• NI_NAME : (requerido.) Nombre de la interfaz de red. La interfaz de red primaria se llama nic0 . Si tiene múltiples interfaces de red, puede especificar múltiples NI_NAMES .
• ADDRESS : (Opcional.) Dirección IP estática para asignar a la instancia en el formato de una URL de una reserva de dirección IP estática, por ejemplo: "projects/example-project/regions/us-east1/addresses/example-ip-name" . Debe y solo puede establecer un campo a la vez, ya sea una dirección o literal, al asignar una dirección IP estática.
• LITERAL : (Opcional.) Dirección IP estática para asignar a la instancia en el formato literal. Por ejemplo: "130.211.181.55" . Debe y solo puede establecer un campo a la vez, ya sea una dirección o literal, al asignar una dirección IP estática.
  • Si la dirección IP literal proporcionada aún no está reservada, el MIG crea automáticamente una reserva de dirección IP correspondiente.
  • Si se reserva la dirección IP literal proporcionada, el MIG asigna la reserva a la instancia.

• DELETE_RULE : (opcional) prescribe lo que debería suceder a un recurso de dirección estática asociada cuando una instancia de VM se elimina permanentemente. Las opciones disponibles son las siguientes:

  • NEVER : (predeterminado). Nunca elimine la dirección IP estática. En su lugar, desassee la dirección en la eliminación de instancias y mantenga la dirección reservada.
  • ON_PERMANENT_INSTANCE_DELETION : elimine la reserva de dirección IP estática cuando una instancia se elimina permanentemente del grupo de instancia, por ejemplo, cuando elimina una instancia manualmente o disminuye el tamaño del grupo.
  • Si se omite, el valor predeterminado se establece para una nueva configuración de IP con estado; el valor permanece sin cambios en una configuración existente.

  Independientemente del valor de la regla de eliminación, el grupo siempre preserva las direcciones IP con estado 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. Se utiliza para bloqueo optimista. La operación falla si la huella digital es diferente de la prevista, ya que indica que la configuración por instancia se cambió desde la última vez que se leía. Para ver la última huella digital, consulte la salida del método listPerInstanceConfigs para un MIG regional o zonal . Si se omite fingerprint , la operación continúa sin comparación de huellas digitales.

Los métodos updatePerInstanceConfigs y patchPerInstanceConfigs actualizan las configuraciones especificadas por instancia, pero no apliquen las actualizaciones de configuración a las instancias administradas asociadas. Los cambios se aplican a una instancia cuando se le indica al MIG que vuelva a crear o actualizar la instancia. Puede aplicar la actualización manualmente para aplicar los cambios a una instancia.

Ejemplo

Tiene una instancia del servidor de archivos llamado file-server , que es una sola instancia en un MIG con estado llamado fs-group . El grupo tiene una configuración correspondiente por instancia, donde se configura un disco de datos con estado. El servidor de archivos solo ha sido accesible internamente, pero ahora tiene usuarios que necesitan acceder a él externamente a través de una dirección IP estática. Ha reservado la IP externa estática creando reserva de dirección file-server-ip . Ahora debe asignar esta IP a la instancia del servidor de archivos.

Para actualizar la configuración por instancia para file-server con la nueva IP externa de estado, llame al método patchPerInstanceConfigs :

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/fs-group/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "file-server",
      "preservedState" : {
        "externalIPs": {
          "nic0" : {
            "ipAddress": {
              "address": "projects/example-project/regions/us-east1/addresses/file-server-ip"
            },
            "autoDelete": "NEVER"
          }
        }
      }
    }
  ]
}

El método parche la configuración por instancia para la instancia file-server :

1. Agrega una configuración de IP externa con estado, señalando la reserva de dirección file-server-ip .
2. Mantiene la configuración de disco de datos estatal existente sin cambios.

La actualización de la configuración aún no se aplica a la instancia file-server VM. El MIG aplicará la actualización de configuración cuando recree o aplique la actualización a la instancia más adelante.

Para aplicar la actualización de configuración por instancia a la instancia de VM file-server , llame al método regionInstanceGroupManagers.applyUpdatesToInstances para la instancia:

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

{
  "instances": ["/zones/us-east1-b/instances/file-server"]
}

El método asigna la dirección IP externa estática configurada desde la reserva de file-server-ip a la instancia administrada. El método actualiza la instancia file-server para asignar una dirección IP externa.

Debido a que autoDelete está configurado para NEVER en la configuración de IP con estado, la IP permanecerá reservada si elimina la instancia más adelante.

nube de gcloud

Para eliminar una configuración de IP con estado de la configuración asociada por instancia, use el comando gcloud compute instance-groups managed instance-configs update con los indicadores: --remove-stateful-internal-ips o --remove-stateful-external-ips :

gcloud compute instance-groups managed instance-configs update INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    --remove-stateful-internal-ips NI_NAME[,NI_NAME,...] \
    --remove-stateful-external-ips NI_NAME[,NI_NAME,...]
    [--no-update-instance | --update-instance] \
    [--instance-update-minimal-action MINIMAL_ACTION]

Reemplace lo siguiente:

• INSTANCE_GROUP_NAME : el nombre del MIG.
• INSTANCE_NAME : (requerido.) El nombre de la instancia para el cual eliminar la configuración de IP con estado.
• NI_NAME : (requerido.) Nombre de la interfaz de red. La interfaz de red primaria se llama nic0 . Si tiene múltiples interfaces de red, puede especificar múltiples NI_NAMES .
• --update-instance : (Opcional. Default.) Aplique los cambios inmediatamente a la instancia. Si usa el indicador --no-update-instance , los cambios permanecen sin aplicar y se aplicarán cuando recreará o aplique la actualización a la instancia más adelante.

• MINIMAL_ACTION : (Opcional.) Realice al menos la acción especificada al aplicar la actualización de configuración por instancia a la instancia. Esta bandera solo se puede usar junto con la bandera --update-instance . El valor debe ser uno de los siguientes:

  • none : ninguna acción.
  • refresh : aplique actualizaciones que sean posibles para aplicar sin detener la instancia.
  • restart : detén la instancia y luego comience nuevamente.
  • replace : Recree la instancia.

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

Ejemplo

Su aplicación ha sido expuesta a los usuarios a través de direcciones IP estáticas estatales específicas de las instancias de VM en un MIG llamado example-group . Ha realizado su servicio implementando un equilibrador de carga frente al MIG y enrutando el tráfico a las máquinas virtuales administradas a través de él. Ya no necesita mantener las direcciones IP externas estáticas y desea hacer las direcciones IP externas de las máquinas virtuales efímeras.

Para hacer las direcciones IP externas con estado de las máquinas virtuales en un MIG efímero, ejecute el siguiente comando para cada instancia, por ejemplo, para node-1 :

gcloud compute instance-groups managed instance-configs update example-group \
    --instance node-1 \
    --remove-stateful-external-ips nic0 \
    --update-instance

El comando hace lo siguiente:

1. Elimina la configuración con estado para la dirección IP externa dentro de la interfaz de red nic0 desde la configuración por instancia para node-1 .
2. Aplica la actualización de configuración por instancia a la instancia de VM node-1 inmediatamente porque se incluye el indicador --update-instance . La instancia de VM no se interrumpe y sigue sirviendo de la misma IP, lo que ya no es condicionado. El MIG elimina la referencia a la reserva de IP estática de la preservedStateFromConfig de la instancia administrada deConfig y trata la dirección IP externa como efímera. El MIG asignará automáticamente una IP externa en eventos de recreación, actualización o autoalámica de instancias posteriores de instancias posteriores.
3. Después de haber sido no asignado , la IP estática original permanece reservada. Puede liberar la IP si ya no la necesita.

DESCANSAR

Para eliminar una configuración de IP 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/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "INSTANCE_NAME",
      "preservedState" : {
        "internalIPs": {
          "NI_NAME" : null
        },
        "externalIPs": {
          "NI_NAME" : null
        }
      },
      "fingerprint: "FINGERPRINT"
    },
    ...
  ]
}

Reemplace lo siguiente:

• PROJECT_ID : el ID del proyecto para la solicitud.
• NAME : El nombre del MIG.
• REGION : para los MIG regionales, la región donde se encuentra el grupo. Para los MIG zonales, reemplace regions/ REGION con zones/ ZONE y especifique la zona donde se encuentra el MIG.
• INSTANCE_NAME : (requerido.) El nombre de la instancia para el cual eliminar la configuración de IP con estado.
• NI_NAME : (requerido.) Nombre de la interfaz de red. La interfaz de red primaria se llama nic0 . Si tiene múltiples interfaces de red, puede especificar múltiples NI_NAMES .
• FINGERPRINT : (opcional.) La huella digital para la configuración dada si ya existe. Se utiliza para bloqueo optimista. La operación falla si la huella digital es diferente de la prevista, ya que indica que la configuración por instancia se cambió desde la última vez que se leía. Para ver la última huella digital, consulte la salida del método listPerInstanceConfigs para un MIG regional o zonal . Si se omite fingerprint , la operación continúa sin comparación de huellas digitales.

El método patchPerInstanceConfigs actualiza las configuraciones especificadas por instancia, pero no aplica las actualizaciones de configuración a las instancias administradas asociadas. Los cambios se aplican a una instancia cuando se le indica al MIG que vuelva a crear o actualizar la instancia. Puede aplicar la actualización manualmente para aplicar los cambios a una instancia.

Ejemplo

Su aplicación ha sido expuesta a los usuarios a través de direcciones IP estáticas estatales específicas de las instancias de VM en un MIG llamado example-group . Ha realizado su servicio implementando un equilibrador de carga frente al MIG y enrutando el tráfico a las máquinas virtuales administradas a través de él. Ya no necesita mantener las direcciones IP externas estáticas y desea hacer las direcciones IP externas de las máquinas virtuales efímeras.

Para hacer las direcciones IP externas con estado de las máquinas virtuales en un MIG efímero, ejecute el siguiente método para cada instancia, por ejemplo, para node-1 , y proporcione un valor null a la configuración de estado de la interfaz de red:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-east1/instanceGroupManagers/example-group/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "node-1",
      "preservedState" : {
        "externalIPs": {
          "nic0" : null
        }
      }
    }
  ]
}

El método elimina la configuración para la dirección IP con estado dentro de la interfaz de red nic0 desde 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 . El MIG aplica la actualización de configuración en la siguiente instancia recreación o actualización.

Para aplicar la actualización de configuración por instancia a la instancia de VM node-1 , ejecute el método regionInstanceGroupManagers.applyUpdatesToInstances para la instancia:

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

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

El MIG elimina la referencia a la reserva IP estática del campo preservedStateFromConfig para la instancia node-1 y trata la dirección IP como efímera. El MIG asignará automáticamente una IP externa en eventos de recreación, actualización o autoalámica de instancias posteriores de instancias posteriores.

Después de haber sido no asignado , la IP estática original permanece reservada. Puede liberar la IP si ya no la necesita.