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 资源。先执行版本检查:

bash
git --version
kubectl version --client
helm version --short

预期输出的具体版本号取决于实际安装版本,形式类似:

text
git version <VERSION>
Client Version: v<VERSION>
v<VERSION>+g<COMMIT>

只要三条命令都能正常返回版本即可。若出现 command not found 或“不是内部或外部命令”,应先安装对应工具并确认其可执行文件目录已经加入 PATH,不要继续排查 Kubernetes。

确认 kubeconfig 指向哪个集群

kubectl 和 Helm 都会依据 Kubernetes 客户端配置访问集群。机器上存在多个本地或远程集群时,先查看当前 context,避免把后续资源部署到错误环境。

bash
kubectl config current-context
kubectl config get-contexts

预期输出中的名称取决于本地环境,例如:

text
<CONTEXT>
CURRENT   NAME        CLUSTER     AUTHINFO    NAMESPACE
*         <CONTEXT>   <CLUSTER>   <USER>

其中星号表示当前 context。实际的 <CONTEXT>、<CLUSTER> 和 <USER> 会因集群实现与 kubeconfig 配置不同而变化。

验证集群真的可访问

客户端存在不代表 Kubernetes API 可访问。使用 kubectl cluster-info 发起真实请求,再查看节点是否能够返回:

bash
kubectl cluster-info
kubectl get nodes

预期结果是命令成功返回控制平面信息以及至少一个节点;地址、节点名、版本和状态取决于本地集群:

text
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 访问配置:

bash
helm list

在尚未安装任何 Release 的干净 namespace 中,预期输出只有表头:

text
NAME    NAMESPACE    REVISION    UPDATED    STATUS    CHART    APP VERSION

如果该 namespace 已有 Release,则会额外显示实际记录,这同样说明访问成功。至此,Git 负责版本管理,kubectl 可以访问并检查集群,Helm 可以通过 Kubernetes API 工作,后续就具备搭建 GitOps 部署链路所需的基础环境。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

准备 Helm、kubectl 与本地集群

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通