CI/CD / 系统课时
准备 Helm、kubectl 与本地集群
准备 Helm、kubectl 与本地集群
开始 Helm 与 Argo CD 实践前,先把命令行工具和 Kubernetes 测试集群准备到可验证状态。本节不追求特定本地集群实现,而是建立一套通用检查路径:确认 Git、kubectl、Helm 可执行,再确认 kubeconfig 指向预期集群,最后用真实 API 请求验证访问能力。
学习目标
- 检查 Git、kubectl 与 Helm 是否正确安装并可执行
- 确认当前 Kubernetes context 与集群连接状态
- 通过最小命令定位工具缺失和集群不可达问题
检查命令行工具
本课程后续需要 Git 管理声明文件、Helm 渲染和安装 Chart、kubectl 验证 Kubernetes 资源。先执行版本检查:
git --version
kubectl version --client
helm version --short预期输出的具体版本号取决于实际安装版本,形式类似:
git version <VERSION>
Client Version: v<VERSION>
v<VERSION>+g<COMMIT>只要三条命令都能正常返回版本即可。若出现 command not found 或“不是内部或外部命令”,应先安装对应工具并确认其可执行文件目录已经加入 PATH,不要继续排查 Kubernetes。
确认 kubeconfig 指向哪个集群
kubectl 和 Helm 都会依据 Kubernetes 客户端配置访问集群。机器上存在多个本地或远程集群时,先查看当前 context,避免把后续资源部署到错误环境。
kubectl config current-context
kubectl config get-contexts预期输出中的名称取决于本地环境,例如:
<CONTEXT>
CURRENT NAME CLUSTER AUTHINFO NAMESPACE
* <CONTEXT> <CLUSTER> <USER>其中星号表示当前 context。实际的 <CONTEXT>、<CLUSTER> 和 <USER> 会因集群实现与 kubeconfig 配置不同而变化。
验证集群真的可访问
客户端存在不代表 Kubernetes API 可访问。使用 kubectl cluster-info 发起真实请求,再查看节点是否能够返回:
kubectl cluster-info
kubectl get nodes预期结果是命令成功返回控制平面信息以及至少一个节点;地址、节点名、版本和状态取决于本地集群:
Kubernetes control plane is running at <URL>
NAME STATUS ROLES AGE VERSION
<NODE> Ready <ROLE> <AGE> v<VERSION>Ready 表明节点已经具备正常调度的基本条件。如果连接被拒绝或超时,应先确认本地集群是否启动,再检查当前 context 指向的 API 地址;若返回认证或授权错误,则检查 kubeconfig 中的凭据,而不是重新安装 kubectl。
用 Helm 验证 Kubernetes 访问
Helm 不需要单独的常驻客户端服务才能操作集群,它通过 Kubernetes API 管理 Release。可以先查询当前 namespace 中的 Release,验证 Helm 能沿用现有 Kubernetes 访问配置:
helm list在尚未安装任何 Release 的干净 namespace 中,预期输出只有表头:
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION如果该 namespace 已有 Release,则会额外显示实际记录,这同样说明访问成功。至此,Git 负责版本管理,kubectl 可以访问并检查集群,Helm 可以通过 Kubernetes API 工作,后续就具备搭建 GitOps 部署链路所需的基础环境。