2.5 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
Google: google_compute_instance_group | docs-google-compute-instance-group | Manages an Instance Group within GCE. |
google_compute_instance_group
The Google Compute Engine Instance Group API creates and manages pools of homogeneous Compute Engine virtual machine instances from a common instance template. For more information, see the official documentation and API
Example Usage
Empty instance group
resource "google_compute_instance_group" "test" {
name = "terraform-test"
description = "Terraform test instance group"
zone = "us-central1-a"
}
With instances and named ports
resource "google_compute_instance_group" "webservers" {
name = "terraform-webservers"
description = "Terraform test instance group"
instances = [
"${google_compute_instance.test.self_link}",
"${google_compute_instance.test2.self_link}"
]
named_port {
name = "http"
port = "8080"
}
named_port {
name = "https"
port = "8443"
}
zone = "us-central1-a"
}
Argument Reference
The following arguments are supported:
-
name
- (Required) The name of the instance group. Must be 1-63 characters long and comply with RFC1035. Supported characters include lowercase letters, numbers, and hyphens. -
zone
- (Required) The zone that this instance group should be created in.
-
description
- (Optional) An optional textual description of the instance group. -
instances
- (Optional) List of instances in the group. They should be given as self_link URLs. When adding instances they must all be in the same network and zone as the instance group. -
named_port
- (Optional) The named port configuration. See the section below for details on configuration. -
project
- (Optional) The project in which the resource belongs. If it is not provided, the provider project is used.
The named_port
block supports:
-
name
- (Required) The name which the port will be mapped to. -
port
- (Required) The port number to map the name to.
Attributes Reference
In addition to the arguments listed above, the following computed attributes are exported:
-
network
- The network the instance group is in. -
self_link
- The URI of the created resource. -
size
- The number of instances in the group.