camptocamp/shared_config_manager

配置卷维护工具镜像

镜像概述

该Docker镜像专注于解决Docker环境中配置卷（Configuration Volumes）的维护难题，提供一套完整的配置数据管理方案。通过该镜像，用户可实现配置数据的持久化存储、跨容器共享、版本控制及动态更新，避免因容器重建、升级或迁移导致的配置丢失，同时简化配置变更流程，提升Docker化应用的运维效率。

核心功能与特性

• 配置卷持久化：将配置数据存储于宿主机或外部存储，确保容器销毁/重建后配置不丢失
• 跨容器配置共享：支持多个容器通过统一配置卷共享相同配置，避免重复维护多份配置副本
• 配置版本控制：内置简易配置版本管理机制，可回溯历史配置状态
• 动态配置更新：支持配置文件实时同步至关联容器，无需重启容器即可应用新配置
• 配置隔离与环境适配：支持按环境（开发/测试/生产）隔离配置，通过标签区分不同环境配置集
• 轻量级设计：镜像体积小巧，基于Alpine或类似精简基础镜像构建，资源占用低

使用场景与适用范围

• 多容器共享配置：微服务架构中多个服务实例共享统一配置（如数据库连接信息、API密钥）
• 频繁配置变更场景：需要定期调整配置参数的应用（如日志级别、限流阈值）
• 配置持久化需求：避免因容器生命周期结束导致关键配置丢失的生产环境
• 环境一致性保障：确保开发、测试、生产环境使用统一配置管理策略，减少"环境不一致"问题
• 配置迁移支持：容器集群迁移时，简化配置数据的迁移与复用流程

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name config-volume-manager \
  -v /host/config:/config  `# 宿主机配置目录挂载（持久化存储）` \
  -v /var/run/docker.sock:/var/run/docker.sock  `# 挂载Docker守护进程套接字（用于容器通信）` \
  -e CONFIG_LABEL=prod  `# 指定配置环境标签（如prod/test/dev）` \
  -e SYNC_INTERVAL=30s  `# 配置同步间隔（默认30秒）` \
  [镜像名称]:[版本标签]

Docker Compose配置示例

yaml
version: '3'
services:
  config-manager:
    image: [镜像名称]:[版本标签]
    container_name: config-volume-manager
    volumes:
      - ./host-config:/config  # 宿主机配置目录（本地开发推荐相对路径）
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - CONFIG_LABEL=prod
      - SYNC_INTERVAL=30s
      - ENABLE_VERSIONING=true  # 启用配置版本控制（默认false）
    restart: unless-stopped

  app-service:
    image: your-app-image:latest
    volumes:
      - config-volume:/app/config  # 挂载由配置管理器维护的共享卷
    depends_on:
      - config-manager

volumes:
  config-volume:  # 定义共享配置卷（由config-manager管理）

环境变量配置

配置更新方法

1. 手动更新：直接修改宿主机挂载目录（如/host/config）中的配置文件，镜像将在SYNC_INTERVAL周期内自动同步至关联容器
2. 命令行更新：通过docker exec进入容器执行配置更新命令

   bash
   docker exec config-volume-manager update-config --file /config/app.conf --content "new_config_value"
   

3. API更新：若镜像内置API服务，可通过HTTP请求更新配置（需暴露对应端口，如-p 8080:8080）

   bash
   curl -X POST http://localhost:8080/config \
     -H "Content-Type: application/json" \
     -d '{"file": "app.conf", "content": "new_config_value"}'
   

注意事项

• 首次使用需确保宿主机挂载目录权限正确（建议设置chmod 755），避免容器内权限不足
• 启用STORAGE_BACKEND=nfs或s3时，需额外配置对应存储的访问凭证（通过环境变量或配置文件）
• 配置版本控制功能启用后，历史版本默认保留30天，可通过MAX_VERSION_RETENTION环境变量调整
• 生产环境建议结合Docker Swarm/Kubernetes的持久卷（PV/PVC）使用，提升配置存储可靠性