# 让 Helm chart 先在笔记本上出错，别等到客户集群

> kind 一条命令就能用 Docker 容器搭出 Kubernetes 集群，正式安装前就能发现 chart 错误。

原文: https://fdetimes.net/zh/tools/test-helm-charts-locally-with-kind/

和 Kubernetes 打交道的前线部署工程师（FDE），大多经历过这样的失败：你站在客户的集群前，敲下 `helm install`，chart 却报错了。原因可能是 `values.yaml` 里一个值写错，可能是镜像拉不下来，也可能是某个模板从来没人渲染过。bug 很小，但发生在别人的基础设施上，丢掉的是信誉。

要避免这种情况，就需要一个用来演练的集群。Helm 的快速入门文档把第一个前提条件说得很直白：你必须已经有一个 Kubernetes 集群，并在本机配置好 kubectl。在客户现场，这个集群属于客户；在你的笔记本上，kind 正好补上这个空缺。

## Kubernetes 集群不过是几个容器

kind 的思路很巧妙：集群里的每个节点都是一个 Docker 容器。不需要为每个节点单独准备虚拟机，也不需要云账号。macOS 和 Windows 用户要注意一点：Docker Desktop 本身就在 Linux 虚拟机里运行容器，所以底层仍然有一台虚拟机，只是 kind 不会再为每个节点额外创建。

唯一的要求是容器运行时。kind 官网要求安装 Docker，kind 会检测机器上装的是 docker、podman 还是 nerdctl，并选用其中可用的那个。之后创建集群只需一条命令：

```bash
kind create cluster
```

如果要同时运行多个集群，比如每个客户一个演练集群，可以用 `--name` 给每个集群单独命名。

## 演练一次客户安装

设想这样一个场景：客户运行着一个内部服务，你为他们的应用写了一个修复，在笔记本上打包成镜像 `my-app:0.1.0`。下周你要用 Helm 把它安装到客户的生产集群，而且必须一次成功。

第一步，创建一个带名称的集群：

```bash
kind create cluster --name test-cluster
```

第二步是 kind 最省时间的地方。刚构建好的镜像在本机的 Docker 里，还不在任何镜像仓库中。不必搭建镜像仓库，也不必把镜像推到公开的地方，直接把它加载进集群：

```bash
kind load docker-image my-app:0.1.0 --name test-cluster
```

第三步，安装 chart，并在安装命令里直接设置拉取策略：

```bash
helm install my-app ./chart --set image.tag=0.1.0 --set image.pullPolicy=IfNotPresent
```

这条命令假定 chart 采用常见的 values 结构，包含 `image.tag` 和 `image.pullPolicy` 这两个键。客户的 chart 可能用了别的键名，所以先打开 `values.yaml` 确认。`--set` 之所以有效，是因为 `values.yaml` 只存放 chart 的默认值，安装者可以在安装时覆盖。

如果 pod 正常启动，你在走进客户会议室之前就验证了三件事：模板渲染正确，values 有效，镜像能在真实的 Kubernetes 集群里运行。

## pod 起不来，先怀疑镜像

上面的例子有一处需要留意。用 `kind load` 加载的镜像只存在于 kind 集群内部，不在任何镜像仓库里。如果让集群去仓库拉取这个镜像，它会去找一个根本不存在的东西。

决定这一点的是容器的 `imagePullPolicy`。kind 文档建议把它设为 `IfNotPresent` 或 `Never`，并避免使用 `:latest` 标签。根据 Kubernetes 文档，`IfNotPresent` 只在本地没有镜像时才拉取；`Never` 从不拉取：镜像存在，kubelet 就启动容器，不存在则启动失败。

所以，pod 卡住时，先别怀疑模板，第一件事是运行 `kubectl describe pod`，看 Events 部分。如果 Events 显示集群在尝试拉取镜像，就检查安装命令里是否带了 `--set image.pullPolicy=IfNotPresent`，或者 chart 是否用了别的键来设置这个策略，导致你的参数没有生效。

