cilium-cli

项目概述

cilium-cli 是 Cilium 官方提供的命令行工具，用于简化 Kubernetes 集群中 Cilium 的全生命周期管理。相比手写 YAML 清单，它能自动识别集群类型（minikube、kind、EKS、GKE、AKS、k3s 等），按环境生成合适的部署配置，一条命令完成安装与升级。它还集成了 Hubble 可观测组件的启用与端口转发，以及内置的连通性测试套件，可以在集群内部署测试负载并逐项验证东西向、南北向流量是否正常。

项目	内容
平台	Linux、macOS、Windows
语言	Go
适用范围	配合 Cilium 1.17 及以上（CLI v0.20+）
许可	Apache-2.0

一条命令装好 Cilium，再用内置测试套件验证集群网络连通性。

主要功能

• 自动安装：自动探测集群类型与版本，生成匹配的 Cilium 部署配置
• 状态巡检：cilium status 图形化展示 Agent、Operator、Hubble 等组件健康度
• 连通性测试：内置套件自动创建负载，验证 Pod 间、Pod 与外网、Service 的连通
• Hubble 集成：一键启用 Hubble Relay，配合 port-forward 查看实时流量日志
• 上下文管理：cilium context 查看当前集群连接信息，方便多集群切换
• 完整生命周期：覆盖 Cilium 的升级、配置变更与卸载流程

适用人群

• 使用 Cilium 作为 CNI 的集群管理员
• 采用 eBPF 网络方案的运维工程师
• 在 minikube、kind 上评估 Cilium 的开发者
• 排查 Kubernetes 网络问题的 SRE

快速上手

1. 下载最新版本的二进制包

   CILIUM_CLI_VERSION=$(curl -s https://raw.githubusercontent.com/cilium/cilium-cli/main/stable.txt)
   curl -L --remote-name-all https://github.com/cilium/cilium-cli/releases/download/${CILIUM_CLI_VERSION}/cilium-$(go env GOOS)-$(go env GOARCH).tar.gz{,.sha256sum}

2. 校验后解压到系统路径

   sha256sum --check cilium-*.tar.gz.sha256sum
   sudo tar -C /usr/local/bin -xzvf cilium-*.tar.gz

3. 安装 Cilium

   cilium install

4. 查看组件状态

   cilium status

5. 运行连通性测试

   cilium connectivity test

核心优势

• 环境自适应：识别主流托管与本地集群，免去手写部署清单
• 开箱测试：连通性测试自带完整用例，无需自建验证负载
• 官方出品：与 Cilium 版本同步维护，兼容性有保障

系统要求

项目	要求
操作系统	Linux、macOS、Windows
集群	Kubernetes（minikube、kind、EKS、GKE、AKS、k3s 等）
版本对应	CLI v0.20+ 对应 Cilium 1.17 及以上

注意事项

• 版本对应：不同 CLI 版本支持的 Cilium 版本不同，升级前查阅发布说明对照表
• Hubble 依赖：连通性测试的流量日志视图需要先启用 Hubble 并做端口转发