From 5ec8d57ea779f4f3932afba47c3d839360985d05 Mon Sep 17 00:00:00 2001 From: The Magician Date: Tue, 13 Nov 2018 11:01:00 -0800 Subject: [PATCH] Add docs about regional and zonal versions differing in GKE (#2464) /cc @rileykarson --- .../docs/d/google_container_engine_versions.html.markdown | 6 ++++++ website/docs/r/container_cluster.html.markdown | 4 ++++ 2 files changed, 10 insertions(+) diff --git a/website/docs/d/google_container_engine_versions.html.markdown b/website/docs/d/google_container_engine_versions.html.markdown index b1b1cc35..aef64ccc 100644 --- a/website/docs/d/google_container_engine_versions.html.markdown +++ b/website/docs/d/google_container_engine_versions.html.markdown @@ -10,6 +10,12 @@ description: |- Provides access to available Google Container Engine versions in a zone or region for a given project. +-> If you are using the `google_container_engine_versions` datasource with a regional cluster, ensure that you have provided a `region` +to the datasource. A `region` can have a different set of supported versions than its corresponding `zone`s, and not all `zone`s in a +`region` are guaranteed to support the same version. + +## Example Usage + ```hcl data "google_container_engine_versions" "central1b" { zone = "us-central1-b" diff --git a/website/docs/r/container_cluster.html.markdown b/website/docs/r/container_cluster.html.markdown index aba768da..85657072 100644 --- a/website/docs/r/container_cluster.html.markdown +++ b/website/docs/r/container_cluster.html.markdown @@ -142,6 +142,10 @@ output "cluster_ca_certificate" { If unset, the cluster's version will be set by GKE to the version of the most recent official release (which is not necessarily the latest version). +-> If you are using the `google_container_engine_versions` datasource with a regional cluster, ensure that you have provided a `region` +to the datasource. A `region` can have a different set of supported versions than its corresponding `zone`s, and not all `zone`s in a +`region` are guaranteed to support the same version. + * `monitoring_service` - (Optional) The monitoring service that the cluster should write metrics to. Automatically send metrics from pods in the cluster to the Google Cloud Monitoring API.