Kubernetes 1.21双栈Calico集群应用service.yaml报IPv6未配置错误如何解决

1. 先确认Kubernetes集群双栈核心配置是否完整 #

Kubernetes 1.21版本双栈为beta特性，需要先验证控制面组件的启动参数配置：

• 检查kube-apiserver、kube-controller-manager、kube-proxy的启动参数是否包含--feature-gates=IPv6DualStack=true
• 检查kube-apiserver的--service-cluster-ip-range参数是否同时配置了IPv4、IPv6两个CIDR段，缺少IPv6的Service网段会直接触发该报错
• 检查kube-controller-manager的--cluster-cidr、--service-cluster-ip-range均配置双栈段

执行以下命令可以快速验证集群支持的IP族：

kubectl get svc kubernetes -o jsonpath='{.spec.ipFamilies}'

如果返回结果仅包含["IPv4"]，说明集群未配置IPv6的Service网段，需要先调整控制面配置。

2. 确认Calico双栈与Service相关配置 #

虽然Pod可以正常分配双栈IP，仍需验证Calico的Service相关配置：

• 检查Calico IP池是否包含IPv6段，且对应的IP池disabled字段为false
• 检查Calico BGP配置是否宣告IPv6的Service CIDR段
• 查看calico-node组件日志，排查是否有IPv6相关的初始化错误

3. 处理Service不可变字段冲突 #

Kubernetes Service的ipFamilies、ipFamilyPolicy属于不可变字段，如果之前已经创建过该Service，直接kubectl apply修改配置不会生效，会残留旧的配置规则，需要先删除旧资源再重新创建：

# 先删除旧Service
kubectl delete -f service.yaml
# 重新创建
kubectl apply -f service.yaml

4. 调整IP族优先级适配集群配置 #

如果集群默认Service网段优先IPv4，可以调整ipFamilies的顺序适配集群默认规则：

ipFamilyPolicy: PreferDualStack
ipFamilies:
  - IPv4
  - IPv6

内容的提问来源于stack exchange，提问作者Vishakha Navlakhe