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

推荐阅读

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

友情链接:  系统软件  程序语言  运营经验  水库文集  网络课程  微信网文  发现知识星球