mosaicgreifswald/wildfly Docker 镜像 - 轩辕镜像

概述

WildFly镜像具有广泛的使用场景，可直接与Docker Compose配合使用，也可作为其他镜像的基础。该镜像无需先构建自定义镜像即可直接启动，当然也支持构建自定义镜像。

健康检查策略

此Docker镜像内置三种健康检查策略：

• 微配置文件健康检查（Microprofile-Health）
  默认策略，仅在设置WF_ADMIN_PASS变量时生效。WildFly管理端会自动检查所有安装了微配置文件的部署（详见：[***]

• URL检查（URL-check）
  需通过环境变量WF_HEALTHCHECK_URLS指定至少一个可访问的URL。若URL不可达或未返回HTTP 200状态码，健康状态将设为“不健康”。此策略可与微配置文件健康检查结合使用。

• 部署运行检查（Running-Deployments）
  仅在未使用前两种策略时生效，仅检查是否存在启动失败的部署。

相关环境变量

shell
# 查看更多环境变量
> docker run --rm mosaicgreifswald/wildfly envs

相关入口点

shell
# 查看入口点详情
> docker run --rm mosaicgreifswald/wildfly entrypoints

使用方法

shell
# 构建WildFly镜像（需依赖mosaicgreifswald/zulujre:21基础镜像）
> git clone [***]
> cd mosaic-hgw/Docker/image/wildfly
> docker build --tag="mosaicgreifswald/wildfly" --file="Dockerfile.wildfly.35" .

# 查看已安装组件版本
> docker run --rm mosaicgreifswald/wildfly versions
  last updated               : 2025-01-24 09:05:05
  Architecture               : x86_64
  Distribution               : Debian GNU/Linux 12.9
  zulu-jre                   : 21.0.6
  WildFly                    : 35.0.0.Final
  MySQL-Connector            : 9.2.0
  EclipseLink                : 4.0.5

# 简单启动（带部署文件且无需WildFly管理员用户）
> docker run --rm \
    -e WF_NO_ADMIN=true \
    -p 8080:8080 \
    -v /本地部署文件路径:/entrypoint-wildfly-deployments \
    mosaicgreifswald/wildfly

# 只读部署目录配置（禁用标记文件）
> docker run --rm \
    -e WF_ADMIN_PASS=top-secret \
    -e WF_MARKERFILES=false \
    -e WF_HEALTHCHECK_URLS=http://localhost:8080\nhttp://localhost:8080/your-app.html \
    -p 8080:8080 \
    -p 9990:9990 \
    -v /本地CLI文件路径:/entrypoint-wildfly-cli \
    -v /本地只读部署文件路径:/entrypoint-wildfly-deployments \
    mosaicgreifswald/wildfly

修改写入权限

通过卷挂载主机目录时，默认文件所有者为内部mosaic用户（UID:GID=1111:1111）。需为主机可写目录授予该用户权限：

sh
# 在主机执行
chown -R 1111:1111 deployments logs

注意：部署目录不一定需要写权限。若禁用写权限，WildFly将不生成标记文件。

替代方案：修改写入用户

可通过Docker参数--user/-u修改写入用户（UID:GID）：

sh
# 修改日志等可写卷的所有者（UID:GID）
> docker run --rm -d \
    -u 1006:1001 \
    -e WF_SYSTEM_LOG_TO=FILE \
    -v /本地日志路径:/entrypoint-wildfly-logs \
    mosaicgreifswald/wildfly

# 查看主机日志目录权限
> ls -la /本地日志路径
总用量 8
drwxr-xr-x  2 1006 1001 4096 12月 11日 10:25 .
drwxrwxrwt 10 root root 4096 12月 11日 10:26 ..
-rw-r--r--  1 1006 1001    0 12月 11日 10:25 server.log
drwxr-xr-x  2 1006 1001 4096 12月 11日 10:25 system

Docker Compose使用示例

与MySQL数据库联动的部署示例：

yml
# docker-compose.yml

version: '3'
services:
  mysql:
    image: mysql
    environment:
      MYSQL_ROOT_PASSWORD: top-secret
    volumes:
      - /本地SQL初始化文件路径:/docker-entrypoint-initdb.d
  wildfly:
    image: mosaicgreifswald/wildfly
    ports:
      - 8080:8080
      - 9990:9990
    depends_on:
      - mysql
    environment:
      WF_ADMIN_PASS: top-secret
      WF_HEALTHCHECK_URLS: |
        http://localhost:8080
        http://localhost:8080/your-app.html
    volumes:
      - /本地CLI文件路径:/entrypoint-wildfly-cli
      - /本地部署文件路径:/entrypoint-wildfly-deployments
    entrypoint: /bin/bash
    command: -c "./wait-for-it.sh mysql:3306 -t 60 && ./run.sh"

什么是JBoss命令行界面文件？

JBoss命令行界面（CLI）文件是包含一系列JBoss服务器命令的文本文件，用于自动化部署、配置系统设置或执行管理操作。通过CLI文件可在不修改镜像的情况下自定义WildFly配置，所有调整均可通过CLI文件传入。

JBoss CLI文件示例

• 添加MySQL数据源

  sh
  # add-mysql-datasource.cli
  
  data-source add \
    --name=MySQLPool \
    --jndi-name=java:/jboss/MySQLDS \
    --connection-url=jdbc:mysql://mysql:3306/dbName \
    --user-name=mosaic \
    --password=top-secret \
    --driver-name=mysql
  

• 添加PostgreSQL驱动模块及数据源

  sh
  # add-postgre-datasource.cli
  
  batch
  
  module add \
    --name=org.postgre \
    --resources=/entrypoint-wildfly-cli/postgresql.jar \
    --dependencies=javax.api,javax.transaction.api
  
  /subsystem=datasources/jdbc-driver=postgre: \
    add( \
      driver-name="postgre", \
      driver-module-name="org.postgre", \
      driver-class-name=org.postgresql.Driver \
    )
  
  data-source add \
    --name=PostgreSQLPool \
    --jndi-name=java:/jboss/PostgreSQLDS \
    --connection-url=jdbc:postgresql://app-db:5432/dbName \
    --user-name=mosaic \
    --password=top-secret \
    --driver-name=postgre
  
  run-batch
  

附加文件

shell
# 查看所有附加文件
> docker run --rm -it mosaicgreifswald/wildfly bash -c "cd /entrypoint-help-and-usage; ls -lah --color; bash"

# 复制到本地
> docker run --rm -v "$(pwd)":"$(pwd)" mosaicgreifswald/wildfly bash -c "cp -R /entrypoint-help-and-usage $(pwd)/help-and-usage"

附加文件目录结构：

├─┬─ layer-readme/
│ ├─── README-debian.md
│ ├─── README-wildfly.md
│ └─── README-zulujre.md
└─┬─ examples/
  ├─┬─ compose-wildfly-dbdriver/
  │ ├─── jboss/
  │ └─┬─ add_x_driver.cli
  │   └─── docker-compose.yml
  ├─┬─ compose-wildfly-empty/
  │ ├─── addins/
  │ ├─┬─ envs/
  │ │ └─── wf_commons.env
  │ ├─── jboss/
  │ ├─── logs/
  │ ├─── sqls/
  │ └─── docker-compose.yml
  └─┬─ pure-envs/
    ├─── debian.env
    ├─── wf_commons.env
    └─── zulujre.env

镜像软件版本历史