greenfinch628/consul

greenfinch628/consul:v6.4 镜像文档

镜像概述

greenfinch628/consul:v6.4是基于Alpine 3.3系统和Consul 6.4版本重建的progrium/consul (0.4)镜像，无其他实质性变更。主要用于部署单节点Consul服务器，以支持Swarm集群，尤其适用于需要完整TLS加密的场景。

核心功能和特性

• 基础环境：基于Alpine 3.3构建，轻量高效
• Consul版本：集成Consul 6.4
• 配置方式：通过配置文件（config.json）进行所有配置，不支持命令行参数（如-bootstrap、-server）
• TLS支持：完全支持TLS加密通信
• Web UI：内置Consul Web UI
• 数据持久化：支持数据目录挂载，确保数据持久化

使用场景

• 部署单节点Consul服务器
• 支持Swarm集群的服务发现与配置
• 需要TLS加密通信的Consul部署环境

使用方法和配置说明

基本使用（非TLS）

1. 准备配置文件

创建config.json配置文件，示例如下：

json
{
    "bootstrap": true,
    "datacenter": "dc1",
    "data_dir": "/data",
    "log_level": "INFO",
    "node_name": "consul-node01",
    "client_addr": "0.0.0.0",
    "server": true,
    "ui": true,
    "disable_update_check": true
}

2. 启动容器

bash
docker run -d \
  -v /root/consul.d:/config \  # 挂载配置文件目录
  -v /root/consul-data:/data \  # 挂载数据持久化目录
  -p 8500:8500 \  # Consul HTTP端口
  -p 8080:8080 \  # Web UI端口
  -h greenfinch-consul \  # 设置主机名
  --name greenfinch-consul \  # 容器名称
  greenfinch628/consul:v6.4

TLS配置使用

1. 准备证书和配置文件

• 将TLS证书（key.pem、cert.pem、ca.pem）放置在主机目录（如/root/.certs）
• 创建TLS配置文件config.json：

json
{
  "bootstrap": true,
  "datacenter": "dc1",
  "data_dir": "/data",
  "log_level": "INFO",
  "node_name": "consul-node01",
  "client_addr": "0.0.0.0",
  "server": true,
  "ui": true,
  "verify_incoming": true,  # 验证传入连接
  "verify_outgoing": true,  # 验证传出连接
  "addresses": {
    "https": "0.0.0.0"  # HTTPS监听地址
  },
  "ports": {
    "https": 8080  # HTTPS端口
  },
  "key_file": "/certs/key.pem",  # 私钥文件路径
  "cert_file": "/certs/cert.pem",  # 证书文件路径
  "ca_file": "/certs/ca.pem",  # CA证书文件路径
  "disable_update_check": true
}

2. 启动容器（TLS模式）

bash
docker run -d \
  -v /root/.certs:/certs:ro \  # 只读挂载证书目录
  -v /root/consul.d.greenfinch:/config \  # 挂载TLS配置文件目录
  -v /root/consul-data:/data \  # 挂载数据持久化目录
  -p 8500:8500 \  # Consul HTTP端口
  -p 8080:8080 \  # HTTPS/Web UI端口
  -h greenfinch-consul \  # 设置主机名
  --name greenfinch-consul \  # 容器名称
  greenfinch628/consul:v6.4

配置参数说明

注意事项

• 与progrium/consul的主要区别：不支持命令行参数，所有配置必须通过config.json文件完成
• 多节点部署未经过测试，但可参考progrium/consul的官方文档进行配置
• 证书和配置文件的挂载路径可自定义，只需确保容器内路径与配置文件中一致