mcneilco/tomcat-maven

tomcat-maven 镜像文档

镜像概述

tomcat-maven 是一个基于 Maven 构建的 Tomcat 运行环境镜像，底层使用 OpenJDK 8。该镜像提供灵活的启动配置和服务依赖管理能力，支持与数据库等外部服务集成，主要用于部署需要 Tomcat 运行环境的 Web 应用。

核心功能与特性

• 基础环境：集成 OpenJDK 8 和 Tomcat，提供完整的 Java Web 运行环境
• 灵活启动：支持自定义启动命令，可直接运行 Tomcat 或等待依赖服务后启动
• 依赖管理：内置 wait-for-it.sh 工具，支持等待外部服务（如数据库）就绪后再启动 Tomcat
• 环境配置：支持通过环境变量自定义 JVM 参数（如 CATALINA_OPTS、JAVA_OPTS）
• 服务集成：支持端口映射、卷挂载及多环境配置文件加载，便于与其他服务（如数据库、存储服务）集成

使用场景

适用于需要 Tomcat 运行环境且依赖外部服务（如数据库、缓存等）的 Web 应用部署，尤其适合需要协调多服务启动顺序的场景（如等待数据库初始化完成后再启动应用）。

使用方法与配置说明

基本启动命令

直接运行 Tomcat：

bash
command: catalina.sh run

等待依赖服务后启动

等待数据库（如 PostgreSQL，地址 db:5432）就绪后启动 Tomcat：

bash
command: ["./wait-for-it.sh", "db:5432", "--", "catalina.sh", "run"]

完整 docker-compose 配置示例（ACAS 应用）

yaml
tomcat:
  image: mcneilco/tomcat-maven:1.0-openjdk8
  restart: always  # 服务异常时自动重启
  depends_on:
    - db  # 依赖 db 服务
  ports:
    - "8080:8080"  # Tomcat 应用端口映射
    - "8000:8000"  # Java 调试端口映射
  environment:
    - ACAS_HOME=/home/runner/build  # 应用主目录
    - CATALINA_OPTS=-Xms512M -Xmx1024M -XX:MaxPermSize=512m  # Tomcat JVM 参数
    - JAVA_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=8000  # Java 调试参数
  volumes_from:
    - roo  # 挂载 roo 服务的卷
    - acas  # 挂载 acas 服务的卷
    - cmpdreg  # 挂载 cmpdreg 服务的卷
  env_file:
    - ./conf/docker/acas/environment/acas.env  # ACAS 应用环境变量文件
    - ./conf/docker/roo/environment/roo.env  # roo 服务环境变量文件
    - ./conf/docker/cmpdreg/environment/cmpdreg.env  # cmpdreg 服务环境变量文件
  command: ["./wait-for-it.sh", "db:5432", "--", "catalina.sh", "run"]  # 等待 db 服务后启动 Tomcat

关键配置说明