terraform-provider-google/website/docs/d/google_container_engine_versions.html.markdown

layout	page_title	sidebar_current	description
google	Google: google_container_engine_versions	docs-google-datasource-container-versions	Provides lists of available Google Container Engine versions for masters and nodes.

google_container_engine_versions

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 zones, and not all zones in a region are guaranteed to support the same version.

Example Usage

data "google_container_engine_versions" "central1b" {
  zone           = "us-central1-b"
  version_prefix = "1.12."
}

resource "google_container_cluster" "foo" {
  name               = "terraform-test-cluster"
  zone               = "us-central1-b"
  node_version       = "${data.google_container_engine_versions.central1b.latest_node_version}"
  initial_node_count = 1

  master_auth {
    username = "mr.yoda"
    password = "adoy.rm"
  }
}

Argument Reference

The following arguments are supported:

• zone (optional) - Zone to list available cluster versions for. Should match the zone the cluster will be deployed in. If not specified, the provider-level zone is used. One of zone or provider-level zone is required.

• region (optional, Beta) - Region to list available cluster versions for. Should match the region the cluster will be deployed in. For regional clusters, this value must be specified and cannot be inferred from provider-level region. One of zone, region, or provider-level zone is required.

• project (optional) - ID of the project to list available cluster versions for. Should match the project the cluster will be deployed to. Defaults to the project that the provider is authenticated with.

• version_prefix (optional) - If provided, Terraform will only return versions that match the string prefix. For example, 1.11. will match all 1.11 series releases. Since this is just a string match, it's recommended that you append a . after minor versions to ensure that prefixes such as 1.1 don't match versions like 1.12.5-gke.10 accidentally. See the docs on versioning schema for full details on how version strings are formatted.

Attributes Reference

The following attributes are exported:

• valid_master_versions - A list of versions available in the given zone for use with master instances.
• valid_node_versions - A list of versions available in the given zone for use with node instances.
• latest_master_version - The latest version available in the given zone for use with master instances.
• latest_node_version - The latest version available in the given zone for use with node instances.
• default_cluster_version - Version of Kubernetes the service deploys by default.