如何搭建Phabricator開發管理平臺

如何搭建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 的過程中取得成功！