Calico：灵活的网络模式与 eBPF 数据平面

<think>好的，我现在需要帮助用户了解如何在Kubernetes（k8s）中使用release-v3.26.0版本部署Calico。首先，用户已经提到过之前关于CNI配置目录的问题，可能对Calico作为CNI插件有一定了解。接下来，我需要确保回答结构清晰，符合用户提供的系统级指令，比如正确使用LaTeX格式，分步骤解释。 首先，我应该明确Calico的作用，它是一个网络插件，提供网络连接和网络策略。然后，用户需要的是部署特定版本v3.26.0的步骤，所以需要查找官方文档或可靠的资源来确认正确的部署方法。通常，Calico可以通过manifest文件或Operator部署，但用户指定了版本，可能需要直接使用manifest。 接下来，我需要检查v3.26.0是否存在，因为有时候版本号可能有误。假设存在的话，标准的部署步骤包括下载对应的YAML文件，应用它到集群，然后验证安装。同时，用户可能需要了解一些注意事项，比如kube-proxy模式、Pod CIDR配置是否正确，以及可能的兼容性问题，比如Kubernetes版本是否支持该Calico版本。 此外，用户可能需要自定义配置，比如IP池的设置，或者启用网络策略。这时候需要指导用户如何修改manifest文件中的相关部分。还要考虑安装后的验证步骤，比如检查Pod状态，确认节点之间的网络连通性，以及测试网络策略是否生效。 可能用户遇到的常见问题包括镜像拉取失败，配置错误导致Pod无法启动，或者网络策略未正确应用。需要提供排查方法，比如查看Pod日志，检查Calico的组件状态，确认配置文件是否正确。 最后，要确保回答符合格式要求，使用适当的代码块，正确的中文术语，以及避免使用Markdown，但根据用户之前的示例，似乎允许代码块。需要确认是否有其他未提及的细节，比如是否需要先安装CNI二进制文件，但根据Calico的标准安装流程，通常manifest会处理这些，但可能需要用户确认CNI目录配置正确，如之前提到的--cni-conf-dir参数。</think>### Kubernetes 使用 Calico `release-v3.26.0` 部署指南 --- #### 1. **前置条件** - **Kubernetes 集群**：已部署且版本与 Calico v3.26.0 兼容（推荐 Kubernetes v1.24+） - **网络要求**：节点间网络互通，允许 179 (BGP)、5473 (Typha) 等端口通信 - **Pod CIDR**：确认集群的 Pod 网段（默认 `192.168.0.0/16`，需与 Calico 配置匹配） --- #### 2. **部署步骤** ##### 2.1 下载 Calico Manifest 从官方仓库获取 `release-v3.26.0` 的部署文件： ```bash curl -L https://raw.githubusercontent.com/projectcalico/calico/v3.26.0/manifests/calico.yaml -o calico-v3.26.0.yaml ``` ##### 2.2 配置关键参数（按需修改） 修改 `calico-v3.26.0.yaml` 中的以下字段： ```yaml # 修改 Pod CIDR（需与 kube-controller-manager 的 --pod-cidr 一致） - name: CALICO_IPV4POOL_CIDR value: "192.168.0.0/16" # 启用 IP-in-IP 封装（跨子网场景需要） - name: CALICO_IPV4POOL_IPIP value: "Always" # 禁用 IPv6（若无需 IPv6） - name: IP6 value: "none" ``` ##### 2.3 应用 Manifest ```bash kubectl apply -f calico-v3.26.0.yaml ``` --- #### 3. **验证部署** ##### 3.1 检查组件状态 ```bash kubectl get pods -n kube-system -l k8s-app=calico-node kubectl get pods -n kube-system -l k8s-app=calico-kube-controllers ``` ##### 3.2 网络连通性测试 ```bash # 部署测试 Pod kubectl run test-pod --image=alpine --restart=Never -- sleep 3600 # 进入 Pod 测试跨节点通信 kubectl exec -it test-pod -- ping <其他节点的Pod_IP> ``` --- #### 4. **核心配置解析** | 组件 | 功能说明 | 配置文件位置 | |---------------------|-------------------------------------|---------------------------| | `calico-node` | 数据平面，负责路由和策略实施 | DaemonSet 部署到所有节点 | | `calico-kube-controllers` | 同步 Kubernetes 资源到 Calico | Deployment 在控制平面运行 | | `calico-typha` | 优化大规模集群的 API 连接（可选） | 默认副本数 0 | --- #### 5. **常见问题排查** ##### 5.1 Pod 无法启动 - **现象**：Pod 卡在 `ContainerCreating` - **检查项**： ```bash kubectl describe pod <pod-name> | grep -A10 Events # 查看事件日志 journalctl -u kubelet | grep "CNI failed" # 检查 kubelet 日志 ``` ##### 5.2 跨节点通信失败 - **诊断步骤**： ```bash calicoctl node status # 检查 BGP 对等状态 calicoctl get ippool # 验证 IP 池配置 ``` --- #### 6. **高级配置示例** ##### 6.1 启用网络策略（NetworkPolicy） ```yaml # 修改 calico.yaml，启用 eBPF 模式（需 Kernel 4.18+） - name: FELIX_BPFENABLED value: "true" ``` ##### 6.2 自定义 BGP 配置 ```bash calicoctl create -f - <<EOF apiVersion: projectcalico.org/v3 kind: BGPConfiguration metadata: name: default spec: logSeverityScreen: Info nodeToNodeMeshEnabled: true EOF ``` --- #### 7. **版本注意事项** - **Kubernetes 兼容性**：v3.26.0 支持 Kubernetes v1.24-1.27 - **弃用警告**：此版本后可能不再支持 `kube-proxy` + `iptables` 模式，建议迁移至 eBPF --- **操作建议**：部署完成后，通过 `calicoctl` 工具监控状态： ```bash watch -n 2 'calicoctl get workloadendpoints -A' ```