在Minikube中使用Calico CNI为Pod分配静态IP失败求助

先确认核心前提：Minikube已启用Calico CNI #

Minikube默认使用的是kindnet或docker bridge这类CNI插件，而非Calico。如果没切换到Calico，Calico的IPAM注解完全不会生效：

• 启动Minikube时直接指定Calico：

  minikube start --cni=calico
  

• 若已启动Minikube，需先删除集群再重建：

  minikube delete
  minikube start --cni=calico
  

检查注解配置是否符合要求 #

确保Pod的注解严格匹配Calico的规则：

• 正确的注解键为cni.projectcalico.org/ipAddrs，值是JSON格式的IP数组，示例yaml：

  apiVersion: v1
  kind: Pod
  metadata:
    name: static-ip-pod
    annotations:
      cni.projectcalico.org/ipAddrs: '["192.168.1.100"]'
  spec:
    containers:
    - name: nginx
      image: nginx
  

• 注意：指定的IP必须属于Calico配置的Pod CIDR范围，可通过以下命令查看该范围：

  kubectl get configmap calico-config -n kube-system -o yaml | grep calico_ipv4pool_cidr
  

确保Pod是新创建的 #

静态IP注解仅对新创建的Pod生效，已存在的Pod不会自动更新IP：

• 手动删除原有Pod，触发重建：

  kubectl delete pod <你的Pod名称>
  

• 若Pod由Deployment管理，执行滚动更新触发重建：

  kubectl rollout restart deployment <你的Deployment名称>
  

排查Calico组件状态 #

• 检查Calico系统Pod是否全部正常运行：

  kubectl get pods -n calico-system
  

• 查看Pod事件日志，排查IP分配错误：

  kubectl describe pod <你的Pod名称>
  

  若日志中出现IP冲突、IP不在CIDR范围内等提示，对应调整指定的IP即可。

常见避坑点 #

• 不要将Node节点IP、Service IP当成Pod可用IP，必须选用Calico Pod CIDR内的地址
• 注解值必须是严格的JSON数组格式：外层用单引号包裹，数组内IP用双引号

内容的提问来源于stack exchange，提问作者Utkarsh Singh