codesuki/ecs-nginx-proxy

ecs-nginx-proxy

![Build Status]([***]

镜像概述

ecs-nginx-proxy是一款适用于AWS ECS集群的Nginx反向代理镜像，通过集成https://github.com/codesuki/ecs-gen%E5%B7%A5%E5%85%B7%E8%87%AA%E5%8A%A8%E7%94%9F%E6%88%90%E9%85%8D%E7%BD%AE%EF%BC%8C%E5%AE%9E%E7%8E%B0%E5%AE%B9%E5%99%A8%E5%90%AF%E5%8A%A8%E6%97%B6%E9%80%9A%E8%BF%87%E5%AD%90%E5%9F%9F%E5%90%8D%E8%AE%BF%E9%97%AE%E7%9A%84%E5%8A%9F%E8%83%BD%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8E%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%EF%BC%8C%E7%81%B5%E6%84%9F%E6%9D%A5%E6%BA%90%E4%BA%8Ehttps://github.com/jwilder/nginx-proxy%E3%80%82

核心功能

1. 自动配置：利用ecs-gen工具，根据容器环境变量动态生成Nginx反向代理配置
2. 子域名访问：支持通过子域名（如branch.domain.com）访问ECS集群中的容器
3. 自定义参数：通过NGINX_GEN_前缀的环境变量，可自定义Nginx配置（如client_max_body_size）

使用场景

适用于开发环境中为每个代码分支或Pull Request创建独立测试环境的场景，通过wildcard域名（如*.domain.com）快速访问不同分支的测试容器。

配置说明

前置条件

• 拥有wildcard域名（如*.domain.com）
• 为该域名配置ELB/ALB
• 已创建AWS ECS集群

IAM权限要求

• ECS集群中的EC2实例需具备ecs:Describe*、ecs:List*、ec2:Describe*权限
• 推荐使用AmazonEC2ContainerServiceFullAccess策略（注：生产环境建议按需最小化权限）

部署步骤

1. 创建ECS任务：添加使用codesuki/ecs-nginx-proxy镜像的容器，暴露80端口
2. 创建ECS服务：关联上述任务与ELB/ALB，绑定wildcard域名

容器配置

• 需访问的容器需设置环境变量VIRTUAL_HOST为目标子域名
• 通过NGINX_GEN_前缀的环境变量自定义Nginx参数（如NGINX_GEN_client_max_body_size=10M）

部署示例

注册任务定义

bash
aws ecs register-task-definition --cli-input-json file://./examples/task.json

创建服务（ELB方式）

bash
aws ecs create-service --cluster <集群名称> --role <服务角色> --load-balancers loadBalancerName=<ELB名称>,containerName=ecs-nginx-proxy,containerPort=80 --cli-input-json file://./examples/service.json

创建服务（ALB方式）

bash
aws ecs create-service --cluster <集群名称> --role <服务角色> --load-balancers targetGroupArn=<目标组ARN>,containerName=ecs-nginx-proxy,containerPort=80 --cli-input-json file://./examples/service.json

注册示例任务（含子域名配置）

修改examples/sample_task.json中的VIRTUAL_HOST为目标域名后执行：

bash
aws ecs register-task-definition --cli-input-json file://./examples/sample_task.json

注册示例服务

bash
aws ecs create-service --cluster <集群名称> --service-name sample-service --task-definition sample-task --desired-count 1

待办事项

• 支持SSL连接（当前可通过ALB实现SSL终止）
• 支持基于路径的路由（如domain.com/service）