ManageIQ UI Worker 镜像文档

1. 镜像概述和主要用途

1.1 概述

ManageIQ UI Worker 镜像是基于 webserver worker 构建的 Docker 镜像，集成静态资源服务与 Apache HTTP Server，专为 ManageIQ 平台的 UI 层提供路由及静态资源托管能力。

1.2 主要用途

作为 ManageIQ 平台的前端核心组件，负责处理用户界面请求路由、静态资源（HTML/CSS/JavaScript）分发，支撑企业级 IT 管理平台的前端交互功能。

2. 核心功能和特性

• 基础架构：基于 webserver worker 构建，具备稳定的 web 服务运行环境
• 静态资源集成：内置 UI 相关静态资源，支持直接访问前端文件
• Apache 路由能力：集成 Apache HTTP Server，提供 HTTP 请求路由与反向代理功能
• 容器化优化：轻量级设计，适配容器化部署场景，支持水平扩展

3. 使用场景和适用范围

3.1 使用场景

• ManageIQ 平台前端服务部署
• 企业 IT 管理平台的 UI 访问层构建
• 静态资源与 HTTP 路由一体化的容器化应用场景

3.2 适用范围

• 企业级 IT 运维管理系统
• 基于 ManageIQ 构建的自定义管理平台
• 多组件架构应用的前端服务层

4. 使用方法和配置说明

4.1 基本部署（docker run 命令示例）

docker run -d \
  --name manageiq-ui-worker \
  -p 80:80 \  # 映射 Apache 服务端口（默认 HTTP 端口）
  -e MIQ_API_ENDPOINT=[***] \  # 后端 API 服务地址
  -e LOG_LEVEL=info \  # 日志级别（debug/info/warn/error）
  -v /host/static:/opt/manageiq/ui/static \  # 挂载自定义静态资源（可选）
  manageiq/ui-worker:latest

4.2 环境变量配置

4.3 端口映射

• 容器内默认端口：80（Apache HTTP 服务）
• 建议映射主机端口：根据实际需求映射（如 -p 8080:80）

4.4 数据卷挂载

4.5 docker-compose 配置示例

version: '3'
services:
  ui-worker:
    image: manageiq/ui-worker:latest
    ports:
      - "80:80"
    environment:
      - MIQ_API_ENDPOINT=[***]
      - LOG_LEVEL=warn
    volumes:
      - ./static:/opt/manageiq/ui/static
      - ./apache-conf:/etc/httpd/conf.d
    depends_on:
      - api-worker
      - db

  api-worker:
    image: manageiq/api-worker:latest  # 后端 API 服务
    # 其他 API 服务配置...

  db:
    image: postgres:13  # 数据库服务
    # 数据库配置...

5. 协同组件与注意事项

5.1 协同组件

• 后端 API 服务（如 ManageIQ API Worker）：通过 Apache 反向代理转发 UI 请求至 API 服务
• 数据库（如 PostgreSQL）：提供 UI 层所需的配置数据与状态存储
• 缓存服务（如 Redis）：优化静态资源访问性能与会话管理

5.2 注意事项

• 静态资源更新：通过挂载 /opt/manageiq/ui/static 目录实现资源热更新，无需重建镜像
• 安全加固：生产环境需启用 HTTPS（挂载 Apache SSL 配置及证书），并限制容器网络访问
• 版本兼容性：确保与 ManageIQ 其他组件版本匹配，避免接口不兼容问题

注：以上配置基于通用场景，具体参数请以官方文档为准。