如何搭建Phabricator开发管理平台

目录

1. 简介
2. 准备工作
3. 安装依赖
4. 下载和配置Phabricator
5. 配置数据库
6. 服务器">配置Web服务器
7. 配置邮件服务
8. 配置Phabricator
9. 常见问题与解决方案
10. 总结

简介

Phabricator 是一个开源的软件开发管理工具，由 Facebook 开发并广泛用于代码审查、任务管理、代码托管等。它提供了一系列的工具，如 Differential（代码审查）、Maniphest（任务管理）、Harbormaster（持续集成）等，帮助开发团队更高效地协作和管理项目。

本文将详细介绍如何在 Linux 系统上搭建 Phabricator 开发管理平台，涵盖从环境准备到最终配置的全过程。

准备工作

在开始搭建 Phabricator 之前，确保你已经具备以下条件：

1. 一台运行 Linux 的服务器：推荐使用 Ubuntu 或 CentOS。
2. root 权限：你需要 root 权限来安装软件和配置系统。
3. 域名：你需要一个域名来访问 Phabricator。
4. 数据库：Phabricator 支持 MySQL 或 MariaDB。
5. Web 服务器：推荐使用 Apache 或 Nginx。
6. 邮件服务：Phabricator 需要发送邮件通知，因此需要一个可用的邮件服务。

安装依赖

在安装 Phabricator 之前，需要确保系统上安装了必要的依赖。

更新系统

首先，更新系统包：

sudo apt-get update
sudo apt-get upgrade

安装必要的软件包

安装 PHP、Git、MySQL 和其他必要的软件包：

sudo apt-get install git apache2 mysql-server php php-mysql php-gd php-curl php-apcu php-cli php-json php-mbstring

安装 Composer

Phabricator 使用 Composer 来管理 PHP 依赖。安装 Composer：

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

下载和配置Phabricator

下载 Phabricator

使用 Git 克隆 Phabricator 的代码库：

cd /var/www/html
sudo git clone https://github.com/phacility/phabricator.git
sudo git clone https://github.com/phacility/arcanist.git
sudo git clone https://github.com/phacility/libphutil.git

配置权限

确保 Phabricator 目录的权限正确：

sudo chown -R www-data:www-data /var/www/html/phabricator
sudo chown -R www-data:www-data /var/www/html/arcanist
sudo chown -R www-data:www-data /var/www/html/libphutil

配置数据库

创建数据库

登录 MySQL 并创建一个新的数据库和用户：

mysql -u root -p

在 MySQL 命令行中执行以下命令：

CREATE DATABASE phabricator;
CREATE USER 'phabricator'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON phabricator.* TO 'phabricator'@'localhost';
FLUSH PRIVILEGES;
EXIT;

配置 Phabricator 数据库连接

编辑 Phabricator 的配置文件 phabricator/conf/local/local.json，添加数据库连接信息：

{
  "mysql.host": "localhost",
  "mysql.user": "phabricator",
  "mysql.pass": "your_password",
  "mysql.port": 3306,
  "mysql.database": "phabricator"
}

配置Web服务器

配置 Apache

创建一个新的 Apache 虚拟主机配置文件：

sudo nano /etc/apache2/sites-available/phabricator.conf

添加以下内容：

<VirtualHost *:80>
    ServerName phabricator.yourdomain.com
    DocumentRoot /var/www/html/phabricator/webroot

    <Directory /var/www/html/phabricator/webroot>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/phabricator_error.log
    CustomLog ${APACHE_LOG_DIR}/phabricator_access.log combined
</VirtualHost>

启用站点并重启 Apache：

sudo a2ensite phabricator.conf
sudo systemctl reload apache2

配置 Nginx

如果你使用 Nginx，可以创建一个新的配置文件：

sudo nano /etc/nginx/sites-available/phabricator

添加以下内容：

server {
    listen 80;
    server_name phabricator.yourdomain.com;

    root /var/www/html/phabricator/webroot;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

启用站点并重启 Nginx：

sudo ln -s /etc/nginx/sites-available/phabricator /etc/nginx/sites-enabled/
sudo systemctl reload nginx

配置邮件服务

Phabricator 需要发送邮件通知，因此需要配置邮件服务。你可以使用本地邮件服务（如 Postfix）或外部邮件服务（如 Gmail）。

配置 Postfix

安装 Postfix：

sudo apt-get install postfix

在安装过程中，选择 “Internet Site” 并输入你的域名。

配置 Phabricator 邮件

编辑 Phabricator 的配置文件 phabricator/conf/local/local.json，添加邮件配置：

{
  "phpmailer.smtp-host": "smtp.gmail.com",
  "phpmailer.smtp-port": 587,
  "phpmailer.smtp-user": "your_email@gmail.com",
  "phpmailer.smtp-password": "your_password",
  "phpmailer.smtp-protocol": "tls"
}

配置Phabricator

初始化 Phabricator

运行以下命令来初始化 Phabricator：

cd /var/www/html/phabricator
sudo ./bin/config set phabricator.base-uri 'http://phabricator.yourdomain.com/'
sudo ./bin/storage upgrade --force

创建管理员账户

访问 http://phabricator.yourdomain.com/，按照提示创建一个管理员账户。

配置其他设置

登录 Phabricator 后，进入 “Config” 页面，根据需要配置其他设置，如身份验证、存储、通知等。

常见问题与解决方案

1. 无法访问 Phabricator

• 检查 Web 服务器配置：确保 Apache 或 Nginx 配置正确，并且站点已启用。
• 检查防火墙：确保防火墙允许 HTTP 和 HTTPS 流量。

2. 数据库连接失败

• 检查数据库配置：确保 local.json 中的数据库配置正确。
• 检查数据库权限：确保 Phabricator 用户有权限访问数据库。

3. 邮件发送失败

• 检查邮件配置：确保 local.json 中的邮件配置正确。
• 检查邮件服务：确保邮件服务正常运行，并且 Phabricator 可以访问邮件服务器。

总结

通过本文的步骤，你应该已经成功搭建了一个 Phabricator 开发管理平台。Phabricator 提供了丰富的功能，帮助开发团队更高效地协作和管理项目。你可以根据需要进一步配置和定制 Phabricator，以满足团队的特定需求。

希望本文对你有所帮助，祝你在使用 Phabricator 的过程中取得成功！