如何基于Docker Compose初始化Consul并预置指定Key/Value

嘿，针对你想在新环境启动Consul时直接导入预置KV配置、省去手动UI操作的需求，我整理了两个实用的实现方案，都是基于你现有的Docker Compose部署来调整的：

方案一：用初始化脚本实现灵活配置（推荐） #

这个方式适合后续可能要加更多初始化逻辑的场景，步骤很清晰：

1. 保存KV导出文件
   把你用consul kv export config/导出的JSON内容，保存成consul-kv-config.json文件，放在和你的Docker Compose文件同一个目录下。

2. 写一个初始化启动脚本
   在同目录下创建init-consul-kv.sh，内容如下：

   #!/bin/sh
   # 先后台启动Consul服务
   consul agent -server -bind 0.0.0.0 -client 0.0.0.0 -bootstrap-expect=1 &
   CONSUL_PID=$!
   
   # 等待Consul完全启动——检查leader状态，直到服务就绪
   until curl -s http://localhost:8500/v1/status/leader | grep -q ":"; do
       echo "Waiting for Consul to be ready..."
       sleep 2
   done
   
   # 导入预置的KV配置
   consul kv import @/consul/config/consul-kv-config.json
   
   # 挂起进程，保持容器持续运行
   wait $CONSUL_PID
   

   别忘了给脚本加执行权限：chmod +x init-consul-kv.sh

3. 修改Docker Compose配置
   更新你的docker-compose.yml，挂载脚本和KV文件，并且指定用这个脚本启动：

   version: '3'
   networks:
     pm:
   services:
     consul:
       container_name: consul
       image: consul:latest
       restart: unless-stopped
       ports:
         - 8300:8300
         - 8301:8301
         - 8302:8302
         - 8400:8400
         - 8500:8500
         - 8600:8600
       environment:
         CONSUL_LOCAL_CONFIG: >-
           { "bootstrap": true, "server": true, "node_name": "consul1", "bind_addr": "0.0.0.0", "client_addr": "0.0.0.0", "bootstrap_expect": 1, "ui": true, "addresses" : { "http" : "0.0.0.0" }, "ports": { "http": 8500 }, "log_level": "DEBUG", "connect" : { "enabled" : true } }
       volumes:
         - ./data:/consul/data
         - ./init-consul-kv.sh:/consul/init-consul-kv.sh
         - ./consul-kv-config.json:/consul/config/consul-kv-config.json
       entrypoint: ["/consul/init-consul-kv.sh"]
   

方案二：直接在Docker Compose里组合命令（更简洁） #

如果你的需求很简单，不需要额外初始化逻辑，可以直接把启动和导入命令写在一起：

更新Docker Compose的command和volumes部分：

services:
  consul:
    # ... 其他配置保持不变
    volumes:
      - ./data:/consul/data
      - ./consul-kv-config.json:/consul/config/consul-kv-config.json
    command: >
      sh -c "consul agent -server -bind 0.0.0.0 -client 0.0.0.0 -bootstrap-expect=1 &
             until curl -s http://localhost:8500/v1/status/leader | grep -q ':'; do sleep 2; done;
             consul kv import @/consul/config/consul-kv-config.json;
             wait"

一些要注意的点 #

• 一定要等Consul完全启动再执行导入命令，不然会失败——上面两种方案里的curl检查leader状态是很可靠的判断方式。
• 确保你的consul-kv-config.json在容器内的路径和命令里的路径对应上，别写错了。
• 如果你以后要搭多节点Consul集群，记得只在bootstrap节点执行一次导入，避免重复写入KV。

内容的提问来源于stack exchange，提问作者user2201789