manageiq/manageiq-base-worker

ManageIQ 非Web服务工作器基础镜像

镜像概述和主要用途

该镜像作为ManageIQ平台中所有不暴露Web服务的工作器组件的基础运行环境。它提供统一的底层依赖和基础配置，旨在作为构建特定功能工作器镜像的底层基础，通过剔除Web服务相关组件（如Web服务器、HTTP路由等）优化资源占用和镜像体积。

核心功能和特性

• 精简架构：不含Web服务组件（如Nginx、Apache等），减少不必要的依赖和***面。
• 基础运行时：提供ManageIQ工作器运行所需的核心依赖（如Ruby/Python运行时、系统工具库等）。
• 统一配置基线：内置ManageIQ工作器通用配置框架，确保不同工作器组件的配置一致性。
• 组件兼容性：与ManageIQ平台其他核心组件（数据库、消息队列等）保持版本兼容。
• 可扩展设计：支持通过Dockerfile扩展，快速集成自定义工作器逻辑。

使用场景和适用范围

适用场景

• 开发或部署ManageIQ后台任务处理组件（如数据同步、定时任务、事件处理等）。
• 构建无需Web服务的ManageIQ功能模块（如批量操作执行器、日志处理器等）。
• 优化ManageIQ部署架构，分离Web服务与后台工作负载。

适用人群

• ManageIQ平台构建者（基于此镜像开发新工作器组件）。
• 运维人员（部署和管理ManageIQ后台工作负载）。
• 扩展开发者（为ManageIQ开发第三方工作器插件）。

使用方法和配置说明

基于镜像构建自定义工作器

通过Dockerfile扩展基础镜像，添加特定工作器逻辑：

dockerfile
# 基于非Web服务工作器基础镜像
FROM docker.xuanyuan.run/manageiq/worker-base:latest

# 复制自定义工作器代码至镜像
COPY ./custom_worker /opt/manageiq/workers/custom_worker

# 设置工作目录
WORKDIR /opt/manageiq/workers/custom_worker

# 安装工作器依赖（如适用）
RUN bundle install --without development test

# 配置启动命令
CMD ["./run_worker.sh"]

运行容器示例

使用docker run启动工作器容器：

bash
docker run -d \
  --name miq-background-processor \
  --network miq-network \  # 连接至ManageIQ平台网络
  -e MIQ_LOG_LEVEL=warn \  # 设置日志级别
  -e MIQ_DB_HOST=miq-postgres \  # 数据库主机
  -e MIQ_DB_USER=miq_user \  # 数据库用户
  -e MIQ_DB_PASSWORD=secure_password \  # 数据库密码
  -v /host/logs:/opt/manageiq/logs \  # 挂载日志目录
  -v /host/data:/opt/manageiq/data \  # 挂载数据持久化目录
  manageiq/worker-base:latest

配置参数

环境变量

数据持久化

兼容性说明

• 兼容ManageIQ Core v5.0+版本。
• 需与ManageIQ数据库schema版本保持一致（通过环境变量MIQ_DB_VERSION指定，默认自动匹配）。
• 支持Docker 19.03+及Podman 2.0+运行环境。