koombea/proxy

koombea/proxy 镜像文档

镜像概述

koombea/proxy是一个基于Nginx的轻量级代理镜像，专为ECS（Elastic Container Service）集群设计，用于实现HTTP到HTTPS的重定向功能。该镜像通过基础域（cluster_domain）配置，接收ALB（Application Load ***）的HTTP监听器请求，并自动重定向至ALB的HTTPS监听器，确保应用流量通过安全通道传输。默认集成于Koombea的Terraform aws_ecs模块中，简化ECS集群的HTTPS配置流程。

核心功能与特性

• HTTPS重定向：自动将HTTP请求重定向至HTTPS，保障数据传输安全
• 基础域配置：通过环境变量灵活设置集群基础域（如*.example.com）
• Nginx轻量基础：基于Nginx构建，资源占用低，性能高效
• ECS集成优化：适配ECS集群环境，支持ALB监听器联动
• Terraform兼容：默认作为Koombea Terraform aws_ecs模块的组件使用

使用场景与适用范围

• ECS集群中需要将HTTP流量统一重定向至HTTPS的场景
• 使用ALB作为入口负载均衡器的ECS部署架构
• 通过Terraform aws_ecs模块管理ECS集群的环境
• 需要简化HTTPS重定向配置的微服务架构

使用方法与配置说明

环境变量

端口映射

容器内部监听端口为80，需在ECS任务定义中配置端口映射，将容器端口80暴露给ALB HTTP监听器。

日志配置

推荐使用awslogs驱动集成AWS CloudWatch Logs，需配置以下选项：

• awslogs-group：日志组名称
• awslogs-region：AWS区域
• awslogs-stream-prefix：日志流前缀（建议使用集群域名）

部署示例（ECS任务定义）

以下是在ECS中使用该镜像的任务定义示例（JSON格式）：

json
[
  {
    "name": "${container_name}",  // 容器名称，可自定义
    "mountPoints": [],           // 无需挂载卷
    "image": "koombea/proxy:${proxy_version}",  // 镜像及版本，如koombea/proxy:latest
    "essential": true,           // 设为必要容器，确保服务可用性
    "memoryReservation": ${memory_limit},  // 内存预留，如128（MB）
    "environment": [
      {
        "name": "CLUSTER_DOMAIN",
        "value": "*.${cluster_domain}"  // 替换为实际集群基础域，如*.example.com
      }
    ],
    "portMappings": [
      {
        "protocol": "tcp",
        "containerPort": 80,     // 容器端口固定为80
        "hostPort": 0            // 动态主机端口，由ECS自动分配
      }
    ],
    "cpu": 0,                    // 不指定固定CPU，使用内存预留自动分配
    "volumesFrom": [],           // 无需从其他容器挂载卷
    "logConfiguration": {
      "logDriver": "awslogs",    // 使用awslogs驱动输出日志到CloudWatch
      "options": {
        "awslogs-group": "${logs_group_name}",  // CloudWatch日志组名称
        "awslogs-region": "${aws_region}",      // AWS区域，如us-east-1
        "awslogs-stream-prefix": "${cluster_domain}"  // 日志流前缀，建议使用集群域名
      }
    }
  }
]

配置说明

• 镜像版本：通过${proxy_version}指定具体版本，建议使用固定版本而非latest以确保部署一致性
• 内存配置：根据实际需求调整memoryReservation，推荐最小值为128MB
• 基础域设置：CLUSTER_DOMAIN需包含通配符（*）以匹配子域名请求，如*.example.com将匹配app1.example.com、api.example.com等
• 日志集成：确保ECS任务执行角色具有CloudWatch Logs的写入权限，以便日志正常输出