agross/teamcity

docker-teamcity

该Dockerfile用于构建部署JetBrains TeamCity实例的镜像，已在Fedora 23和CentOS 7系统上测试通过。

请务必定期备份数据目录，尤其是在升级到新版本之前。

快速测试

1. http://docs.docker.io/en/latest/installation/%E3%80%82
2. 运行容器（可通过CTRL-C停止）：

sh
docker run -it --publish 8111:8111 agross/teamcity

3. 打开浏览器访问 http://localhost:8111。

作为systemd服务运行

1. 环境变量与目录设置

确定TeamCity数据和日志的存储位置，设置域名/服务器名及公共端口：

sh
TEAMCITY_DATA="/var/data/teamcity"
TEAMCITY_LOGS="/var/log/teamcity"

DOMAIN=example.com
PORT=8011

2. 创建数据和日志目录

在容器外部创建用于存储数据和日志的目录：

sh
mkdir --parents "$TEAMCITY_DATA" \
                "$TEAMCITY_LOGS"

3. 设置权限

Dockerfile中创建了teamcity用户和组，其UID和GID均为3000。需在主机系统创建具有相同UID和GID的用户，并授予对$TEAMCITY_DATA和$TEAMCITY_LOGS的读写权限：

sh
# 在Docker主机创建teamcity组和用户
groupadd --gid 3000 \
        --system teamcity
useradd --uid 3000 \
        --gid 3000 \
        --system \
        --shell /sbin/nologin \
        --comment "JetBrains TeamCity" \
        teamcity

# 设置目录权限（3000为Dockerfile中创建的用户/组ID）
chown -R 3000:3000 "$TEAMCITY_DATA" "$TEAMCITY_LOGS"

4. 创建容器

注意： 卷挂载时的:z选项用于正确设置SELinux上下文，详情参见相关文档。

可通过--env指定JVM和TeamCity服务器选项，例如内存配置。需挂载/etc/localtime以保持与主机相同的时区。

sh
docker create -it --env TEAMCITY_SERVER_MEM_OPTS='-Xms1g -Xmx3g' \
                  --publish $PORT:8111 \
                  --volume /etc/localtime:/etc/localtime:ro \
                  --volume "$TEAMCITY_DATA:/teamcity/.BuildServer:z" \
                  --volume "$TEAMCITY_LOGS:/teamcity/logs:z" \
                  --name teamcity \
                  agross/teamcity

5. 创建systemd服务单元

创建/etc/systemd/system/teamcity.service文件：

sh
cat <<EOF > "/etc/systemd/system/teamcity.service"
[Unit]
Description=JetBrains TeamCity Server
Requires=docker.service
After=docker.service

[Service]
Restart=always
# 当执行docker stop时，docker-entrypoint.sh的trap+wait组合会生成143退出状态码（128+15，SIGTERM）
# 详情：http://veithen.github.io/2014/11/16/sigterm-propagation.html
SuccessExitStatus=143
PrivateTmp=true
ExecStart=/usr/bin/docker start --attach=true teamcity
ExecStop=/usr/bin/docker stop --time=60 teamcity

[Install]
WantedBy=multi-user.target
EOF

systemctl enable teamcity.service
systemctl start teamcity.service

6. 配置logrotate

创建/etc/logrotate.d/teamcity文件：

