Як встановити та налаштувати Phabricator на CentOS 7

Phabricator — це передова платформа для розробки програмного забезпечення з відкритим вихідним кодом, яку можна використовувати для:

• Код перевірки та аудиту.
• Хост репозицій Git/Hg/SVN.
• Відстежуйте помилки.
• Керуйте проектами.
• Спілкуйтеся з членами команди.
• І зробити набагато більше!

Завдяки багатим функціям і винятковій продуктивності Phabricator стає все більш популярним у спільноті програмного забезпечення з відкритим кодом.

У цій статті я покажу вам, як встановити Phabricator на екземпляр сервера Vultr CentOS 7.

Передумови

• Розгорнути екземпляр сервера Vultr CentOS 7 з нуля;
• Увійдіть із терміналу SSH за допомогою користувача sudo без права root.

Крок 1: Оновлення системи

Оновіть систему CentOS 7, а потім перезавантажте:

yum update -y && shutdown -r now

Після завантаження системи увійдіть як користувач без права root з доступом sudo.

Крок 2: Встановіть MariaDB

Встановіть сервер MariaDB:

sudo yum install mariadb mariadb-server

Запустіть і ввімкніть службу MariaDB:

sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

З метою безпеки запустіть утиліту безпечного встановлення MySQL:

sudo /usr/bin/mysql_secure_installation

Завершіть цей процес відповідно до наведених нижче інструкцій:

Enter current password for root (enter for none): Enter
Set root password? [Y/n]: Y
New password:<your-password>
Re-enter new password:<your-password>
Remove anonymous users? [Y/n]: Y
Disallow root login remotely? [Y/n]: Y
Remove test database and access to it? [Y/n]: Y
Reload privilege tables now? [Y/n]: Y

Крок 3: Встановіть Apache

Встановіть веб-сервер Apache за допомогою YUM:

sudo yum install httpd

Змініть конфігурацію за замовчуванням, щоб підвищити безпеку:

sudo sed -i 's/^/#&/g' /etc/httpd/conf.d/welcome.conf
sudo sed -i "s/Options Indexes FollowSymLinks/Options FollowSymLinks/" /etc/httpd/conf/httpd.conf

Запустіть і ввімкніть службу Apache:

sudo systemctl start httpd.service
sudo systemctl enable httpd.service

Крок 4: Встановіть PHP

Встановіть PHP та необхідні розширення:

sudo yum install php php-mysqli php-mbstring php-gd php-curl php-cli php-common php-process

Крок 5: Встановіть git

sudo yum install git

Крок 6: Завантажте та встановіть Phabricator

cd ~
mkdir phabricator
cd phabricator
git clone https://github.com/phacility/libphutil.git
git clone https://github.com/phacility/arcanist.git
git clone https://github.com/phacility/phabricator.git
cd ~
sudo chown -R apache: ~/phabricator
sudo mv ~/phabricator /var/www/html

Крок 7: Налаштуйте віртуальний хост для Phabricator

sudo vi /etc/httpd/conf.d/phabricator.conf

Заповніть такий сегмент коду:

Примітка. Вам потрібно замінити [email protected], phabricator.example.com, www.phabricator.example.com, /var/log/httpd/phabricator.example.com-error_log, і /var/log/httpd/phabricator.example.com-access_logсвоїми власними значеннями.

<VirtualHost *:80>
    ServerAdmin [email protected]
    DocumentRoot /var/www/html/phabricator/phabricator/webroot/
    ServerName phabricator.example.com
    ServerAlias www.phabricator.example.com
    RewriteEngine on
    RewriteRule ^/rsrc/(.*)     -                       [L,QSA]
    RewriteRule ^/favicon.ico   -                       [L,QSA]
    RewriteRule ^(.*)$          /index.php?__path__=$1  [B,L,QSA]
    <Directory /var/www/html/phabricator/phabricator/webroot/>
        AllowOverride All
    </Directory>
    ErrorLog /var/log/httpd/phabricator.example.com-error_log
    CustomLog /var/log/httpd/phabricator.example.com-access_log common
</VirtualHost>

Збережіть і вийдіть:

