joatmon08/consul-ecs

在ECS上运行Consul的Docker镜像

注意：这不是HashiCorp官方支持的镜像。它展示了在Amazon ECS上运行Consul的最小配置。

该容器镜像包含多个自动化步骤，专为在Amazon ECS上运行而设计。可作为Consul客户端或代理运行。

镜像概述和主要用途

本镜像提供了在Amazon ECS环境中部署Consul客户端或代理的最小化配置方案，适用于演示和测试场景，不建议用于生产环境。

核心功能和特性

• 支持Consul客户端模式和代理模式运行
• 包含ECS环境适配的自动化配置步骤
• 通过环境变量灵活配置Consul参数

使用场景和适用范围

适用于需要在Amazon ECS集群中集成Consul服务发现的测试或演示环境，可用于部署Consul客户端节点或服务代理。

使用方法和配置说明

环境变量配置

必填环境变量

• CONSUL_HTTP_TOKEN：Consul API访问令牌
• CONSUL_CA_PEM：服务器ca.pem文件的base64编码内容（客户端模式）
• CONSUL_GOSSIP_ENCRYPT： gossip加密密钥（客户端模式）
• SERVICE_NAME：服务名称（代理模式）
• SERVICE_PORT：服务端口（代理模式）

可选环境变量

• CONSUL_CACERT：CA证书路径，默认值：/consul/tls.crt
• CONSUL_HTTP_ADDR：Consul HTTP地址，默认值：EC2主机IP
• CONSUL_DATACENTER：数据中心名称，默认值：dc1
• SERVICE_ID：服务ID，默认值：${SERVICE_NAME}
• CONSUL_SERVICE_UPSTREAMS：上游服务配置，默认值：[]
• SIDECAR_PORT：Sidecar代理端口，默认值：21000
• SERVICE_HEALTH_CHECK_PATH：服务健康检查路径，默认值：/
• SERVICE_HEALTH_CHECK_INTERVAL：健康检查间隔，默认值：1s
• SERVICE_HEALTH_CHECK_TIMEOUT：健康检查超时时间，默认值：1s

部署示例

客户端模式运行

bash
docker run -d \
  -e CONSUL_HTTP_TOKEN=your_token \
  -e CONSUL_CA_PEM=base64_encoded_ca_pem \
  -e CONSUL_GOSSIP_ENCRYPT=gossip_key \
  joatmon08/consul-ecs

代理模式运行

bash
docker run -d \
  -e CONSUL_HTTP_TOKEN=your_token \
  -e SERVICE_NAME=my-service \
  -e SERVICE_PORT=8080 \
  joatmon08/consul-ecs

更多信息

项目地址：https://github.com/joatmon08/consul-ecs