2.6 KiB

Raw Blame History

layout	page_title	sidebar_current	description
google	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.

2.6 KiB Raw Blame History