wslph/mule Docker镜像文档

概述

wslph/mule是Mule ESB运行时的Docker容器镜像，支持社区版（Community Edition）和企业版（Enterprise Edition）。该镜像提供容器化部署方式，便于快速搭建Mule ESB运行环境，适用于开发、测试及生产环境中运行Mule ESB应用。

核心功能与特性

• 多版本支持：提供社区版和企业版Mule ESB运行时，支持不同版本标签（如3.9.0-ce、4.3.0-ee等）。
• 数据持久化：通过挂载卷（volume）持久化应用（apps）、域名（domains）、配置（conf）、日志（logs）等关键数据，避免容器删除导致数据丢失。
• 灵活配置：支持通过环境变量自定义时区、ESB名称、管理平台注册信息等，满足不同部署需求。
• 管理集成：可注册到Anypoint Runtime Manager或Mule Management Console（MMC），实现运行时监控与管理。
• 补丁应用：支持通过挂载补丁卷自动将补丁文件复制到运行时目录，简化版本维护。
• 自定义脚本：允许在Mule启动前执行自定义shell脚本，实现个性化初始化逻辑。

使用场景

• 开发环境：快速搭建本地Mule ESB开发环境，测试Mule应用。
• 生产环境：容器化部署Mule ESB运行时，结合卷挂载实现数据持久化和配置管理。
• 管理集成：集成Anypoint平台或MMC，实现多实例集中监控、应用部署与版本控制。

前置要求

• Docker主机需至少2GB可用内存（Mule ESB硬件要求详见***文档）。
• 安装最新版Docker Engine（推荐通过***Docker发布页安装）。

安装与部署

拉取镜像

从Docker Hub拉取最新版本镜像：

bash
# 拉取企业版3.9.0最新构建
docker pull wslph/mule:3.9.0-ee

# 拉取指定日期构建的镜像（格式：版本-YYYY-MM-DD）
docker pull wslph/mule:3.9.0-ee-2018-02-02

运行示例

示例1：启动社区版容器

bash
docker run --restart=always --name mule-ce -d \
    --publish 7777:7777 \
    wslph/mule:3.9.0-ce && docker logs -f mule-ce

示例2：启动企业版容器

bash
docker run --restart=always --name mule-ee -d \
    --publish 7777:7777 \
    wslph/mule:3.9.0-ee && docker logs -f mule-ee

示例3：使用主机网络模式

bash
docker run --restart=always --name mule-ee -d \
    --net=host \
    wslph/mule:3.9.0-ee && docker logs -f mule-ee

示例4：Mule 4集成Anypoint监控

bash
docker run --restart=always --name mule -d \
    --publish 8081:8081\
    --env 'ARM_AUTH_TOKEN=<auth-token>' \
    --env 'ANYPOINT_ENV_ID=<env-id-hash-code>' \
    --env 'ANYPOINT_ORG_ID=<org-id-hash-code>' \
    --env 'MULE_ESB_NAME=NODE-1' \
    --env 'MULE_SERVER_GROUP=BILLING-SERVICES' \
    --env 'MULE_ENVIRONMENT=DEVELOPMENT' \
    --env 'MULE_ARM_MONITORING_ENABLED=true' \
    --volume ~/mule/apps:/opt/mule/apps \
    --volume ~/mule/domains:/opt/mule/domains \
    --volume ~/mule/conf:/opt/mule/conf \
    --volume ~/mule/logs:/opt/mule/logs \
    --volume ~/mule/patches:/opt/mule/patches \
    --volume ~/mule/.mule:/opt/mule/.mule \
    --volume ~/mule/plugins:/opt/mule/plugins \
    --volume ~/mule/server-plugins:/opt/mule/server-plugins \
    --volume ~/mule/policies:/opt/mule/policies \
    wslph/mule:4.3.0-20210304-ee-2021-10-23 && docker logs -f mule

说明：<auth-token>需通过命令生成：curl -X POST -H "Content-Type: application/json" -d '{"username":"<username>", "password":"<password>"}' [***] | jq -r .access_token

安装企业版许可证

企业版默认以试用模式运行，如需安装许可证，将license.lic或mule-ee-license.lic文件放入挂载的conf卷（如~/mule/conf），重启容器即可自动检测并安装。

配置说明

数据存储

为避免数据丢失，建议挂载以下卷：

应用运行时补丁

将补丁文件（如SE-3341-3.6.2.jar）放入/opt/mule/patches卷，容器启动时会自动复制到/opt/mule/lib/user目录，重启容器即可应用补丁。

注册到Anypoint Runtime Manager

通过环境变量MULE_ARM_TOKEN指定Anypoint令牌，示例：

bash
docker run --restart=always --name mule-ee -d \
    --publish 8081:8081\
    --env 'MULE_ESB_NAME=My-ESB-Server-01' \
    --env 'MULE_ARM_TOKEN=aaabbbcccdddeeefff...' \
    --volume ~/mule/apps:/opt/mule/apps \
    --volume ~/mule/conf:/opt/mule/conf \
    wslph/mule:3.9.0-ee && docker logs -f mule-ee

注册到Mule Management Console（MMC）

需指定以下环境变量，并执行注册脚本：

示例命令：

bash
docker run --restart=always --name mule-ee -d \
    --publish 7777:7777 \
    --env 'MULE_ESB_NAME=My-ESB-Server-01' \
    --env 'MULE_MMC_AGENT_HOST=123.455.234.110' \
    --env 'MULE_MMC_URL=[***] \
    --env 'MULE_MMC_USERNAME=admin' \
    --env 'MULE_MMC_PASSWORD=admin' \
    --volume ~/mule/conf:/opt/mule/conf \
    wslph/mule:3.9.0-ee && docker logs -f mule-ee

注册执行：

bash
docker exec <container-name> mmc_setup  # 返回JSON结果表示注册状态

可用配置参数

维护操作

Shell访问

通过docker exec进入运行中的容器：

bash
docker exec -it <container-name> bash  # 如：docker exec -it mule-ee bash

基于该镜像创建自定义镜像

如需构建包含特定应用的自定义镜像，需在Dockerfile中指定CMD命令，示例：

dockerfile
FROM wslph/mule:4.2.0-ee
COPY ./helloworld/target/helloworld-1.0.0-SNAPSHOT-mule-application.jar /opt/mule/apps/
CMD ["/opt/mule/bin/mule-start.sh"]  # 必须包含，确保启动时执行配置检查

参考链接

• 镜像标签列表：Docker Hub Tags
• Mule ESB用户指南：Mule ESB User Guide
• Mule 4文档：Mule 4 Documentation

关于

该镜像由WhiteSky Labs的Reynold Lariza开发维护，WhiteSky Labs是MuleSoft®的高级合作伙伴，专注于API集成服务。