再配合 `0.1.0` 这样的固定标签，集群就会准确使用你刚加载的镜像。正式安装同样需要固定标签，因为它能让你确切知道运行的是哪个版本。

**要点:** 在客户集群上的第一次安装，不应该是你的 chart 第一次运行。

## kind 不是客户集群的复制品

kind 主页明确写道，这个工具主要是为测试 Kubernetes 本身而开发的，本地开发和 CI 只是次要用途。解读结果时要记住这一点。kind 集群上一片绿灯，证明的是 chart 对 Kubernetes 来说正确，还不能证明它适合客户的环境。

生产集群和 kind 集群可能在很多地方不同：用哪种存储类，云厂商的负载均衡器，网络策略，允许从哪些镜像仓库拉取镜像，RBAC 权限有多严格。

`kind load docker-image` 这个技巧就是最明显的例子。在 kind 上它绕过了镜像仓库；而在真实集群上，镜像仍然必须放在客户集群能拉取的仓库里，这时 `imagePullPolicy` 也可能需要和演练时不同。

合理的用法是把 kind 当作第一道筛子。它在你的机器上拦下模板、values 和镜像错误，让你在客户现场的时间都花在真正属于客户的特殊问题上。做客户需求调研时，尽早问清存储、ingress、镜像仓库和访问权限，因为这些问题 kind 替你回答不了。

## 一个证明你能做到的练习

把所有步骤串成一个小练习：创建 `test-cluster` 集群，加载 `my-app:0.1.0`，用 `imagePullPolicy: IfNotPresent` 安装 chart，然后让应用运行两个 pod。

怎样得到两个 pod 取决于 chart。`replicaCount` 不是 Helm 的内置功能，而是每个 chart 在自己的 values 里定义的键。如果 chart 有这个键，就用 `--set replicaCount=2`；如果没有，`kubectl scale deployment my-app --replicas=2` 可以在不改动 chart 的情况下调整 deployment 的副本数。

预期结果：`kubectl get pods -o wide` 显示两个处于 Running 状态的 pod。如果有 pod 卡住，回到 `kubectl describe pod` 的 Events 部分。在笔记本上找到原因，远比在客户面前找原因代价小。

## 先学什么，简历上写什么

合理的学习顺序是：创建带名称的集群，加载带固定标签的镜像，理解 `imagePullPolicy`，安装 chart，然后练习覆盖 values 和扩缩 deployment。

对想转 FDE 岗位的人来说，这是一项很容易展示的技能。一个小仓库，里面有一个 chart 和一个 CI 任务，每次 push 都把它安装到 kind 集群上，这比简历上一句“熟悉 Kubernetes”更有说服力。

读到提及 Kubernetes、Helm 或“部署到客户环境”的岗位描述时，你在面试中就已经有了具体的故事可讲，包括某次 pod 起不来，你如何顺着 Events 找到原因。

客户永远看不到你的 kind 集群。他们看到的，是从第一条命令起就顺利完成的安装。

**本周动手试试:**

- 安装 Docker 和 kind，运行 kind create cluster --name test-cluster，再用 kubectl 检查集群
- 构建一个带固定标签的小镜像，用 kind load docker-image 加载进集群，再用 --set image.pullPolicy=IfNotPresent 安装 chart
- 用 --set replicaCount=2 把 deployment 扩到两个 pod；如果 chart 没有这个键，就用 kubectl scale

## 信源

- [kind](https://kind.sigs.k8s.io/)

- [Quick Start](https://kind.sigs.k8s.io/docs/user/quick-start/)

- [Images | Kubernetes Documentation](https://kubernetes.io/docs/concepts/containers/images/)

- [Quickstart Guide | Helm](https://helm.sh/docs/intro/quickstart/)

- [kubectl scale | Kubernetes](https://kubernetes.io/docs/reference/kubectl/generated/kubectl_scale/)

- [Virtual Machine Manager | Docker Docs](https://docs.docker.com/desktop/features/vmm/)

- [Getting Started | Helm](https://helm.sh/docs/chart_template_guide/getting_started/)
