gcloud: Wed Oct 11 10:37:28 UTC 2023

gcloud/compute/instance-groups/managed/instance-configs/create

@@ -9,6 +9,10 @@ SYNOPSIS
           default="none"]
         [--stateful-disk=[auto-delete=AUTO-DELETE],
           [device-name=DEVICE-NAME],[mode=MODE],[source=SOURCE]]
+        [--stateful-external-ip=[address=ADDRESS],
+          [auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]]
+        [--stateful-internal-ip=[address=ADDRESS],
+          [auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]]
         [--stateful-metadata=KEY=VALUE,[KEY=VALUE,...]] [--no-update-instance]
         [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...]
 
@@ -36,6 +40,20 @@ EXAMPLES
     does not exist in the group's instance template, then the command adds
     my-disk to my-instance.
 
+    To create a per-instance config with a stateful internal IP 192.168.0.10
+    and a stateful external IP reserved in address my-address, on instance
+    my-instance, run:
+
+        $ gcloud compute instance-groups managed instance-configs create \
+            my-group --region=europe-west4 --instance=my-instance \
+            --stateful-internal-ip=address=192.168.0.10,\
+        interface-name=nic0 \
+            --stateful-external-ip=address=/projects/example-project/\
+        regions/europe-west4/addresses/my-address,interface-name=nic0
+
+    If the provided IP address is not yet reserved, the MIG automatically
+    creates a corresponding IP address reservation.
+
 POSITIONAL ARGUMENTS
      NAME
         Name of the managed instance group to create a per-instance config for.
@@ -99,6 +117,90 @@ OPTIONAL FLAGS
               the group; for example, when the instance is deleted manually or
               when the group size is decreased.
 
+     --stateful-external-ip=[address=ADDRESS],[auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]
+        Managed instance groups preserve stateful IPs on VM autohealing,
+        update, and recreate events.
+
+        You can preserve the IP address that's specified in a network interface
+        for a specific managed instance, even if that network interface is not
+        defined in the group's instance template.
+
+        Use this argument multiple times to attach and preserve multiple IPs.
+
+         interface-name
+            (Optional) Network interface name. If omitted, the default network
+            interface named nic0 is assumed.
+
+                *address*::: Static IP address to assign to the instance in one of
+                the following formats:
+
+            + Address: URL of a static IP address reservation. For example:
+            projects/example-project/regions/us-east1/addresses/example-ip-name.
+
+            + Literal: For example: 130.211.181.55.
+
+            If the provided IP address is not yet reserved, the managed
+            instance group automatically creates the corresponding IP address
+            reservation. If the provided IP address is reserved, the group
+            assigns the reservation to the instance.
+
+         auto-delete
+            (Optional) Prescribes what should happen to an associated static
+            Address resource when a VM instance is permanently deleted.
+            Regardless of the value of the delete rule, stateful IP addresses
+            are always preserved on instance autohealing, update, and
+            recreation operations. The following options are available:
+            ▸ never: (Default) Never delete the static IP address. Instead,
+              unassign the address when its instance is permanently deleted and
+              keep the address reserved.
+            ▸ on-permanent-instance-deletion: Delete the static IP address
+              reservation when the instance that it's assigned to is
+              permanently deleted from the instance group; for example, when
+              the instance is deleted manually or when the group size is
+              decreased.
+
+     --stateful-internal-ip=[address=ADDRESS],[auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]
+        Managed instance groups preserve stateful IPs on VM autohealing,
+        update, and recreate events.
+
+        You can preserve the IP address that's specified in a network interface
+        for a specific managed instance, even if that network interface is not
+        defined in the group's instance template.
+
+        Use this argument multiple times to attach and preserve multiple IPs.
+
+         interface-name
+            (Optional) Network interface name. If omitted, the default network
+            interface named nic0 is assumed.
+
+                *address*::: Static IP address to assign to the instance in one of
+                the following formats:
+
+            + Address: URL of a static IP address reservation. For example:
+            projects/example-project/regions/us-east1/addresses/example-ip-name.
+
+            + Literal: For example: 130.211.181.55.
+
+            If the provided IP address is not yet reserved, the managed
+            instance group automatically creates the corresponding IP address
+            reservation. If the provided IP address is reserved, the group
+            assigns the reservation to the instance.
+
+         auto-delete
+            (Optional) Prescribes what should happen to an associated static
+            Address resource when a VM instance is permanently deleted.
+            Regardless of the value of the delete rule, stateful IP addresses
+            are always preserved on instance autohealing, update, and
+            recreation operations. The following options are available:
+            ▸ never: (Default) Never delete the static IP address. Instead,
+              unassign the address when its instance is permanently deleted and
+              keep the address reserved.
+            ▸ on-permanent-instance-deletion: Delete the static IP address
+              reservation when the instance that it's assigned to is
+              permanently deleted from the instance group; for example, when
+              the instance is deleted manually or when the group size is
+              decreased.
+
      --stateful-metadata=KEY=VALUE,[KEY=VALUE,...]
         Additional metadata to be made available to the guest operating system
         in addition to the metadata defined in the instance template.