sh
cat <<EOF > "/etc/logrotate.d/teamcity"
$TEAMCITY_LOGS/*.log
{
  rotate 7
  daily
  dateext
  missingok
  notifempty
  sharedscripts
  copytruncate
  compress
}
EOF

7. 配置Nginx反向代理

创建/etc/nginx/conf.d/teamcity.conf文件：

sh
cat <<EOF > "/etc/nginx/conf.d/teamcity.conf"
upstream teamcity {
  server localhost:$PORT;
}

map $http_upgrade $connection_upgrade {
  default upgrade;
  ''      '';
}

server {
  listen           80;
  listen      [::]:80;

  server_name $DOMAIN;

  access_log  /var/log/nginx/$DOMAIN.access.log;
  error_log   /var/log/nginx/$DOMAIN.error.log;

  # 不限制上传大小
  client_max_body_size 0;

  proxy_read_timeout     1200;
  proxy_connect_timeout  240;

  # 解决HTTP 411错误：参见issue #1486 (https://gitteamcity.com/dotcloud/docker/issues/1486)
  chunked_transfer_encoding on;

  location / {
    proxy_pass http://teamcity;

    proxy_set_header Host \$host;
    proxy_set_header X-Real-IP \$remote_addr;
    proxy_set_header X-Forwarded-Host \$http_host;
    proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto \$scheme;
    proxy_http_version 1.1;

    # 支持WebSocket
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
  }
}
EOF

nginx -s reload

确保SELinux策略允许Nginx访问$PORT（步骤4中--publish $PORT:8111的第一个端口）：

sh
EXPR="^http_port_t\s+tcp\s.*\b$PORT\b"
if ! semanage port --list | grep --quiet --perl-regexp "$EXPR"; then
  if semanage port --add --type http_port_t --proto tcp $PORT; then
    echo Added port $PORT as a valid port for nginx:
    semanage port --list | grep --perl-regexp "$EXPR"
  else
    >&2 echo Could not add port $PORT as a valid port for nginx. \
             Please add it yourself. More information: \
             http://axilleas.me/en/blog/2013/selinux-policy-for-nginx-and-gitlab-unix-socket-in-fedora-19/
  fi
else
  echo Port $PORT is already a valid port for nginx:
  semanage port --list | grep --perl-regexp "$EXPR"
fi

8. 配置TeamCity

按照JetBrains TeamCity的安装配置指南进行配置，容器内的配置路径为/teamcity/.BuildServer。

9. 升级到新版本

sh
docker pull agross/teamcity

systemctl stop teamcity.service

# 备份数据目录
tar -zcvf "teamcity-data-$(date +%F-%H-%M-%S).tar.gz" "$TEAMCITY_DATA"

docker rm teamcity

# 重复步骤4创建新容器
docker create ...

systemctl start teamcity.service

10. 信任自签名SSL证书

若需连接使用自签名证书的服务（如LDAP服务器或NuGet源），需将证书添加到容器内JVM的信任库：

sh
HOST=ldap.example.com:636

docker exec -it -u root teamcity_teamcity_1 bash -c "
  set -o pipefail
  echo -n |
    openssl s_client -connect "$HOST" |
    sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > "/tmp/$HOST" &&
    "\$JAVA_HOME/bin/keytool" -import \
                              -alias "$HOST" \
                              -file "/tmp/$HOST" \
                              -keystore "\$JAVA_HOME/jre/lib/security/cacerts" \
                              -noprompt \
                              -storepass changeit &&
    rm /tmp/$HOST"

构建和测试Dockerfile

1. 构建Dockerfile

sh
docker build --tag agross/teamcity:testing .

docker images
# 应显示:
# REPOSITORY                        TAG                 IMAGE ID            CREATED             VIRTUAL SIZE
# agross/teamcity                   testing             0dcb8bf6093f        49 seconds ago      405.4 MB

2. 准备测试目录

sh
TEST_DIR="/tmp/teamcity-testing"

mkdir --parents "$TEST_DIR/data" \
                "$TEST_DIR/logs"
chown -R 3000:3000 "$TEST_DIR"

3. 运行测试容器

注意： 卷挂载时的:z选项用于正确设置SELinux上下文，详情参见相关文档。

sh
docker run -it --rm \
               --name teamcity-testing \
               --publish 8111:8111 \
               --volume "$TEST_DIR/data:/teamcity/.BuildServer:z" \
               --volume "$TEST_DIR/logs:/teamcity/logs:z" \
               agross/teamcity:testing

4. 进入运行中的容器

sh
docker exec -it teamcity-testing bash

5. 运行bash而非启动TeamCity

sh
docker run -it --rm \
               --name teamcity-testing \
               --publish 8111:8111 \
               --volume "$TEST_DIR/data:/teamcity/.BuildServer:z" \
               --volume "$TEST_DIR/logs:/teamcity/logs:z" \
               agross/teamcity:testing \
               bash