TomEE Docker 镜像文档

镜像概述与主要用途

TomEE（发音"Tommy"）是基于 Apache Tomcat 的全 Apache Java EE Web Profile 认证应用服务器。它通过在 vanilla Apache Tomcat 基础上集成 Java EE 特性组件，提供了轻量级且符合企业级标准的运行环境，适用于部署遵循 Java EE 规范的 Web 应用程序。

注意：本文档对应 arm32v7 架构的 TomEE 镜像仓库，但该架构不支持 TomEE 镜像。实际部署请使用支持的架构（amd64/arm64v8）。

核心功能与特性

TomEE 提供四种功能版本（Flavor），满足不同场景需求：

• Web Profile
  基础版本，包含 Servlets、JSP、JSF、JTA、JPA、CDI、Bean Validation 和 EJB Lite。

• JAX-RS
  在 Web Profile 基础上增加 JAX-RS（RESTful 服务）支持。

• Plus
  在 JAX-RS 基础上增加 EJB Full、Java EE Connector Architecture（JCA）、JMS（Java 消息服务）和 JAX-WS（Web 服务）。

• Plume
  在 Plus 基础上增加 Mojarra（JSF 实现）和 EclipseLink（JPA 实现）支持。

支持的架构与标签

支持的架构

• amd64（详情：amd64/tomee）
• arm64v8（详情：arm64v8/tomee）

警告：arm32v7 架构不支持 TomEE 镜像。

标签格式

镜像标签遵循 <java-version>-<tomee-version>-<flavor> 格式，例如：

• 8-jre-1.7.2-webprofile（Java 8 JRE + TomEE 1.7.2 + Web Profile）
• 11-jre-8.0.0-plus（Java 11 JRE + TomEE 8.0.0 + Plus）

具体标签及对应 Dockerfile 可在 官方仓库 查看。

使用方法

基本运行

通过 docker run 命令启动 TomEE 服务器（默认执行 catalina.sh run）：

# 语法：docker run -it --rm <架构>/tomee:<标签>
docker run -it --rm amd64/tomee:8-jre-1.7.2-webprofile

端口映射

如需从宿主机访问，映射容器的 8080 端口（TomEE 默认端口）到宿主机端口（如 8888）：

docker run -it --rm -p 8888:8080 amd64/tomee:8-jre-1.7.2-webprofile

访问方式：http://localhost:8888 或 http://<宿主机IP>:8888。

部署应用

可将此镜像作为基础镜像，通过 Dockerfile 部署自定义 WAR 包：

# 基于 TomEE 镜像构建
FROM amd64/tomee:8-jre-1.7.2-webprofile

# 复制 WAR 包到 TomEE 的 webapps 目录
COPY ./your-app.war /usr/local/tomee/webapps/

构建并运行：

docker build -t my-tomee-app .
docker run -it --rm -p 8080:8080 my-tomee-app

配置说明

配置文件路径

TomEE 配置文件位于容器内 /usr/local/tomee/conf/ 目录，包括：

• server.xml（服务器核心配置）
• tomcat-users.xml（用户权限配置）
• web.xml（Web 应用默认配置）

用户权限配置

默认情况下，tomcat-users.xml 未配置 manager-gui 角色用户，无法访问 /manager/html 管理界面。需手动添加用户：

1. 进入容器修改配置：

   docker exec -it <容器ID> vi /usr/local/tomee/conf/tomcat-users.xml
   

2. 添加用户配置（示例）：

   <tomcat-users>
     <role rolename="manager-gui"/>
     <user username="admin" password="secret" roles="manager-gui"/>
   </tomcat-users>
   

3. 重启容器使配置生效。

商业支持

Tomitribe

提供 Apache TomEE 商业支持、专业服务和培训，团队成员均为 TomEE 提交者，参与项目方向和开发。

• 详情：Tomitribe 企业支持

ManageCat

提供 Apache Tomcat/TomEE 企业级支持，专注于 Java EE 技术（JPA、EJB、CDI 等）的应用开发与部署。

• 详情：ManageCat 企业支持

许可证

• 软件许可证：Apache License 2.0
• 镜像可能包含其他软件（如基础系统组件、Bash 等），其许可证需用户自行合规检查。

参考与资源

• 维护者：Docker 社区
• 获取帮助：Docker Community Slack、Server Fault、Stack Overflow
• 提交 Issue：GitHub Issues
• 镜像详情：repo-info 仓库（元数据、传输大小等）
• 镜像更新：official-images 仓库
• 文档来源：docker-library/docs