| --- |
| page_title: "Provider: Google Cloud" |
| description: |- |
| The Terraform provider for Google Cloud is used to configure your Google Cloud infrastructure |
| --- |
| |
| # Terraform provider for Google Cloud |
| |
| The Google Cloud provider is used to configure your [Google Cloud](https://cloud.google.com/) infrastructure. |
| |
| To learn the basics of Terraform using this provider, follow the hands-on |
| [get started tutorials](https://developer.hashicorp.com/terraform/tutorials/gcp-get-started/infrastructure-as-code). |
| For more involved examples, try [provisioning a GKE cluster](https://learn.hashicorp.com/tutorials/terraform/gke) |
| and deploying [Consul-backed Vault into it using Terraform Cloud](https://learn.hashicorp.com/tutorials/terraform/kubernetes-consul-vault-pipeline). |
| |
| Already experienced with Terraform? Check out the [Getting Started](/docs/providers/google/guides/getting_started.html) |
| page for a short introduction to using Terraform with Google Cloud. |
| |
| ## Example Usage |
| |
| A typical provider configuration will look something like: |
| |
| ```hcl |
| provider "google" { |
| project = "my-project-id" |
| region = "us-central1" |
| } |
| ``` |
| |
| See the [provider reference](/docs/providers/google/guides/provider_reference.html) |
| page for details on authentication and configuring the provider. |
| |
| Take advantage of [Modules](https://www.terraform.io/docs/modules/index.html) |
| to simplify your config by browsing the [Module Registry for Google Cloud modules](https://registry.terraform.io/browse?provider=google). |
| |
| The Google Cloud provider is jointly maintained by: |
| |
| * The [Terraform Team](https://cloud.google.com/docs/terraform) at Google |
| * The Terraform team at [HashiCorp](https://www.hashicorp.com/) |
| |
| If you have configuration questions, or general questions about using the provider, try checking out: |
| |
| * [The Google category on discuss.hashicorp.com](https://discuss.hashicorp.com/c/terraform-providers/tf-google/32) |
| * The [Google Cloud Community Slack](https://googlecloud-community.slack.com/) `#terraform` channel. If you are not registered with that Slack Workspace yet, the up-to-date **public sign-up link** can be found in the "Stay Connected" section of the [Google Developer Center](https://cloud.google.com/developers#stay-connected). |
| * [Terraform's community resources](https://www.terraform.io/docs/extend/community/index.html) |
| * [HashiCorp support](https://support.hashicorp.com) for Terraform Enterprise customers |
| |
| ## Releases |
| |
| Interested in the provider's latest features, or want to make sure you're up to date? |
| Check out the [`google` provider Releases](https://github.com/hashicorp/terraform-provider-google/releases) |
| and the [`google-beta` provider Releases](https://github.com/hashicorp/terraform-provider-google-beta/releases) |
| for release notes and additional information. |
| |
| Per [Terraform Provider Versioning](https://www.hashicorp.com/blog/hashicorp-terraform-provider-versioning), |
| the Google Cloud provider follows [semantic versioning](https://semver.org/). |
| |
| In practice, patch / bugfix-only releases of the provider are infrequent. Most |
| provider releases are either minor or major releases. |
| |
| ### Minor Releases |
| |
| The Google Cloud provider currently aims to publish a minor release every week, |
| although the timing of individual releases may differ if required by the |
| provider team. |
| |
| ### Major Releases |
| |
| The Google Cloud provider publishes major releases roughly yearly. An upgrade |
| guide will be published to help ease you through the transition between the |
| prior releases series and the new major release. |
| |
| During major releases, all current deprecation warnings will be resolved, |
| removing the field in question unless the deprecation warning message specifies |
| another resolution. |
| |
| Before a major release, deprecation warnings don't require immediate action. The |
| provider team aims to surface deprecation warnings early in a major release |
| lifecycle to give users plenty of time to safely update their configs. |
| |
| ## Features and Bug Requests |
| |
| The Google Cloud provider's bugs and feature requests can be found in the [GitHub repo issues](https://github.com/hashicorp/terraform-provider-google/issues). |
| Please avoid "me too" or "+1" comments. Instead, use a thumbs up [reaction](https://blog.github.com/2016-03-10-add-reactions-to-pull-requests-issues-and-comments/) |
| 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](https://github.com/hashicorp/terraform-provider-google/issues/new?labels=bug&template=00_bug.yml). |
| |
| * and you'd like the provider to support a new resource or field, [file an enhancement/feature request](https://github.com/hashicorp/terraform-provider-google/issues/new?labels=enhancement&template=01_enhancement.yml). |
| |
| 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 `hashibot` indicates a member of the community has taken on |
| the issue! |
| |
| ## Argument reference |
| |
| See the [provider reference](/docs/providers/google/guides/provider_reference.html) |
| page for details on configuring the provider. |
| |
| ## Contributing |
| |
| If you'd like to help extend the Google Cloud provider, we gladly accept community |
| contributions! Development on the providers is done through the |
| [Magic Modules](https://github.com/GoogleCloudPlatform/magic-modules) |
| repository. Our full contribution guide is available on the |
| [Magic Modules Documentation Site](https://googlecloudplatform.github.io/magic-modules/) |