scalified/jboss-eap

JBOSS EAP Docker镜像文档

镜像概述和主要用途

JBOSS EAP（Enterprise Application Platform）Docker镜像是基于Red Hat JBOSS EAP构建的容器化解决方案，为企业级Java应用提供稳定、高效的运行环境。该镜像封装了JBOSS EAP核心组件，支持JEE（Java Enterprise Edition）规范，可快速部署、扩展和管理Java应用，适用于开发、测试及生产环境的标准化部署。

核心功能和特性

• JEE规范支持：全面兼容Servlet、EJB、JPA、CDI等JEE标准，满足企业级应用开发需求。
• 部署模式灵活：支持独立模式（Standalone Mode）和域模式（Domain Mode），适应不同规模应用场景。
• 高可用性：可配置集群实现服务高可用，保障应用持续稳定运行。
• 安全机制：内置用户认证、授权、SSL/TLS加密等安全功能，保护应用数据安全。
• 容器化优势：环境一致性强，避免"在我机器上能运行"问题；资源占用可控，易于集成CI/CD流程。
• 性能优化：针对企业应用场景优化JVM参数和服务器配置，提升运行效率。

使用场景和适用范围

• 企业级Java应用部署：运行ERP、CRM、OA等基于JEE开发的业务系统。
• 微服务架构节点：作为微服务架构中的应用服务器节点，承载特定业务模块。
• 开发/测试环境：快速搭建标准化开发测试环境，缩短部署周期。
• 标准化运维：统一开发、测试、生产环境部署流程，降低运维复杂度。

使用方法和配置说明

1. 拉取镜像

从Docker仓库拉取镜像（具体镜像名称以GitHub仓库为准）：

bash
docker pull scalified/jboss-eap:latest

2. 基本运行命令

以独立模式启动容器，映射应用端口（8080）和管理端口（9990）：

bash
docker run -d -p 8080:8080 -p 9990:9990 --name jboss-eap scalified/jboss-eap:latest

3. 环境变量配置

通过环境变量自定义配置，常用参数如下：

示例：指定管理用户密码并调整JVM参数：

bash
docker run -d \
  -p 8080:8080 -p 9990:9990 \
  -e JBOSS_USER=admin \
  -e JBOSS_PASSWORD=SecurePass123 \
  -e JAVA_OPTS="-Xms1g -Xmx2g -XX:+UseG1GC" \
  --name jboss-eap scalified/jboss-eap:latest

4. 应用部署

通过挂载卷部署本地应用（如WAR包）：

bash
docker run -d \
  -p 8080:8080 \
  -v /local/deployments:/opt/jboss/eap/standalone/deployments \
  --name jboss-eap scalified/jboss-eap:latest

5. Docker Compose配置示例

创建docker-compose.yml实现多环境配置管理：

yaml
version: '3'
services:
  jboss-eap:
    image: scalified/jboss-eap:7.4.0  # 建议使用具体版本标签
    ports:
      - "8080:8080"   # 应用访问端口
      - "9990:9990"   # 管理控制台端口
    environment:
      - JBOSS_USER=admin
      - JBOSS_PASSWORD=ProdPass@2024
      - JAVA_OPTS="-Xms2g -Xmx4g -XX:+HeapDumpOnOutOfMemoryError"
    volumes:
      - ./deployments:/opt/jboss/eap/standalone/deployments  # 应用部署目录
      - ./config:/opt/jboss/eap/standalone/configuration      # 自定义配置文件
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

6. 管理控制台访问

容器启动后，通过http://<主机IP>:9990访问管理控制台，使用配置的JBOSS_USER和JBOSS_PASSWORD登录。

注意事项

• 生产环境建议使用具体版本标签（如7.4.0）而非latest，确保版本稳定性。
• 自定义配置文件时需遵循JBOSS EAP配置格式（如standalone.xml），避免冲突。
• 高并发场景下，建议调整JAVA_OPTS中的JVM参数（如堆内存、GC策略）优化性能。