Hur man installerar och konfigurerar Phabricator på CentOS 7

Förutsättningar

Steg 1: Systemuppdatering

Steg 2: Installera MariaDB

Steg 3: Installera Apache

Steg 4: Installera PHP

Steg 5: Installera git

Steg 6: Ladda ner och installera Phabricator

Steg 7: Konfigurera en virtuell värd för Phabricator

Steg 8: Ställ in MariaDB-uppgifterna för Phabricator

Steg 9: Ändra brandväggsregler och konfigurera ett Phabricator-administratörskonto

Steg 10: Åtgärda olösta installationsproblem

Phabricator är en avancerad mjukvaruutvecklingsplattform med öppen källkod som kan användas för att:

• Granskning och revisionskod.
• Värd Git/Hg/SVN-repos.
• Spåra buggar.
• Hantera projekt.
• Kommunicera med teammedlemmar.
• Och gör mycket mer!

Tack vare dess rikliga funktioner och exceptionella prestanda blir Phabricator mer och mer populärt inom mjukvarugemenskapen med öppen källkod.

I den här artikeln kommer jag att visa dig hur du installerar Phabricator på en Vultr CentOS 7-serverinstans.

Förutsättningar

• Distribuera en Vultr CentOS 7-serverinstans från början;
• Logga in från SSH-terminalen med en icke-root sudo-användare.

Steg 1: Systemuppdatering

Uppdatera ditt CentOS 7-system och starta sedan om:

yum update -y && shutdown -r now

Efter att systemet har startat, logga in som en icke-root-användare med sudo-åtkomst.

Steg 2: Installera MariaDB

Installera MariaDB-servern:

sudo yum install mariadb mariadb-server

Starta och aktivera MariaDB-tjänsten:

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

Av säkerhetsskäl, kör MySQL säker installationsverktyget:

sudo /usr/bin/mysql_secure_installation

Avsluta denna process i enlighet med instruktionerna nedan:

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

Steg 3: Installera Apache

Installera Apache-webbservern med YUM:

sudo yum install httpd

Ändra standardkonfigurationen för att förbättra säkerheten:

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

Starta och aktivera Apache-tjänsten:

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

Steg 4: Installera PHP

Installera PHP och nödvändiga tillägg:

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

Steg 5: Installera git

sudo yum install git

Steg 6: Ladda ner och installera 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

Steg 7: Konfigurera en virtuell värd för Phabricator

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

Fyll i följande kodsegment:

Obs: Du måste ersätta admin@example.com, phabricator.example.com, www.phabricator.example.com, /var/log/httpd/phabricator.example.com-error_log, och /var/log/httpd/phabricator.example.com-access_logmed dina egna värden.

<VirtualHost *:80>
    ServerAdmin admin@example.com
    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>

Spara och avsluta:

:wq

Starta om Apache-tjänsten för att sätta dina ändringar i kraft:

sudo systemctl restart httpd.service

Steg 8: Ställ in MariaDB-uppgifterna för Phabricator

Innan du kan använda Phabricator måste du ställa in MariaDB-uppgifterna:

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>

Fyll i Phabricator-scheman:

./bin/storage upgrade

Under denna process måste du mata in "y" två gånger:

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

Steg 9: Ändra brandväggsregler och konfigurera ett Phabricator-administratörskonto

Du måste tillåta inkommande trafik på standard HTTP-port 80:

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

Använd sedan din webbläsare för att besöka:

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

Du kommer att presenteras med Phabricators registreringswebbsida. Skapa ett administratörskonto för daglig hantering.

Låt oss nu ta en titt på hur man konfigurerar Phabricator.

Steg 10: Åtgärda olösta installationsproblem

Innan du kan använda Phabricator med sinnesfrid måste du åtgärda flera installationsproblem. Antalet installationsproblem varierar, i mitt fall var det 16. Låt oss lösa dem en efter en.

Problem 1: Bas-URI inte konfigurerad

Klicka på länken "Bas-URI inte konfigurerad" för att komma till sidan med probleminformation där du kan lära dig mer om det här problemet.

För att åtgärda det här problemet måste du utföra följande kommandon på din SSH-terminal. Se till att använda rätt IP-adress.

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

I din webbläsare klickar du sedan på knappen "Ladda om sida" på sidan med probleminformation. Om din reparation fungerade kommer texten på sidan att bli "Problem löst". Klicka på länken "Återgå till öppen ärendelista" för att undersöka andra problem.

Problem 2: Inga autentiseringsleverantörer konfigurerade

Klicka på länken "Inga autentiseringsleverantörer konfigurerade" för att komma till sidan med probleminformation.

För att åtgärda det här problemet måste du ange autentiseringsleverantören.

