Kubernetes ingress-nginx 0.25 源代码走读笔记

Tags: kubernetes 

本篇目录

说明

猛然发现还没有看过 ingress-nginx 的代码,调查问题的时候都是直接阅读最终生成的 nginx.conf 文件。

使用较新版本的金丝雀发布功能时,发现 openresty 替换了原生的 nginx, nginx.conf 文件也发生了变化,文件中不直接包含 Pod 的 IP 地址,用一段 lua 脚本处理转发,需要阅读代码理清配置生成、Pod IP 的下发过程。

拓展:Kubernetes 基于 openresty 的 ingress-nginx 的实现分析和使用

Go 部分

Nginx-ingress-controller 是用 Go 语言实现的,负责发现 Ingress 以及 Pod 的 IP 等,入口是:

ingress-nginx入口

核心操作在 NGINXController 中:

ngx := controller.NewNGINXController(conf, mc, fs)
go handleSigterm(ngx, func(code int) {
    os.Exit(code)
})

nginx controller

创建 nginx controller 时,传入 syncQueue 的方法 n.syncIngress 负责生成并下发最新的配置:

// internal/ingress/controller/controller.go: 113
func NewNGINXController(config *Configuration, mc metric.Collector, fs file.Filesystem) *NGINXController {
...
    n.syncQueue = task.NewTaskQueue(n.syncIngress)
...

阅读代码可知,配置变化分为可以动态加载和不可以动态加载的,只有配置变化不可以动态加载时,重新生成配置文件,并执行 reload 操作,代码中的!n.IsDynamicConfigurationEnough(pcfg)部分,pcfg 是最新的相关配置:

ingress-nginx入口

动态加载的配置在函数 configureDynamically(pcfg) 中下发,调用了 openresty 的 /configuration 地址:

func configureDynamically(pcfg *ingress.Configuration) error {
...
    statusCode, _, err := nginx.NewPostStatusRequest("/configuration/backends", "application/json", backends)
...
    statusCode, _, err = nginx.NewPostStatusRequest("/configuration/general", "application/json", ingress.GeneralConfig{
...

在最终生成的 nginx.conf 可以找到 /configuration 接口的实现:

server {
    listen unix:/tmp/nginx-status-server.sock;
    set $proxy_upstream_name "internal";

    ...

    location /configuration {
        # this should be equals to configuration_data dict
        client_max_body_size                    10m;
        client_body_buffer_size                 10m;
        proxy_buffering                         off;

        content_by_lua_block {
            configuration.call()
        }
    }
    location / {
        content_by_lua_block {
            ngx.exit(ngx.HTTP_NOT_FOUND)
        }
    }
}

Lua 部分

Lua 代码位于 rootfs/etc/ngxin/lua 目录中,在制作镜像的时候被一同打包到镜像中:

ingress-nginx lua 代码

Lua 部分就是标准的 openresty 应用,openresty 的应用开发见 Web开发平台OpenResty

编译与镜像制作

编译:

make build

编译后得到的文件位于:

$ tree bin
bin
└── amd64
    ├── dbg
    └── nginx-ingress-controller

制作镜像:

make container

制作镜像需要的文件位于 rootfs 中,制作镜像是准备一个临时目录,将 bin 目录中的文件和 rootfs 中的文件复制到临时目录中,并且替换 Dockerfile 中的 BASEIMAGE 等字符串,生成最终的 Dockerfile。

rootfs 目录中的所有文件都会被打包到容器中,所有如果要增减镜像中的文件,直接在 rootfs 目录中操作即可。

参考

  1. 李佶澳的博客笔记
  2. kubernetes ingress-nginx 的金丝雀(canary)/灰度发布功能的使用方法
  3. Kubernetes 基于 openresty 的 ingress-nginx 的实现分析和使用

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],备注网站合作

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