ananace/choria-bolt

MCollective、Choria和Bolt Task集成镜像

镜像概述

本Docker镜像集成了MCollective、Choria和Bolt Task工具，提供容器化环境用于服务器编排、分布式系统管理和自动化任务执行。通过容器化部署简化工具安装配置流程，确保环境一致性，适用于各类运维自动化场景。

核心功能与特性

• MCollective集成：提供服务器编排和消息传递能力，支持跨节点命令执行和状态监控
• Choria支持：基于MCollective的现代化分支，提供服务发现、元数据管理和安全编排功能
• Bolt Task执行：集成Puppet Bolt工具，支持无代理任务执行、任务编排和基础设施自动化
• 容器化优势：独立运行环境，避免依赖冲突，简化部署和版本管理
• 灵活配置：支持通过环境变量和挂载卷自定义工具配置，适应不同场景需求

使用场景

• 分布式服务器集群的统一管理与监控
• 跨节点自动化运维任务（如软件部署、配置更新）
• 无代理环境下的任务执行与状态检查
• 基础设施即代码(IaC)流程中的自动化环节
• 多环境（开发、测试、生产）下的一致化工具部署

使用方法与配置说明

基本运行命令

bash
docker run -d \
  --name mcollective-choria-bolt \
  -v /path/to/config:/etc/mcollective \
  -v /path/to/bolt-tasks:/etc/bolt/tasks \
  -e MCOLLECTIVE_CONFIG=/etc/mcollective/server.cfg \
  -e CHORIA_BROKER_URL=nats://broker:4222 \
  [镜像名称]

环境变量配置

挂载卷说明

• /etc/mcollective：MCollective配置文件目录，需包含服务器配置、证书等
• /etc/bolt：Bolt配置和任务目录，存放任务定义（.pp或.yaml文件）
• /var/log/mcollective：日志目录，用于持久化工具运行日志

执行Bolt任务示例

bash
# 进入容器
docker exec -it mcollective-choria-bolt /bin/bash

# 执行Bolt任务
bolt task run package --targets all action=install name=nginx

Docker Compose配置示例

yaml
version: '3'
services:
  mcollective-choria-bolt:
    image: [镜像名称]
    container_name: mcollective-choria-bolt
    volumes:
      - ./mcollective-config:/etc/mcollective
      - ./bolt-tasks:/etc/bolt/tasks
      - ./logs:/var/log/mcollective
    environment:
      - MCOLLECTIVE_CONFIG=/etc/mcollective/server.cfg
      - CHORIA_BROKER_URL=nats://nats:4222
      - LOG_LEVEL=info
    depends_on:
      - nats
  nats:
    image: nats:latest
    container_name: choria-nats
    ports:
      - "4222:4222"

注意事项

• 首次运行需确保挂载的配置文件目录包含有效的MCollective和Choria配置
• Choria依赖消息代理（如NATS），需提前部署并配置正确的BROKER_URL
• Bolt任务文件需符合Puppet Task规范，放置在挂载的bolt/tasks目录下
• 生产环境建议配置持久化日志和证书文件，确保数据安全