![David Quarles](/assets/img/avatar_default.png)
* add support for `google_container_node_pool` management (sans-tests) * [review] add tests, docs, general cleanup * add docs * [review] amend test to check updates and terraform fmt * test updates, make nested management fields non-computed
3.0 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
Google: google_container_node_pool | docs-google-container-node-pool | Manages a GKE NodePool resource. |
google_container_node_pool
Manages a Node Pool resource within GKE. For more information see the official documentation and API.
Example usage
resource "google_container_node_pool" "np" {
name = "my-node-pool"
zone = "us-central1-a"
cluster = "${google_container_cluster.primary.name}"
initial_node_count = 3
}
resource "google_container_cluster" "primary" {
name = "marcellus-wallace"
zone = "us-central1-a"
initial_node_count = 3
additional_zones = [
"us-central1-b",
"us-central1-c",
]
master_auth {
username = "mr.yoda"
password = "adoy.rm"
}
node_config {
oauth_scopes = [
"https://www.googleapis.com/auth/compute",
"https://www.googleapis.com/auth/devstorage.read_only",
"https://www.googleapis.com/auth/logging.write",
"https://www.googleapis.com/auth/monitoring",
]
}
}
Argument Reference
-
zone
- (Required) The zone in which the cluster resides. -
cluster
- (Required) The cluster to create the node pool for.
-
autoscaling
- (Optional) Configuration required by cluster autoscaler to adjust the size of the node pool to the current cluster usage. Structure is documented below. -
initial_node_count
- (Deprecated, Optional) The initial node count for the pool. Usenode_count
instead. -
management
- (Optional) Node management configuration, wherein auto-repair and auto-upgrade is configured. Structure is documented below. -
name
- (Optional) The name of the node pool. If left blank, Terraform will auto-generate a unique name. -
name_prefix
- (Optional) Creates a unique name for the node pool beginning with the specified prefix. Conflicts withname
. -
node_config
- (Optional) The node configuration of the pool. See google_container_cluster for schema. -
node_count
- (Optional) The number of nodes per instance group. -
project
- (Optional) The project in which to create the node pool. If blank, the provider-configured project will be used.
The autoscaling
block supports:
-
min_node_count
- (Required) Minimum number of nodes in the NodePool. Must be >=1 and <=max_node_count
. -
max_node_count
- (Required) Maximum number of nodes in the NodePool. Must be >= min_node_count.
The management
block supports:
-
auto_repair
- (Optional) Whether the nodes will be automatically repaired. -
auto_upgrade
- (Optional) Whether the nodes will be automatically upgraded.
Import
Node pools can be imported using the zone
, cluster
and name
, e.g.
$ terraform import google_container_node_pool.mainpool us-east1-a/my-cluster/main-pool