public/terraform-provider-google
0
0
Fork 0
mirror of https://github.com/letic/terraform-provider-google.git synced 2024-09-07 01:26:43 +00:00
Code Issues Projects Releases Wiki Activity
0daf28f350
terraform-provider-google/r/compute_instance.html.markdown
Emil Hessman 0daf28f350 docs: consistent use of array configuration syntax 
The Terraform configuration syntax defines what arrays are.
Use the word array consistently throughout the documentation
instead of list.

The corresponding JSON datatype is called array as well, and
since the Terraform configuration syntax is interoperable with
JSON it makes sense to use the term array to describe them.
2015-01-13 06:59:12 +01:00

2.6 KiB
Raw Blame History

layout page_title sidebar_current description
google Google: google_compute_instance docs-google-resource-instance Manages a VM instance resource within GCE.

google_compute_instance

Manages a VM instance resource within GCE.

Example Usage

resource "google_compute_instance" "default" {
	name = "test"
	machine_type = "n1-standard-1"
	zone = "us-central1-a"
	tags = ["foo", "bar"]

	disk {
		image = "debian-7-wheezy-v20140814"
	}

	network {
		source = "default"
	}

	metadata {
		foo = "bar"
	}

	service_account {
		scopes = ["userinfo-email", "compute-ro", "storage-ro"]
	}
}

Argument Reference

The following arguments are supported:

  • name - (Required) A unique name for the resource, required by GCE. Changing this forces a new resource to be created.

  • description - (Optional) A brief description of this resource.

  • machine_type - (Required) The machine type to create.

  • zone - (Required) The zone that the machine should be created in.

  • disk - (Required) Disks to attach to the instance. This can be specified multiple times for multiple disks. Structure is documented below.

  • can_ip_forward - (Optional) Whether to allow sending and receiving of packets with non-matching source or destination IPs. This defaults to false.

  • metadata - (Optional) Metadata key/value pairs to make available from within the instance.

  • network - (Required) Networks to attach to the instance. This can be specified multiple times for multiple networks. Structure is documented below.

  • service_account - (Optional) Service account to attach to the instance.

  • tags - (Optional) Tags to attach to the instance.

The disk block supports:

  • disk - (Required if image not set) The name of the disk (such as those managed by google_compute_disk) to attach.

  • image - (Required if disk not set) The name of the image to base this disk off of.

  • auto_delete - (Optional) Whether or not the disk should be auto-deleted. This defaults to true.

  • type - (Optional) The GCE disk type.

The network block supports:

  • source - (Required) The name of the network to attach this interface to.

  • address - (Optional) The IP address of a reserved IP address to assign to this interface.

The service_account block supports:

  • scopes - (Required) An array of service scopes. Both OAuth2 URLs and gcloud short names are supported.

Attributes Reference

The following attributes are exported:

  • name - The name of the resource.
  • machine_type - The type of machine.
  • zone - The zone the machine lives in.