自定义 Prober

前文已将讲解了如何 编写一个简单的Prober，以及 Prober CRD 基本概念。此外 kubeprober 还有一些已经编写好的 Prober 可供开发者直接使用，它们位于目录 probers 下。

自定义 Prober 编写

开发者除了使用当前已有的 Prober 外，还可以根据需求，开发自定义 Prober。

在实际的开发过程中，kubeprober 对于 prober 的编写、打包总结了一些最佳实践:

  • 一个 prober 支持将多个执行探测的二进制文件打包到一个容器镜像中的，这样可以通过一个 pod 运行原本需要多个 pod 运行的探测任务，节省了很多资源和容器调度时间。
  • kubeprober 当前主要支持 golang、 shell 编写 prober 探测集
  • 同一个 prober 镜像中的每个二进制探测任务可能需要各自的自定义配置，为了避免将所有的配置放在一起，导致混乱，kubeprober 支持为每个二进制探测任务分别指定自定义配置。

下面以具体示例 probers/demo-example 讲解自定义 prober 编写:

Prober 目录结构：

  1. probers/
  2.     # 探测集 demo-example
  3.     # 探测集下的探测任务会分别编译打包到同一个容器镜像中
  4.     demo-example/
  5.         # 探测任务子目录，gonlang 执行入口为 main.go 文件
  6.         demo-checker1/
  7.             ...
  8.             main.go
  9.         # 探测任务子目录，shell 执行入口为 main.sh 文件
  10.         demo-checker2/
  11.             ...
  12.             main.sh

镜像打包

  1. # 进入到 probers 目录
  2. cd probers
  4. # 镜像打包
  5. # 此处指定探测集 PROBER=demo-example， 版本号: V=0.0.1
  6. # 打包后的镜像为: kubeprober/demo-example:0.0.1
  7. PROBER=demo-example V=0.0.1 make docker-build
  9. # 查看镜像内容
  10. # docker run -it --rm kubeprober/demo-example:0.0.1 /bin/sh
  11. /checkers # ls -lh *
  12. # run.sh 是 prober 内置的启动执行脚本，会依次执行打包到该镜像的可执行文件（探测任务）
  13. run.sh
  14. # 各探测任务在镜像中会被编译为 main 可执行文件，由 run.sh 依次调用执行
  15. demo-checker1:
  16.     main
  17. demo-checker2:
  18.     main

这样就可以将多个可执行探测任务（demo-checker1, demo-checker2）打包到一个镜像中去了

自定义Prober

上述 Prober（demo-example）镜像打包好后，即可编写对应的 prober.yaml，如下：

  1. apiVersion: kubeprober.erda.cloud/v1
  2. kind: Probe
  3. metadata:
  4.   name: prober-demo-example
  5.   namespace: kubeprober
  6. spec:
  7.   template:
  8.     containers:
  9.       - name: prober-demo-example
  10.         image: kubeprober/demo-example:v0.0.1
  11.         resources:
  12.           requests:
  13.             cpu: 10m
  14.             memory: 50Mi
  15.     restartPolicy: Never
  16.   # 如果可执行探测任务有自定义变量配置需求，即可配置如下自定义配置，名字不能重复
  17.   configs:
  18.     - name: demo-checker1
  19.       env:
  20.         - name: CHECKER1_ENV1
  21.           value: "CHECKER1_VAL1"
  22.         - name: CHECKER1_ENV2
  23.           value: "CHECKER1_VAL2"
  24.     - name: demo-checker2
  25.       env:
  26.         - name: CHECKER2_ENV1
  27.           value: "CHECKER2_VAL1"
  28.         - name: CHECKER2_ENV2
  29.           value: "CHECKER2_VAL2"