一篇带给你kustomize 简明教程

开发 项目管理
kustomize 是一个通过 kustomization 文件定制 kubernetes 对象的工具,它可以通过一些资源生成一些新的资源,也可以定制不同的资源的集合。

[[398747]]

在上一篇文章当中我们了解了 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 环境,可以执行下列命令进行安装

  1. GOBIN=$(pwd)/ GO111MODULE=on go get sigs.k8s.io/kustomize/kustomize/v3 

除此之外也可以使用对应操作系统的包管理器进行安装,例如 mac 可以使用 brew 进行安装

除了直接使用 kustomize 命令外,kubernetes 自 v1.14 之后也可以使用 kubectl kustomize的方式执行 kustomize

布局

  1. ├── base 
  2. │   ├── deployment.yaml 
  3. │   ├── kustomization.yaml 
  4. │   └── service.yaml 
  5. └── overlays 
  6.     ├── dev 
  7.     │   ├── kustomization.yaml 
  8.     │   └── patch.yaml 
  9.     ├── prod 
  10.     │   ├── kustomization.yaml 
  11.     │   └── patch.yaml 
  12.     └── staging 
  13.         ├── kustomization.yaml 
  14.         └── patch.yaml 

一个常见的项目 kustomize 项目布局如上所示,可以看到每个环境文件夹里面都有一个 kustomization.yaml 文件,这个文件里面就类似配置文件,里面指定源文件以及对应的一些转换文件,例如 patch 等

kustomization.yml

一个常见的 kustomization.yml 如下所示,一般包含 apiVsersion 和 kind 两个固定字段

  1. apiVersion: kustomize.config.k8s.io/v1beta1 
  2. kind: Kustomization 
  3.  
  4. resources: 
  5. - manager.yaml 
  6.  
  7. configMapGenerator: 
  8. - files: 
  9.   - controller_manager_config.yaml 
  10.   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 已经存在值,这个值将会被覆盖
  1. commonAnnotations: 
  2.   app.lailin.xyz/inject: agent 
  3.  
  4. resources: 
  5. - deploy.yaml 
  • commonLabels 为所有资源的加上 label 和 label selector 注意:这个操作会比较危险
  1. apiVersion: kustomize.config.k8s.io/v1beta1 
  2. kind: Kustomization 
  3.  
  4. commonLabels: 
  5.   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/

 

责任编辑:姜华 来源: mohuishou
相关推荐

2021-05-08 09:02:48

KubeBuilderOperatork8s

2022-07-06 07:57:37

Zookeeper分布式服务框架

2021-07-12 06:11:14

SkyWalking 仪表板UI篇

2021-09-18 07:43:33

ApolloJava配置中心

2021-10-14 09:58:24

消息中间件ActiveMQ Java

2021-04-08 11:00:56

CountDownLaJava进阶开发

2023-03-29 07:45:58

VS编辑区编程工具

2021-01-28 08:55:48

Elasticsear数据库数据存储

2021-06-21 14:36:46

Vite 前端工程化工具

2022-04-29 14:38:49

class文件结构分析

2021-04-01 10:51:55

MySQL锁机制数据库

2022-03-22 09:09:17

HookReact前端

2021-04-14 14:16:58

HttpHttp协议网络协议

2021-03-12 09:21:31

MySQL数据库逻辑架构

2022-02-17 08:53:38

ElasticSea集群部署

2021-07-21 09:48:20

etcd-wal模块解析数据库

2024-06-13 08:34:48

2021-10-28 08:51:53

GPIO软件框架 Linux

2023-03-13 09:31:04

2022-02-25 15:50:05

OpenHarmonToggle组件鸿蒙
点赞
收藏

51CTO技术栈公众号