<!-- This change is generated by MagicModules. --> /cc @rileykarson
2.6 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
Google Provider Versions | docs-google-provider-versions | How to use the different Google Provider versions |
Google Provider Versions
Starting with version 1.19.0
, there are two versions of the Google provider:
- terraform-provider-google
- terraform-provider-google-beta
All GA products and features are available in both versions of the provider.
From version 2.0.0
onwards, beta features are only available in the beta version of the provider (google-beta
).
Beta GCP Features have no deprecation policy and no SLA, but are otherwise considered to be feature-complete
with only minor outstanding issues after their Alpha period. Beta is when GCP
features are publicly announced, and is when they generally become publicly
available. For more information see the official documentation on GCP launch stages.
The beta provider sends all requests to the beta endpoint for GCP if one exists for that product, regardless of whether the request contains any beta features.
Using multiple provider versions together
To have resources at different API versions, set up provider blocks for each version:
provider "google" {
credentials = "${file("account.json")}"
project = "my-project-id"
region = "us-central1"
}
provider "google-beta" {
credentials = "${file("account.json")}"
project = "my-project-id"
region = "us-central1"
}
In each resource, state which provider that resource should be used with:
resource "google_compute_instance" "ga-instance" {
provider = "google"
# ...
}
resource "google_compute_instance" "beta-instance" {
provider = "google-beta"
# ...
}
If the provider
field is omitted, Terraform will choose one of the versions available to it. To be in control of which version Terraform chooses, be sure to set the provider
field.
Converting resources between versions
Resources can safely be converted from one version to the other without needing to rebuild infrastructure.
To go from GA to beta, change the provider
field from "google"
to "google-beta"
.
To go from beta to GA, do the reverse. If you were previously using beta fields that you no longer wish to use:
- (Optional) Explicitly set the fields back to their default values in your Terraform config file, and run
terraform apply
. - Change the
provider
field to"google"
. - Remove any beta fields from your Terraform config.
- Run
terraform plan
orterraform refresh
+terraform show
to see that the beta fields are no longer in state.