Skip to content

Commit 4a06fd2

Browse files
authored
Merge pull request hashicorp#1260 from wayfair/ishashchuk_rigm_rolling
rIGM rolling update support
2 parents 5283ceb + 955ddd7 commit 4a06fd2

File tree

1 file changed

+37
-2
lines changed

1 file changed

+37
-2
lines changed

Diff for: docs/r/compute_region_instance_group_manager.html.markdown

+37-2
Original file line numberDiff line numberDiff line change
@@ -87,6 +87,12 @@ The following arguments are supported:
8787
* `project` - (Optional) The ID of the project in which the resource belongs. If it
8888
is not provided, the provider project is used.
8989

90+
* `update_strategy` - (Optional, Default `"NONE"`) If the `instance_template`
91+
resource is modified, a value of `"NONE"` will prevent any of the managed
92+
instances from being restarted by Terraform. A value of `"ROLLING_UPDATE"`
93+
is supported as [Beta feature]. A value of `"ROLLING_UPDATE"` requires
94+
`rolling_update_policy` block to be set
95+
9096
* `target_size` - (Optional) The target number of running instances for this managed
9197
instance group. This value should always be explicitly set unless this resource is attached to
9298
an autoscaler, in which case it should never be set. Defaults to `0`.
@@ -104,17 +110,46 @@ The following arguments are supported:
104110
* `auto_healing_policies` - (Optional, [Beta](/docs/providers/google/index.html#beta-features)) The autohealing policies for this managed instance
105111
group. You can specify only one value. Structure is documented below. For more information, see the [official documentation](https://cloud.google.com/compute/docs/instance-groups/creating-groups-of-managed-instances#monitoring_groups).
106112

113+
* `rolling_update_policy` - (Optional, [Beta](/docs/providers/google/index.html#beta-features)) The update policy for this managed instance group. Structure is documented below. For more information, see the [official documentation](https://cloud.google.com/compute/docs/instance-groups/updating-managed-instance-groups) and [API](https://cloud.google.com/compute/docs/reference/rest/beta/regionInstanceGroupManagers/patch)
114+
107115
* `distribution_policy_zones` - (Optional, [Beta](/docs/providers/google/index.html#beta-features)) The distribution policy for this managed instance
108116
group. You can specify one or more values. For more information, see the [official documentation](https://cloud.google.com/compute/docs/instance-groups/distributing-instances-with-regional-instance-groups#selectingzones).
109117

118+
The **rolling_update_policy** block supports:
119+
120+
```hcl
121+
rolling_update_policy{
122+
type = "PROACTIVE"
123+
minimal_action = "REPLACE"
124+
max_surge_percent = 20
125+
max_unavailable_fixed = 2
126+
min_ready_sec = 50
127+
}
128+
```
129+
130+
* `minimal_action` - (Required) - Minimal action to be taken on an instance. Valid values are `"RESTART"`, `"REPLACE"`
131+
132+
* `type` - (Required) - The type of update. Valid values are `"OPPORTUNISTIC"`, `"PROACTIVE"`
110133

111-
The `named_port` block supports: (Include a `named_port` block for each named-port required).
134+
* `max_surge_fixed` - (Optional), The maximum number of instances that can be created above the specified targetSize during the update process. Conflicts with `max_surge_percent`. It has to be either 0 or at least equal to the number of zones. If fixed values are used, at least one of `max_unavailable_fixed` or `max_surge_fixed` must be greater than 0.
135+
136+
* `max_surge_percent` - (Optional), The maximum number of instances(calculated as percentage) that can be created above the specified targetSize during the update process. Conflicts with `max_surge_fixed`. Percent value is only allowed for regional managed instance groups with size at least 10.
137+
138+
* `max_unavailable_fixed` - (Optional), The maximum number of instances that can be unavailable during the update process. Conflicts with `max_unavailable_percent`. It has to be either 0 or at least equal to the number of zones. If fixed values are used, at least one of `max_unavailable_fixed` or `max_surge_fixed` must be greater than 0.
139+
140+
* `max_unavailable_percent` - (Optional), The maximum number of instances(calculated as percentage) that can be unavailable during the update process. Conflicts with `max_unavailable_fixed`. Percent value is only allowed for regional managed instance groups with size at least 10.
141+
142+
* `min_ready_sec` - (Optional), Minimum number of seconds to wait for after a newly created instance becomes available. This value must be from range [0, 3600]
143+
- - -
144+
145+
The **named_port** block supports: (Include a `named_port` block for each named-port required).
112146

113147
* `name` - (Required) The name of the port.
114148

115149
* `port` - (Required) The port number.
150+
- - -
116151

117-
The `auto_healing_policies` block supports:
152+
The **auto_healing_policies** block supports:
118153

119154
* `health_check` - (Required) The health check resource that signals autohealing.
120155

0 commit comments

Comments
 (0)