:wq

Перезапустіть службу Apache, щоб ваші зміни запрацювали:

sudo systemctl restart httpd.service

Крок 8: Налаштуйте облікові дані MariaDB для Phabricator

Перш ніж ви зможете використовувати Phabricator, вам потрібно налаштувати облікові дані MariaDB:

cd /var/www/html/phabricator/phabricator/
sudo ./bin/config set mysql.host localhost
sudo ./bin/config set mysql.port 3306
sudo ./bin/config set mysql.user root
sudo ./bin/config set mysql.pass <your-MySQL-root-password>

Заповніть схеми Phabricator:

./bin/storage upgrade

Під час цього процесу вам потрібно ввести «y» двічі:

Before running storage upgrades, you should take down the Phabricator web
interface and stop any running Phabricator daemons (you can disable this
warning with --force).

    Are you ready to continue? [y/N] y

...

MySQL needs to copy table data to make some adjustments, so these migrations may take some time.

    Fix these schema issues? [y/N] y

Крок 9. Змініть правила брандмауера та налаштуйте обліковий запис адміністратора Phabricator

Вам потрібно дозволити вхідний трафік на порту HTTP за замовчуванням 80:

sudo firewall-cmd --zone=public --permanent --add-service=http
sudo firewall-cmd --reload

Потім скористайтеся веб-переглядачем, щоб відвідати:

http://<your-Vultr-server-IP>

Вам буде представлена ​​веб-сторінка реєстрації Phabricator. Створіть обліковий запис адміністратора для щоденного керування.

Тепер давайте подивимося, як налаштувати Phabricator.

Крок 10. Виправте невирішені проблеми з налаштуванням

Before you can use Phabricator with a peace of mind, you have to fix several setup issues. The number of setup issues varies, in my case, there were 16. Let's solve them one by one.

Issue 1: Base URI Not Configured

Click the "Base URI Not Configured" link to get into the issue details page in which you can learn more about this issue.

In order to fix this issue, you need to execute the following commands on your SSH terminal. Be sure to use the proper IP address.

cd /var/www/html/phabricator/phabricator/
sudo ./bin/config set phabricator.base-uri 'http://<your-Vultr-server-IP>'

Then in your web browser, click the "Reload Page" button on the issue details page. If your repair worked, the text on the page will become "Issue Resolved". Click the "Return to Open Issue List" link to investigate other issues.

Issue 2: No Authentication Providers Configured

Click the "No Authentication Providers Configured" link to get into the issue details page.

In order to fix this issue, you need to specify the authentication provider.

Click the "Auth Application" link and then the "+ Add Provider" button to get into the "Add Auth Provider" page. Choose an appropriate authentication provider, and then click the "Continue" button. Here I chose "Username/Password".

In the "Add Auth Provider: Username/Password" page, you can review more detailed settings, then click the "Add Provider" button.

You can add more authentication providers in the same fashion, but for now, click the "You have X unresolved setup issues..." link to handle other issues.

Issue 3: Phabricator Daemons Are Not Running

Click the "Phabricator Daemons Are Not Running" link to enter the details page.

In order to solve this issue, run the command below on your SSH terminal:

cd /var/www/html/phabricator/phabricator/
./bin/phd start

Click the "Reload Page" button to confirm the result.

Issue 4: PHP post_max_size Not Configured

Run the following commands on your SSH terminal to fix this issue:

sudo sed -i "s/post_max_size = 8M/post_max_size = 32M/" /etc/php.ini
sudo systemctl restart httpd.service

Click the "Reload Page" button to confirm your modifications.

Issue 5-10: MySQL-related issues

There are six MySQL-related issues in total:

• Small MySQL "maxallowedpacket"
• MySQL STRICTALLTABLES Mode Not Set
• MySQL is Using Default Stopword File
• MySQL is Using Default Minimum Word Length
• MySQL is Using the Default Boolean Syntax
• MySQL May Run Slowly

As a matter of convenience, let's fix them in one batch.

На терміналі SSH відредагуйте файл конфігурації MySQL за допомогою vi:

sudo vi /etc/my.cnf

