kubernetes ingress-nginx 的测试代码(单元测试+e2e测试)

Tags: kubernetes 

本篇目录

说明

这是 ingress-nginx 的使用方法 手册的配套笔记。

如果要修改代码并贡献到社区,ingress-nginx 测试代码的组织方式是必须了解的。ingress-nginx 的代码分为 go 和 lua 两部分,单元测试再加上 e2e 测试,一共有三套测试代码。

测试方法

在 Makefile 中可以看到测试方法:

.PHONY: test
test:
	@build/test.sh

.PHONY: lua-test
lua-test:
	@build/test-lua.sh

.PHONY: e2e-test
e2e-test:
	@build/run-e2e-suite.sh

make test 调用 go test 执行单元测试代码,在 build/test.sh 中可以看到:

go test -v -race -tags "cgo" ...(省略)...

make lua-test 执行 lua 的单元测试代码,测试代码也是 lua 编写的,在 build/test-lua.sh 中可以看到:

resty \
  -I ./rootfs/etc/nginx/lua \
  --shdict "configuration_data 5M" \
  --shdict "certificate_data 16M" \
  --shdict "balancer_ewma 1M" \
  --shdict "balancer_ewma_last_touched_at 1M" \
  ./rootfs/etc/nginx/lua/test/run.lua ${BUSTED_ARGS} ./rootfs/etc/nginx/lua/test/

make e2e-test 执行 e2e 测试代码,使用的测试框架是 GinkGo,GinkGo 的用法见 Go 语言测试框架 GinkGo 的使用方法

go 和 lua 单元测试

Go 代码的单元测试就是和被测文件位于同一目录中的 *_test.go 文件,例如:

$ ls internal/net/ipnet*
internal/net/ipnet.go      internal/net/ipnet_test.go

Lua 代码的测试文件位于 rootfs/etc/nginx/lua/test/:

$ ls -F rootfs/etc/nginx/lua/test/
balancer/               fixtures/               run.lua
balancer_test.lua       helpers.lua             util/
certificate_test.lua    lua_ingress_test.lua    util_test.lua
configuration_test.lua  monitor_test.lua

Lua 测试代码的执行:

resty \
  -I ./rootfs/etc/nginx/lua \
  --shdict "configuration_data 5M" \
  --shdict "certificate_data 16M" \
  --shdict "balancer_ewma 1M" \
  --shdict "balancer_ewma_last_touched_at 1M" \
  ./rootfs/etc/nginx/lua/test/run.lua ${BUSTED_ARGS} ./rootfs/etc/nginx/lua/test/

e2e 测试代码

GinkGo 支持将 e2e 测试代码编译成能够独立运行的二进制文件,ingress-nginx 的 ginkgo 测试代码位于 test/e2e 目录中,使用过程如下:

  • make e2e-test-binary 将 e2e 测试代码编译成可执行文件
  • make e2e-test-image 将可执行文件打包成 docker 镜像
  • make e2e-test 在 kubernetes 集群中启动使用该镜像的容器,开始 e2e 测试

e2e 镜像的测试过程就是调用 kubernetes 的接口,创建 service 以及 ingress 等,然后检查结果。

直接阅读代码即可,代码很好懂:

$ ls -F
annotations/       e2e.test*          leaks/             settings/
dbg/               e2e_test.go        loadbalance/       ssl/
defaultbackend/    framework/         lua/               status/
down.sh*           gracefulshutdown/  run.sh*            tcpudp/
e2e.go             kind.yaml          servicebackend/    wait-for-nginx.sh*

参考

  1. 李佶澳的博客
  2. ingress-nginx 的使用方法
  3. Go 语言测试框架 GinkGo 的使用方法

