oba11/consul

Docker-Consul v0.5.0

镜像概述

Docker-Consul v0.5.0是用于运行Consul的Docker容器。该镜像最初因progium/consul镜像的Atlas SSL问题而创建，目前该问题已在最新版progium/consul中修复。本镜像提供Consul服务的容器化部署能力，适用于各类基于Consul的服务治理场景。

核心功能与特性

• 多模式支持：可作为Consul代理（Agent）或服务器（Server）运行
• 单节点部署：支持快速启动单节点Consul服务器
• Atlas集成：可与Consul Atlas集成，实现跨环境服务发现与管理
• 端口映射：默认映射Consul核心端口（RPC:8400、HTTP API:8500、DNS:8600/udp）

使用场景

• 开发环境中的服务发现测试--- 测试环境中的分布式系统统的配置管理
• 需要快速部署Consul单节点服务器的场景
• 与Consul Atlas集成的跨网络服务治理

使用方法与配置说明

1. 基本代理模式

启动Consul代理，映射必要端口：

bash
docker run -it -p 8400:8400 -p 8500:8500 -p 8600:53/udp oba11/consul

• 端口说明：8400（RPC端口）、8500（HTTP API端口）、8600/udp（DNS端口）

2. 单节点服务器模式

启动单节点Consul服务器（含自举功能）：

bash
docker run -it -p 8400:8400 -p 8500:8500 -p 8600:53/udp oba11/consul -server -bootstrap

• 参数说明：
  • -server：以服务器模式运行
  • -bootstrap：启用自举模式，允许单节点集群初始化

3. 与Consul Atlas集成

方式一：通过环境变量设置Atlas令牌

bash
docker run -it -p 8400:8400 -p 8500:8500 -p 8600:53/udp -e ATLAS_TOKEN=my_atlas_token \
  oba11/consul -server -bootstrap -atlas atlas_id/infrastructure_id -atlas-join

方式二：通过命令行参数设置Atlas令牌

bash
docker run -it -p 8400:8400 -p 8500:8500 -p 8600:53/udp oba11/consul \
  -server -bootstrap -atlas atlas_id/infrastructure_id -atlas-join \
  -atlas-token my_atlas_token

• 参数说明：
  • -atlas：指定Atlas基础设施ID（格式：atlas_id/infrastructure_id）
  • -atlas-join：启用Atlas自动加入集群
  • -atlas-token：Consul Atlas访问令牌（也可通过ATLAS_TOKEN环境变量设置）