» Google Cloud Platform Provider
Want more information about upgrading from 1.X
of the provider to 2.0.0
? Check out the 2.0.0 Upgrade Guide.
The Google provider is used to configure your Google Cloud Platform infrastructure. See the Getting Started page for an introduction to using the provider.
A typical provider configuration will look something like:
provider "google" {
credentials = "${file("account.json")}"
project = "my-project-id"
region = "us-central1"
}
See the provider reference for more details on authenticating or otherwise configuring the provider.
Interested in the provider's latest features, or want to make sure you're up to date? Check out the changelog for version information and release notes.
Take advantage of Modules to simplify your config by browsing the Module Registry for GCP modules.
The Google provider is jointly maintained by:
- The Google Cloud Graphite Team at Google
- The Terraform team at HashiCorp
If you have configuration questions, or general questions about using the provider, try checking out:
- The Google Cloud Platform Community Slack #terraform channel
- Terraform's community resources
- HashiCorp support for Terraform Enterprise customers
» Features and Bug Requests
The Google provider's bugs and feature requests can be found in the GitHub repo issues. Please avoid "me too" or "+1" comments. Instead, use a thumbs up reaction on enhancement requests. Provider maintainers will often prioritize work based on the number of thumbs on an issue.
Community input is appreciated on outstanding issues! We love to hear what use cases you have for new features, and want to provide the best possible experience for you using the Google provider.
If you have a bug or feature request without an existing issue
-
and an existing resource or field is working in an unexpected way, file a bug.
-
and you'd like the provider to support a new resource or field, file an enhancement/feature request.
The provider maintainers will often use the assignee field on an issue to mark who is working on it.
- An issue assigned to an individual maintainer indicates that maintainer is working on the issue
- An issue assigned to the
modular-magician
indicates the feature is being autogenerated by Magic Modules in the immediate future, so direct contributions to that resource are discouraged. - An issue assigned to
hashibot
indicates a member of the community has taken on the issue!
» Contributing
If you'd like to help extend the Google provider, we gladly accept community
contributions! Pull requests should be made against Magic Modules
to ensure they are applied to both google
and google-beta
.
Check out the Magic Modules setup guide to get set up, the provider README for instructions about running your generated code, the HashiCorp contribution guidelines for a Terraform provider development overview, and the Google provider contribution guidelines for our provider-specific advice.
» GCP API Versions
The Google provider supports generally available (GA) and Beta GCP features. We are focusing on filling out general GA feature coverage and on adding support for beta features that customers request. If you need us to support a feature whether GA or beta, please file a feature request!
If you're interested in using Alpha GCP features, you should still file a feature request or thumbs up reaction the existing request if one exists. By filing and reacting to requests, we can gauge your interest in yet-to-be-supported GCP features and make sure that we prioritize support for them when they enter Beta.