README.md

terraform-google-vm

This is a collection of opinionated submodules that can be used as building blocks to provision VMs in GCP:

• Instance template
• Managed instance group
• Unmanaged instance group

Compatibility

This module is meant for use with Terraform 0.13+ and tested using Terraform 1.0+. If you find incompatibilities using Terraform >=0.13, please open an issue. If you haven't upgraded and need a Terraform 0.12.x-compatible version of this module, the last released version intended for Terraform 0.12.x is v5.1.0.

Examples

Examples of how to use these modules can be found in the examples folder.

Project APIs

The following APIs must be enabled on your project:

• compute.googleapis.com
• iam.googleapis.com

See also the project_services module (optional).

Notes

distribution_policy_zones cannot be changed during use. If you have changed them yourself or used to have a default value, then you'll have to force recreate a MIG group yourself.

Tests

For running the integration test cases, please refer to the CONTRIBUTING documentation.

Permissions

The service account used to execute tests for this module should have the following roles:

• roles/compute.admin
• roles/iam.serviceAccountUser