rosskukulinski/nginx-kubernetes-reload

适用于Kubernetes的NGINX镜像

本仓库提供容器化的NGINX镜像，支持监听Kubernetes Secrets或ConfigMaps中的配置文件变化并自动重载，主要用于动态更新LetEncrypt TLS证书等场景。

为何不使用Ingress控制器？

Ingress控制器通过Kubernetes API监控Ingress资源并更新负载均衡配置，但在需要自定义NGINX配置或Ingress控制器缺少关键特性时，本镜像可满足需求——它能动态处理TLS和ConfigMap变化，同时允许完全自定义配置。

工作原理

从Dockerfile可见：

• 基于Alpine NGINX基础镜像（nginx:1.10-alpine），支持HTTP2
• 使用dumb-init作为PID 1进程
• 通过nginx-reload.sh脚本监听配置变化
• 8080端口暴露健康检查端点

核心参数为环境变量WATCH_PATHS：脚本用inotifywait监听该路径下文件变化，检测到变化后验证配置有效性，若有效则重载NGINX，无效则保留最后有效配置。

示例部署

yaml
apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  labels:
    app: gateway
  name: gateway
spec:
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxUnavailable: 0
  template:
    metadata:
      labels:
        app: gateway
    spec:
      containers:
      - image: rosskukulinski/nginx-kubernetes-reload:v1.0.0
        imagePullPolicy: Always
        name: gateway
        ports:
        - containerPort: 80
          protocol: TCP
        - containerPort: 8080
          protocol: TCP
        env:
          - name: WATCH_PATHS
            value: "/etc/nginx /etc/nginx-ssl/jenkins/"
        volumeMounts:
        - mountPath: /etc/nginx/
          name: gateway-config
        - mountPath: /etc/nginx-ssl/jenkins/
          name: jenkins-tls
        livenessProbe:
          httpGet:
            path: /
            port: 8080
          initialDelaySeconds: 5
          timeoutSeconds: 1
        readinessProbe:
          httpGet:
            path: /
            port: 8080
          initialDelaySeconds: 5
          timeoutSeconds: 1
      restartPolicy: Always
      volumes:
      - name: gateway-config
        configMap:
          name: gateway-config
      - name: jenkins-tls
        secret:
          secretName: jenkins-tls

联系反馈

若有建议或问题，请在GitHub创建issue或提交PR，也可通过***联系作者。