TeamCity Server Docker镜像文档

镜像概述和主要用途

!official JetBrains project

本镜像为JetBrains***提供的TeamCity Server容器化部署方案，适用于生产环境部署和功能评估场景。TeamCity是一款功能强大的持续集成/持续交付（CI/CD）工具，支持自动化构建、测试和部署流程。

核心功能和特性

• 支持：由JetBrains维护，确保与TeamCity Server功能同步更新
• 完整CI/CD能力：开箱即用地提供持续集成、持续交付功能，支持复杂构建流程
• 数据持久化：通过目录挂载实现配置和构建结果的持久化存储，避免容器重启导致数据丢失
• 灵活配置选项：支持HTTPS反向代理、自定义Tomcat服务器配置、环境变量参数调优
• 跨平台兼容：提供Linux和Windows容器版本，适配不同部署环境
• 安全设计：默认以非root用户（UID 1000）运行，降低权限风险，同时支持root用户模式（需评估安全风险）

使用场景和适用范围

• 开发团队CI/CD流程：自动化代码构建、测试和部署，提升开发效率
• 生产环境部署：作为企业级CI/CD平台，稳定运行构建任务和交付流程
• 功能评估：快速搭建TeamCity环境，测试其对项目流程的适配性
• 多环境一致性：通过容器化确保开发、测试、生产环境的配置一致性

详细使用方法和配置说明

镜像拉取

首先从Docker Hub拉取镜像：

bash
docker pull jetbrains/teamcity-server

Linux容器部署

基本启动命令

使用以下命令启动TeamCity Server容器，需确保数据和日志目录持久化：

bash
docker run --name teamcity-server-instance  \
    -v <主机数据目录路径>:/data/teamcity_server/datadir \
    -v <主机日志目录路径>:/opt/teamcity/logs  \
    -p <主机端口>:8111 \
    jetbrains/teamcity-server

参数说明：

• <主机数据目录路径>：映射TeamCity数据目录（存储项目配置、构建结果等），首次启动需为空目录。必须挂载，否则容器关闭后数据丢失。
• <主机日志目录路径>：映射日志目录，用于问题排查。建议挂载，否则日志随容器销毁丢失。
• <主机端口>：主机映射端口，容器内默认端口为8111。

用户权限配置

默认情况下，容器以UID 1000用户运行。如需root权限（不推荐），可通过--user 0参数指定：

bash
docker run --name teamcity-server-instance  \
    --user 0 \
    -v <主机数据目录路径>:/data/teamcity_server/datadir \
    -v <主机日志目录路径>:/opt/teamcity/logs  \
    -p <主机端口>:8111 \
    jetbrains/teamcity-server

安全提示：以root用户运行容器可能带来权限提升等安全风险，生产环境需进行充分安全评估。

HTTPS反向代理配置

当TeamCity部署在Nginx或Apache等反向代理后，需启用安全Cookie配置，通过环境变量实现：

bash
docker run --name teamcity-server-instance  \
    -e TEAMCITY_HTTPS_PROXY_ENABLED=true \
    -v <主机数据目录路径>:/data/teamcity_server/datadir \
    -v <主机日志目录路径>:/opt/teamcity/logs  \
    -p <主机端口>:8111 \
    jetbrains/teamcity-server

该参数会使TeamCity使用server-https-proxy.xml配置文件，启用HTTPS相关选项。

HTTPS访问配置

TeamCity Server默认通过443端口提供HTTPS服务，但非root用户（如UID 1000）无法使用1024以下特权端口。解决方法如下：

方法1：端口映射（推荐）

将容器内非特权端口8443映射到主机443端口：

bash
docker run --name teamcity-server-instance  \
    -v <主机数据目录路径>:/data/teamcity_server/datadir \
    -v <主机日志目录路径>:/opt/teamcity/logs  \
    -p 443:8443 \  # 主机443端口映射到容器8443端口
    jetbrains/teamcity-server

方法2：root用户运行（不推荐）

以root用户启动容器，直接使用443端口：

bash
docker run --name teamcity-server-instance  \
    --user 0 \
    -v <主机数据目录路径>:/data/teamcity_server/datadir \
    -v <主机日志目录路径>:/opt/teamcity/logs  \
    -p 443:443 \
    jetbrains/teamcity-server