Klicka på länken "Auth Application" och sedan på "+ Add Provider"-knappen för att komma till sidan "Add Auth Provider". Välj en lämplig autentiseringsleverantör och klicka sedan på knappen "Fortsätt". Här valde jag "Användarnamn/Lösenord".

På sidan "Lägg till autentiseringsleverantör: Användarnamn/Lösenord" kan du granska mer detaljerade inställningar och klicka sedan på knappen "Lägg till leverantör".

Du kan lägga till fler autentiseringsleverantörer på samma sätt, men för tillfället klickar du på länken "Du har X olösta installationsproblem..." för att hantera andra problem.

Problem 3: Phabricator Daemons är inte igång

Klicka på länken "Phabricator Daemons Are Not Running" för att komma till informationssidan.

För att lösa det här problemet, kör kommandot nedan på din SSH-terminal:

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

Klicka på knappen "Ladda om sida" för att bekräfta resultatet.

Problem 4: PHP post_max_sizeinte konfigurerat

Kör följande kommandon på din SSH-terminal för att åtgärda problemet:

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

Klicka på knappen "Ladda om sidan" för att bekräfta dina ändringar.

Problem 5-10: MySQL-relaterade problem

Det finns sex MySQL-relaterade problem totalt:

• Litet MySQL "max tillåtet paket"
• MySQL STRICT ALL TABLES Läget ej inställt
• MySQL använder standardstoppordsfil
• MySQL använder förinställd minsta ordlängd
• MySQL använder den booleska standardsyntaxen
• MySQL kan köras långsamt

För enkelhets skull, låt oss fixa dem i en omgång.

På din SSH-terminal, redigera MySQL-konfigurationsfilen med vi:

sudo vi /etc/my.cnf

Under de tre raderna överst:

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

Lägg till de sex raderna nedan:

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

Varning: Du måste ställa in en lämplig Innodb-buffertpoolstorlek enligt din specifika serverstorlek. Vanligtvis bör Innodb-buffertpoolens storlek vara cirka 40 % av mängden din maskins minne. Till exempel, om du använder en maskin med 4G-minne, skulle den rimliga Innodb-buffertpoolen vara 1600M. Om du använder en maskin med lite minne (t.ex. 768M), kan du behöva tilldela en storlek som är mindre än 40 % av mängden maskinens minne (säg 220M) för att spara mer minne för systemet.

Spara och avsluta:

:wq

Starta om MariaDB-tjänsten:

sudo systemctl restart mariadb.service

Slutligen, kör följande kommando:

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

Klicka på knappen "Ladda om sidan" för att undersöka dina ansträngningar.

Problem 11: Installera Pygments för att förbättra syntaxmarkering

På CentOS 7 har Pygments installerats men inte aktiverats som standard, du måste aktivera det manuellt:

Klicka på länken: Redigera "pygments.enabled", välj "Använd pygment" från rullgardinsmenyn "Databasvärde" och klicka sedan på knappen "Spara konfigurationspost".

Problem 12: Serverns tidszon inte konfigurerad

Ändra php.inifilen:

sudo vi /etc/php.ini

Byt ut raden:

;date.timezone =

Med:

date.timezone = America/Los_Angeles

Spara och avsluta:

:wq

Notera: "America/Los_Angeles" är tidszonvärdet för min maskin, du måste hitta rätt tidszonvärde för din egen serverinstans här .

Starta om Apache-tjänsten:

sudo systemctl restart httpd.service

Klicka på knappen "Ladda om sida" för att undersöka resultatet.

Problem 13: Stor fillagring inte konfigurerad

Du måste distribuera en lämplig lösning för lagring av stora filer enligt din egen inställning. För närvarande kan du klicka på "Ignorera installationsproblem" för att hoppa över.

Problem 14: Alternativ fildomän inte konfigurerad

Säg att du har ställt in en alternativ fildomän eller ett CDN, och sedan i SSH-terminalen:

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

Klicka på knappen "Ladda om sida" för att undersöka resultatet.

Problem 15: Lokal sökväg för förvar saknas

Använd följande kommandon för att lösa problemet:

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

Klicka på knappen "Ladda om sida" för att undersöka resultatet.

Problem 16: PHP-tillägget 'APC' inte installerat

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

Under installationsprocessen av APC, tryck alltid på Enter för att använda standardalternativet.

sudo vi /etc/php.ini

Lägg till de fyra raderna i slutet av filen:

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

Spara och avsluta:

:wq

Starta om Apache-tjänsten:

sudo systemctl restart httpd.service

Klicka på knappen "Ladda om sida" för att kontrollera resultatet.

Det är allt. Glad kodning!