myquartz/tomcat-xslt

tomcat-libxslt容器镜像文档

镜像概述

该镜像包含用于构建带有LibXSLT的Apache Tomcat的脚本，LibXSLT用于XML配置文件（如server.xml和context.xml）的处理。支持多种Tomcat版本与JDK组合，以及AMD64和ARM64/v8平台。

支持的Tomcat版本

1. Tomcat 8.5（搭配JDK 8、11）
2. Tomcat 9（搭配JDK 11、17）
3. Tomcat 10.0、10.1（搭配JDK 11、17，可选编译CDI和CXF模块）

核心功能与特性

1. 基于上下文的部署：启动脚本会为application.war创建"conf/Catalina/localhost/application.xml"上下文部署文件
2. 全局资源配置：启动脚本会更新conf/server.xml中的<GlobalNamingResources />以添加资源
3. HTTP/HTTPS端口自定义
4. 数据源配置（上下文级或全局级）
5. 基于数据源和LDAP的领域认证
6. Tomcat集群支持

使用场景

适用于需要自定义Tomcat配置（如端口、数据源、认证领域）的Web应用部署，尤其适合需要动态调整XML配置文件的场景。

配置说明

上下文部署

需定义环境变量DEPLOY_CONTEXT指定应用war包名称，若未定义则默认使用ROOT.war。

HTTP/HTTPS/AJP端口配置

通过以下环境变量修改Tomcat监听端口：

• TOMCAT_HTTP_PORT：HTTP端口，默认8080，对应server.xml中的<Connector />元素
• TOMCAT_HTTPS_PORT：HTTPS端口，默认空，对应server.xml中的SSL <Connector />元素（暂不包含密钥库）
• TOMCAT_AJP_PORT：AJP端口，默认8009，对应server.xml中的<Connector />元素
• CONNECTOR_MAX_THREADS：连接器的最大线程数

数据源配置

根据环境变量在context.xml（上下文级）或server.xml（全局级）中添加数据源。

环境变量说明

生成的XML配置示例

xml
<Resource
  auth="Container" 
  type="javax.sql.DataSource" 
  factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" 
  minIdle="0"
  name="${DB_SOURCENAME}或${GLOBAL_DB_SOURCENAME}" driverClassName="${DB_CLASS}"
  url="${DB_URL}" username="${DB_USERNAME}" password="${DB_PASSWORD}"
  maxActive="${DB_POOL_MAX}" initialSize="${DB_POOL_INIT}" maxIdle="${DB_IDLE_MAX}"
  validationQuery="${DB_VALIDATION_QUERY}" />

数据源领域认证

基于数据源中的用户表实现Servlet/应用认证，根据上下文级或全局级数据源自动配置对应领域。

环境变量说明

生成的XML配置示例

xml
<Realm className="org.apache.catalina.realm.DataSourceRealm"
  dataSourceName="${DB_SOURCENAME}或${GLOBAL_DB_SOURCENAME}"
  userTable="${REALM_USERTAB}" userNameCol="${REALM_USERCOL}" userCredCol="${REALM_CREDCOL}"
  userRoleTable="${REALM_ROLETAB}" roleNameCol="${REALM_ROLECOL}"
  allRolesMode="${ALL_ROLES_MODE}">
  <!-- 若定义REALM_ALGORITHM和REALM_INTERATIONS则包含以下内容 -->
  <CredentialHandler className="org.apache.catalina.realm.MessageDigestCredentialHandler"
    algorithm="${REALM_ALGORITHM}" interations="${REALM_INTERATIONS}"
    saltLength="${REALM_SALT_LENGTH}" encoding="${REALM_ENCODING}"
  />
</Realm>

应用部署示例

Dockerfile示例（部署booking.war）

dockerfile
FROM myquartz/tomcat-xslt:9-jdk11

# 从Maven下载JDBC驱动
RUN curl -sSo /usr/local/tomcat/lib/mysql-connector-java-8.0.30.jar https://repo1.maven.org/maven2/mysql/mysql-connector-java/8.0.30/mysql-connector-java-8.0.30.jar
# RUN curl -sSo /usr/local/tomcat/lib/postgresql-42.5.4.jar https://repo1.maven.org/maven2/org/postgresql/postgresql/42.5.4/postgresql-42.5.4.jar

ENV TOMCAT_HTTP_PORT=8088
EXPOSE 8088
 
ENV DEPLOY_CONTEXT=booking
ENV DB_SOURCENAME=jdbc/ds
ENV DB_CLASS=com.mysql.cj.jdbc.Driver
ENV DB_URL=jdbc:mysql://mysqldb:3306/dbname
ENV DB_USERNAME=db_username
ENV DB_PASSWORD=

COPY target/booking.war /usr/local/tomcat/webapps/booking.war

构建与运行命令

shell
mvn package
docker build -t booking-app .
docker run -d -p 8088:8088 -e DB_URL=jdbc:mysql://your-db-server-ip:3306/dbname -e DB_USERNAME=you -e DB_PASSWORD=your-password booking-app

访问演示地址：http://localhost:8088/booking

更多信息请访问GitHub页面：https://github.com/myquartz/tomcat-libxslt/tree/main