本文使用「署名 4.0 国际 (CC BY 4.0)」许可协议，欢迎转载、或重新修改使用，但需要注明来源。 [署名 4.0 国际 (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/deed.zh)
本文作者: 苏洋
创建时间: 2020年02月02日
统计字数: 6012字
阅读时间: 12分钟阅读
本文链接: https://soulteary.com/2020/02/02/phabricator-with-docker-and-traefik-v2.html
-----
# 使用 Docker 和 Traefik v2 搭建 Phabricator
这篇文章躺在草稿箱里有一个多月了，恰逢最近一段时间远程协作需求，以及 Traefik v2 的升级，于是便有了这篇文章。
如果你的团队也需要一个内部看板，Phabricator 是个不错的选择：能提供简单的任务管理、能提供工作看板、支持代码讨论、甚至能够让设计师也使用起来，当然还有它主打的代码审计 / Review和管理功能。
## 写在前面
最早接触它是在 2012 年，八年之后，这款工具的开源版本变的更加好用了。
- 开源仓库：[https://secure.phabricator.com/source/phabricator/repository/stable/](https://secure.phabricator.com/source/phabricator/repository/stable/)
- 镜像仓库：[https://github.com/phacility/phabricator/](https://github.com/phacility/phabricator/)
- SaaS 版本：[https://www.phacility.com/phabricator/](https://www.phacility.com/phabricator/)
从开源仓库可以看到，社区版的代码一直在持续更新，而且现在还提供了 SaaS 版本，考虑到私密性和账户集成等定制要求，这里决定自建服务，并自行封装容器镜像。
考虑到不是所有人都有定制需求，这里分别提供两个方案，Bitnami 的容器方案，和完全基于官方代码进行定制的容器方案。
目前社区最新版是 [《stable - Promote 2020 Week 5》 ](https://secure.phabricator.com/rPcc11dff7d317b5a1e82e24ab571fef9abb633a49)，Bitnami 会定时从官方仓库中获取版本，并进行容器封装，仓库地址：[https://github.com/bitnami/bitnami-docker-phabricator](https://github.com/bitnami/bitnami-docker-phabricator)，相比官方更新会稍有延时，但是基本不影响使用。
### 准备数据库
生产环境推荐使用云服务商提供的数据库，但是如果小规模使用，使用容器启动一个数据库示例也未尝不可。
```yaml
version: '3.7'
services:
mariadb:
image: mariadb
environment:
- MYSQL_ROOT_PASSWORD=phabricator
- MYSQL_DATABASE=phabricator
command: --max_allowed_packet=33554432 --sql_mode="STRICT_ALL_TABLES" --local-infile=0
ports:
- 13306:3306
networks:
- traefik
healthcheck:
test: "mysqladmin --password=phabricator ping -h 127.0.0.1"
timeout: 5s
retries: 20
volumes:
- './mariadb_data:/var/lib/mysql'
networks:
traefik:
external: true
```
将上面的内容保存为 `docker-compose.yml` 并执行 `docker-compose up -d` 即可。
准备好数据库后，我们聊聊怎么简单启动一个 phabricator 服务。
## Bitnami 容器方案
这里提供两个版本的配置文件，更多搭配 Traefik 使用的前置知识可以在 [过往的文章中](https://soulteary.com/tags/traefik.html) 找到。
### 搭配 Traefik v1 使用
如果你还在使用 Traefik v1 ，那么使用下面的配置，可以一键启动封装好的稳定版本。
```yaml
version: '2'
services:
phabricator:
image: 'bitnami/phabricator:2019'
expose:
- 80
- 443
volumes:
- './phabricator_data:/bitnami'
- './extensions:/opt/bitnami/phabricator/src/extensions'
environment:
- PHABRICATOR_HOST=phabricator.soulteary.com
- PHABRICATOR_USERNAME=soulteary
- PHABRICATOR_PASSWORD=soulteary
networks:
- traefik
labels:
- "traefik.enable=true"
- "traefik.port=80"
- "traefik.frontend.rule=Host:phabricator.soulteary.com"
- "traefik.frontend.entryPoints=https,http"
networks:
traefik:
external: true
```
### 搭配 Traefik v2 使用
当然，这里更推荐搭配 Traefik v2 一起使用。
```yaml
version: '3.7'
services:
phabricator:
image: 'bitnami/phabricator:2019'
expose:
- 80
networks:
- traefik
labels:
- "traefik.enable=true"
- "traefik.docker.network=traefik"
- "traefik.http.routers.phab0.middlewares=https-redirect@file"
- "traefik.http.routers.phab0.entrypoints=http"
- "traefik.http.routers.phab0.rule=Host(`phabricator.lab.io`,`phabricator-file.lab.io`)"
- "traefik.http.routers.phab1.middlewares=content-compress@file"
- "traefik.http.routers.phab1.entrypoints=https"
- "traefik.http.routers.phab1.tls=true"
- "traefik.http.routers.phab1.rule=Host(`phabricator.lab.io`,`phabricator-file.lab.io`)"
- "traefik.http.services.phabbackend.loadbalancer.server.scheme=http"
- "traefik.http.services.phabbackend.loadbalancer.server.port=80"
volumes:
- './phabricator_data:/bitnami'
- './extensions:/opt/bitnami/phabricator/src/extensions'
networks:
traefik:
external: true
```
## 对程序进行汉化
感谢社区网友提供了程序的[汉化补丁](https://github.com/arielyang/phabricator_zh_Hans)，下载仓库中的 ** PhabricatorSimplifiedChineseTranslation.php** 并放置于上面配置文件指定的 `extensions` 目录中后，启动应用，等待应用启动就绪后，在个人设置中切换中文即可。
接下来开始正餐，如何基于源代码对 phabricator 进行容器封装。
## 封装 Phabricator 容器镜像
[官方安装文档](https://secure.phabricator.com/book/phabricator/article/installation_guide/) 写的比较详细，甚至封装了一个基础的安装脚本，我们基于此进行容器的 Dockerfile 的编写。
```bash
FROM ubuntu:18.04
LABEL maintainer="soulteary@gmail.com"
ENV DEBIAN_FRONTEND noninteractive
RUN apt-get update && apt-get upgrade -y && \
echo 'debconf debconf/frontend select Noninteractive' | debconf-set-selections && export DEBIAN_FRONTEND=noninteractive && \
apt-get install -y lsb-release curl && \
# deps from: https://raw.githubusercontent.com/phacility/phabricator/stable/scripts/install/install_ubuntu.sh
apt-get install -y tzdata sudo && \
ln -fs /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
apt-get install -y git apache2 libapache2-mod-php php php-mysql php-gd php-curl php-apcu php-cli php-json php-mbstring php-zip python python-pip && \
a2enmod rewrite && \
pip install Pygments
WORKDIR /opt
RUN git clone https://github.com/phacility/phabricator.git --branch=stable --depth=1 && \
cd phabricator && \
git checkout cc11dff7d317b5a1e82e24ab571fef9abb633a49
RUN git clone https://github.com/phacility/arcanist.git --branch=stable --depth=1 && \
cd arcanist && \
git checkout 729100955129851a52588cdfd9b425197cf05815
RUN git clone https://github.com/phacility/libphutil.git --branch=stable --depth=1 && \
cd libphutil && \
git checkout 034cf7cc39940b935e83923dbb1bacbcfe645a85
RUN git clone https://github.com/arielyang/phabricator_zh_Hans.git --branch=master --depth=1 && \
cd phabricator_zh_Hans && \
git checkout ba5e602d934a6efacdc09082cd3a762449de45cf && \
cp dist/\(stable\)\ Promote\ 2019\ Week\ 50/PhabricatorSimplifiedChineseTranslation.php ../phabricator/src/extensions/
COPY phabricator/docker-assets ./assets
RUN sed -i -e "s/post_max_size = 8M/post_max_size = 32M/g" /etc/php/7.2/apache2/php.ini && \
sed -i -e "s/;opcache.validate_timestamps=1/opcache.validate_timestamps = 0/g" /etc/php/7.2/apache2/php.ini
RUN useradd daemon-user && \
mkdir -p /data/repo && \
chown -R daemon-user:daemon-user /data/repo && \
ln -s /usr/lib/git-core/git-http-backend /usr/bin/ && \
echo "Cmnd_Alias GIT_CMDS = /usr/bin/git*" >> /etc/sudoers.d/www-user-git && \
echo "www-data ALL=(daemon-user) SETENV: NOPASSWD: GIT_CMDS" >> /etc/sudoers.d/www-user-git && \
chmod 0440 /etc/sudoers.d/www-user-git
ENTRYPOINT ["bash", "-c", "/opt/assets/entrypoint.sh"]
EXPOSE 80
```
Dockerfile 主要分为三个部分，第一部分进行基础系统环境配置、系统环境依赖；第二部分获取当前这个版本的程序代码和应用依赖；第三部分配置应用权限、设置容器启动脚本。
这里所需的程序启动脚本 **entrypoint.sh** 内容如下：
```bash
#!/usr/bin/env bash
./phabricator/bin/storage upgrade --force && \
./phabricator/bin/phd start
apachectl -D FOREGROUND
```
执行的工作也很简单：初始化Phabricator 配置，并启动 Web Server。
相关代码我已经上传至 [GitHub](https://github.com/soulteary/phabricator-dockerize)，并推送至 [DockerHub](https://hub.docker.com/repository/docker/soulteary/phabricator) 有需求的同学可以自取。
### 编写服务配置
服务配置分为两部分，第一部分是 Web Server 使用的。
```bash
ServerName phabricator.lab.io
DocumentRoot /opt/phabricator/webroot
RewriteEngine on
RewriteRule ^(.*)$ /index.php?__path__=$1 [B,L,QSA]
SetEnv HTTPS true
Require all granted
ServerName phabricator-file.lab.io
DocumentRoot /opt/phabricator/webroot
RewriteEngine on
RewriteRule ^(.*)$ /index.php?__path__=$1 [B,L,QSA]
Require all granted
```
将上面内容中的域名替换为自己实际使用的地址后，保存为 **phabricator.conf**，接着准备应用配置：
```bash
{
"phabricator.base-uri": "https://phabricator.lab.io/",
"security.alternate-file-domain":"https://phabricator-file.lab.io/",
"pygments.enabled": true,
"phabricator.timezone":"Asia/Shanghai",
"storage.local-disk.path":"/data/stor",
"repository.default-local-path": "/data/repo",
"phd.user": "daemon-user",
"mysql.pass": "phabricator",
"mysql.user": "root",
"mysql.port": "3306",
"mysql.host": "mariadb"
}
```
同样，替换域名为你自己的，并且将配置中的数据库相关内容替换为实际的数值，将文件保存为**local.json**。（如果数据库使用的是本文的内容，可以不需要修改）
### 编写容器启动配置
将上面保存的配置文件放置到指定目录后，编写应用启动使用的 **docker-compose.yml**：
```bash
version: '3.7'
services:
phabricator:
image: soulteary/phabricator:stable-2020-week-5
expose:
- 80
networks:
- traefik
labels:
- "traefik.enable=true"
- "traefik.docker.network=traefik"
- "traefik.http.routers.phab0.middlewares=https-redirect@file"
- "traefik.http.routers.phab0.entrypoints=http"
- "traefik.http.routers.phab0.rule=Host(`phabricator.lab.io`,`phabricator-file.lab.io`)"
- "traefik.http.routers.phab1.middlewares=content-compress@file"
- "traefik.http.routers.phab1.entrypoints=https"
- "traefik.http.routers.phab1.tls=true"
- "traefik.http.routers.phab1.rule=Host(`phabricator.lab.io`,`phabricator-file.lab.io`)"
- "traefik.http.services.phabbackend.loadbalancer.server.scheme=http"
- "traefik.http.services.phabbackend.loadbalancer.server.port=80"
volumes:
- ./phabricator_data/stor:/data/stor
- ./phabricator_data/repo:/data/repo
- ./phabricator/docker-assets/phabricator.conf:/etc/apache2/sites-available/000-default.conf:ro
- ./phabricator/docker-assets/local.json:/opt/phabricator/conf/local/local.json:ro
networks:
traefik:
external: true
```
使用 `docker-compose up -d` 将应用启动，并执行 `docker-compose logs -f`查看应用启动状况。
```bash
Creating phabricator-dockerize_phabricator_1 ... done
Attaching to phabricator-dockerize_phabricator_1
phabricator_1 | Loading quickstart template onto "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:db.paste" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190523.myisam.01.documentfield.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190718.paste.01.edge.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190718.paste.02.edgedata.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190718.paste.03.paste.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190718.paste.04.xaction.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190718.paste.05.comment.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190802.email.01.storage.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190802.email.02.xaction.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190815.account.01.carts.php" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190815.account.02.subscriptions.php" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190816.payment.01.xaction.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190816.subscription.01.xaction.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190822.merchant.01.view.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190909.herald.01.rebuild.php" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190924.diffusion.01.permanent.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20190924.diffusion.02.default.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20191028.uriindex.01.rebuild.php" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20191113.identity.01.email.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20191113.identity.02.populate.php" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20191113.identity.03.unassigned.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20191114.email.01.phid.sql" to host "mariadb:3306"...
phabricator_1 | Applying patch "phabricator:20191114.email.02.populate.php" to host "mariadb:3306"...
phabricator_1 | Storage is up to date. Use "storage status" for details.
phabricator_1 | Synchronizing static tables...
phabricator_1 | Verifying database schemata on "mariadb:3306"...
phabricator_1 |
phabricator_1 |
phabricator_1 | Database Table Name Issues
phabricator_1 | phabricator_differential differential_revision phid Surplus Key
phabricator_1 | phabricator_differential differential_revision key_modified Missing Key
phabricator_1 | phabricator_differential differential_revision key_phid Missing Key
phabricator_1 | phabricator_repository repository_identity key_email Missing Key
phabricator_1 | phabricator_phortune phortune_accountemail key_account Missing Key
phabricator_1 | phabricator_phortune phortune_accountemail key_address Missing Key
phabricator_1 | phabricator_phortune phortune_accountemail key_phid Missing Key
phabricator_1 | phabricator_user user_email key_phid Missing Key
phabricator_1 | phabricator_conpherence conpherence_index Better Table Engine Available
phabricator_1 | Applying schema adjustments...
phabricator_1 | Completed applying all schema adjustments.
phabricator_1 | ANALYZE Analyzing tables...
phabricator_1 | ANALYZED Analyzed 535 table(s).
phabricator_1 | Freeing active task leases...
phabricator_1 | Freed 0 task lease(s).
phabricator_1 | Starting daemons as daemon-user
phabricator_1 | Launching daemons:
phabricator_1 | (Logs will appear in "/var/tmp/phd/log/daemons.log".)
phabricator_1 |
phabricator_1 | (Pool: 1) PhabricatorRepositoryPullLocalDaemon
phabricator_1 | (Pool: 1) PhabricatorTriggerDaemon
phabricator_1 | (Pool: 1) PhabricatorFactDaemon
phabricator_1 | (Pool: 4) PhabricatorTaskmasterDaemon
phabricator_1 |
phabricator_1 | Done.
phabricator_1 | AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 172.20.0.4. Set the 'ServerName' directive globally to suppress this message
```
当看到 **Done.** 的时候，就可以打开浏览器对 Phabricator 进行进一步配置啦。
打开浏览器，输入你配置的域名后，Phabricator 将跳转至 Dashboard。
剩下的事情就是根据你自己的需求进行应用配置啦。
## 最后
Phabricator 的搭建只是第一步，与现有仓库集成、与CI 集成等内容留与后续再写吧。
--EOF