imixs/wildfly

imixs/wildfly

本Docker镜像基于官方OpenJDK镜像构建，运行最新版本的Java应用服务器http://www.wildfly.org（基于OpenJDK 10）。此外，镜像还在WildFly的模块配置中添加了eclipselink.jar，并支持PostgreSQL的JDBC驱动。

核心功能

• 继承自官方OpenJDK镜像
• 运行基于OpenJDK 10的最新版WildFly
• 使用非特权系统用户（imixs）运行
• 以独立模式启动WildFly并启用管理控制台
• 首次使用时创建管理员用户
• 添加EclipseLink支持
• 提供PostgreSQL JDBC驱动
• 安装路径：/opt/wildfly
• 支持调试模式

环境变量

imixs/wildfly提供以下环境变量：

• JAVA_HOME
• WILDFLY_HOME（/opt/wildfly）
• WILDFLY_DEPLOYMENT（$WILDFLY_HOME/standalone/deployments）
• WILDFLY_CONFIG（$WILDFLY_HOME/standalone/configuration）

版本信息

以下镜像版本可用：

• imixs/wildfly:1.2.2 => Wildfly 10.0.0.Final
• imixs/wildfly:1.2.3 => Wildfly 11.0.0.Final
• imixs/wildfly:1.2.4 => Wildfly 12.0.0.Final
• imixs/wildfly:1.2.5 => Wildfly 13.0.0.Final（OpenJDK 8）
• imixs/wildfly:1.2.6 => Wildfly 13.0.0.Final（OpenJDK 10）
• imixs/wildfly:1.2.7 => Wildfly 15.0.1.Final（OpenJDK 10）
• imixs/wildfly:1.2.8 => Wildfly 16.0.0.Final（OpenJDK 10）
• imixs/wildfly:1.2.9 => Wildfly 18.0.0.Final（OpenJDK 10）
• imixs/wildfly:1.2.11 => Wildfly 18.0.0.Final（OpenJDK 10）
• imixs/wildfly:latest => Wildfly 20.0.0.Final（OpenJDK 10）

使用场景

适用于需要部署Java EE应用的开发、测试或生产环境，支持与PostgreSQL数据库集成，可通过外部卷自定义配置和部署应用。

配置说明

1. 安装Docker

按照https://docs.docker.com/engine/installation/为您的主机系统安装Docker。

2. 运行与停止容器

容器包含启动脚本，允许使用管理员密码启动Wildfly以访问Web管理控制台。使用以下命令启动Wildfly实例：

bash
docker run --name="wildfly" -d \
    -p 8080:8080 -p 9990:9990 \
    -e WILDFLY_PASS="admin_password" \
    docker.xuanyuan.run/imixs/wildfly

若省略WILDFLY_PASS环境变量，启动脚本会生成随机密码。暴露8080和9990端口后，可通过http://localhost:8080访问应用，通过http://localhost:9990访问管理控制台。

停止并移除容器：

bash
docker stop wildfly && docker rm wildfly

3. 访问WildFly

服务器启动后，可通过浏览器访问：

http://localhost:8080/

查看服务器日志：

bash
docker logs -f wildfly

进入容器bash：

bash
docker exec -it wildfly bash

绑定外部卷

若需自定义配置或部署应用，可绑定外部卷到以下位置：

• /opt/wildfly/standalone/configuration/：用于自定义配置文件（如standalone.xml）
• /opt/wildfly/standalone/deployments/：外部自动部署目录

示例：绑定外部部署卷

bash
docker run --name="wildfly" -d \
    -p 8080:8080 -p 9990:9990 \
    -e WILDFLY_PASS="admin_password" \
    -v /path/to/deployments:/opt/wildfly/standalone/deployments/ \
    docker.xuanyuan.run/imixs/wildfly

将.war或.ear文件放入deployments目录即可自动部署。

绑定外部配置卷示例：

bash
docker run --name="wildfly" -d \
    -p 8080:8080 -p 9990:9990 \
    -e WILDFLY_PASS="admin_password" \
    -v ~/git/imixs-office-workflow/src/docker/imixs/config/deployments:/opt/wildfly/standalone/deployments/ \
    -v ~/git/imixs-office-workflow/src/docker/imixs/config/configuration/standalone.xml:/opt/wildfly/standalone/configuration/standalone.xml \
    docker.xuanyuan.run/imixs/wildfly

从其他数据容器共享卷：

bash
docker run --name="wildfly" -d \
    -p 8080:8080 -p 9990:9990 \
    -e WILDFLY_PASS="admin_password" \
    --volumes-from my_data_container \
    docker.xuanyuan.run/imixs/wildfly

权限说明

Imixs Wildfly容器使用UID和GID为901的非特权用户启动Wildfly。若从主机共享卷，需确保该用户对主机目录有写权限：

bash
chgrp -R 901 /path/to/deployments && chmod 775 -R /path/to/deployments

链接容器

Java企业应用常需数据库服务，可通过Docker网络链接Wildfly容器与数据库容器。以下是docker-compose.yml示例：

yaml
version: "3.1"
services:
  postgres:
    image: docker.xuanyuan.run/postgres:9.6.1
    environment:
      POSTGRES_PASSWORD: xxx
      POSTGRES_DB: db
  wildfly:
    image: docker.xuanyuan.run/imixs/wildfly
    environment:
      WILDFLY_PASS: adminadmin
      POSTGRES_USER: "postgres"
      POSTGRES_PASSWORD: "xxx"
      POSTGRES_CONNECTION: "jdbc:postgresql://postgres/db"
    ports:
      - "8080:8080"
      - "9990:9990"
      - "8787:8787"

调试模式

设置环境变量DEBUG为true可启用调试模式，需暴露8787端口以连接调试工具：

bash
docker run --name="wildfly" -d \
    -p 8080:8080 -p 8787:8787 -p 9990:9990 \
    -e WILDFLY_PASS="admin_password" \
    -e DEBUG=true \
    docker.xuanyuan.run/imixs/wildfly

堆大小配置

Wildfly默认内存设置较低，生产环境可通过JAVA_OPTS调整。例如，将堆大小从512MB增加到1GB：

bash
docker run --name="wildfly" -d \
    -p 8080:8080 -p 9990:9990 \
    -e WILDFLY_PASS="admin_password" \
    -e JAVA_OPTS="-Xms64m -Xmx1g -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stack=true -Djboss.modules.system.pkgs=$JBOSS_MODULES_SYSTEM_PKGS -Djava.awt.headless=true" \
    docker.xuanyuan.run/imixs/wildfly

贡献

源码托管于https://github.com/imixs-docker/imixs-wildfly，如有问题请https://github.com/imixs-docker/wildfly/issues。

构建镜像

从Dockerfile构建镜像：

bash
docker build --tag=imixs/wildfly .

测试镜像

以交互模式运行容器：

bash
docker run --rm --name="wildfly" -it \
    -p 8080:8080 -p 9990:9990 \
    -e WILDFLY_PASS="admin_password" \
    docker.xuanyuan.run/imixs/wildfly

手动推送至Docker Hub

bash
docker build -t imixs/wildfly:X.X.X .
docker push imixs/wildfly:X.X.X