gcloud/compute/instance-groups/managed/instance-configs/update

@@ -8,9 +8,15 @@ SYNOPSIS
         [--instance-update-minimal-action=INSTANCE_UPDATE_MINIMAL_ACTION;
           default="none"]
         [--remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...]]
+        [--remove-stateful-external-ips=KEY,[KEY,...]]
+        [--remove-stateful-internal-ips=KEY,[KEY,...]]
         [--remove-stateful-metadata=KEY,[KEY,...]]
         [--stateful-disk=[auto-delete=AUTO-DELETE],
           [device-name=DEVICE-NAME],[mode=MODE],[source=SOURCE]]
+        [--stateful-external-ip=[address=ADDRESS],
+          [auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]]
+        [--stateful-internal-ip=[address=ADDRESS],
+          [auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]]
         [--stateful-metadata=KEY=VALUE,[KEY=VALUE,...]] [--no-update-instance]
         [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...]
 
@@ -43,6 +49,20 @@ EXAMPLES
     for my-disk-1 and my-disk-2; if these disk are not defined in the group's
     instance template, then they are detached.
 
+    To update a per-instance configuration with a stateful internal IP
+    192.168.0.10, on instance my-instance, run:
+
+        $ gcloud compute instance-groups managed instance-configs update \
+            my-group --region=europe-west4 --instance=my-instance \
+            --stateful-internal-ip=address=192.168.0.10,interface-name=nic0
+
+    To update a per-instance configuration to remove a stateful external IP
+    that's defined in network interface nic0, on instance my-instance, run:
+
+        $ gcloud compute instance-groups managed instance-configs update \
+            my-group --region=europe-west4 --instance=my-instance \
+            --remove-stateful-internal-ips=nic0
+
 POSITIONAL ARGUMENTS
      NAME
         Name of the managed instance group to update per-instance config for.
@@ -74,6 +94,14 @@ OPTIONAL FLAGS
         Remove stateful configuration for the specified disks from the
         instance's configuration.
 
+     --remove-stateful-external-ips=KEY,[KEY,...]
+        List of all stateful IP network interface names to remove from the
+        instance's per-instance configuration.
+
+     --remove-stateful-internal-ips=KEY,[KEY,...]
+        List of all stateful IP network interface names to remove from the
+        instance's per-instance configuration.
+
      --remove-stateful-metadata=KEY,[KEY,...]
         Remove stateful configuration for the specified metadata keys from the
         instance's configuration.
@@ -119,6 +147,114 @@ OPTIONAL FLAGS
               the group; for example, when the instance is deleted manually or
               when the group size is decreased.
 
