Comment installer et configurer Phabricator sur CentOS 7

• Conditions préalables
• Étape 1: mise à jour du système
• Étape 2: installer MariaDB
• Étape 3: installer Apache
• Étape 4: installer PHP
• Étape 5: installer git
• Étape 6: Téléchargez et installez Phabricator
• Étape 7: configurer un hôte virtuel pour Phabricator
• Étape 8: Configurer les informations d'identification MariaDB pour Phabricator
• Étape 9: Modifiez les règles de pare-feu et configurez un compte d'administrateur Phabricator
• Étape 10: résoudre les problèmes d'installation non résolus

Phabricator est une plate-forme de développement de logiciels open source avancée qui peut être utilisée pour:

• Examiner et auditer le code.
• Hébergez les dépôts Git / Hg / SVN.
• Suivi des bugs.
• Gérez vos projets.
• Communiquez avec les membres de l'équipe.
• Et faites bien plus!

Grâce à ses nombreuses fonctionnalités et à ses performances exceptionnelles, Phabricator devient de plus en plus populaire dans la communauté des logiciels open source.

Dans cet article, je vais vous montrer comment installer Phabricator sur une instance de serveur Vultr CentOS 7.

Conditions préalables

• Déployer une instance de serveur Vultr CentOS 7 à partir de zéro;
• Connectez-vous à partir du terminal SSH à l'aide d'un utilisateur sudo non root.

Étape 1: mise à jour du système

Mettez à jour votre système CentOS 7, puis redémarrez:

yum update -y && shutdown -r now

Après le démarrage du système, connectez-vous en tant qu'utilisateur non root avec accès sudo.

Étape 2: installer MariaDB

Installez le serveur MariaDB:

sudo yum install mariadb mariadb-server

Démarrez et activez le service MariaDB:

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

Pour des raisons de sécurité, exécutez l'utilitaire d'installation sécurisée MySQL:

sudo /usr/bin/mysql_secure_installation

Terminez ce processus conformément aux instructions ci-dessous:

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

Étape 3: installer Apache

Installez le serveur Web Apache à l'aide de YUM:

sudo yum install httpd

Modifiez la configuration par défaut afin d'améliorer la sécurité:

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

Démarrez et activez le service Apache:

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

Étape 4: installer PHP

Installez PHP et les extensions nécessaires:

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

Étape 5: installer git

sudo yum install git

Étape 6: Téléchargez et installez 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

Étape 7: configurer un hôte virtuel pour Phabricator

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

Remplissez le segment de code suivant:

Note: Vous devez remplacer [email protected], phabricator.example.com, www.phabricator.example.com, /var/log/httpd/phabricator.example.com-error_loget /var/log/httpd/phabricator.example.com-access_logavec vos propres valeurs.

<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>

Sauvegarder et quitter:

:wq

Redémarrez le service Apache afin de mettre en œuvre vos modifications:

sudo systemctl restart httpd.service

Étape 8: Configurer les informations d'identification MariaDB pour Phabricator

Avant de pouvoir utiliser Phabricator, vous devez configurer les informations d'identification 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>

Remplissez les schémas Phabricator:

./bin/storage upgrade

Au cours de ce processus, vous devez saisir "y" deux fois:

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

Étape 9: Modifiez les règles de pare-feu et configurez un compte d'administrateur Phabricator

Vous devez autoriser le trafic entrant sur le port HTTP 80 par défaut:

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

Utilisez ensuite votre navigateur Web pour visiter:

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

La page Web d'inscription Phabricator vous sera présentée. Créez un compte administrateur pour la gestion quotidienne.

Maintenant, voyons comment configurer Phabricator.

Étape 10: résoudre les problèmes d'installation non résolus

Avant de pouvoir utiliser Phabricator en toute sérénité, vous devez résoudre plusieurs problèmes de configuration. Le nombre de problèmes de configuration varie, dans mon cas, il y en avait 16. Résolvons-les un par un.

Problème 1: URI de base non configuré

Cliquez sur le lien "URI de base non configuré" pour accéder à la page de détails du problème dans laquelle vous pouvez en savoir plus sur ce problème.

Afin de résoudre ce problème, vous devez exécuter les commandes suivantes sur votre terminal SSH. Assurez-vous d'utiliser la bonne adresse IP.

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

Ensuite, dans votre navigateur Web, cliquez sur le bouton "Recharger la page" sur la page des détails du problème. Si votre réparation a fonctionné, le texte sur la page deviendra «Problème résolu». Cliquez sur le lien "Retour à la liste des problèmes ouverts" pour rechercher d'autres problèmes.

Problème 2: aucun fournisseur d'authentification configuré

Cliquez sur le lien «Aucun fournisseur d'authentification configuré» pour accéder à la page des détails du problème.

Afin de résoudre ce problème, vous devez spécifier le fournisseur d'authentification.

