mirror of
https://github.com/letic/terraform-provider-google.git
synced 2024-10-03 01:01:06 +00:00
Refresh provider docs in anticipation of 2.0.0 (#2981)
<!-- This change is generated by MagicModules. --> /cc @rileykarson
This commit is contained in:
parent
72959e504c
commit
9c8bea96d8
@ -227,5 +227,7 @@ You can also check out the [GCP Community tutorials](https://cloud.google.com/co
|
|||||||
such as:
|
such as:
|
||||||
|
|
||||||
* [Getting started with Terraform on Google Cloud Platform](https://cloud.google.com/community/tutorials/getting-started-on-gcp-with-terraform)
|
* [Getting started with Terraform on Google Cloud Platform](https://cloud.google.com/community/tutorials/getting-started-on-gcp-with-terraform)
|
||||||
|
|
||||||
* [Managing GCP Projects with Terraform](https://cloud.google.com/community/tutorials/managing-gcp-projects-with-terraform)
|
* [Managing GCP Projects with Terraform](https://cloud.google.com/community/tutorials/managing-gcp-projects-with-terraform)
|
||||||
|
|
||||||
* [Modular Load Balancing with Terraform](https://cloud.google.com/community/tutorials/modular-load-balancing-with-terraform)
|
* [Modular Load Balancing with Terraform](https://cloud.google.com/community/tutorials/modular-load-balancing-with-terraform)
|
||||||
|
@ -8,9 +8,7 @@ description: |-
|
|||||||
|
|
||||||
# Google Cloud Platform Provider
|
# Google Cloud Platform Provider
|
||||||
|
|
||||||
-> We recently introduced the `google-beta` provider. See [Provider Versions](https://terraform.io/docs/providers/google/provider_versions.html)
|
-> Want more information about upgrading from `1.X` of the provider to `2.0.0`? Check out the [2.0.0 Upgrade Guide](https://terraform.io/docs/providers/google/version_2_upgrade.html).
|
||||||
for more details on how to use `google-beta`. The documentation in this site is shared between both `google` and `google-beta`; fields or
|
|
||||||
resources only present in `google-beta` will be marked as such.
|
|
||||||
|
|
||||||
The Google provider is used to configure your [Google Cloud Platform](https://cloud.google.com/) infrastructure.
|
The Google provider is used to configure your [Google Cloud Platform](https://cloud.google.com/) infrastructure.
|
||||||
See the [Getting Started](/docs/providers/google/getting_started.html) page for an introduction to using the provider.
|
See the [Getting Started](/docs/providers/google/getting_started.html) page for an introduction to using the provider.
|
||||||
|
@ -8,9 +8,7 @@ description: |-
|
|||||||
|
|
||||||
# `google` provider reference
|
# `google` provider reference
|
||||||
|
|
||||||
-> We recently introduced the `google-beta` provider. See [Provider Versions](https://terraform.io/docs/providers/google/provider_versions.html)
|
-> Want more information about upgrading from `1.X` of the provider to `2.0.0`? Check out the [2.0.0 Upgrade Guide](https://terraform.io/docs/providers/google/version_2_upgrade.html).
|
||||||
for more details on how to use `google-beta`. The documentation in this site is shared between both `google` and `google-beta`; fields or
|
|
||||||
resources only present in `google-beta` will be marked as such.
|
|
||||||
|
|
||||||
The `google` and `google-beta` provider blocks are used to configure default values for
|
The `google` and `google-beta` provider blocks are used to configure default values for
|
||||||
your GCP project and location (`zone` and `region`), and add your credentials.
|
your GCP project and location (`zone` and `region`), and add your credentials.
|
||||||
@ -58,6 +56,8 @@ resource "google_compute_instance" "beta-instance" {
|
|||||||
|
|
||||||
# ...
|
# ...
|
||||||
}
|
}
|
||||||
|
|
||||||
|
provider "google-beta" {}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
@ -11,27 +11,34 @@ description: |-
|
|||||||
Starting with version `1.19.0`, there are two versions of the Google provider:
|
Starting with version `1.19.0`, there are two versions of the Google provider:
|
||||||
|
|
||||||
* `google`
|
* `google`
|
||||||
|
|
||||||
* `google-beta`
|
* `google-beta`
|
||||||
|
|
||||||
This documentation (https://www.terraform.io/docs/providers/google/) is shared
|
This documentation (https://www.terraform.io/docs/providers/google/) is shared
|
||||||
between both providers. Fields and resources that are only present in
|
between both providers, and all generally available (GA) products and features
|
||||||
`google-beta` will be marked as such.
|
are available in both versions of the provider.
|
||||||
|
|
||||||
All GA (generally available) products and features are available in both
|
The `google-beta` provider is distinct from the `google` provider in that it
|
||||||
versions of the provider, and from the `2.0.0` release onwards beta GCP features
|
supports GCP products and features that are in beta, while `google` does not.
|
||||||
are only available in the `google-beta` provider.
|
Fields and resources that are only present in `google-beta` will be marked as
|
||||||
|
such in the shared provider documentation.
|
||||||
|
|
||||||
|
`1.X` versions of the `google` provider supported beta features; from `2.0.0`
|
||||||
|
onwards, beta features are only supported in `google-beta`.
|
||||||
|
|
||||||
Beta GCP features have no deprecation policy and no SLA, but are otherwise considered to be feature-complete
|
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
|
with only minor outstanding issues after their Alpha period. Beta is when GCP
|
||||||
features are publicly announced, and is when they generally become publicly
|
features are publicly announced, and is when they generally become publicly
|
||||||
available. For more information see [the official documentation on GCP launch stages](https://cloud.google.com/terms/launch-stages).
|
available. For more information see [the official documentation on GCP launch stages](https://cloud.google.com/terms/launch-stages).
|
||||||
|
|
||||||
The beta provider sends all requests to the beta endpoint for GCP if one exists
|
The `google-beta` provider sends all requests to the beta endpoint for GCP if
|
||||||
for that product, regardless of whether the request contains any beta features.
|
one exists for that product, regardless of whether the request contains any beta
|
||||||
|
features.
|
||||||
|
|
||||||
-> Using `google-beta` over `google` is similar to using `gcloud beta` over `gcloud`.
|
-> In short, using `google-beta` over `google` is similar to using `gcloud beta`
|
||||||
Features that are exclusively available in `google-beta` are GCP features that
|
over `gcloud`. Features that are exclusively available in `google-beta` are GCP
|
||||||
are not yet GA, and they will be made available in `google` after their GA launch.
|
features that are not yet GA, and they will be made available in `google` after
|
||||||
|
their GA launch.
|
||||||
|
|
||||||
## Using the `google-beta` provider
|
## Using the `google-beta` provider
|
||||||
|
|
||||||
|
@ -113,6 +113,11 @@ resource "google_container_cluster" "primary" {
|
|||||||
|
|
||||||
tags = ["foo", "bar"]
|
tags = ["foo", "bar"]
|
||||||
}
|
}
|
||||||
|
|
||||||
|
timeouts {
|
||||||
|
create = "30m"
|
||||||
|
update = "40m"
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
# The following outputs allow authentication and connectivity to the GKE Cluster
|
# The following outputs allow authentication and connectivity to the GKE Cluster
|
||||||
@ -559,8 +564,8 @@ exported:
|
|||||||
[Timeouts](/docs/configuration/resources.html#timeouts) configuration options:
|
[Timeouts](/docs/configuration/resources.html#timeouts) configuration options:
|
||||||
|
|
||||||
- `create` - (Default `30 minutes`) Used for clusters
|
- `create` - (Default `30 minutes`) Used for clusters
|
||||||
- `update` - (Default `10 minutes`) Used for updates to clusters
|
- `update` - (Default `30 minutes`) Used for updates to clusters
|
||||||
- `delete` - (Default `10 minutes`) Used for destroying clusters.
|
- `delete` - (Default `30 minutes`) Used for destroying clusters.
|
||||||
|
|
||||||
## Import
|
## Import
|
||||||
|
|
||||||
|
@ -54,6 +54,11 @@ resource "google_container_node_pool" "np" {
|
|||||||
zone = "us-central1-a"
|
zone = "us-central1-a"
|
||||||
cluster = "${google_container_cluster.primary.name}"
|
cluster = "${google_container_cluster.primary.name}"
|
||||||
node_count = 3
|
node_count = 3
|
||||||
|
|
||||||
|
timeouts {
|
||||||
|
create = "30m"
|
||||||
|
update = "20m"
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
resource "google_container_cluster" "primary" {
|
resource "google_container_cluster" "primary" {
|
||||||
@ -144,6 +149,16 @@ The `management` block supports:
|
|||||||
|
|
||||||
* `auto_upgrade` - (Optional) Whether the nodes will be automatically upgraded.
|
* `auto_upgrade` - (Optional) Whether the nodes will be automatically upgraded.
|
||||||
|
|
||||||
|
<a id="timeouts"></a>
|
||||||
|
## Timeouts
|
||||||
|
|
||||||
|
`google_container_node_pool` provides the following
|
||||||
|
[Timeouts](/docs/configuration/resources.html#timeouts) configuration options:
|
||||||
|
|
||||||
|
- `create` - (Default `30 minutes`) Used for adding node pools
|
||||||
|
- `update` - (Default `10 minutes`) Used for updates to node pools
|
||||||
|
- `delete` - (Default `10 minutes`) Used for removing node pools.
|
||||||
|
|
||||||
## Import
|
## Import
|
||||||
|
|
||||||
Node pools can be imported using the `project`, `zone`, `cluster` and `name`. If
|
Node pools can be imported using the `project`, `zone`, `cluster` and `name`. If
|
||||||
|
Loading…
Reference in New Issue
Block a user