stakater/git2consul

git2consul Docker镜像

镜像概述

本镜像封装了git2consul工具，用于将一个或多个Git仓库映射到Consul服务器。其核心功能是读取Git仓库中的配置文件，并将其转换为Consul的键值对存储；同时支持定时同步Git仓库变更（默认每1分钟同步一次）。

核心功能与特性

• Git与Consul同步：将Git仓库中的配置文件映射为Consul键值对
• 定时同步：默认每1分钟检测Git仓库变更并同步至Consul
• 灵活配置：通过配置文件自定义Git仓库信息、同步策略等
• 轻量级基础：基于Alpine Linux构建，镜像体积小

使用场景

• 微服务架构中集中管理配置，通过Git版本控制配置文件
• 需要将Git作为配置源，自动同步配置到Consul的场景
• 多环境（如开发、测试、生产）配置的统一管理与同步

使用方法

基本运行命令

通过docker run命令启动容器，需设置COMMAND环境变量指定git2consul运行参数：

bash
docker run -d \
  -e COMMAND="git2consul --endpoint <consul服务器地址> --port <consul端口> --config-file /home/git2consul/config.json" \
  -v /本地配置目录:/home/git2consul \
  stakater/git2consul:0.12.13

参数说明

• --endpoint：Consul服务器地址（如192.168.1.100）
• --port：Consul服务器端口（如8500）
• --config-file：配置文件路径（容器内路径固定为/home/git2consul/config.json）

配置文件示例

需在本地创建config.json文件，挂载到容器内/home/git2consul/目录。示例配置：

json
{
  "version": "1.0",
  "repos": [{
    "name": "keyValue pairs",
    "url": "你的Git仓库链接",
    "branches": ["dev"],
    "include_branch_name": false,
    "ignore_repo_name": true,
    "ignore_file_extension": true,
    "expand_keys": true,
    "hooks": [{
      "type": "polling",
      "interval": "1"  // 同步间隔（分钟）
    }]
  }]
}

默认命令

若未设置COMMAND环境变量，容器将使用默认命令：

bash
git2consul --endpoint 127.0.0.1 --port 80 --config-file /home/git2consul/config.json

版本信息

• 可用版本：v0.12.13

镜像层结构

alpine:3.5 → stakater/base-alpine:3.5 → stakater/node/6.9 → stakater/git2consul

更多配置

关于git2consul的详细配置说明，可参考https://github.com/breser/git2consul%E3%80%82