Під трьома рядками зверху:

[mysqld]
datadir=/var/lib/mysql
socket=/var/lib/mysql/mysql.sock

Додайте шість рядків нижче:

max_allowed_packet=32M
sql_mode=STRICT_ALL_TABLES
ft_stopword_file=/var/www/html/phabricator/phabricator/resources/sql/stopwords.txt
ft_min_word_len=3
ft_boolean_syntax=' |-><()~*:""&^'
innodb_buffer_pool_size=1600M        # about 40% of your system memory

Попередження: вам потрібно встановити правильний розмір буферного пулу Innodb відповідно до розміру вашого сервера. Зазвичай розмір буферного пулу Innodb має становити приблизно 40% обсягу пам’яті вашої машини. Наприклад, якщо ви використовуєте машину з пам’яттю 4G, розумний розмір буферного пулу Innodb буде 1600 МБ. У випадку, якщо ви використовуєте машину з малою пам’яттю (наприклад, 768M), вам може знадобитися призначити розмір менше 40% від обсягу пам’яті вашого пристрою (скажімо, 220M), щоб заощадити більше пам’яті для системи.

Збережіть і вийдіть:

:wq

Перезапустіть службу MariaDB:

sudo systemctl restart mariadb.service

Нарешті, виконайте таку команду:

mysql -u root -p -e "REPAIR TABLE phabricator_search.search_documentfield"

Натисніть кнопку «Перезавантажити сторінку», щоб перевірити свої зусилля.

Проблема 11. Установіть Pygments, щоб покращити підсвічування синтаксису

У CentOS 7 Pygments було встановлено, але не ввімкнено за замовчуванням, вам потрібно ввімкнути його вручну:

Натисніть посилання: Редагувати «pygments.enabled», виберіть «Використовувати Pygments» зі спадного меню «Значення бази даних», а потім натисніть кнопку «Зберегти запис конфігурації».

Проблема 12: Часовий пояс сервера не налаштовано

Змінити php.iniфайл:

sudo vi /etc/php.ini

Замініть рядок:

;date.timezone =

з:

date.timezone = America/Los_Angeles

Збережіть і вийдіть:

:wq

Примітка: "America/Los_Angeles" - це значення часового поясу моєї машини, вам потрібно знайти відповідне значення часового поясу для вашого власного екземпляра сервера тут .

Перезапустіть службу Apache:

sudo systemctl restart httpd.service

Натисніть кнопку «Перезавантажити сторінку», щоб перевірити результат.

Проблема 13: Велике сховище файлів не налаштовано

Вам потрібно розгорнути відповідне рішення для зберігання великих файлів відповідно до ваших власних налаштувань. Наразі ви можете натиснути кнопку «Ігнорувати проблему встановлення», щоб пропустити.

Проблема 14: Альтернативний домен файлу не налаштовано

Скажімо, ви налаштували альтернативний файловий домен або CDN, а потім у терміналі SSH:

cd /var/www/html/phabricator/phabricator/
sudo ./bin/config set security.alternate-file-domain <https://files.example.com>

Натисніть кнопку «Перезавантажити сторінку», щоб перевірити результат.

Проблема 15: Відсутній локальний шлях до сховища

Використовуйте такі команди, щоб вирішити цю проблему:

sudo mkdir /var/repo
sudo chown apache: /var/repo

Натисніть кнопку «Перезавантажити сторінку», щоб перевірити результат.

Проблема 16: Розширення PHP «APC» не встановлено

sudo yum install php-pear php-devel httpd-devel pcre-devel gcc make
sudo pecl install apc

Під час процесу встановлення APC завжди натискайте Enter, щоб використовувати параметр за замовчуванням.

sudo vi /etc/php.ini

Додайте чотири рядки в кінець файлу:

extension=apc.so
apc.write_lock = On
apc.slam_defense = Off
apc.stat = Off

Збережіть і вийдіть:

:wq

Перезапустіть службу Apache:

sudo systemctl restart httpd.service

Натисніть кнопку «Перезавантажити сторінку», щоб перевірити результат.

Це все. Щасливого кодування!