cbflow-agent Docker镜像文档

概述

cbflow-agent是cbflow工作流/流程管理系统的核心代理组件，部署于分布式节点，负责接收中心服务下发的任务指令、执行任务操作、实时采集运行数据（日志、状态、资源占用），并与cbflow中心服务维持通信，确保分布式任务的协调执行与系统稳定运行。该镜像基于轻量级基础镜像构建，支持多架构部署，适用于各类分布式任务调度场景。

核心功能与特性

• 任务执行代理：接收并执行中心服务下发的多样化任务（命令执行、脚本运行、容器化任务等），支持任务优先级与依赖管理
• 数据采集与上报：实时收集任务运行日志、执行状态（成功/失败/进行中）及节点资源使用率（CPU、内存、磁盘I/O）
• 双向通信机制：与cbflow中心服务保持长连接，支持任务状态实时上报、配置动态更新及紧急指令接收
• 高可用设计：内置自动重连机制，任务失败支持可配置重试策略（次数/间隔），保障任务可靠性
• 轻量高效：基于Alpine Linux构建，镜像体积<50MB，启动时间<10秒，资源占用低
• 多平台兼容：支持x86_64、ARM64架构，适配物理机、虚拟机及容器平台（Kubernetes、Docker Swarm）

使用场景与适用范围

• 分布式任务调度：在集群节点中分发执行批量任务（如数据ETL、文件同步、定时报表生成）
• 边缘计算节点：部署于边缘设备，执行本地化计算任务并向中心节点汇报结果
• CI/CD流水线代理：作为CI/CD系统工作节点，执行代码构建、测试及部署流程
• 监控与运维自动化：在服务器节点部署，执行系统监控脚本、配置巡检及故障自愈任务

使用方法与配置说明

前置条件

• 已部署cbflow中心服务，获取服务访问地址（如[***]）
• Docker环境版本≥19.03或容器运行时兼容OCI标准

基础部署命令

bash
docker run -d \
  --name cbflow-agent \
  --restart always \
  -e CBFLOW_SERVER_URL="[***]" \  # 中心服务地址（必填）
  -e AGENT_ID="node-001" \                           # 节点唯一标识（可选，默认自动生成UUID）
  -e LOG_LEVEL="info" \                              # 日志级别（可选，默认info）
  -v /var/run/docker.sock:/var/run/docker.sock \      # 执行容器化任务需挂载（可选）
  -v /opt/cbflow-agent/logs:/app/logs \              # 日志持久化（推荐）
  -v /opt/cbflow-agent/data:/app/data \              # 任务数据持久化（推荐）
  cbflow/cbflow-agent:latest

环境变量配置参数

数据持久化配置

为避免容器重启导致数据丢失，建议持久化以下目录：

健康检查配置

容器内置健康检查端点http://localhost:9090/health，可通过以下方式启用Docker健康检查：

bash
docker run -d \
  --name cbflow-agent \
  --health-cmd "curl -sf http://localhost:9090/health || exit 1" \
  --health-interval 30s \
  --health-timeout 10s \
  --health-retries 3 \
  # 其他参数...
  cbflow/cbflow-agent:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  cbflow-agent:
    image: cbflow/cbflow-agent:latest
    container_name: cbflow-agent
    restart: always
    environment:
      - CBFLOW_SERVER_URL=[***]
      - AGENT_ID=node-001
      - LOG_LEVEL=info
      - HEARTBEAT_INTERVAL=30
      - RETRY_LIMIT=3
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /opt/cbflow-agent/logs:/app/logs
      - /opt/cbflow-agent/data:/app/data
    healthcheck:
      test: ["CMD", "curl", "-sf", "http://localhost:9090/health"]
      interval: 30s
      timeout: 10s
      retries: 3
    networks:
      - cbflow-network

networks:
  cbflow-network:
    driver: bridge

版本与获取

• 最新稳定版：cbflow/cbflow-agent:latest
• 历史版本：访问Docker Hub查看标签
• 镜像拉取命令：docker pull cbflow/cbflow-agent:latest