sigcorp/tomcat

Parameterized Tomcat 镜像文档

镜像概述和主要用途

Parameterized Tomcat 镜像基于 https://hub.docker.com/_/tomcat 扩展，提供启动时参数化配置能力。该镜像允许用户在容器启动阶段灵活调整关键运行参数，无需重新构建镜像，适用于需要动态配置 Tomcat 运行环境的场景。

核心功能和特性

• 内存设置：支持在启动时配置 JVM 内存参数（如堆内存、非堆内存等）
• 命令行选项：可自定义 Tomcat 和 Java 运行时的命令行参数
• JNDI 数据源：支持配置 JNDI 数据源，便于应用程序访问数据库资源

使用场景和适用范围

• 开发环境：快速调整 Tomcat 配置进行功能测试
• 测试环境：根据测试需求动态修改 JVM 参数和数据源配置
• 生产环境：针对不同部署实例定制资源分配和运行参数，优化性能

使用方法和配置说明

基本使用

通过 docker run 命令启动容器，可通过环境变量或启动参数传递配置：

bash
docker run -d -p 8080:8080 sigcorp/tomcat

配置参数说明

内存设置

通过环境变量 JAVA_OPTS 配置 JVM 内存参数，例如：

bash
docker run -d -p 8080:8080 -e "JAVA_OPTS=-Xms512m -Xmx1024m" sigcorp/tomcat

Tomcat 命令行选项

通过环境变量 CATALINA_OPTS 配置 Tomcat 特定参数，例如：

bash
docker run -d -p 8080:8080 -e "CATALINA_OPTS=-Dcatalina.logs=/var/log/tomcat" sigcorp/tomcat

JNDI 数据源配置

通过挂载自定义 context.xml 文件配置 JNDI 数据源：

bash
docker run -d -p 8080:8080 -v /path/to/context.xml:/usr/local/tomcat/conf/context.xml sigcorp/tomcat

Docker Compose 示例

yaml
version: '3'
services:
  tomcat:
    image: sigcorp/tomcat
    ports:
      - "8080:8080"
    environment:
      - JAVA_OPTS=-Xms512m -Xmx1024m -XX:+UseG1GC
      - CATALINA_OPTS=-Duser.timezone=Asia/Shanghai
    volumes:
      - ./context.xml:/usr/local/tomcat/conf/context.xml
      - ./webapps:/usr/local/tomcat/webapps

官方资源

• https://hub.docker.com/r/sigcorp/tomcat