webgames/tomcat

docker-tomcat 镜像文档

镜像概述

docker-tomcat是一个基于Apache Tomcat官方镜像构建的自定义配置版本，旨在提供灵活的配置选项，简化Java Web应用的部署与运行过程。该镜像保留了Tomcat的核心功能，同时允许用户根据实际需求自定义服务器配置，适用于开发、测试及生产环境。

核心功能和特性

• 自定义配置支持：允许通过挂载配置文件（如server.xml、web.xml等）或环境变量调整Tomcat服务器参数。
• 轻量级设计：基于官方Tomcat镜像优化，保持较小体积的同时确保功能完整。
• 兼容性：支持主流Tomcat版本（具体版本需参考镜像标签），兼容标准Java Web应用（WAR包）。
• 易于集成：可直接与CI/CD流程结合，支持自动化部署。

使用场景和适用范围

• Java Web应用开发：本地开发环境快速搭建，支持配置实时调整。
• 测试环境部署：模拟生产环境配置，验证应用在不同Tomcat设置下的运行情况。
• 生产环境运行：通过自定义配置优化性能、安全性等关键参数，满足生产需求。
• 教学与演示：作为Tomcat学习工具，展示服务器配置对应用运行的影响。

使用方法和配置说明

基本使用

通过docker run命令启动容器：

bash
docker run -d -p 8080:8080 --name my-tomcat [镜像名称]:[标签]

自定义配置

1. 挂载配置文件

将本地自定义的Tomcat配置文件挂载到容器中：

bash
docker run -d -p 8080:8080 \
  -v /本地路径/server.xml:/usr/local/tomcat/conf/server.xml \
  -v /本地路径/web.xml:/usr/local/tomcat/conf/web.xml \
  --name my-tomcat [镜像名称]:[标签]

2. 环境变量配置

通过环境变量调整基本参数（具体支持的变量需参考镜像文档）：

bash
docker run -d -p 8080:8080 \
  -e TOMCAT_PORT=8080 \
  -e CATALINA_OPTS="-Xms512m -Xmx1024m" \
  --name my-tomcat [镜像名称]:[标签]

Docker Compose 示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  tomcat:
    image: [镜像名称]:[标签]
    ports:
      - "8080:8080"
    volumes:
      - ./conf/server.xml:/usr/local/tomcat/conf/server.xml
      - ./webapps:/usr/local/tomcat/webapps
    environment:
      - TOMCAT_PORT=8080
      - CATALINA_OPTS="-Xms512m -Xmx1024m"
    restart: always

启动服务：

bash
docker-compose up -d

注意事项

• 挂载配置文件时需确保文件权限正确，避免容器内权限不足导致启动失败。
• 不同版本的Tomcat配置文件结构可能存在差异，需根据实际使用的镜像标签调整配置。
• 生产环境中建议结合数据卷（Volume）持久化应用数据及日志。