![Dave Cunningham](/assets/img/avatar_default.png)
Additionally: Update CHANGELOG Make cooldown period optional for autoscaler Refactor autoscaler and add more error checking Instance template now supports image aliases Replace instance group manager 'size' -- use target_size (now writeable) Add documentation for autoscaler Add beta warnings to docs
2.5 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
Google: google_replicapool_instance_group_manager | docs-google-resource-instance_group_manager | Manages an Instance Group within GCE. |
google_replicapool_instance_group_manager
Note: This resource is in beta.
The Google Compute Engine Instance Group Manager API creates and manages pools of homogeneous Compute Engine virtual machine instances from a common instance template. For more information, see [the official documentation](https://cloud.google.com/compute/docs/instance-groups/manager and API
Example Usage
resource "google_replicapool_instance_group_manager" "foobar" {
description = "Terraform test instance group manager"
name = "terraform-test"
instance_template = "${google_compute_instance_template.foobar.self_link}"
target_pools = ["${google_compute_target_pool.foobar.self_link}"]
base_instance_name = "foobar"
zone = "us-central1-a"
target_size = 2
}
Argument Refernce
The following arguments are supported:
-
base_instance_name
- (Required) The base instance name to use for instances in this group. The value must be a valid RFC1035 name. Supported characters are lowercase letters, numbers, and hyphens (-). Instances are named by appending a hyphen and a random four-character string to the base instance name. -
description
- (Optional) An optional textual description of the instance group manager. -
instance_template
- (Required) The full URL to an instance template from which all new instances will be created. -
name
- (Required) The name of the instance group manager. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens. -
target_size
- (Optional) If not given at creation time, this defaults to 1. Do not specify this if you are managing the group with an autoscaler, as this will cause fighting. -
target_pools
- (Required) The full URL of all target pools to which new instances in the group are added. Updating the target pool values does not affect existing instances. -
zone
- (Required) The zone that instances in this group should be created in.
Attributes Reference
The following attributes are exported:
-
group
- The full URL of the instance group created by the manager. -
self_link
- The URL of the created resource.