From 81d082830257846db84f48e7fd0c555a7ddb890b Mon Sep 17 00:00:00 2001 From: David Watson Date: Mon, 16 Feb 2015 16:07:26 +0000 Subject: [PATCH] Add tests for InstanceGroupManagers in GCE. --- ...apool_instance_group_manager.html.markdown | 65 +++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 website/source/docs/providers/google/r/replicapool_instance_group_manager.html.markdown diff --git a/website/source/docs/providers/google/r/replicapool_instance_group_manager.html.markdown b/website/source/docs/providers/google/r/replicapool_instance_group_manager.html.markdown new file mode 100644 index 000000000..671ddb29d --- /dev/null +++ b/website/source/docs/providers/google/r/replicapool_instance_group_manager.html.markdown @@ -0,0 +1,65 @@ +--- +layout: "google" +page_title: "Google: google_replicapool_instance_group_manager" +sidebar_current: "docs-google-resource-instance_group_manager" +description: |- + 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](https://cloud.google.com/compute/docs/instance-groups/manager/v1beta2/instanceGroupManagers) + +## 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](https://www.ietf.org/rfc/rfc1035.txt) 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](https://www.ietf.org/rfc/rfc1035.txt). +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.