Skip to content

Commit 5ead326

Browse files
author
Aaina26
committed
Fix references in IPv4/IPv6 dual-stack
1 parent 095bca3 commit 5ead326

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

content/en/docs/concepts/services-networking/dual-stack.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ set the `.spec.ipFamilyPolicy` field to one of the following values:
9393
using the first configured service cluster IP range.
9494
* `PreferDualStack`: Allocates both IPv4 and IPv6 cluster IPs for the Service when dual-stack is enabled. If dual-stack is not enabled or supported, it falls back to single-stack behavior.
9595
* `RequireDualStack`: Allocates Service `.spec.clusterIPs` from both IPv4 and IPv6 address ranges when dual-stack is enabled. If dual-stack is not enabled or supported, the Service API object creation fails.
96-
* Selects the `.spec.ClusterIP` from the list of `.spec.ClusterIPs` based on the address family
96+
* Selects the `.spec.clusterIP` from the list of `.spec.clusterIPs` based on the address family
9797
of the first element in the `.spec.ipFamilies` array.
9898

9999
If you would like to define which IP family to use for single stack or define the order of IP
@@ -112,7 +112,7 @@ You can set `.spec.ipFamilies` to any of the following array values:
112112
- `["IPv4","IPv6"]` (dual stack)
113113
- `["IPv6","IPv4"]` (dual stack)
114114

115-
The first family you list is used for the legacy `.spec.ClusterIP` field.
115+
The first family you list is used for the legacy `.spec.clusterIP` field.
116116

117117
### Dual-stack Service configuration scenarios
118118

@@ -132,13 +132,13 @@ These examples demonstrate the behavior of various dual-stack Service configurat
132132
1. This Service specification explicitly defines `PreferDualStack` in `.spec.ipFamilyPolicy`. When
133133
you create this Service on a dual-stack cluster, Kubernetes assigns both IPv4 and IPv6
134134
addresses for the service. The control plane updates the `.spec` for the Service to record the IP
135-
address assignments. The field `.spec.ClusterIPs` is the primary field, and contains both assigned
136-
IP addresses; `.spec.ClusterIP` is a secondary field with its value calculated from
137-
`.spec.ClusterIPs`.
135+
address assignments. The field `.spec.clusterIPs` is the primary field, and contains both assigned
136+
IP addresses; `.spec.clusterIP` is a secondary field with its value calculated from
137+
`.spec.clusterIPs`.
138138

139-
* For the `.spec.ClusterIP` field, the control plane records the IP address that is from the
139+
* For the `.spec.clusterIP` field, the control plane records the IP address that is from the
140140
same address family as the first service cluster IP range.
141-
* On a single-stack cluster, the `.spec.ClusterIPs` and `.spec.ClusterIP` fields both only list
141+
* On a single-stack cluster, the `.spec.clusterIPs` and `.spec.clusterIP` fields both only list
142142
one address.
143143
* On a cluster with dual-stack enabled, specifying `RequireDualStack` in `.spec.ipFamilyPolicy`
144144
behaves the same as `PreferDualStack`.
@@ -147,8 +147,8 @@ These examples demonstrate the behavior of various dual-stack Service configurat
147147

148148
1. This Service specification explicitly defines `IPv6` and `IPv4` in `.spec.ipFamilies` as well
149149
as defining `PreferDualStack` in `.spec.ipFamilyPolicy`. When Kubernetes assigns an IPv6 and
150-
IPv4 address in `.spec.ClusterIPs`, `.spec.ClusterIP` is set to the IPv6 address because that is
151-
the first element in the `.spec.ClusterIPs` array, overriding the default.
150+
IPv4 address in `.spec.clusterIPs`, `.spec.clusterIP` is set to the IPv6 address because that is
151+
the first element in the `.spec.clusterIPs` array, overriding the default.
152152

153153
{{% code_sample file="service/networking/dual-stack-preferred-ipfamilies-svc.yaml" %}}
154154

@@ -161,7 +161,7 @@ dual-stack.)
161161
1. When dual-stack is enabled on a cluster, existing Services (whether `IPv4` or `IPv6`) are
162162
configured by the control plane to set `.spec.ipFamilyPolicy` to `SingleStack` and set
163163
`.spec.ipFamilies` to the address family of the existing Service. The existing Service cluster IP
164-
will be stored in `.spec.ClusterIPs`.
164+
will be stored in `.spec.clusterIPs`.
165165

166166
{{% code_sample file="service/networking/dual-stack-default-svc.yaml" %}}
167167

@@ -200,7 +200,7 @@ dual-stack.)
200200
[headless Services](/docs/concepts/services-networking/service/#headless-services) with selectors are
201201
configured by the control plane to set `.spec.ipFamilyPolicy` to `SingleStack` and set
202202
`.spec.ipFamilies` to the address family of the first service cluster IP range (configured via the
203-
`--service-cluster-ip-range` flag to the kube-apiserver) even though `.spec.ClusterIP` is set to
203+
`--service-cluster-ip-range` flag to the kube-apiserver) even though `.spec.clusterIP` is set to
204204
`None`.
205205

206206
{{% code_sample file="service/networking/dual-stack-default-svc.yaml" %}}
@@ -260,9 +260,9 @@ Services can be changed from single-stack to dual-stack and from dual-stack to s
260260

261261
1. To change a Service from dual-stack to single-stack, change `.spec.ipFamilyPolicy` from
262262
`PreferDualStack` or `RequireDualStack` to `SingleStack`. When you change this Service from
263-
dual-stack to single-stack, Kubernetes retains only the first element in the `.spec.ClusterIPs`
264-
array, and sets `.spec.ClusterIP` to that IP address and sets `.spec.ipFamilies` to the address
265-
family of `.spec.ClusterIPs`.
263+
dual-stack to single-stack, Kubernetes retains only the first element in the `.spec.clusterIPs`
264+
array, and sets `.spec.clusterIP` to that IP address and sets `.spec.ipFamilies` to the address
265+
family of `.spec.clusterIPs`.
266266

267267
### Headless Services without selector
268268

0 commit comments

Comments
 (0)