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.