如何在Terraform+Helm部署的Nginx Ingress Controller中安装非官方动态模块

1. 自定义模块编译可行性说明 #

可以直接在官方提供的构建脚本对应位置添加编译逻辑，该位置本身就是Nginx编译参数的配置段，完全支持插入--add-dynamic-module相关参数。

2. 具体实现步骤 #

2.1 构建自定义控制器镜像 #

• 拉取与你当前使用的Chart 3.34.0版本对应的ingress-nginx源码，避免版本不兼容问题
• 提前将所需的动态模块源码导入构建上下文，可在构建脚本中添加拉取源码的命令，或提前将源码放入构建目录
• 在你找到的编译参数段末尾添加--add-dynamic-module=模块源码路径参数
• 按照官方镜像构建流程完成编译，将生成的镜像推送至你的私有镜像仓库

2.2 配置模块加载 #

无需修改官方Chart源码，直接使用Helm原生支持的controller.config.mainSnippet参数即可注入load_module配置，该参数会将内容直接插入nginx.conf的全局配置块，完全满足加载动态模块的需求。

2.3 调整Terraform配置 #

仅需在原有helm_release资源中添加values字段，覆盖镜像地址并注入模块加载配置即可，修改后的配置如下：

resource "helm_release" "nginx-ingress-controller" {
  name      = "nginx-ingress-controller"
  chart     = "ingress-nginx/ingress-nginx"
  namespace = "kube-system"
  version   = "3.34.0"

  values = [
    <<EOF
controller:
  image:
    repository: 你的私有镜像仓库/自定义ingress-nginx控制器镜像名
    tag: 你自定义的镜像版本号
    digest: ""
  config:
    mainSnippet: |
      load_module modules/你的模块文件名.so;
      # 模块所需的其他全局配置可直接在此处追加
EOF
  ]
}

3. 注意事项 #

• 每次官方发布安全补丁版本时，需同步拉取对应版本的源码重新编译自定义镜像，避免存在安全漏洞
• 基于官方构建脚本编译可保证Nginx版本、编译参数与模块完全匹配，不会出现模块加载失败的兼容性问题
• 该方案仅替换镜像和注入必要配置，无需深度自定义Chart或Fork官方仓库，符合轻量改造的要求

内容的提问来源于stack exchange，提问作者mto