使用 kubeadm 实现双栈支持

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

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

在开始之前

您需要安装 kubeadm 工具，按照 安装 kubeadm 中的步骤进行操作。

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

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

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

创建双栈集群

要使用 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/v1beta4
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/v1beta4
kind: InitConfiguration
localAPIEndpoint:
  advertiseAddress: "10.100.0.1"
  bindPort: 6443
nodeRegistration:
  kubeletExtraArgs:
  - name: "node-ip"
    value: "10.100.0.2,fd00:1:2:3::2"

advertiseAddress 在 InitConfiguration 中指定 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/v1beta4
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:
  - name: "node-ip"
    value: "10.100.0.2,fd00:1:2:3::3"

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

apiVersion: kubeadm.k8s.io/v1beta4
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:
  - name: "node-ip"
    value: "10.100.0.2,fd00:1:2:3::4"

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

kubeadm join --config=kubeadm-config.yaml

创建单栈集群

为了更清晰，以下是一个用于单栈控制平面节点的 kubeadm 配置文件 kubeadm-config.yaml 示例。

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

下一步

最后修改时间：2024 年 7 月 5 日下午 4:06 PST：kubeadm：在所有文档示例中使用 v1beta4 (efc1133fa4)