![Paddy](/assets/img/avatar_default.png)
Fix the CI tests we broke with the deprecations for 1.0.0, and update the docs we missed. Also, update the examples.
2.8 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
Google: google_compute_image | docs-google-compute-image | Creates a bootable VM image for Google Compute Engine from an existing tarball. |
google_compute_image
Creates a bootable VM image resource for Google Compute Engine from an existing tarball. For more information see the official documentation and API.
Example Usage
resource "google_compute_image" "bootable-image" {
name = "my-custom-image"
raw_disk {
source = "https://storage.googleapis.com/my-bucket/my-disk-image-tarball.tar.gz"
}
}
resource "google_compute_instance" "vm" {
name = "vm-from-custom-image"
machine_type = "n1-standard-1"
zone = "us-east1-c"
boot_disk {
initialize_params {
image = "${google_compute_image.bootable-image.self_link}"
}
}
network_interface {
network = "default"
}
}
Argument Reference
The following arguments are supported: (Note that one of either source_disk or raw_disk is required)
-
name
- (Required) A unique name for the resource, required by GCE. Changing this forces a new resource to be created. -
source_disk
- The URL of a disk that will be used as the source of the image. Changing this forces a new resource to be created. -
raw_disk
- The raw disk that will be used as the source of the image. Changing this forces a new resource to be created. Structure is documented below. -
create_timeout
- Configurable timeout in minutes for creating images. Default is 4 minutes. Changing this forces a new resource to be created.
The raw_disk
block supports:
-
source
- (Required) The full Google Cloud Storage URL where the disk image is stored. -
sha1
- (Optional) SHA1 checksum of the source tarball that will be used to verify the source before creating the image. -
container_type
- (Optional) The format used to encode and transmit the block device. TAR is the only supported type and is the default.
-
project
- (Optional) The project in which the resource belongs. If it is not provided, the provider project is used. -
description
- (Optional) The description of the image to be created -
family
- (Optional) The name of the image family to which this image belongs. -
labels
- (Optional) A set of key/value label pairs to assign to the image.
Attributes Reference
In addition to the arguments listed above, the following computed attributes are exported:
-
self_link
- The URI of the created resource. -
label_fingerprint
- The fingerprint of the assigned labels.
Import
VM image can be imported using the name
, e.g.
$ terraform import google_compute_image.web-image my-custom-image