Cliquez sur le lien "Auth Application" puis sur le bouton "+ Add Provider" pour accéder à la page "Add Auth Provider". Choisissez un fournisseur d'authentification approprié, puis cliquez sur le bouton "Continuer". Ici, j'ai choisi "Nom d'utilisateur / Mot de passe".

Dans la page "Ajouter un fournisseur d'authentification: nom d'utilisateur / mot de passe", vous pouvez consulter des paramètres plus détaillés, puis cliquer sur le bouton "Ajouter un fournisseur".

Vous pouvez ajouter d'autres fournisseurs d'authentification de la même manière, mais pour l'instant, cliquez sur le lien "Vous avez X problèmes d'installation non résolus ..." pour gérer d'autres problèmes.

Problème 3: les démons Phabricator ne fonctionnent pas

Cliquez sur le lien «Les démons Phabricator ne fonctionnent pas» pour accéder à la page de détails.

Afin de résoudre ce problème, exécutez la commande ci-dessous sur votre terminal SSH:

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

Cliquez sur le bouton "Recharger la page" pour confirmer le résultat.

Problème 4: PHP post_max_sizenon configuré

Exécutez les commandes suivantes sur votre terminal SSH pour résoudre ce problème:

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

Cliquez sur le bouton "Recharger la page" pour confirmer vos modifications.

Problème 5-10: problèmes liés à MySQL

Il y a six problèmes liés à MySQL au total:

• Petit " paquet autorisé max" MySQL
• MySQL STRICT ALL TABLES Mode non défini
• MySQL utilise un fichier de mots-clés par défaut
• MySQL utilise la longueur de mot minimale par défaut
• MySQL utilise la syntaxe booléenne par défaut
• MySQL peut fonctionner lentement

Par souci de commodité, corrigeons-les en un seul lot.

Sur votre terminal SSH, éditez le fichier de configuration MySQL avec vi:

sudo vi /etc/my.cnf

Sous les trois lignes du haut:

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

Ajoutez les six lignes ci-dessous:

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

Avertissement: Vous devez définir une taille de pool de mémoire tampon Innodb appropriée en fonction de la taille de votre serveur spécifique. Habituellement, la taille du pool de mémoire tampon Innodb doit représenter environ 40% de la quantité de mémoire de votre ordinateur. Par exemple, si vous utilisez une machine avec de la mémoire 4G, la taille raisonnable du pool de mémoire tampon Innodb serait de 1600M. Dans le cas où vous utilisez une machine avec peu de mémoire (comme 768M), vous devrez peut-être affecter une taille inférieure à 40% de la quantité de mémoire de votre machine (disons 220M) afin d'économiser plus de mémoire pour le système.

Sauvegarder et quitter:

:wq

Redémarrez le service MariaDB:

sudo systemctl restart mariadb.service

Enfin, exécutez la commande suivante:

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

Cliquez sur le bouton "Recharger la page" pour examiner vos efforts.

Problème 11: installation de pygments pour améliorer la mise en évidence de la syntaxe

Sur CentOS 7, Pygments a été installé mais n'est pas activé par défaut, vous devez l'activer manuellement:

Cliquez sur le lien: Modifier "pygments.enabled", choisissez "Use Pygments" dans le menu déroulant "Database Value", puis cliquez sur le bouton "Save Config Entry".

Problème 12: fuseau horaire du serveur non configuré

Modifiez le php.inifichier:

sudo vi /etc/php.ini

Remplacez la ligne:

;date.timezone =

Avec:

date.timezone = America/Los_Angeles

Sauvegarder et quitter:

:wq

Remarque: "America / Los_Angeles" est la valeur de fuseau horaire de ma machine, vous devez trouver la valeur de fuseau horaire appropriée pour votre propre instance de serveur ici .

Redémarrez le service Apache:

sudo systemctl restart httpd.service

Cliquez sur le bouton "Recharger la page" pour examiner le résultat.

Problème 13: stockage de fichiers volumineux non configuré

Vous devez déployer une solution de stockage de fichiers volumineux appropriée en fonction de votre propre paramètre. Pour l'instant, vous pouvez cliquer sur le bouton "Ignorer le problème de configuration" pour ignorer.

Problème 14: autre domaine de fichiers non configuré

Supposons que vous ayez configuré un autre domaine de fichiers ou un CDN, puis dans le terminal SSH:

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

Cliquez sur le bouton "Recharger la page" pour examiner le résultat.

Problème 15: Chemin local du référentiel manquant

Utilisez les commandes suivantes pour résoudre ce problème:

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

Cliquez sur le bouton "Recharger la page" pour examiner le résultat.

Problème 16: l'extension PHP «APC» n'est pas installée

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

Pendant le processus d'installation d'APC, appuyez toujours sur Entrée pour utiliser l'option par défaut.

sudo vi /etc/php.ini

Ajoutez les quatre lignes à la fin du fichier:

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

Sauvegarder et quitter:

:wq

Redémarrez le service Apache:

sudo systemctl restart httpd.service

Cliquez sur le bouton "Recharger la page" pour vérifier le résultat.

C'est tout. Bon codage!