stakater/nginx-with-consul-template

docker-nginx-consul-template

镜像概述

docker-nginx-consul-template是一个由Consul Template驱动的Nginx容器镜像。该镜像旨在与Consul和Consul-Template配合使用，实现透明且动态的负载均衡，当新容器启动或停止时能自动更新配置。Nginx作为流行的开源Web服务器、反向代理和负载均衡器，在此镜像中通过Consul Template实现配置的动态管理。

核心功能与特性

• Consul Template集成：Consul Template守护进程查询Consul实例，更新文件系统上的指定模板文件
• 动态配置更新：支持在配置更新完成后执行任意命令（如Nginx重载）
• Nginx核心功能：提供Web服务、反向代理及负载均衡能力
• 容器化适配：适用于动态变化的容器环境，自动适应服务实例的增减

使用场景与适用范围

• 微服务架构中的动态服务发现与负载均衡
• 需要自动调整负载均衡配置的容器化部署环境
• 服务实例频繁启停或扩缩容的场景
• 需减少人工干预配置更新的自动化运维环境

使用方法与配置说明

基本运行命令

bash
docker run -p 8080:80 -d --name nginx \
  --volume /home/core/templates:/templates \
  --link consul:consul \
  stakater/nginx-with-consul-template:latest

参数说明

• -p 8080:80：将容器内Nginx的80端口映射到主机的8080端口
• --volume /home/core/templates:/templates：挂载本地模板目录到容器内/templates
• --link consul:consul：链接Consul容器，使镜像能访问Consul服务

Consul Template配置

Consul Template通过以下命令执行模板渲染和配置更新：

bash
consul-template -consul=$CONSUL_URL -template="/templates/service.ctmpl:/etc/nginx/conf.d/service.conf:service nginx reload"

或

bash
consul-template -consul=$CONSUL_URL -template="/templates/service.ctmpl:/etc/nginx/conf.d/service.conf" -exec="service nginx reload"

配置参数说明

• -consul=$CONSUL_URL：指定Consul服务地址（环境变量）
• -template：定义模板文件映射关系，格式为[源模板路径]:[目标配置路径]:[更新后执行命令]
• -exec：配置更新后执行的命令（如重载Nginx服务）

环境变量

• CONSUL_URL：Consul服务地址，默认为通过--link consul:consul链接的Consul容器地址