Docker Compose实战：TeamCity 2023.05.2企业级部署指南
在持续集成领域，TeamCity以其强大的构建流水线管理和与JetBrains生态的无缝集成，成为众多技术团队的首选。本文将深入探讨如何通过Docker Compose这一声明式工具，实现TeamCity 2023.05.2版本的高效部署，特别针对有无MySQL环境的两种典型场景提供完整解决方案。
1. 环境准备与架构设计
部署前的环境评估至关重要。对于资源受限的开发环境，建议至少分配4GB内存和2核CPU；生产环境则需根据团队规模适当扩容。TeamCity的标准架构包含三个核心组件：
- Server节点：处理构建调度和结果存储（默认端口8111）
- Agent节点：执行实际构建任务（默认端口9090）
- 数据库服务：支持MySQL/PostgreSQL等主流数据库
# 验证Docker环境 docker --version docker-compose --version提示：若使用Windows系统，建议启用WSL2以获得更好的性能表现。Linux环境下需确保当前用户具有docker组权限。
2. 独立MySQL容器部署方案
对于没有现成数据库服务的环境，以下配置将同时启动MySQL和TeamCity服务：
version: '3.8' services: mysql: image: mysql:8.0 command: - --default-authentication-plugin=mysql_native_password - --character-set-server=utf8mb4 - --collation-server=utf8mb4_unicode_ci environment: MYSQL_ROOT_PASSWORD: Tc@Secure123 MYSQL_DATABASE: teamcity MYSQL_USER: teamcity MYSQL_PASSWORD: TeamCity@2023 volumes: - mysql_data:/var/lib/mysql healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] interval: 5s timeout: 10s retries: 10 teamcity: image: jetbrains/teamcity-server:2023.05.2 depends_on: mysql: condition: service_healthy environment: TEAMCITY_DB_HOST: mysql TEAMCITY_DB_NAME: teamcity TEAMCITY_DB_USER: teamcity TEAMCITY_DB_PASSWORD: TeamCity@2023 volumes: - teamcity_data:/data/teamcity_server/datadir - teamcity_logs:/opt/teamcity/logs ports: - "8111:8111" agent1: image: jetbrains/teamcity-agent:2023.05.2 environment: SERVER_URL: "http://teamcity:8111" volumes: - /var/run/docker.sock:/var/run/docker.sock privileged: true volumes: mysql_data: teamcity_data: teamcity_logs:关键参数解析：
| 配置项 | 说明 | 推荐值 |
|---|---|---|
| MYSQL_ROOT_PASSWORD | 数据库root密码 | 符合复杂度要求的字符串 |
| healthcheck | 确保MySQL就绪 | 至少5秒间隔 |
| TEAMCITY_DB_* | 数据库连接参数 | 与MySQL服务对应 |
| privileged | Agent容器特权模式 | 需要Docker in Docker时启用 |
3. 外接MySQL服务配置方案
当已有企业级MySQL服务时，精简版配置如下：
version: '3.8' services: teamcity: image: jetbrains/teamcity-server:2023.05.2 environment: TEAMCITY_DB_HOST: 192.168.1.100 TEAMCITY_DB_PORT: 3306 TEAMCITY_DB_NAME: teamcity_prod TEAMCITY_DB_USER: teamcity_user TEAMCITY_DB_PASSWORD: Prod@Secure2023 volumes: - teamcity_data:/data/teamcity_server/datadir - teamcity_logs:/opt/teamcity/logs ports: - "8111:8111" agent1: image: jetbrains/teamcity-agent:2023.05.2 environment: SERVER_URL: "http://teamcity:8111" deploy: resources: limits: cpus: '2' memory: 4G volumes: teamcity_data: teamcity_logs:外接数据库注意事项：
- 提前在MySQL创建专用数据库账户
- 确保网络连通性和白名单设置
- 生产环境建议配置SSL加密连接
- 定期备份数据库和volume数据
4. 部署验证与故障排查
服务启动命令：
docker-compose up -d docker-compose logs -f teamcity常见问题处理：
JDBC驱动缺失报错
No suitable JDBC driver found for database type: MySQL解决方案：
- 访问
http://<server>:8111进入Web界面 - 下载页面提供的JDBC驱动
- 或手动上传mysql-connector-java-8.0.xx.jar
数据库连接失败检查要点：
- 确认MySQL服务可达
- 验证账号权限
- 检查防火墙规则
- 查看TeamCity日志定位具体错误
管理员密码恢复
docker exec -it jetbrains-teamcity grep "Super user authentication token" /opt/teamcity/logs/teamcity-server.log5. 生产环境优化建议
性能调优参数：
environment: TEAMCITY_SERVER_MEM_OPTS: "-Xmx4g -XX:ReservedCodeCacheSize=512m" TEAMCITY_AGENT_MEM_OPTS: "-Xmx2g"高可用架构：
- 使用云数据库服务保障数据库可用性
- 配置多个Agent实现负载均衡
- 定期备份关键数据：
# 备份数据库 docker exec mysql sh -c 'exec mysqldump --databases teamcity -uteamcity -p"$TEAMCITY_DB_PASSWORD"' > backup.sql # 备份配置 docker run --rm -v teamcity_data:/volume -v $(pwd):/backup alpine tar cvf /backup/teamcity_data.tar /volume安全加固措施：
- 替换默认自签名证书
- 配置基于角色的访问控制
- 启用构建日志加密
- 定期更新容器镜像版本
在实际项目部署中，我们发现合理配置volume挂载路径可以显著提升I/O性能。对于Windows宿主机的场景，建议将数据卷映射到WSL2子系统而非直接挂载NTFS分区。
