kavra/consul

Consul初始化容器镜像

概述

该镜像作为Consul相关的初始化容器，主要用于在容器启动阶段填充envconsul和consul-template工具，为后续应用容器提供配置管理支持。通过该初始化容器，可在应用启动前完成必要的配置工具准备，确保应用能够顺利从Consul获取配置信息。

核心功能与特性

• 内置envconsul和consul-template工具，支持从Consul获取配置并注入环境变量或生成配置文件
• 设计为初始化容器（init container），确保在应用容器启动前完成工具准备
• 与Consul服务无缝集成，支持从Consul KV存储或服务发现中获取配置数据
• 轻量级架构，专注于初始化阶段的配置工具填充功能，减少资源占用

使用场景与适用范围

• 微服务架构中需从Consul获取动态配置的应用容器
• 通过envconsul将Consul配置注入环境变量的应用场景
• 使用consul-template根据Consul数据动态生成配置文件的场景
• Kubernetes或Docker Compose环境中需初始化配置工具的多容器应用

使用方法与配置说明

基本使用示例（Docker Run）

作为初始化容器与应用容器配合使用：

bash
# 初始化容器示例：将工具复制到共享卷
docker run --name consul-init \
  -v /app/tools:/target \
  consul-init-image:latest \
  sh -c "cp /usr/local/bin/envconsul /usr/local/bin/consul-template /target/"

# 应用容器使用初始化后的工具
docker run --name app \
  -v /app/tools:/usr/local/bin \
  -e CONSUL_HTTP_ADDR=consul-server:8500 \
  app-image:latest

Docker Compose配置示例

yaml
version: '3'
services:
  app:
    image: app-image:latest
    depends_on:
      - consul-init
    volumes:
      - tools:/usr/local/bin
    environment:
      - CONSUL_HTTP_ADDR=consul-server:8500
  
  consul-init:
    image: consul-init-image:latest
    volumes:
      - tools:/target
    command: ["sh", "-c", "cp /usr/local/bin/envconsul /usr/local/bin/consul-template /target/"]

volumes:
  tools:

配置参数说明

• 卷挂载：建议将工具目标目录（如/target）挂载为共享卷，以便应用容器访问工具
• 自定义命令：可通过command参数覆盖默认行为，实现工具版本选择或自定义初始化逻辑
• 环境变量：可配置Consul连接参数（如CONSUL_HTTP_ADDR、CONSUL_TOKEN），用于工具与Consul服务的认证和通信