2.4 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
Google: google_replicapool_instance_group_manager | docs-google-resource-instance_group_manager | Managers an Instance Group within GCE. |
google_replicapool_instance_group_manager
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"
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. -
size
- (Required) The desired number of instance to be maintained in this instance group manager. -
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.