github.com/jmbataller/terraform@v0.6.8-0.20151125192640-b7a12e3a580c/website/source/docs/providers/google/r/compute_instance_group_manager.html.markdown (about)

     1  ---
     2  layout: "google"
     3  page_title: "Google: google_compute_instance_group_manager"
     4  sidebar_current: "docs-google-compute-instance-group-manager"
     5  description: |-
     6    Manages an Instance Group within GCE.
     7  ---
     8  
     9  # google\_compute\_instance\_group\_manager
    10  
    11  The Google Compute Engine Instance Group Manager API creates and manages pools
    12  of homogeneous Compute Engine virtual machine instances from a common instance
    13  template.  For more information, see [the official documentation](https://cloud.google.com/compute/docs/instance-groups/manager
    14  and [API](https://cloud.google.com/compute/docs/instance-groups/manager/v1beta2/instanceGroupManagers)
    15  
    16  ## Example Usage
    17  
    18  ```
    19  resource "google_compute_instance_group_manager" "foobar" {
    20  	description = "Terraform test instance group manager"
    21  	name = "terraform-test"
    22  	instance_template = "${google_compute_instance_template.foobar.self_link}"
    23  	target_pools = ["${google_compute_target_pool.foobar.self_link}"]
    24  	base_instance_name = "foobar"
    25  	zone = "us-central1-a"
    26  	target_size = 2
    27  }
    28  ```
    29  
    30  ## Argument Reference
    31  
    32  The following arguments are supported:
    33  
    34  * `base_instance_name` - (Required) The base instance name to use for
    35  instances in this group. The value must be a valid [RFC1035](https://www.ietf.org/rfc/rfc1035.txt) name.
    36  Supported characters are lowercase letters, numbers, and hyphens (-). Instances
    37  are named by appending a hyphen and a random four-character string to the base
    38  instance name.
    39  
    40  * `description` - (Optional) An optional textual description of the instance
    41  group manager.
    42  
    43  * `instance_template` - (Required) The full URL to an instance template from
    44  which all new instances will be created.
    45  
    46  * `name` - (Required) The name of the instance group manager. Must be 1-63
    47  characters long and comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt).
    48  Supported characters include lowercase letters, numbers, and hyphens.
    49  
    50  * `target_size` - (Optional) If not given at creation time, this defaults to 1.  Do not specify this
    51    if you are managing the group with an autoscaler, as this will cause fighting.
    52  
    53  * `target_pools` - (Optional) The full URL of all target pools to which new
    54  instances in the group are added. Updating the target pools attribute does not
    55  affect existing instances.
    56  
    57  * `zone` - (Required) The zone that instances in this group should be created in.
    58  
    59  ## Attributes Reference
    60  
    61  The following attributes are exported:
    62  
    63  * `instance_group` - The full URL of the instance group created by the manager.
    64  
    65  * `self_link` - The URL of the created resource.