Skip to content

Commit 54f8c65

Browse files
modular-magicianupodroidrileykarson
authored
Update beta mentions in Provider docs (#5667) (#11547)
Co-authored-by: upodroid <[email protected]> Co-authored-by: Riley Karson <[email protected]> Signed-off-by: Modular Magician <[email protected]> Co-authored-by: upodroid <[email protected]> Co-authored-by: Riley Karson <[email protected]>
1 parent abe722a commit 54f8c65

File tree

3 files changed

+12
-17
lines changed

3 files changed

+12
-17
lines changed

.changelog/5667.txt

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
```release-note:none
2+
3+
```

website/docs/guides/provider_reference.html.markdown

+1-1
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ authentication options [documented for Google Cloud](https://cloud.google.com/do
9696

9797
Place your credentials in a Terraform Cloud [environment variable](https://www.terraform.io/docs/cloud/workspaces/variables.html):
9898
1. Create an environment variable called `GOOGLE_CREDENTIALS` in your Terraform Cloud workspace.
99-
2. Remove the newline characters from your JSON key file and then paste the credentials into the environment variable value field.
99+
2. Remove the newline characters from your JSON key file and then paste the credentials into the environment variable value field. You can use the tr command to strip newline characters. `cat key.json | tr -s '\n' ' '`
100100
3. Mark the variable as **Sensitive** and click **Save variable**.
101101

102102
All runs within the workspace will use the `GOOGLE_CREDENTIALS` variable to authenticate with Google Cloud Platform.

website/docs/guides/provider_versions.html.markdown

+8-16
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ description: |-
88

99
# Google Provider Versions
1010

11-
Starting with the `1.19.0` release, there are two versions of the Google
11+
Starting with the `1.19.0` release, there are two versions of the Google Cloud Platform
1212
provider:
1313

1414
* `google`
@@ -19,18 +19,13 @@ This documentation (https://registry.terraform.io/providers/hashicorp/google/lat
1919
between both providers, and all generally available (GA) products and features
2020
are available in both versions of the provider.
2121

22-
The `google-beta` provider is distinct from the `google` provider in that it
23-
supports GCP products and features that are in beta, while `google` does not.
24-
Fields and resources that are only present in `google-beta` will be marked as
25-
such in the shared provider documentation.
22+
You may see beta features referenced as Preview since Google simplified the [product launch stages](https://cloud.google.com/blog/products/gcp/google-cloud-gets-simplified-product-launch-stages) in late 2020.
2623

27-
`1.X` series releases of the `google` provider supported beta features; from
28-
`2.0.0` onwards, beta features are only supported in `google-beta`.
24+
The `google-beta` provider is distinct from the `google` provider in that it
25+
supports GCP products and features that are in Preview, while `google` does not.
26+
Fields and resources that are only present in `google-beta` are clearly marked in the provider documentation.
2927

30-
Beta GCP features have no deprecation policy and no SLA, but are otherwise considered to be feature-complete
31-
with only minor outstanding issues after their Alpha period. Beta is when GCP
32-
features are publicly announced, and is when they generally become publicly
33-
available. For more information see [the official documentation on GCP launch stages](https://cloud.google.com/terms/launch-stages).
28+
Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. For more information, see the [launch stage descriptions](https://cloud.google.com/products#product-launch-stages).
3429

3530
The `google-beta` provider sends all requests to the beta endpoint for GCP if
3631
one exists for that product, regardless of whether the request contains any beta
@@ -39,7 +34,7 @@ features.
3934
-> In short, using `google-beta` over `google` is similar to using `gcloud beta`
4035
over `gcloud`. Features that are exclusively available in `google-beta` are GCP
4136
features that are not yet GA, and they will be made available in `google` after
42-
their GA launch.
37+
they go to GA.
4338

4439
## Using the `google-beta` provider
4540

@@ -58,7 +53,6 @@ provider block, which accepts the same arguments as the `google` provider block.
5853

5954
```hcl
6055
provider "google-beta" {
61-
credentials = "${file("account.json")}"
6256
project = "my-project-id"
6357
region = "us-central1"
6458
}
@@ -93,13 +87,11 @@ You can define parallel provider blocks - they will not interfere with each othe
9387

9488
```hcl
9589
provider "google" {
96-
credentials = "${file("account.json")}"
9790
project = "my-project-id"
9891
region = "us-central1"
9992
}
10093
10194
provider "google-beta" {
102-
credentials = "${file("account.json")}"
10395
project = "my-project-id"
10496
region = "us-central1"
10597
}
@@ -126,4 +118,4 @@ To go from beta to GA, do the reverse. If you were previously using beta fields
126118
1. (Optional) Explicitly set the fields back to their default values in your Terraform config file, and run `terraform apply`.
127119
1. Change the `provider` field to `"google"`.
128120
1. Remove any beta fields from your Terraform config.
129-
1. Run `terraform plan` or `terraform refresh`+`terraform show` to see that the beta fields are no longer in state.
121+
1. Run `terraform plan` or `terraform refresh`+`terraform show` to see that the beta fields are no longer in state.

0 commit comments

Comments
 (0)