cerberustesting/cerberus-as-tomcat

Cerberus-Tomcat Docker镜像文档

镜像概述

该Docker镜像旨在提供一个预配置的环境，用于在Tomcat应用服务器中快速部署和运行Cerberus实例。通过容器化部署，简化了Cerberus服务的安装、配置流程，确保服务在隔离、一致的环境中稳定运行，适用于开发、测试及生产环境的Cerberus服务部署需求。

核心功能与特性

• 集成化部署：整合Tomcat运行环境与Cerberus服务，无需手动配置应用服务器与服务依赖
• 轻量级架构：基于官方Tomcat基础镜像构建，优化镜像体积，减少资源占用
• 灵活配置支持：支持通过环境变量、配置文件挂载等方式自定义Cerberus服务参数
• 标准化部署流程：提供统一的启动入口，确保跨环境部署一致性
• 端口可定制：支持自定义Tomcat监听端口，适应不同网络环境的端口规划

使用场景

• 企业级安全服务部署：需快速搭建Cerberus身份验证、授权服务的企业环境
• 开发测试环境：开发者本地或CI/CD流程中部署Cerberus服务进行功能验证
• 微服务架构集成：作为微服务架构中的独立认证组件，通过容器化方式与其他服务协同工作
• 临时环境搭建：需要短期部署Cerberus服务进行演示或评估的场景

使用方法与配置说明

基本部署命令

通过以下命令可快速启动一个基础Cerberus-Tomcat实例，默认映射Tomcat 8080端口至主机：

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

自定义配置

环境变量参数

支持通过环境变量调整服务运行参数，常用配置项如下：

示例：自定义端口与上下文路径

bash
docker run -d \
  --name cerberus-custom \
  -p 9090:9090 \
  -e TOMCAT_HTTP_PORT=9090 \
  -e CERBERUS_CONTEXT=/auth \
  -e LOG_LEVEL=DEBUG \
  [镜像名称]:[标签]

配置文件挂载

如需使用自定义Cerberus配置文件（如数据库连接、认证策略等），可通过-v参数挂载本地配置目录至容器内/opt/cerberus/conf路径：

bash
docker run -d \
  --name cerberus-with-config \
  -p 8080:8080 \
  -v /host/path/to/cerberus/conf:/opt/cerberus/conf \
  [镜像名称]:[标签]

注意：挂载的配置文件需符合Cerberus服务的配置规范，文件权限需确保容器内进程可读取（建议设置权限为644）。

服务验证

容器启动后，可通过以下方式验证服务状态：

1. 检查容器运行状态：

   bash
   docker ps --filter "name=cerberus-tomcat"
   

2. 访问服务端点：
   浏览器或curl访问 http://<主机IP>:<映射端口>/<CERBERUS_CONTEXT>（如默认配置下为http://localhost:8080/cerberus），返回Cerberus服务首页或登录界面即表示部署成功。
3. 查看服务日志：

   bash
   docker logs -f cerberus-tomcat
   

数据持久化

生产环境中建议挂载持久化卷保存Cerberus服务数据（如日志、临时文件），示例：

bash
docker run -d \
  --name cerberus-production \
  -p 8080:8080 \
  -v cerberus-data:/opt/cerberus/data \
  -v cerberus-logs:/usr/local/tomcat/logs \
  [镜像名称]:[标签]

其中cerberus-data和cerberus-logs为Docker命名卷，需提前创建：docker volume create cerberus-data

进阶部署（Docker Compose）

通过docker-compose.yml实现多环境变量、依赖服务（如数据库）的协同部署：

yaml
version: '3.8'
services:
  cerberus:
    image: [镜像名称]:[标签]
    container_name: cerberus-tomcat
    ports:
      - "8080:8080"
    environment:
      - TOMCAT_HTTP_PORT=8080
      - CERBERUS_CONTEXT=/auth
      - LOG_LEVEL=INFO
      - DB_HOST=mysql
      - DB_PORT=3306
    volumes:
      - ./cerberus-conf:/opt/cerberus/conf
      - cerberus-logs:/usr/local/tomcat/logs
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: mysql:8.0
    container_name: cerberus-mysql
    environment:
      - MYSQL_ROOT_PASSWORD=secret
      - MYSQL_DATABASE=cerberus
    volumes:
      - mysql-data:/var/lib/mysql
    restart: unless-stopped

volumes:
  cerberus-logs:
  mysql-data:

启动命令：docker-compose up -d

注意事项

• 生产环境中需限制容器资源（如--memory、--cpus参数），避免资源过度占用
• 自定义端口时需确保主机端口未被占用，且容器内端口与TOMCAT_HTTP_PORT环境变量一致
• 敏感配置（如数据库密码）建议通过Docker Secrets或环境变量文件（--env-file）传入，避免明文暴露
• 定期更新基础镜像与Cerberus版本，修复安全漏洞