Skip to content

Commit fe27035

Browse files
modular-magicianrileykarson
authored andcommitted
Add note about cluster cidr range behaviours to GKE cluster (#4231)
Signed-off-by: Modular Magician <[email protected]>
1 parent da214d1 commit fe27035

File tree

1 file changed

+12
-6
lines changed

1 file changed

+12
-6
lines changed

website/docs/r/container_cluster.html.markdown

+12-6
Original file line numberDiff line numberDiff line change
@@ -153,8 +153,12 @@ deprecated in favour of `node_locations`.
153153
* `addons_config` - (Optional) The configuration for addons supported by GKE.
154154
Structure is documented below.
155155

156-
* `cluster_ipv4_cidr` - (Optional) The IP address range of the kubernetes pods in
157-
this cluster. Default is an automatically assigned CIDR.
156+
* `cluster_ipv4_cidr` - (Optional) The IP address range of the Kubernetes pods
157+
in this cluster in CIDR notation (e.g. 10.96.0.0/14). Leave blank to have one
158+
automatically chosen or specify a /14 block in 10.0.0.0/8. This field will only
159+
work if your cluster is not VPC-native- when an `ip_allocation_policy` block is
160+
not defined, or `ip_allocation_policy.use_ip_aliases` is set to false. If your
161+
cluster is VPC-native, use `ip_allocation_policy.cluster_ipv4_cidr_block`.
158162

159163
* `cluster_autoscaling` - (Optional, [Beta](https://terraform.io/docs/providers/google/provider_versions.html))
160164
Per-cluster configuration of Node Auto-Provisioning with Cluster Autoscaler to
@@ -424,10 +428,12 @@ API is `false`; afterwards, it's `true`.
424428
subnetwork.
425429

426430
* `cluster_ipv4_cidr_block` - (Optional) The IP address range for the cluster pod IPs.
427-
Set to blank to have a range chosen with the default size. Set to /netmask (e.g. /14)
428-
to have a range chosen with a specific netmask. Set to a CIDR notation (e.g. 10.96.0.0/14)
429-
from the RFC-1918 private networks (e.g. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) to
430-
pick a specific range to use.
431+
Set to blank to have a range chosen with the default size. Set to /netmask (e.g. /14)
432+
to have a range chosen with a specific netmask. Set to a CIDR notation (e.g. 10.96.0.0/14)
433+
from the RFC-1918 private networks (e.g. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) to
434+
pick a specific range to use. This field will only work if your cluster is
435+
VPC-native- when `ip_allocation_policy.use_ip_aliases` is undefined or set to
436+
true. If your cluster is not VPC-native, use `cluster_ipv4_cidr`.
431437

432438
* `node_ipv4_cidr_block` - (Optional) The IP address range of the node IPs in this cluster.
433439
This should be set only if `create_subnetwork` is true.

0 commit comments

Comments
 (0)