` | no |
+|------|-------------|------|---------|:--------:|
+| autoscaling\_cpu | Autoscaling, cpu utilization policy block as single element array. https://www.terraform.io/docs/providers/google/r/compute_autoscaler.html#cpu_utilization | `list(map(number))` | `[]` | no |
+| autoscaling\_enabled | Creates an autoscaler for the managed instance group | `string` | `"false"` | no |
+| autoscaling\_lb | Autoscaling, load balancing utilization policy block as single element array. https://www.terraform.io/docs/providers/google/r/compute_autoscaler.html#load_balancing_utilization | `list(map(number))` | `[]` | no |
+| autoscaling\_metric | Autoscaling, metric policy block as single element array. https://www.terraform.io/docs/providers/google/r/compute_autoscaler.html#metric | list(object({
name = string
target = number
type = string
})) | `[]` | no |
+| cooldown\_period | The number of seconds that the autoscaler should wait before it starts collecting information from a new instance. | `number` | `60` | no |
+| distribution\_policy\_zones | The distribution policy, i.e. which zone(s) should instances be create in. Default is all zones in given region. | `list(string)` | `[]` | no |
+| health\_check | Health check to determine whether instances are responsive and able to do work | object({
type = string
initial_delay_sec = number
check_interval_sec = number
healthy_threshold = number
timeout_sec = number
unhealthy_threshold = number
response = string
proxy_header = string
port = number
request = string
request_path = string
host = string
}) | {
"check_interval_sec": 30,
"healthy_threshold": 1,
"host": "",
"initial_delay_sec": 30,
"port": 80,
"proxy_header": "NONE",
"request": "",
"request_path": "/",
"response": "",
"timeout_sec": 10,
"type": "",
"unhealthy_threshold": 5
} | no |
+| hostname | Hostname prefix for instances | `string` | `"default"` | no |
+| instance\_template | Instance template self\_link used to create compute instances | `any` | n/a | yes |
+| max\_replicas | The maximum number of instances that the autoscaler can scale up to. This is required when creating or updating an autoscaler. The maximum number of replicas should not be lower than minimal number of replicas. | `number` | `10` | no |
+| mig\_timeouts | Times for creation, deleting and updating the MIG resources. Can be helpful when using wait\_for\_instances to allow a longer VM startup time. | object({
create = string
update = string
delete = string
}) | {
"create": "5m",
"delete": "15m",
"update": "5m"
} | no |
+| min\_replicas | The minimum number of replicas that the autoscaler can scale down to. This cannot be less than 0. | `number` | `2` | no |
+| named\_ports | Named name and named port. https://cloud.google.com/load-balancing/docs/backend-service#named_ports | list(object({
name = string
port = number
})) | `[]` | no |
+| network | Network to deploy to. Only one of network or subnetwork should be specified. | `string` | `""` | no |
+| project\_id | The GCP project ID | `string` | `null` | no |
+| region | The GCP region where the managed instance group resides. | `any` | n/a | yes |
+| stateful\_disks | Disks created on the instances that will be preserved on instance delete. https://cloud.google.com/compute/docs/instance-groups/configuring-stateful-disks-in-migs | list(object({
device_name = string
delete_rule = string
})) | `[]` | no |
+| subnetwork | Subnet to deploy to. Only one of network or subnetwork should be specified. | `string` | `""` | no |
+| subnetwork\_project | The project that subnetwork belongs to | `string` | `""` | no |
+| target\_pools | The target load balancing pools to assign this group to. | `list(string)` | `[]` | no |
+| target\_size | The target number of running instances for this managed instance group. This value should always be explicitly set unless this resource is attached to an autoscaler, in which case it should never be set. | `number` | `1` | no |
+| update\_policy | The rolling update policy. https://www.terraform.io/docs/providers/google/r/compute_region_instance_group_manager.html#rolling_update_policy | list(object({
max_surge_fixed = number
instance_redistribution_type = string
max_surge_percent = number
max_unavailable_fixed = number
max_unavailable_percent = number
min_ready_sec = number
minimal_action = string
type = string
})) | `[]` | no |
+| wait\_for\_instances | Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, Terraform will continue trying until it times out. | `string` | `"false"` | no |
## Outputs
| Name | Description |
|------|-------------|
+| health\_check\_self\_links | All self\_links of healthchecks created for the instance group. |
| instance\_group | Instance-group url of managed instance group |
+| instance\_group\_manager | An instance of google\_compute\_region\_instance\_group\_manager of the instance group. |
| self\_link | Self-link of managed instance group |
diff --git a/modules/mig/main.tf b/modules/mig/main.tf
index 4bb37f35..d1bfe61a 100644
--- a/modules/mig/main.tf
+++ b/modules/mig/main.tf
@@ -55,6 +55,8 @@ resource "google_compute_region_instance_group_manager" "mig" {
target_pools = var.target_pools
target_size = var.autoscaling_enabled ? null : var.target_size
+ wait_for_instances = var.wait_for_instances
+
dynamic "auto_healing_policies" {
for_each = local.healthchecks
content {
@@ -63,17 +65,26 @@ resource "google_compute_region_instance_group_manager" "mig" {
}
}
+ dynamic "stateful_disk" {
+ for_each = var.stateful_disks
+ content {
+ device_name = stateful_disk.value.device_name
+ delete_rule = lookup(stateful_disk.value, "delete_rule", null)
+ }
+ }
+
distribution_policy_zones = local.distribution_policy_zones
dynamic "update_policy" {
for_each = var.update_policy
content {
- max_surge_fixed = lookup(update_policy.value, "max_surge_fixed", null)
- max_surge_percent = lookup(update_policy.value, "max_surge_percent", null)
- max_unavailable_fixed = lookup(update_policy.value, "max_unavailable_fixed", null)
- max_unavailable_percent = lookup(update_policy.value, "max_unavailable_percent", null)
- min_ready_sec = lookup(update_policy.value, "min_ready_sec", null)
- minimal_action = update_policy.value.minimal_action
- type = update_policy.value.type
+ instance_redistribution_type = lookup(update_policy.value, "instance_redistribution_type", null)
+ max_surge_fixed = lookup(update_policy.value, "max_surge_fixed", null)
+ max_surge_percent = lookup(update_policy.value, "max_surge_percent", null)
+ max_unavailable_fixed = lookup(update_policy.value, "max_unavailable_fixed", null)
+ max_unavailable_percent = lookup(update_policy.value, "max_unavailable_percent", null)
+ min_ready_sec = lookup(update_policy.value, "min_ready_sec", null)
+ minimal_action = update_policy.value.minimal_action
+ type = update_policy.value.type
}
}
@@ -81,6 +92,12 @@ resource "google_compute_region_instance_group_manager" "mig" {
create_before_destroy = true
ignore_changes = [distribution_policy_zones]
}
+
+ timeouts {
+ create = var.mig_timeouts.create
+ update = var.mig_timeouts.update
+ delete = var.mig_timeouts.delete
+ }
}
resource "google_compute_region_autoscaler" "autoscaler" {
@@ -89,7 +106,8 @@ resource "google_compute_region_autoscaler" "autoscaler" {
name = "${var.hostname}-autoscaler"
project = var.project_id
region = var.region
- target = google_compute_region_instance_group_manager.mig.self_link
+
+ target = google_compute_region_instance_group_manager.mig.self_link
autoscaling_policy {
max_replicas = var.max_replicas
diff --git a/modules/mig/outputs.tf b/modules/mig/outputs.tf
index f2a9052a..8b0fc1e7 100644
--- a/modules/mig/outputs.tf
+++ b/modules/mig/outputs.tf
@@ -25,3 +25,13 @@ output "instance_group" {
description = "Instance-group url of managed instance group"
value = google_compute_region_instance_group_manager.mig.instance_group
}
+
+output "instance_group_manager" {
+ description = "An instance of google_compute_region_instance_group_manager of the instance group."
+ value = google_compute_region_instance_group_manager.mig
+}
+
+output "health_check_self_links" {
+ description = "All self_links of healthchecks created for the instance group."
+ value = local.healthchecks
+}
diff --git a/modules/mig/variables.tf b/modules/mig/variables.tf
index fa5a4c92..a8d2bda1 100644
--- a/modules/mig/variables.tf
+++ b/modules/mig/variables.tf
@@ -52,6 +52,18 @@ variable "distribution_policy_zones" {
default = []
}
+#################
+# Stateful disks
+#################
+variable "stateful_disks" {
+ description = "Disks created on the instances that will be preserved on instance delete. https://cloud.google.com/compute/docs/instance-groups/configuring-stateful-disks-in-migs"
+ type = list(object({
+ device_name = string
+ delete_rule = string
+ }))
+ default = []
+}
+
#################
# Rolling Update
#################
@@ -59,13 +71,14 @@ variable "distribution_policy_zones" {
variable "update_policy" {
description = "The rolling update policy. https://www.terraform.io/docs/providers/google/r/compute_region_instance_group_manager.html#rolling_update_policy"
type = list(object({
- max_surge_fixed = number
- max_surge_percent = number
- max_unavailable_fixed = number
- max_unavailable_percent = number
- min_ready_sec = number
- minimal_action = string
- type = string
+ max_surge_fixed = number
+ instance_redistribution_type = string
+ max_surge_percent = number
+ max_unavailable_fixed = number
+ max_unavailable_percent = number
+ min_ready_sec = number
+ minimal_action = string
+ type = string
}))
default = []
}
@@ -176,3 +189,22 @@ variable "named_ports" {
}))
default = []
}
+
+variable "wait_for_instances" {
+ description = "Whether to wait for all instances to be created/updated before returning. Note that if this is set to true and the operation does not succeed, Terraform will continue trying until it times out."
+ default = "false"
+}
+
+variable "mig_timeouts" {
+ description = "Times for creation, deleting and updating the MIG resources. Can be helpful when using wait_for_instances to allow a longer VM startup time. "
+ type = object({
+ create = string
+ update = string
+ delete = string
+ })
+ default = {
+ create = "5m"
+ update = "5m"
+ delete = "15m"
+ }
+}
diff --git a/modules/mig/versions.tf b/modules/mig/versions.tf
index 37b48316..17e2fb2d 100644
--- a/modules/mig/versions.tf
+++ b/modules/mig/versions.tf
@@ -15,9 +15,15 @@
*/
terraform {
- required_version = "~> 0.12.6"
+ required_version = ">=0.13.0"
required_providers {
- google = ">= 2.7, <4.0"
- google-beta = ">= 2.7, <4.0"
+ google = ">= 3.43, <4.0"
+ google-beta = ">= 3.43, <4.0"
+ }
+ provider_meta "google" {
+ module_name = "blueprints/terraform/terraform-google-vm:mig/v6.0.0"
+ }
+ provider_meta "google-beta" {
+ module_name = "blueprints/terraform/terraform-google-vm:mig/v6.0.0"
}
}
diff --git a/modules/mig_with_percent/README.md b/modules/mig_with_percent/README.md
index 52c2157f..d6acdef8 100644
--- a/modules/mig_with_percent/README.md
+++ b/modules/mig_with_percent/README.md
@@ -16,35 +16,40 @@ The current version is 2.X. The following guides are available to assist with up
## Inputs
| Name | Description | Type | Default | Required |
-|------|-------------|:----:|:-----:|:-----:|
-| autoscaling\_cpu | Autoscaling, cpu utilization policy block as single element array. https://www.terraform.io/docs/providers/google/r/compute_autoscaler.html#cpu_utilization | list(map(number)) | `` | no |
-| autoscaling\_enabled | Creates an autoscaler for the managed instance group | string | `"false"` | no |
-| autoscaling\_lb | Autoscaling, load balancing utilization policy block as single element array. https://www.terraform.io/docs/providers/google/r/compute_autoscaler.html#load_balancing_utilization | list(map(number)) | `` | no |
-| autoscaling\_metric | Autoscaling, metric policy block as single element array. https://www.terraform.io/docs/providers/google/r/compute_autoscaler.html#metric | object | `` | no |
-| cooldown\_period | The number of seconds that the autoscaler should wait before it starts collecting information from a new instance. | string | `"60"` | no |
-| distribution\_policy\_zones | The distribution policy, i.e. which zone(s) should instances be create in. Default is all zones in given region. | list(string) | `` | no |
-| health\_check | Health check to determine whether instances are responsive and able to do work | object | `