mirror of
https://github.com/letic/terraform-provider-google.git
synced 2024-10-07 03:01:06 +00:00
1ec0749d5d
Update the Google Compute Engine provider to add support for service accounts on `google_compute_instance`. Both gcloud shorthand (`compute-ro`, `storage-ro`, etc.) and OAuth2 API endpoints are supported. This feature is currently limited to a single service account (supporting multiple scopes) and an automatically-generated service account email.
103 lines
2.6 KiB
Markdown
103 lines
2.6 KiB
Markdown
---
|
|
layout: "google"
|
|
page_title: "Google: google_compute_instance"
|
|
sidebar_current: "docs-google-resource-instance"
|
|
description: |-
|
|
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) A list 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.
|