madhu1512/ecs-nginx-proxy

ecs-nginx-proxy

![Build Status]([***]

镜像概述

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

安全提示

当前该镜像主要用于私有网络中的开发集群，不建议直接用于生产环境。若需在生产环境使用，建议基于https://github.com/codesuki/ecs-gen%E8%87%AA%E5%AE%9A%E4%B9%89Nginx%E9%85%8D%E7%BD%AE%E4%BB%A5%E6%BB%A1%E8%B6%B3%E5%AE%89%E5%85%A8%E9%9C%80%E6%B1%82%E3%80%82

核心功能

1. 自动为ECS容器生成反向代理配置
2. 支持通过子域名访问容器（需设置VIRTUAL_HOST环境变量）
3. 与AWS ECS集群无缝集成

使用场景

• 为每个代码分支构建独立测试环境，通过branch.domain.com访问
• 快速暴露ECS容器服务，无需手动配置反向代理

配置说明

前提条件

1. 拥有通配符域名（如*.domain.com）
2. 为该域名配置的ELB/ALB
3. AWS ECS集群
4. 集群内EC2实例需具备ecs:Describe*和ecs:List*权限（建议使用AmazonEC2ContainerServiceFullAccess角色）

部署步骤

1. 创建ECS任务

添加容器，使用codesuki/ecs-nginx-proxy镜像并开放80端口。

2. 创建ECS服务

使用上述任务，关联到处理通配符域名的ELB/ALB。

3. 添加可访问容器

需暴露的容器需满足：

• 映射对应端口（可随机映射）
• 设置环境变量VIRTUAL_HOST为目标域名（如branch.domain.com）

示例命令

注册任务定义

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

待办事项

1. 支持SSL连接（目前可在ALB层终止SSL）
2. 支持基于路径的路由（如domain.com/service）