kubernetes

  1. Prometheus 采集 Kubernetes 中的 pod 的 metrics 的方法
  2. kubernetes configmap 热加载,inotifywatch 监测文件触发热更新
  3. kubernetes 百变定制: 支持的扩展点和扩展方法(api/crd/plugin...)
  4. kubernetes 调度组件 kube-scheduler 1.16.3 源代码阅读指引
  5. kubernetes 代码中的 k8s.io 是怎么回事?
  6. 旌旗招展,向网格而行!
  7. 《不一样的 双11 技术,阿里巴巴经济体云原生实践》阅读笔记
  8. kubernetes ingress-nginx 启用 upstream 长连接,需要注意,否则容易 502
  9. ingress-nginx 的限速功能在 nginx.conf 中的对应配置
  10. kubernetes 中的容器设置透明代理,自动在 HTTP 请求头中注入 Pod 信息
  11. kubernetes ingress-nginx 的测试代码(单元测试+e2e测试)
  12. kubernetes ingress-nginx http 请求复制功能与 nginx mirror 的行为差异
  13. kubernetes 基于 openresty 的 ingress-nginx 的状态和配置查询
  14. Kubernetes ingress-nginx 0.25 源代码走读笔记
  15. kubernetes ingress-nginx 的金丝雀(canary)/灰度发布功能的使用方法
  16. kubernetes code-generator 用法: 生成 kubernetes-style 的 api 和 client 代码
  17. kubernetes 操作命令 kubectl 在 shell 中的自动补全配置
  18. flannel ip 地址段扩容方法
  19. kubernetes 组件 kube-proxy 的 IPVS 功能的使用
  20. lxcfs 是什么? 怎样通过 lxcfs 在容器内显示容器的 CPU、内存状态
  21. kubernetes initializer 功能的使用方法: 在 Pod 等 Resource 落地前进行修改
  22. kubernetes 版本特性: 新特性支持版本和组件兼容版本
  23. kubernetes API 与 Operator: 不为人知的开发者战争(完整篇)
  24. kubernetes 1.12 从零开始(七): kubernetes开发资源
  25. kubernetes 1.12 从零开始(六): 从代码编译到自动部署
  26. kubernetes 网络方案 Flannel 的学习笔记
  27. kubernetes 1.12 从零开始(五): 自己动手部署 kubernetes
  28. kubernetes 1.12 从零开始(四): 必须先讲一下基本概念
  29. kubernetes 1.12 从零开始(三): 用 kubeadm 部署多节点集群
  30. kubernetes 1.12 从零开始(二): 用 minikube 部署开发测试环境
  31. kubernetes 1.12 从零开始(一): 部署环境准备
  32. kubernetes 1.12 从零开始(零): 遇到的问题与解决方法
  33. kubernetes 1.12 从零开始(初): 课程介绍与官方文档汇总
  34. 通过Prometheus查询计算Kubernetes集群中的容器CPU、内存使用率等指标
  35. 使用 grafana 和 prometheus 监控 kubernetes 集群状态
  36. 一些比较有意思的Kubernetes周边产品
  37. Borg论文阅读笔记
  38. kubelet下载pod镜像时,docker口令文件的查找顺序
  39. kubernetes 的 Client Libraries 的使用
  40. kubernetes的网络隔离networkpolicy
  41. kube-router的源码走读
  42. 使用calico的ipip模式解决k8s的跨网段通信
  43. kubernetes的调试方法
  44. kubernetes 与 calico 的衔接过程
  45. 怎样理解 kubernetes 以及微服务?
  46. kubernetes中部署有状态的复杂分布式系统
  47. kubernetes的apiserver的启动过程
  48. kubernetes的api定义与装载
  49. kubernetes的federation部署,跨区Service
  50. kubernetes的编译、打包、发布
  51. kubernetes的第三方包的使用
  52. kubernetes的Storage的实现
  53. kubernetes 的 Apiserver 的 storage 使用
  54. kubernetes的Controller-manager的工作过程
  55. kubernetes的Client端Cache
  56. kubernetes 的 Apiserver 的工作过程
  57. kubernetes的CNI插件初始化与Pod网络设置
  58. kubernetes的Pod变更过程
  59. kubernetes的kubelet的工作过程
  60. kuberntes 的 Cmdline 实现
  61. kubernetes的Pod内挂载的Service Account的使用方法
  62. kubernetes的社区资源与项目参与方式
  63. kubernetes的Kube-proxy的转发规则分析
  64. kubernetes的基本操作
  65. kubernetes在CentOS上的集群部署
  66. kubernetes在CentOS上的All In One部署
  67. 怎样选择集群管理系统?

推荐阅读

Copyright @2011-2019 All rights reserved. 转载请添加原文连接,合作请加微信lijiaocn或者发送邮件: [email protected],备注网站合作

友情链接:  李佶澳的博客  小鸟笔记  软件手册  编程手册  运营手册  网络课程  收藏文章  发现知识星球  百度搜索 谷歌搜索