manageiq/manageiq-orchestrator

ManageIQ Orchestrator 容器镜像文档

1. 镜像概述和主要用途

ManageIQ Orchestrator 容器是 ManageIQ 云管理平台的核心组件之一，主要负责协调和管理 ManageIQ 环境中的各类任务、工作流及跨组件通信。该容器提供任务编排、流程自动化和组件协作能力，是实现 ManageIQ 混合云资源管理、自动化运维和跨平台协调的关键支撑。

2. 核心功能和特性

2.1 核心功能

• 任务编排：支持复杂任务的定义、调度与执行，实现多步骤操作的自动化流转。
• 工作流管理：提供可视化或代码化的工作流定义方式，支持条件分支、并行任务等复杂流程逻辑。
• 组件协调：作为 ManageIQ 各组件（如数据库、API 服务、UI 前端）的通信中枢，协调组件间数据交互与状态同步。
• 事件驱动处理：响应来自其他组件或外部系统的事件（如资源变更、告警触发），自动触发预设工作流。

2.2 关键特性

• 兼容性：与 ManageIQ 生态系统无缝集成，支持与数据库、消息队列、外部云平台 API 等组件通信。
• 可扩展性：支持水平扩展，通过多实例部署提升并发处理能力。
• 可配置性：通过环境变量、配置文件等方式灵活调整行为，适配不同部署场景。
• 高可用性：支持故障自动恢复，配合外部存储和数据库实现状态持久化。

3. 使用场景和适用范围

3.1 典型使用场景

• 混合云资源自动化：跨私有云、公有云（如 AWS、Azure）的资源创建、配置与生命周期管理。
• 运维任务自动化：自动化执行重复性运维操作，如虚拟机备份、快照清理、资源优化等。
• 合规性与审计：定期执行合规性检查工作流，生成审计报告并触发异常修复流程。
• 跨平台工作流协调：协调不同管理平台（如 VMware vCenter、OpenStack）的操作，实现统一管理流程。

3.2 适用范围

• 基于 ManageIQ 构建的云管理平台部署。
• 需要自动化协调多组件、多步骤任务的 IT 运维场景。
• 混合云、多云环境的统一资源与流程管理。

4. 使用方法和配置说明

4.1 前置条件

• 已部署 ManageIQ 核心组件（如数据库、API 服务）。
• 容器运行环境需支持 Docker 19.03+ 或 Kubernetes 1.16+。
• 网络需确保 Orchestrator 容器能与 ManageIQ 其他组件及外部系统通信。

4.2 Docker 快速启动

4.2.1 基本运行命令

bash
docker run -d \
  --name manageiq-orchestrator \
  --network manageiq-network \  # 与其他 ManageIQ 组件共享网络
  -e MIQ_DB_HOST=manageiq-db \  # 数据库主机地址
  -e MIQ_DB_USER=miq_user \      # 数据库用户名
  -e MIQ_DB_PASSWORD=secret \    # 数据库密码
  -e MIQ_DB_NAME=miq_orchestrator \  # 数据库名称
  -e MIQ_LOG_LEVEL=info \        # 日志级别：debug/info/warn/error
  -e MIQ_API_HOST=manageiq-api \ # API 服务主机地址
  -p 8080:8080 \                 # 工作流 API 端口
  manageiq/orchestrator:latest

4.2.2 挂载配置文件（可选）

如需自定义工作流模板或配置，可挂载本地目录：

bash
docker run -d \
  --name manageiq-orchestrator \
  --network manageiq-network \
  -e MIQ_DB_HOST=manageiq-db \
  -e MIQ_DB_USER=miq_user \
  -e MIQ_DB_PASSWORD=secret \
  -v /local/workflows:/etc/manageiq/orchestrator/workflows \  # 挂载工作流模板
  -v /local/config:/etc/manageiq/orchestrator/config \      # 挂载配置文件
  manageiq/orchestrator:latest

4.3 Docker Compose 部署示例

适用于开发或测试环境的多组件协同部署：

yaml
version: '3.8'

services:
  orchestrator:
    image: docker.xuanyuan.run/manageiq/orchestrator:latest
    container_name: manageiq-orchestrator
    depends_on:
      - db
      - api
    environment:
      - MIQ_DB_HOST=db
      - MIQ_DB_USER=miq_user
      - MIQ_DB_PASSWORD=secret
      - MIQ_DB_NAME=miq_orchestrator
      - MIQ_API_HOST=api
      - MIQ_API_PORT=3000
      - MIQ_LOG_LEVEL=info
    volumes:
      - orchestrator-workflows:/etc/manageiq/orchestrator/workflows
    ports:
      - "8080:8080"
    restart: unless-stopped

  db:
    image: docker.xuanyuan.run/postgres:13
    container_name: manageiq-db
    environment:
      - POSTGRES_USER=miq_user
      - POSTGRES_PASSWORD=secret
      - POSTGRES_DB=miq_orchestrator
    volumes:
      - db-data:/var/lib/postgresql/data

  api:
    image: docker.xuanyuan.run/manageiq/api:latest
    container_name: manageiq-api
    depends_on:
      - db

volumes:
  orchestrator-workflows:
  db-data:

4.4 环境变量配置

4.5 持久化与配置文件

• 工作流模板：可通过挂载目录 /etc/manageiq/orchestrator/workflows 加载自定义工作流 YAML/JSON 模板。
• 配置文件：主配置文件 orchestrator.yml 可通过挂载 /etc/manageiq/orchestrator/config/orchestrator.yml 覆盖默认配置，支持自定义任务超时、重试策略等高级参数。

5. 注意事项

• 生产环境部署需配合外部数据库（如 PostgreSQL 集群）和持久化存储，确保数据可靠性。
• 容器资源建议：至少 2 CPU 核心、4GB 内存，具体根据工作流数量和复杂度调整。
• 网络安全：限制容器端口暴露范围，通过防火墙或网络策略控制组件间通信。
• 版本兼容性：需与 ManageIQ 其他组件版本保持一致，具体参考官方版本矩阵。

注：本文档基于 ManageIQ 通用架构推断，具体配置参数和功能请以官方最新文档为准。