artcom/acms-config

ACMS 配置镜像

镜像概述和主要用途

该镜像为https://github.com/artcom/acms-compose%E6%8F%90%E4%BE%9B%E5%9F%BA%E7%A1%80Git%E4%BB%93%E5%BA%93%EF%BC%8C%E5%88%9D%E5%A7%8B%E5%8C%96%E5%8C%85%E5%90%AB%E6%BC%94%E7%A4%BA%E5%86%85%E5%AE%B9%EF%BC%8C%E7%94%A8%E4%BA%8EACMS%E7%B3%BB%E7%BB%9F%E7%9A%84%E9%85%8D%E7%BD%AE%E7%AE%A1%E7%90%86%E3%80%82%E5%AE%83%E6%94%AF%E6%8C%81Git%E7%89%88%E6%9C%AC%E6%8E%A7%E5%88%B6%E3%80%81%E9%BB%98%E8%AE%A4%E5%88%86%E6%94%AF%E8%87%AA%E5%AE%9A%E4%B9%89%E5%8F%8A%E9%85%8D%E7%BD%AE%E5%8F%98%E6%9B%B4%E7%9A%84MQTT%E4%BA%8B%E4%BB%B6%E9%80%9A%E7%9F%A5%EF%BC%8C%E6%98%AFACMS%E7%94%9F%E6%80%81%E4%B8%AD%E9%85%8D%E7%BD%AE%E7%AE%A1%E7%90%86%E7%9A%84%E6%A0%B8%E5%BF%83%E7%BB%84%E4%BB%B6%E3%80%82

重大变更

默认分支已从 master 更改为 main。如果依赖之前的默认分支，构建镜像时需传递 DEFAULT_BRANCH 构建参数：

bash
docker build --build-arg DEFAULT_BRANCH=master -t artcom/acms-config .

仅当镜像构建时未使用正确的构建参数时，才需要通过运行时环境变量 -e DEFAULT_BRANCH=master 进行覆盖。

核心功能和特性

• Git仓库初始化：构建时创建包含演示内容的裸Git仓库
• 默认分支管理：支持构建时和运行时自定义默认分支
• 配置变更通知：通过MQTT发布配置变更事件
• 灵活配置：支持构建参数和环境变量自定义行为

使用场景和适用范围

适用于ACMS系统的配置管理场景，特别是需要：

• 对ACMS配置进行版本控制
• 实时监控配置变更
• 集成MQTT消息系统实现配置变更通知的场景

使用方法和配置说明

基本使用

构建镜像

bash
docker build -t artcom/acms-config .

运行容器

bash
docker run artcom/acms-config

构建参数

示例：使用自定义默认分支构建

bash
docker build --build-arg DEFAULT_BRANCH=master -t artcom/acms-config .

默认分支处理

裸Git仓库在构建时会初始化一个以 DEFAULT_BRANCH 构建参数命名的分支（默认：main）。

容器启动时，入口脚本 50-set-default-branch.sh 会将仓库分支名称与 DEFAULT_BRANCH 环境变量进行协调。如果名称不同，脚本会原地重命名分支（通过移动引用和更新 HEAD），确保客户端始终将配置的名称视为默认分支，无论构建时嵌入的分支名称是什么。

配置变更钩子

当裸Git仓库接收到推送时，post-receive 钩子会向 <BASE_TOPIC>/onConfigurationChange 发布MQTT事件。

该钩子在Docker构建期间通过 core.hooksPath 全局安装，无需每个仓库单独创建符号链接。

事件 payload

每个更新的引用会发布一条消息：

json
{
  "refName": "refs/heads/master",
  "changedFiles": [
    "config/content/pages/page001/index.json",
    "config/content/pages/page002/index.json"
  ]
}

环境变量