自定义Tomcat配置

TeamCity基于Tomcat服务器运行，可通过挂载自定义配置目录覆盖默认配置：

bash
docker run --name teamcity-server-instance  \
    -v /自定义/tomcat/conf目录:/opt/teamcity/conf \  # 挂载自定义Tomcat配置
    -v <主机数据目录路径>:/data/teamcity_server/datadir \
    -v <主机日志目录路径>:/opt/teamcity/logs  \
    -p <主机端口>:8111 \
    jetbrains/teamcity-server

如需获取默认Tomcat配置样本，可通过docker cp命令从运行中的容器复制：
docker cp teamcity-server-instance:/opt/teamcity/conf /本地目录

Windows容器部署

Windows容器需指定数据目录、日志目录和临时目录的挂载路径：

powershell
docker run --name teamcity-server-instance `
    -v <主机数据目录路径>:C:/ProgramData/JetBrains/TeamCity `
    -v <主机日志目录路径>:C:/TeamCity/logs `
    -v <主机临时目录路径>:C:/TeamCity/temp `
    -p <主机端口>:8111 `
    jetbrains/teamcity-server

推荐配置：为容器分配足够资源（内存、CPU）并调整JVM参数：

powershell
docker run --memory="6g" --cpus=4 `
    -e TEAMCITY_SERVER_MEM_OPTS="-Xmx3g -XX:MaxPermSize=270m -XX:ReservedCodeCacheSize=640m" `
    --name teamcity-server-instance `
    -v <主机数据目录路径>:C:/ProgramData/JetBrains/TeamCity `
    -v <主机日志目录路径>:C:/TeamCity/logs `
    -v <主机临时目录路径>:C:/TeamCity/temp `
    -p <主机端口>:8111 `
    jetbrains/teamcity-server

注意：Windows容器已知问题可参考TeamCity***文档。

数据库配置

• 默认配置：TeamCity使用数据目录下的内部文件数据库，适用于评估场景。
• 生产环境：需配置外部数据库（如PostgreSQL、MySQL等），并参考生产环境配置建议。

构建代理集成

TeamCity Server需配合构建代理执行构建任务，推荐使用***代理镜像：

• jetbrains/teamcity-agent：完整代理（包含常用构建工具）
• jetbrains/teamcity-minimal-agent：最小化代理（需手动安装依赖）

如需一键启动Server和Agent，可参考***Docker Compose示例。

配置参数与环境变量

额外操作命令

传递自定义环境变量

通过-e参数传递环境变量，例如调整JVM内存：

bash
docker run --name teamcity-server-instance  \
    -e TEAMCITY_SERVER_MEM_OPTS="-Xmx2g -XX:MaxPermSize=270m -XX:ReservedCodeCacheSize=640m" \
    -v <主机数据目录路径>:/data/teamcity_server/datadir  \
    -v <主机日志目录路径>:/opt/teamcity/logs   \
    -p <主机端口>:8111 \
    jetbrains/teamcity-server

执行数据库维护脚本（如备份）

停止当前容器后，通过以下命令运行maintainDB脚本：

bash
docker run -it --name teamcity-server-instance  \
    -v <主机数据目录路径>:/data/teamcity_server/datadir  \
    -v <主机日志目录路径>:/opt/teamcity/logs  \
    jetbrains/teamcity-server \
    "/opt/teamcity/bin/maintainDB.sh" "backup"

注意：需保持数据目录和日志目录挂载路径与主服务启动命令一致。

升级指南

1. 停止运行中的容器：docker stop teamcity-server-instance
2. 拉取新版本镜像：docker pull jetbrains/teamcity-server
3. 使用原数据目录和配置参数重新启动容器（数据目录挂载确保配置和数据保留）

详细升级步骤请参考***升级指南。

许可证信息

本镜像遵循TeamCity许可证。免费版限制：最多100个构建配置和3个构建代理。商业使用需购买相应许可证。

反馈与支持

• 问题报告：TeamCity***Issue Tracker
• 文档参考：TeamCity***文档

相关镜像

• TeamCity Minimal Agent
• TeamCity Agent