81 lines
1.9 KiB
Markdown
81 lines
1.9 KiB
Markdown
|
---
|
||
|
|
layout: "google"
|
||
|
|
page_title: "Google: google_compute_instance"
|
||
|
|
sidebar_current: "docs-google-resource-instance"
|
||
|
|
---
|
||
|
|
|
||
|
|
# 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"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## 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.
|
||
|
|
|
||
|
|
* `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.
|
||
|
|
|
||
|
|
* `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.
|
||
|
|
|
||
|
|
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.
|
||
|
|
|
||
|
|
## 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.
|