`
* Ця опція є обовʼязковою для bare metal двостекових вузлів (вузлів, які не визначають постачальника хмари прапорцем `--cloud-provider`). Якщо ви використовуєте постачальника хмари та вирішили перевизначити IP-адреси вузлів, визначені постачальником хмари, встановіть опцію `--node-ip`.
* (Вбудовані застарілі постачальники хмари не підтримують двостековий параметр `--node-ip`.)
Примітка:
Приклад CIDR IPv4: 10.244.0.0/16 (хоча ви повинні вказати свій власний діапазон адрес)
Приклад CIDR IPv6: fdXY:IJKL:MNOP:15::/64 (це показує формат, але не є дійсною адресою — дивіться RFC 4193)
Примітка:
Поле .spec.ipFamilies умовно змінюване: ви можете додавати або видаляти вторинне
сімейство IP-адрес, але не можете змінювати основне сімейство IP-адрес наявного Service.
Ви можете встановити `.spec.ipFamilies` в будь-яке з наступних значень масиву:
* `["IPv4"]`
* `["IPv6"]`
* `["IPv4","IPv6"]` (два стеки)
* `["IPv6","IPv4"]` (два стеки)
Перше сімейство, яке ви перераховуєте, використовується для легасі-поля `.spec.clusterIP`.
### Сценарії конфігурації двостекового Service {#dual-stack-service-configuration-scenarios}
Ці приклади демонструють поведінку різних сценаріїв конфігурації двостекового Service.
#### Параметри подвійного стека в нових Service {#dual-stack-options-on-new-services}
1. Специфікація цього Service явно не визначає `.spec.ipFamilyPolicy`. Коли ви створюєте цей Service, Kubernetes виділяє кластерний IP для Service з першого налаштованого `service-cluster-ip-range` та встановлює значення `.spec.ipFamilyPolicy` на `SingleStack`. ([Service без селекторів](/docs/concepts/services-networking/service/#services-without-selectors) та [headless Services](/docs/concepts/services-networking/service/#headless-services) із селекторами будуть працювати так само.)
apiVersion: v1
kind: Service
metadata:
name: my-service
labels:
app.kubernetes.io/name: MyApp
spec:
selector:
app.kubernetes.io/name: MyApp
ports:
- protocol: TCP
port: 80
2. Специфікація цього Service явно визначає `PreferDualStack` в `.spec.ipFamilyPolicy`. Коли ви створюєте цей Service у двостековому кластері, Kubernetes призначає як IPv4, так і IPv6 адреси для Service. Панель управління оновлює `.spec` для Service, щоб зафіксувати адреси IP. Поле `.spec.clusterIPs` є основним полем і містить обидві призначені адреси IP; `.spec.clusterIP` є вторинним полем зі значенням, обчисленим з `.spec.clusterIPs`.
* Для поля `.spec.clusterIP` панель управління записує IP-адресу, яка є з того ж самого сімейства адрес, що й перший діапазон кластерних IP Service.
* У одностековому кластері поля `.spec.clusterIPs` та `.spec.clusterIP` містять лише одну адресу.
* У кластері з увімкненими двома стеками вказання `RequireDualStack` в `.spec.ipFamilyPolicy` працює так само як і `PreferDualStack`.
apiVersion: v1
kind: Service
metadata:
name: my-service
labels:
app.kubernetes.io/name: MyApp
spec:
ipFamilyPolicy: PreferDualStack
selector:
app.kubernetes.io/name: MyApp
ports:
- protocol: TCP
port: 80
3. Специфікація цього Service явно визначає `IPv6` та `IPv4` в `.spec.ipFamilies`, а також визначає `PreferDualStack` в `.spec.ipFamilyPolicy`. Коли Kubernetes призначає IPv6 та IPv4 адреси в `.spec.clusterIPs`, `.spec.clusterIP` встановлюється на IPv6 адресу, оскільки це перший елемент у масиві `.spec.clusterIPs`, що перевизначає типові значення.
apiVersion: v1
kind: Service
metadata:
name: my-service
labels:
app.kubernetes.io/name: MyApp
spec:
ipFamilyPolicy: PreferDualStack
ipFamilies:
- IPv6
- IPv4
selector:
app.kubernetes.io/name: MyApp
ports:
- protocol: TCP
port: 80
#### Параметри подвійного стека в наявних Service {#dual-stack-details-on-existing-services}
Ці приклади демонструють типову поведінку при увімкненні двостековості в кластері, де вже існують Service. (Оновлення наявного кластера до версії 1.21 або новіше вмикає двостековість.)
1. Коли двостековість увімкнена в кластері, наявні Service (безперебійно `IPv4` або `IPv6`) конфігуруються панеллю управління так, щоб встановити `.spec.ipFamilyPolicy` на `SingleStack` та встановити `.spec.ipFamilies` на сімейство адрес наявного Service. Кластерний IP наявного Service буде збережено в `.spec.clusterIPs`.
apiVersion: v1
kind: Service
metadata:
name: my-service
labels:
app.kubernetes.io/name: MyApp
spec:
selector:
app.kubernetes.io/name: MyApp
ports:
- protocol: TCP
port: 80
Ви можете перевірити цю поведінку за допомогою kubectl, щоб переглянути наявний Service.
```shell
kubectl get svc my-service -o yaml
```
```yaml
apiVersion: v1
kind: Service
metadata:
labels:
app.kubernetes.io/name: MyApp
name: my-service
spec:
clusterIP: 10.0.197.123
clusterIPs:
- 10.0.197.123
ipFamilies:
- IPv4
ipFamilyPolicy: SingleStack
ports:
- port: 80
protocol: TCP
targetPort: 80
selector:
app.kubernetes.io/name: MyApp
type: ClusterIP
status:
loadBalancer: {}
```
2. Коли двостековість увімкнена в кластері, наявні [headless Services](/docs/concepts/services-networking/service/#headless-services) з селекторами конфігуруються панеллю управління так, щоб встановити `.spec.ipFamilyPolicy` на `SingleStack` та встановити `.spec.ipFamilies` на сімейство адрес першого діапазону кластерних IP Service (налаштованого за допомогою прапорця `--service-cluster-ip-range` для kube-apiserver), навіть якщо `.spec.clusterIP` встановлено в `None`.
apiVersion: v1
kind: Service
metadata:
name: my-service
labels:
app.kubernetes.io/name: MyApp
spec:
selector:
app.kubernetes.io/name: MyApp
ports:
- protocol: TCP
port: 80
Ви можете перевірити цю поведінку за допомогою kubectl, щоб переглянути наявний headless Service з селекторами.
```shell
kubectl get svc my-service -o yaml
```
```yaml
apiVersion: v1
kind: Service
metadata:
labels:
app.kubernetes.io/name: MyApp
name: my-service
spec:
clusterIP: None
clusterIPs:
- None
ipFamilies:
- IPv4
ipFamilyPolicy: SingleStack
ports:
- port: 80
protocol: TCP
targetPort: 80
selector:
app.kubernetes.io/name: MyApp
```
#### Перемикання Service між одностековим та двостековим режимами {#switching-services-between-single-stack-and-dual-stack}
Service можна перемикати з одностекового режиму на двостековий та навпаки.
1. Для того щоби перемикнути Service з одностекового режиму на двостековий, змініть `.spec.ipFamilyPolicy` з `SingleStack` на `PreferDualStack` або `RequireDualStack` за необхідності. Коли ви змінюєте цей Service з одностекового режиму на двостековий, Kubernetes призначає відсутнє адресне сімейство, так що тепер Service має адреси IPv4 та IPv6.
Відредагуйте специфікацію Service, оновивши `.spec.ipFamilyPolicy` з `SingleStack` на `PreferDualStack`.
До:
```yaml
spec:
ipFamilyPolicy: SingleStack
```
Після:
```yaml
spec:
ipFamilyPolicy: PreferDualStack
```
2. Для того щоби змінити Service з двостекового режиму на одностековий, змініть `.spec.ipFamilyPolicy` з `PreferDualStack` або `RequireDualStack` на `SingleStack`. Коли ви змінюєте цей Service з двостекового режиму на одностековий, Kubernetes залишає лише перший елемент у масиві `.spec.clusterIPs`, і встановлює `.spec.clusterIP` на цю IP-адресу і встановлює `.spec.ipFamilies` на адресне сімейство `.spec.clusterIPs`.
### Headless Services без селекторів {#headless-services-without-selectors}
Для [Headless Services без селекторів](/docs/concepts/services-networking/service/#without-selectors) і без явно вказаного `.spec.ipFamilyPolicy`, поле `.spec.ipFamilyPolicy` має типове значення `RequireDualStack`.
### Тип Service — LoadBalancer {#service-type-loadbalancer}
Щоб налаштувати двостековий балансувальник навантаження для вашого Service:
* Встановіть значення поля `.spec.type` в `LoadBalancer`
* Встановіть значення поля `.spec.ipFamilyPolicy` в `PreferDualStack` або `RequireDualStack`
Примітка:
Для використання двостекового Service типу LoadBalancer, ваш постачальник хмари повинен підтримувати балансувальники навантаження IPv4 та IPv6.
## Трафік Egress {#egress-traffic}
Якщо ви хочете увімкнути трафік Egress, щоб досягти призначення за межами кластера (наприклад, публічний Інтернет) з Podʼа, який використовує непублічно марковані адреси IPv6, вам потрібно увімкнути Pod для використання публічно-маршрутизованих адрес IPv6 за допомогою механізму, такого як прозорий проксі або IP маскування. Проєкт [ip-masq-agent](https://github.com/kubernetes-sigs/ip-masq-agent) підтримує IP-маскування у двостекових кластерах.
Примітка:
Переконайтеся, що ваш постачальник
CNI підтримує IPv6.
Примітка:
Мережі VXLAN на Windows не підтримують двостекову мережу.
Ви можете дізнатися більше про різні режими мережі для Windows в розділі [Мережа у Windows](/docs/concepts/services-networking/windows-networking#network-modes).
## Що далі
* [Перевірте двостекову мережу IPv4/IPv6](/docs/tasks/network/validate-dual-stack)
* [Увімкніть двостекову мережу за допомогою kubeadm](/docs/setup/production-environment/tools/kubeadm/dual-stack-support/)
