使用 kubeadm 进行双栈支持

功能状态： Kubernetes v1.23 [稳定]

您的 Kubernetes 集群包含 双栈 网络，这意味着集群网络允许您使用任一地址系列。在集群中，控制平面可以为单个 Pod 或 Service 分配 IPv4 地址和 IPv6 地址。

准备工作

您需要按照 安装 kubeadm 中的步骤安装 kubeadm 工具。

对于要用作 节点 的每台服务器，请确保它允许 IPv6 转发。在 Linux 上，您可以通过在每台服务器上以 root 用户身份运行 sysctl -w net.ipv6.conf.all.forwarding=1 来设置此项。

您需要有一个要使用的 IPv4 和 IPv6 地址范围。集群运营商通常对 IPv4 使用私地址范围。对于 IPv6，集群运营商通常从 2000::/3 中选择一个分配给运营商的全局单播地址块。您不必将集群的 IP 地址范围路由到公共互联网。

IP 地址分配的大小应适合您计划运行的 Pod 和 Service 的数量。

创建双栈集群

要使用 kubeadm init 创建双栈集群，您可以传递类似于以下示例的命令行参数

# These address ranges are examples
kubeadm init --pod-network-cidr=10.244.0.0/16,2001:db8:42:0::/56 --service-cidr=10.96.0.0/16,2001:db8:42:1::/112

为了更清楚地说明，以下是主双栈控制平面节点的示例 kubeadm 配置文件 kubeadm-config.yaml。

---
apiVersion: kubeadm.k8s.io/v1beta3
kind: ClusterConfiguration
networking:
  podSubnet: 10.244.0.0/16,2001:db8:42:0::/56
  serviceSubnet: 10.96.0.0/16,2001:db8:42:1::/112
---
apiVersion: kubeadm.k8s.io/v1beta3
kind: InitConfiguration
localAPIEndpoint:
  advertiseAddress: "10.100.0.1"
  bindPort: 6443
nodeRegistration:
  kubeletExtraArgs:
    node-ip: 10.100.0.2,fd00:1:2:3::2

InitConfiguration 中的 advertiseAddress 指定 API 服务器将通告其正在侦听的 IP 地址。advertiseAddress 的值等于 kubeadm init 的 --apiserver-advertise-address 标志。

运行 kubeadm 以初始化双栈控制平面节点

kubeadm init --config=kubeadm-config.yaml

kube-controller-manager 标志 --node-cidr-mask-size-ipv4|--node-cidr-mask-size-ipv6 使用默认值设置。请参阅 配置 IPv4/IPv6 双栈。

将节点加入双栈集群

在加入节点之前，请确保该节点具有 IPv6 可路由网络接口并允许 IPv6 转发。

以下是将工作节点加入集群的示例 kubeadm 配置文件 kubeadm-config.yaml。

apiVersion: kubeadm.k8s.io/v1beta3
kind: JoinConfiguration
discovery:
  bootstrapToken:
    apiServerEndpoint: 10.100.0.1:6443
    token: "clvldh.vjjwg16ucnhp94qr"
    caCertHashes:
    - "sha256:a4863cde706cfc580a439f842cc65d5ef112b7b2be31628513a9881cf0d9fe0e"
    # change auth info above to match the actual token and CA certificate hash for your cluster
nodeRegistration:
  kubeletExtraArgs:
    node-ip: 10.100.0.3,fd00:1:2:3::3

此外，以下是将另一个控制平面节点加入集群的示例 kubeadm 配置文件 kubeadm-config.yaml。

apiVersion: kubeadm.k8s.io/v1beta3
kind: JoinConfiguration
controlPlane:
  localAPIEndpoint:
    advertiseAddress: "10.100.0.2"
    bindPort: 6443
discovery:
  bootstrapToken:
    apiServerEndpoint: 10.100.0.1:6443
    token: "clvldh.vjjwg16ucnhp94qr"
    caCertHashes:
    - "sha256:a4863cde706cfc580a439f842cc65d5ef112b7b2be31628513a9881cf0d9fe0e"
    # change auth info above to match the actual token and CA certificate hash for your cluster
nodeRegistration:
  kubeletExtraArgs:
    node-ip: 10.100.0.4,fd00:1:2:3::4

JoinConfiguration.controlPlane 中的 advertiseAddress 指定 API 服务器将通告其正在侦听的 IP 地址。advertiseAddress 的值等于 kubeadm join 的 --apiserver-advertise-address 标志。

kubeadm join --config=kubeadm-config.yaml

创建单栈集群

为了更清楚地说明，以下是单栈控制平面节点的示例 kubeadm 配置文件 kubeadm-config.yaml。

apiVersion: kubeadm.k8s.io/v1beta3
kind: ClusterConfiguration
networking:
  podSubnet: 10.244.0.0/16
  serviceSubnet: 10.96.0.0/16

后续步骤

上次修改时间：2023 年 7 月 8 日下午 6:23 PST：调整 kops 和 kubespray 中的换行（df1e0b0d97）