8.3 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
Google: google_compute_instance_template | docs-google-compute-instance-template | Manages a VM instance template resource within GCE. |
google_compute_instance_template
Manages a VM instance template resource within GCE. For more information see the official documentation and API.
Example Usage
resource "google_compute_instance_template" "foobar" {
name = "terraform-test"
description = "template description"
tags = ["foo", "bar"]
instance_description = "description assigned to instances"
machine_type = "n1-standard-1"
can_ip_forward = false
automatic_restart = true
on_host_maintenance = "MIGRATE"
// Create a new boot disk from an image
disk {
source_image = "debian-7-wheezy-v20160301"
auto_delete = true
boot = true
}
// Use an existing disk resource
disk {
source = "foo_existing_disk"
auto_delete = false
boot = false
}
network_interface {
network = "default"
}
metadata {
foo = "bar"
}
service_account {
scopes = ["userinfo-email", "compute-ro", "storage-ro"]
}
}
Using with Instance Group Manager
Instance Templates cannot be updated after creation with the Google
Cloud Platform API. In order to update an Instance Template, Terraform will
destroy the existing resource and create a replacement. In order to effectively
use an Instance Template resource with an Instance Group Manager resource,
it's recommended to specify create_before_destroy
in a lifecycle block.
Either omit the Instance Template name
attribute, or specify a partial name
with name_prefix
. Example:
resource "google_compute_instance_template" "instance_template" {
name_prefix = "instance-template-"
machine_type = "n1-standard-1"
region = "us-central1"
// boot disk
disk {
...
}
// networking
network_interface {
...
}
lifecycle {
create_before_destroy = true
}
}
resource "google_compute_instance_group_manager" "instance_group_manager" {
name = "instance-group-manager"
instance_template = "${google_compute_instance_template.instance_template.self_link}"
base_instance_name = "instance-group-manager"
zone = "us-central1-f"
target_size = "1"
}
With this setup Terraform generates a unique name for your Instance Template and can then update the Instance Group manager without conflict before destroying the previous Instance Template.
Argument Reference
Note that changing any field for this resource forces a new resource to be created.
The following arguments are supported:
-
disk
- (Required) Disks to attach to instances created from this template. This can be specified multiple times for multiple disks. Structure is documented below. -
machine_type
- (Required) The machine type to create.
-
name
- (Optional) The name of the instance template. If you leave this blank, Terraform will auto-generate a unique name. -
name_prefix
- (Optional) Creates a unique name beginning with the specified prefix. Conflicts withname
. -
can_ip_forward
- (Optional) Whether to allow sending and receiving of packets with non-matching source or destination IPs. This defaults to false. -
description
- (Optional) A brief description of this resource. -
instance_description
- (Optional) A brief description to use for instances created from this template. -
metadata
- (Optional) Metadata key/value pairs to make available from within instances created from this template. -
network_interface
- (Required) Networks to attach to instances created from this template. This can be specified multiple times for multiple networks. Structure is documented below. -
project
- (Optional) The project in which the resource belongs. If it is not provided, the provider project is used. -
region
- (Optional) An instance template is a global resource that is not bound to a zone or a region. However, you can still specify some regional resources in an instance template, which restricts the template to the region where that resource resides. For example, a customsubnetwork
resource is tied to a specific region. Defaults to the region of the Provider if no value is given. -
scheduling
- (Optional) The scheduling strategy to use. More details about this configuration option are detailed below. -
service_account
- (Optional) Service account to attach to the instance. -
tags
- (Optional) Tags to attach to the instance.
The disk
block supports:
-
auto_delete
- (Optional) Whether or not the disk should be auto-deleted. This defaults to true. -
boot
- (Optional) Indicates that this is a boot disk. -
device_name
- (Optional) A unique device name that is reflected into the /dev/ tree of a Linux operating system running within the instance. If not specified, the server chooses a default device name to apply to this disk. -
disk_name
- (Optional) Name of the disk. When not provided, this defaults to the name of the instance. -
source_image
- (Required if source not set) The name of the image to base this disk off of. Accepts same arguments as a google_compute_instance image. -
interface
- (Optional) Specifies the disk interface to use for attaching this disk. -
mode
- (Optional) The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If you are attaching or creating a boot disk, this must read-write mode. -
source
- (Required if source_image not set) The name of the disk (such as those managed bygoogle_compute_disk
) to attach. -
disk_type
- (Optional) The GCE disk type. Can be either"pd-ssd"
,"local-ssd"
, or"pd-standard"
. -
disk_size_gb
- (Optional) The size of the image in gigabytes. If not specified, it will inherit the size of its base image. -
type
- (Optional) The type of GCE disk, can be either"SCRATCH"
or"PERSISTENT"
.
The network_interface
block supports:
-
network
- (Optional) The name of the network to attach this interface to. Usenetwork
attribute for Legacy or Auto subnetted networks andsubnetwork
for custom subnetted networks. -
subnetwork
- (Optional) the name of the subnetwork to attach this interface to. The subnetwork must exist in the sameregion
this instance will be created in. Eithernetwork
orsubnetwork
must be provided. -
access_config
- (Optional) Access configurations, i.e. IPs via which this instance can be accessed via the Internet. Omit to ensure that the instance is not accessible from the Internet (this means that ssh provisioners will not work unless you are running Terraform can send traffic to the instance's network (e.g. via tunnel or because it is running on another cloud instance on that network). This block can be repeated multiple times. Structure documented below.
The access_config
block supports:
nat_ip
- (Optional) The IP address that will be 1:1 mapped to the instance's network ip. If not given, one will be generated.
The service_account
block supports:
scopes
- (Required) A list of service scopes. Both OAuth2 URLs and gcloud short names are supported.
The scheduling
block supports:
-
automatic_restart
- (Optional) Specifies whether the instance should be automatically restarted if it is terminated by Compute Engine (not terminated by a user). This defaults to true. -
on_host_maintenance
- (Optional) Defines the maintenance behavior for this instance. -
preemptible
- (Optional) Allows instance to be preempted. Read more on this here.
Attributes Reference
In addition to the arguments listed above, the following computed attributes are exported:
-
metadata_fingerprint
- The unique fingerprint of the metadata. -
self_link
- The URI of the created resource. -
tags_fingerprint
- The unique fingerprint of the tags.