isimplelab/tomcat

isimplelab/tomcat:8.5-alpine Docker镜像文档

镜像概述

本镜像基于官方Tomcat 8.5-alpine镜像构建，额外集成了ttf-dejavu和fontconfig字体库，提供基础的Web应用部署环境，特别适用于需要字体支持的Java Web应用场景。CLUSTER标签版本具备自动节点配置能力，简化集群部署流程。

核心功能与特性

• 基础环境：基于Tomcat 8.5-alpine，提供轻量级Java Web运行环境
• 字体支持：集成ttf-dejavu和fontconfig库，解决Java应用中字体缺失问题（如报表生成、PDF导出等场景）
• 灵活部署：支持通过挂载目录方式部署WAR文件
• 集群优化：CLUSTER标签版本自动生成节点名，并将其配置到server.xml和JAVA_OPTS中，便于集群环境使用

使用场景

• 开发/测试环境快速部署Java Web应用
• 需要字体支持的Web应用（如生成含中文字体的报表、PDF文件等）
• 构建简单的Tomcat集群环境（使用CLUSTER标签版本）

使用方法

基本部署

通过挂载本地WAR文件目录到容器的/usr/local/tomcat/webapps目录，实现Web应用部署：

bash
docker run -p 8080:8080 -it -v /home/user/path-to-war-dir/:/usr/local/tomcat/webapps isimplelab/tomcat:8.5-alpine

参数说明：

• -p 8080:8080：将容器的8080端口映射到主机的8080端口
• -v /home/user/path-to-war-dir/:/usr/local/tomcat/webapps：挂载本地WAR文件所在目录到容器的Tomcat webapps目录
• /home/user/path-to-war-dir/：需替换为本地存放WAR文件的实际路径

集群版本使用

对于带有CLUSTER标签的版本（如isimplelab/tomcat:8.5-alpine-CLUSTER），镜像会自动完成以下配置：

1. 生成唯一节点名
2. 将节点名配置到Tomcat的server.xml中
3. 将节点名通过JAVA_OPTS环境变量传递给JVM

启动命令与基础版本类似：

bash
docker run -p 8080:8080 -it -v /home/user/path-to-war-dir/:/usr/local/tomcat/webapps isimplelab/tomcat:8.5-alpine-CLUSTER

注意事项

• 确保本地WAR文件目录路径正确，且容器有足够权限访问挂载目录
• CLUSTER版本的节点名生成逻辑依赖容器内部环境，适用于简单集群场景，复杂集群可能需要额外配置
• 如需自定义Tomcat配置，可通过挂载server.xml等配置文件实现