+     --stateful-external-ip=[address=ADDRESS],[auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]
+        Managed instance groups preserve stateful IPs on VM autohealing,
+        update, and recreate events.
+
+        You can preserve the IP address that's specified in a network interface
+        for a specific managed instance, even if that network interface is not
+        defined in the group's instance template.
+
+        Use this argument multiple times to update multiple IPs.
+
+        If a stateful IP with the given network interface name exists in the
+        current per-instance configuration, its properties are replaced by the
+        newly provided ones. Otherwise, a new stateful IP definition is added
+        to the per-instance configuration.
+
+         interface-name
+            (Optional) Network interface name. If omitted, the default network
+            interface named nic0 is assumed.
+
+         address
+            (Optional) Static IP address to assign to the instance in one of
+            the following formats:
+
+            + Address: URL of a static IP address reservation. For example:
+            projects/example-project/regions/us-east1/addresses/example-ip-name.
+
+            + Literal: For example: 130.211.181.55.
+
+            If the provided IP address is not yet reserved, the managed
+            instance group automatically creates the corresponding IP address
+            reservation. If the provided IP address is reserved, the group
+            assigns the reservation to the instance.
+
+            The address flag is optional if an address is already defined in
+            the instance's per-instance configuration. Otherwise it is
+            required.
+
+            If omitted, the currently configured address remains unchanged.
+
+         auto-delete
+            (Optional) Prescribes what should happen to an associated static
+            Address resource when a VM instance is permanently deleted.
+            Regardless of the value of the delete rule, stateful IP addresses
+            are always preserved on instance autohealing, update, and
+            recreation operations. The following options are available:
+            ▸ never: (Default) Never delete the static IP address. Instead,
+              unassign the address when its instance is permanently deleted and
+              keep the address reserved.
+            ▸ on-permanent-instance-deletion: Delete the static IP address
+              reservation when the instance that it's assigned to is
+              permanently deleted from the instance group; for example, when
+              the instance is deleted manually or when the group size is
+              decreased.
+
+     --stateful-internal-ip=[address=ADDRESS],[auto-delete=AUTO-DELETE],[interface-name=INTERFACE-NAME]
+        Managed instance groups preserve stateful IPs on VM autohealing,
+        update, and recreate events.
+
+        You can preserve the IP address that's specified in a network interface
+        for a specific managed instance, even if that network interface is not
+        defined in the group's instance template.
+
+        Use this argument multiple times to update multiple IPs.
+
+        If a stateful IP with the given network interface name exists in the
+        current per-instance configuration, its properties are replaced by the
+        newly provided ones. Otherwise, a new stateful IP definition is added
+        to the per-instance configuration.
+
+         interface-name
+            (Optional) Network interface name. If omitted, the default network
+            interface named nic0 is assumed.
+
+         address
+            (Optional) Static IP address to assign to the instance in one of
+            the following formats:
+
+            + Address: URL of a static IP address reservation. For example:
+            projects/example-project/regions/us-east1/addresses/example-ip-name.
+
+            + Literal: For example: 130.211.181.55.
+
+            If the provided IP address is not yet reserved, the managed
+            instance group automatically creates the corresponding IP address
+            reservation. If the provided IP address is reserved, the group
+            assigns the reservation to the instance.
+
+            The address flag is optional if an address is already defined in
+            the instance's per-instance configuration. Otherwise it is
+            required.
+
+            If omitted, the currently configured address remains unchanged.
+
+         auto-delete
+            (Optional) Prescribes what should happen to an associated static
+            Address resource when a VM instance is permanently deleted.
+            Regardless of the value of the delete rule, stateful IP addresses
+            are always preserved on instance autohealing, update, and
+            recreation operations. The following options are available:
+            ▸ never: (Default) Never delete the static IP address. Instead,
+              unassign the address when its instance is permanently deleted and
+              keep the address reserved.
+            ▸ on-permanent-instance-deletion: Delete the static IP address
+              reservation when the instance that it's assigned to is
+              permanently deleted from the instance group; for example, when
+              the instance is deleted manually or when the group size is
+              decreased.
+
      --stateful-metadata=KEY=VALUE,[KEY=VALUE,...]
         Additional metadata to be made available to the guest operating system
         in addition to the metadata defined in the instance template.