ManageIQ Worker Web Server 镜像文档

一、镜像概述和主要用途

概述

该镜像是 ManageIQ 平台的核心工作节点（Worker）组件，内置 Web 服务器并暴露 3000 端口，用于处理 HTTP 请求。ManageIQ 是一款开源企业级云管理平台，支持混合云、私有云及虚拟化环境的统一管理，该 Worker 镜像作为平台的功能节点，提供 Web 服务能力。

主要用途

• 作为 ManageIQ 平台的 Web 服务节点，提供用户界面（UI）或 API 访问入口
• 处理来自客户端的 HTTP 请求，与 ManageIQ 其他组件（如数据库、消息队列）协同工作
• 扩展 ManageIQ 平台的 Web 服务能力，支持高可用或分布式部署架构

二、核心功能和特性

核心功能

1. Web 服务运行：内置 Web 服务器（基于 ManageIQ 应用框架，通常为 Ruby on Rails 应用的 Rack 服务器），监听 3000 端口并处理 HTTP 请求
2. ManageIQ 生态集成：与 ManageIQ 平台的数据库、消息队列（如 Kafka、RabbitMQ）等组件无缝对接，协同完成云资源管理、自动化运维等核心业务逻辑
3. 请求处理：支持标准 HTTP 协议，处理用户界面交互请求、API 调用及内部组件通信

特性

• 轻量级部署：基于 Docker 容器化设计，支持快速启停和环境一致性
• 可扩展性：可通过多实例部署实现负载均衡，满足高并发场景需求
• 配置兼容性：遵循 ManageIQ 平台统一配置标准，支持通过环境变量或配置文件自定义参数

三、使用场景和适用范围

使用场景

• ManageIQ 平台部署：作为 Web 服务节点集成到 ManageIQ 集群，提供 UI/API 访问能力
• 分布式架构扩展：在多节点 ManageIQ 部署中，独立部署该 Worker 以分担 Web 请求负载
• 开发/测试环境：用于快速搭建 ManageIQ Web 服务节点，验证功能或集成方案

适用范围

• 企业级 IT 管理环境（混合云、私有云、虚拟化平台）
• 需要部署 ManageIQ 平台 Web 服务能力的场景
• 基于 Docker/Kubernetes 的容器化部署架构

四、使用方法和配置说明

前提条件

• 已安装 Docker 引擎（20.10+ 版本）
• 网络环境允许 3000 端口通信（客户端访问及与 ManageIQ 其他组件的内部通信）
• 若需持久化数据或配置，需准备本地目录用于挂载数据卷

基础使用（Docker Run）

通过 docker run 命令启动容器，映射 3000 端口并配置必要参数：

docker run -d \
  --name manageiq-worker-web \
  -p 3000:3000 \  # 映射容器 3000 端口到主机
  -e DATABASE_URL=postgresql://user:password@db-host:5432/manageiq \  # 数据库连接地址（示例）
  -e MIQ_SECRET_KEY=your-secret-key \  # ManageIQ 加密密钥（示例，需与平台一致）
  -v /host/path/config:/opt/manageiq/config \  # 挂载本地配置目录（可选）
  -v /host/path/logs:/opt/manageiq/logs \  # 挂载日志目录（可选）
  manageiq/worker-web:latest  # 镜像名称（需替换为实际镜像标签）

说明：上述环境变量（如 DATABASE_URL、MIQ_SECRET_KEY）为 ManageIQ 平台通用配置参数，具体值需根据实际部署环境调整，详细参数可参考 ManageIQ 官方配置文档。

Docker Compose 部署示例

在多容器环境中（如需关联数据库、消息队列），可通过 docker-compose.yml 定义服务：

version: '3.8'
services:
  manageiq-web-worker:
    image: manageiq/worker-web:latest
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://user:password@postgres:5432/manageiq
      - MIQ_SECRET_KEY=${MIQ_SECRET_KEY}
      - RABBITMQ_URL=amqp://guest:guest@rabbitmq:5672  # 消息队列连接（示例）
    volumes:
      - ./config:/opt/manageiq/config
      - ./logs:/opt/manageiq/logs
    depends_on:
      - postgres
      - rabbitmq

  postgres:  # 示例数据库服务（实际部署中可能使用外部数据库）
    image: postgres:13
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=manageiq
    volumes:
      - postgres-data:/var/lib/postgresql/data

  rabbitmq:  # 示例消息队列服务（ManageIQ 依赖）
    image: rabbitmq:3.9-management
    ports:
      - "5672:5672"

volumes:
  postgres-data:

配置参数说明

1. 端口映射

• 容器端口：3000（固定，Web 服务监听端口）
• 主机端口：可自定义（如 -p 8080:3000 将主机 8080 端口映射到容器 3000 端口）

2. 环境变量（示例）

3. 数据卷挂载

五、注意事项

1. 镜像版本：需使用与 ManageIQ 平台版本匹配的镜像（如平台版本为 jansa，则镜像标签应为 jansa-latest），避免版本兼容性问题。
2. 依赖组件：该 Worker 需与 ManageIQ 数据库、消息队列等核心组件通信，部署前需确保相关服务已正常运行且网络可达。
3. 资源配置：根据实际负载调整容器 CPU/内存限制（如 --cpus 2 -m 4G），避免资源不足导致服务异常。
4. 安全配置：生产环境中需通过环境变量或配置文件设置强密钥（如 MIQ_SECRET_KEY），并限制 3000 端口的访问来源（如通过防火墙策略）。

如需更详细的配置说明，请参考 ManageIQ 官方文档 或镜像维护者提供的补充说明。