library/tomee

Apache TomEE Docker 镜像文档

快速参考

• 维护者：
  https://github.com/tomitribe/docker-tomee

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

支持的标签及对应 Dockerfile 链接

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

• 详见 https://github.com/docker-library/docs/tree/master/tomee/README.md#supported-tags-and-respective-dockerfile-links

快速参考（续）

• 问题反馈地址：
  https://github.com/tomitribe/docker-tomee/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/tomee/%E3%80%81https://hub.docker.com/r/arm64v8/tomee/

• 已发布镜像制品详情：
  https://github.com/docker-library/repo-info/blob/master/repos/tomee%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/tomee%EF%BC%89
  （包含镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Ftomee
  https://github.com/docker-library/official-images/blob/master/library/tomee%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/tomee%EF%BC%89

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/tomee%EF%BC%88https://github.com/docker-library/docs/commits/master/tomee%EF%BC%89

什么是 TomEE？

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

!https://raw.githubusercontent.com/docker-library/docs/4a10a52c08621b68c1b1b53b561f819d9e78c2e0/tomee/logo.png

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 可在 https://github.com/tomitribe/docker-tomee 查看。

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

可通过浏览器访问 http://container-ip:8080 测试。若需从主机外部访问，可映射端口（如 8888）：

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

之后可通过浏览器访问 http://localhost:8888 或 http://host-ip: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 项目（https://hub.docker.com/_/alpine%EF%BC%89%E6%9E%84%E5%BB%BA%E3%80%82Alpine Linux 体积远小于大多数基础镜像（约 5MB），因此生成的镜像更精简。

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

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

许可证

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

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

自动检测到的额外许可证信息可在 https://github.com/docker-library/repo-info/tree/master/repos/tomee 查看。

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