Apache TomEE Docker 镜像文档

快速参考

• 维护者：
  Docker 社区

• 获取帮助：
  Docker Community Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应 Dockerfile 链接

注意：本镜像描述长度超过 Hub 的 25000 字符限制，因此“支持的标签”列表已被精简。另请参见 docker/hub-feedback#238 和 docker/roadmap#475。

• 详见 GitHub 文档中的“支持的标签及对应 Dockerfile 链接”

快速参考（续）

• 问题反馈地址：
  [***]

• 支持的架构：(更多信息)
  amd64、arm64v8

• 已发布镜像制品详情：
  repo-info 仓库的 repos/tomee/ 目录（历史记录）
  （包含镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/tomee 标签
  official-images 仓库的 library/tomee 文件（历史记录）

• 本描述的来源：
  docs 仓库的 tomee/ 目录（历史记录）

什么是 TomEE？

Apache TomEE（发音为“Tommy”）是一个全 Apache 出品的 Java EE Web Profile 认证技术栈，以 Apache Tomcat 为核心。Apache TomEE 基于原生 Apache Tomcat 压缩包构建，通过添加必要的 JAR 包并整合其他组件，为 Tomcat 增加了企业级功能，形成了 TomEE。

!logo

Apache TomEE 提供四种版本：Web Profile、JAX-RS、Plus 和 Plume。

• Apache TomEE Web Profile：提供 Servlet、JSP、JSF、JTA、JPA、CDI、Bean Validation 和 EJB 精简版。
• Apache TomEE JAX-RS（RESTful 服务）：在 Web Profile 基础上增加 JAX-RS（RESTful 服务）。
• Apache TomEE Plus：包含 Web Profile 和 JAX-RS 的所有功能，额外提供完整 EJB、Java EE 连接器架构、JMS（Java 消息服务）和 JAX-WS（Web 服务）。
• Apache TomEE Plume：包含 Plus 版本的所有功能，并增加 Mojarra 和 EclipseLink 支持。

所有支持版本的 Dockerfile 可在 [***] 查看。

Apache TomEE 与 Tomitribe

Tomitribe 为 Apache TomEE 提供商业支持、专业服务和培训。其采用创新商业模式，在推动开源项目发展的同时，满足企业级生产环境的支持需求。Tomitribe 社区合作计划将企业用户与社区连接起来。

Tomitribe 的所有开发人员均为 TomEE 提交者，对项目方向和开发有重要影响。他们致力于将这种影响力扩展到 TomEE 的用户和企业。相关新闻稿：

• Tomitribe 宣布 Apache TomEE 企业服务支持
• Tomitribe 推出 社区合作计划及 JavaOne 2014 会议参与

Apache TomEE 与 ManageCat

另一家提供 Apache TomEE 企业支持的公司是 ManageCat。ManageCat 参与多个 Apache Java EE 项目，为开源 Java EE 生态系统贡献力量。ManageCat 联合创始人同时也是开源 Apache OpenWebBeans 项目（[***] Apache TomEE 应用服务器的 CDI 集成中被广泛使用。

ManageCat 是 Apache Tomcat 和 Apache TomEE 服务器的云管理与服务平台。凭借在多个 Apache Java EE 项目的经验，ManageCat 不仅提供 Apache TomEE 相关知识，还涵盖 JPA、EJB、CDI、JSF、JSTL、JTA、JMS 等 Java EE 技术，帮助客户顺利开发和部署基于 Java EE 的生产级应用。

• ManageCat 宣布 Apache Tomcat 和 TomEE 企业服务支持

Apache TomEE 与 ManageCat

另一家提供 Apache TomEE 企业级支持的公司是 ManageCat。ManageCat 参与多个 Apache Java EE 项目，致力于推动开源 Java EE 生态系统发展。其联合创始人同时也是开源 Apache OpenWebBeans 项目（[***] Apache TomEE 应用服务器的 CDI 集成提供核心支持。

ManageCat 是 Apache Tomcat 和 Apache TomEE 服务器的云管理与服务平台。基于在多个 Apache Java EE 项目的经验，ManageCat 不仅分享 Apache TomEE 相关知识，还涵盖 JPA、EJB、CDI、JSF、JSTL、JTA、JMS 等 Java EE 技术，助力客户顺利开发和部署生产级 Java EE 应用。

• ManageCat 宣布 Apache Tomcat 和 TomEE 企业服务支持

如何使用本镜像

运行默认 TomEE 服务器

默认命令为 CMD ["catalina.sh", "run"]，运行方式：

console
$ docker run -it --rm tomee:<java-version>\-<tomeeversion>\-<flavour>

例如，运行 JRE 8、TomEE 1.7.2 Web Profile 版本：

console
$ docker run -it --rm tomee:8-jre-1.7.2-webprofile

可通过浏览器访问 [***] 测试。若需从主机外部访问，可映射端口（如 8888）：

console
$ docker run -it --rm -p 8888:8080 tomee:<java-version>\-<tomeeversion>\-<flavour>

之后可通过浏览器访问 http://localhost:8888 或 [***]。

配置文件与用户管理

配置文件位于 /usr/local/tomee/conf/。默认情况下，“manager-gui”角色（用于访问“/manager/html” Web 应用）未配置用户。如需使用该应用，需在 tomcat-users.xml 中定义相应用户。

作为基础镜像部署 WAR 应用

可将本镜像作为基础镜像部署 WAR 应用。创建 Dockerfile，基于 TomEE 镜像，并将 WAR 文件复制到 webapps 目录：

dockerfile
COPY <应用路径>/<war文件> /usr/local/tomee/webapps/<war文件>

镜像变体

tomee 镜像提供多种变体，适用于不同场景。

tomee:<version>

默认镜像。若不确定需求，建议使用此版本。既可作为临时容器（挂载源码并启动应用），也可作为构建其他镜像的基础。

tomee:<version>-alpine

基于流行的 Alpine Linux 项目（alpine ***镜像）构建。Alpine Linux 体积远小于大多数基础镜像（约 5MB），因此生成的镜像更精简。

该变体适用于对最终镜像体积有严格要求的场景。注意：其使用 musl libc 而非 glibc 及相关库，部分软件可能因 libc 依赖差异出现兼容性问题。更多讨论参见 Hacker News 评论。

为最小化体积，Alpine 基础镜像通常不包含额外工具（如 git、bash）。如需添加，可在 Dockerfile 中自行安装（参考 alpine 镜像说明 的包安装示例）。

许可证

本镜像包含软件的许可证信息参见 许可证信息。

与所有 Docker 镜像一样，本镜像可能包含基础发行版的其他软件（如 Bash 等）及直接/间接依赖，这些软件可能具有独立许可证。

自动检测到的额外许可证信息可在 repo-info 仓库的 tomee/ 目录 查看。

对于预构建镜像的使用，用户需自行确保符合所有包含软件的相关许可证要求。