rkrahl/glassfish

GlassFish JavaEE 7 应用服务器 Docker 镜像文档

镜像概述与主要用途

本镜像基于GlassFish应用服务器构建，是JavaEE 7规范的官方参考实现。该镜像旨在简化JavaEE 7应用程序的部署流程，提供开箱即用的标准化运行环境，适用于开发、测试及小型生产环境，帮助开发者快速搭建符合JavaEE 7规范的应用服务。

核心功能与特性

• 完整JavaEE 7支持：兼容JavaEE 7规范，支持EJB、JPA、Servlet、JSP、CDI、JMS等核心技术组件。
• 轻量级部署：内置自动部署机制（autodeploy目录），支持WAR/JAR包的热部署。
• 管理界面：集成GlassFish Admin Console管理控制台，通过Web界面配置服务器参数。
• 容器化优势：基于Docker容器化技术，实现环境隔离、资源控制及跨平台可移植性。
• 灵活配置：支持通过环境变量、命令行参数或配置文件自定义服务器行为。
• 日志集成：标准输出日志与Docker日志系统兼容，便于日志收集与分析。

使用场景与适用范围

• 开发环境：快速搭建本地JavaEE 7开发测试环境，验证应用兼容性。
• 小型生产环境：部署轻量级JavaEE 7应用（如企业内部系统、中小流量Web应用）。
• CI/CD流程：集成到持续集成/持续部署 pipeline，自动化测试与部署JavaEE应用。
• 教学与演示：作为JavaEE 7技术教学或技术演示的标准化环境。

使用方法与配置说明

基本运行命令

通过以下命令启动GlassFish容器，默认映射HTTP端口（8080）和管理端口（4848）：

docker
docker run -d -p 8080:8080 -p 4848:4848 --name glassfish-javaee7 [镜像名称]

• -p 8080:8080：映射HTTP应用端口，用于访问部署的Web应用。
• -p 4848:4848：映射管理控制台端口，用于通过Admin Console管理服务器。
• --name：指定容器名称，便于后续操作（如停止、重启）。

部署应用程序

方法1：自动部署（推荐）

将WAR包挂载到容器的autodeploy目录，实现自动部署：

docker
docker run -d -p 8080:8080 \
  -v /本地路径/your-app.war:/glassfish4/glassfish/domains/domain1/autodeploy/your-app.war \
  --name glassfish-app [镜像名称]

方法2：通过管理控制台部署

1. 访问管理控制台：http://localhost:4848
2. 使用默认管理员账户登录（初始无密码，首次登录需设置密码）。
3. 进入“Applications”菜单，上传并部署WAR/JAR包。

Docker Compose配置示例

创建docker-compose.yml文件，定义服务配置：

yaml
version: '3'
services:
  glassfish:
    image: [镜像名称]
    ports:
      - "8080:8080"   # HTTP应用端口
      - "4848:4848"   # 管理控制台端口
    volumes:
      - ./your-app.war:/glassfish4/glassfish/domains/domain1/autodeploy/your-app.war  # 挂载应用
      - ./logs:/glassfish4/glassfish/domains/domain1/logs  # 挂载日志目录（可选）
    environment:
      - ADMIN_PASSWORD=your_admin_password  # 设置管理员密码
      - JVM_OPTS="-Xmx512m -Xms256m"  # 自定义JVM参数（可选）
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

核心配置参数

环境变量

示例：自定义JVM参数与管理员密码

docker
docker run -d \
  -p 8080:8080 -p 4848:4848 \
  -e ADMIN_PASSWORD=mysecret \
  -e JVM_OPTS="-Xmx1g -XX:+UseG1GC" \
  --name glassfish-custom [镜像名称]

管理控制台访问

1. 启动容器后，通过浏览器访问：http://localhost:4848
2. 使用账户admin及ADMIN_PASSWORD环境变量设置的密码登录。
3. 通过控制台可配置数据源、安全策略、部署应用等高级功能。

日志查看

通过Docker日志命令查看服务器运行日志：

docker
docker logs -f glassfish-javaee7  # -f 实时跟踪日志输出

若挂载了日志目录（如./logs），可直接查看本地文件系统日志。