一篇帶給你kustomize 簡明教程
在上一篇文章當中我們了解了 kubebuilder 的基本使用方法，通過 kubebuilder 實現了一個簡單的 operator 并運行了起來。雖然整個程序跑起來了，但是還是存在著一些疑惑，除了上篇文章有提到過的 controller-gen 之外，makefile當中還大量存在了 kustomize 這樣的命令，kustomize是什么，有什么用，怎么用?今天我們就一起來學習一下，在后續的文章當中，我們還會用到一些 kustomize 特性來部署不同的環境。
簡介
kustomize 是一個通過 kustomization 文件定制 kubernetes 對象的工具，它可以通過一些資源生成一些新的資源，也可以定制不同的資源的集合。
一個比較典型的場景是我們有一個應用，在不同的環境例如生產環境和測試環境，它的 yaml 配置絕大部分都是相同的，只有個別的字段不同，這時候就可以利用 kustomize 來解決，kustomize 也比較適合用于 gitops 工作流。
bespoke config workflow image
如上圖所示，有一個 ldap 的應用，/base目錄保存的是基本的配置，/overlays里放置的不同環境的配置，例如 /dev、/staging，/prod這些就是不同環境的配置，/base等文件夾下都有一個 kustomization .yml 文件，用于配置。
執行 kustomize build dir的方式就可以生成我們最后用于部署的 yaml 文件，也就是進行到了我們上圖的第四步，然后通過 kubectl apply -f命令進行部署。
安裝
使用 kubebuilder 我們不需要額外進行安裝，因為在執行相關 make 命令的時候，會自動下載可執行文件到 bin/ 目錄下
如果本地有 go 環境，可以執行下列命令進行安裝
- GOBIN=$(pwd)/ GO111MODULE=on go get sigs.k8s.io/kustomize/kustomize/v3
除此之外也可以使用對應操作系統的包管理器進行安裝，例如 mac 可以使用 brew 進行安裝
除了直接使用 kustomize 命令外，kubernetes 自 v1.14 之后也可以使用 kubectl kustomize的方式執行 kustomize
布局
- ├── base
- │ ├── deployment.yaml
- │ ├── kustomization.yaml
- │ └── service.yaml
- └── overlays
- ├── dev
- │ ├── kustomization.yaml
- │ └── patch.yaml
- ├── prod
- │ ├── kustomization.yaml
- │ └── patch.yaml
- └── staging
- ├── kustomization.yaml
- └── patch.yaml
一個常見的項目 kustomize 項目布局如上所示，可以看到每個環境文件夾里面都有一個 kustomization.yaml 文件，這個文件里面就類似配置文件，里面指定源文件以及對應的一些轉換文件，例如 patch 等
kustomization.yml
一個常見的 kustomization.yml 如下所示，一般包含 apiVsersion 和 kind 兩個固定字段
- apiVersion: kustomize.config.k8s.io/v1beta1
- kind: Kustomization
- resources:
- - manager.yaml
- configMapGenerator:
- - files:
- - controller_manager_config.yaml
- name: manager-config
kustomize 提供了比較豐富的字段選擇，除此之外還可以自定義插件，下面會大概列舉一下每個字段的含義，當我們需要用到的時候知道有這么個能力，然后再去 Kustomize 官方文檔 查找對應的 API 文檔就行了
- resources 表示 k8s 資源的位置，這個可以是一個文件，也可以指向一個文件夾，讀取的時候會按照順序讀取，路徑可以是相對路徑也可以是絕對路徑，如果是相對路徑那么就是相對于 kustomization.yml的路徑
- crds 和 resources 類似，只是 crds 是我們自定義的資源
- namespace 為所有資源添加 namespace
- images 修改鏡像的名稱、tag 或 image digest ，而無需使用 patches
- replicas 修改資源副本數
- namePrefix 為所有資源和引用的名稱添加前綴
- nameSuffix 為所有資源和引用的名稱添加后綴
- patches 在資源上添加或覆蓋字段，Kustomization 使用 patches 字段來提供該功能。
- patchesJson6902 列表中的每個條目都應可以解析為 kubernetes 對象和將應用于該對象的 JSON patch。
- patchesStrategicMerge 使用 strategic merge patch 標準 Patch resources.
- vars 類似指定變量
- commonAnnotations 為所有資源加上 annotations 如果對應的 key 已經存在值，這個值將會被覆蓋
- commonAnnotations:
- app.lailin.xyz/inject: agent
- resources:
- - deploy.yaml
- commonLabels 為所有資源的加上 label 和 label selector 注意：這個操作會比較危險
- apiVersion: kustomize.config.k8s.io/v1beta1
- kind: Kustomization
- commonLabels:
- app: bingo
- configMapGenerator 可以生成 config map，列表中的每一條都會生成一個 configmap
- secretGenerator 用于生成 secret 資源
- generatorOptions 用于控制 configMapGenerator 和 secretGenerator 的行為
總結
看到 Kustomize 我的第一反應是這個東西和 helm 有什么區別，Kustomize 沒有模板語法，只需要一個二進制命令就可以生成對應的 yaml 文件非常的輕量，而 helm 支持 GoTemplate，組件上也要多一些，并且 helm 通過 chart 包來進行發布相對來說還是要重量級一些。個人覺得 Kustomize 更適合做 gitops 而 helm 更合適做應用包的分發。
參考文獻
[^1]: Kustomize 官方文檔 https://kubectl.docs.kubernetes.io/zh/guides/
[^2]: 使用 Kustomize 對 Kubernetes 對象進行聲明式管理https://kubernetes.io/zh/docs/tasks/manage-kubernetes-objects/kustomization/
