Come installare e configurare Phabricator su CentOS 7

• Prerequisiti
• Passaggio 1: aggiornamento del sistema
• Passaggio 2: installare MariaDB
• Passaggio 3: installare Apache
• Passaggio 4: installa PHP
• Passaggio 5: installare git
• Passaggio 6: scaricare e installare Phabricator
• Passaggio 7: installare un host virtuale per Phabricator
• Passaggio 8: configurare le credenziali MariaDB per Phabricator
• Passaggio 9: modifica le regole del firewall e imposta un account amministratore Phabricator
• Passaggio 10: risolvere i problemi di installazione non risolti

Phabricator è una piattaforma di sviluppo software open source avanzata che può essere utilizzata per:

• Codice di revisione e controllo.
• Host repository Git / Hg / SVN.
• Tieni traccia dei bug.
• Gestisci progetti.
• Comunicare con i membri del team.
• E fai molto di più!

Grazie alle sue abbondanti funzionalità e prestazioni eccezionali, Phabricator sta diventando sempre più popolare nella comunità del software open source.

In questo articolo, ti mostrerò come installare Phabricator su un'istanza del server Vultr CentOS 7.

Prerequisiti

• Distribuire da zero un'istanza del server Vultr CentOS 7;
• Accedere dal terminale SSH utilizzando un utente sudo non root.

Passaggio 1: aggiornamento del sistema

Aggiorna il tuo sistema CentOS 7, quindi riavvia:

yum update -y && shutdown -r now

Dopo l'avvio del sistema, accedere come utente non root con accesso sudo.

Passaggio 2: installare MariaDB

Installa il server MariaDB:

sudo yum install mariadb mariadb-server

Avviare e abilitare il servizio MariaDB:

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

Per motivi di sicurezza, eseguire l'utilità di installazione sicura MySQL:

sudo /usr/bin/mysql_secure_installation

Termina questo processo secondo le istruzioni seguenti:

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

Passaggio 3: installare Apache

Installa il web server Apache usando YUM:

sudo yum install httpd

Modifica la configurazione predefinita per migliorare la sicurezza:

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

Avviare e abilitare il servizio Apache:

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

Passaggio 4: installa PHP

Installa PHP e le estensioni necessarie:

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

Passaggio 5: installare git

sudo yum install git

Passaggio 6: scaricare e installare 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

Passaggio 7: installare un host virtuale per Phabricator

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

Popolare il seguente segmento di codice:

Nota: È necessario sostituire [email protected], phabricator.example.com, www.phabricator.example.com, /var/log/httpd/phabricator.example.com-error_log, e /var/log/httpd/phabricator.example.com-access_logcon i propri valori.

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

Salva ed esci:

:wq

Riavvia il servizio Apache per rendere effettive le modifiche:

sudo systemctl restart httpd.service

Passaggio 8: configurare le credenziali MariaDB per Phabricator

Prima di poter utilizzare Phabricator, è necessario impostare le credenziali di 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>

Popola schemi di Phabricator:

./bin/storage upgrade

Durante questo processo, devi inserire "y" due volte:

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

Passaggio 9: modifica le regole del firewall e imposta un account amministratore Phabricator

Devi consentire il traffico in entrata sulla porta HTTP 80 predefinita:

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

Quindi utilizzare il browser Web per visitare:

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

Ti verrà presentata la pagina web di registrazione Phabricator. Crea un account amministratore per la gestione quotidiana.

Ora diamo un'occhiata a come configurare Phabricator.

Passaggio 10: risolvere i problemi di installazione non risolti

Prima di poter utilizzare Phabricator in tutta tranquillità, è necessario risolvere diversi problemi di installazione. Il numero di problemi di installazione varia, nel mio caso, c'erano 16. Risolviamoli uno per uno.

Problema 1: URI di base non configurato

Fare clic sul collegamento "URI di base non configurato" per accedere alla pagina dei dettagli del problema in cui è possibile ottenere ulteriori informazioni su questo problema.

Per risolvere questo problema, è necessario eseguire i seguenti comandi sul terminale SSH. Assicurati di utilizzare l'indirizzo IP corretto.

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

Quindi, nel browser Web, fai clic sul pulsante "Ricarica pagina" nella pagina dei dettagli del problema. Se la riparazione ha funzionato, il testo nella pagina diventerà "Problema risolto". Fai clic sul link "Ritorna all'elenco dei numeri aperti" per esaminare altri problemi.

Problema 2: nessun provider di autenticazione configurato

Fare clic sul collegamento "Nessun provider di autenticazione configurato" per accedere alla pagina dei dettagli del problema.

Per risolvere questo problema, è necessario specificare il provider di autenticazione.

Fai clic sul link "Applicazione Auth" e quindi sul pulsante "+ Aggiungi provider" per accedere alla pagina "Aggiungi provider Auth". Scegliere un provider di autenticazione appropriato, quindi fare clic sul pulsante "Continua". Qui ho scelto "Nome utente / Password".

Nella pagina "Aggiungi provider di autenticazione: nome utente / password" è possibile rivedere impostazioni più dettagliate, quindi fare clic sul pulsante "Aggiungi provider".

Puoi aggiungere altri provider di autenticazione allo stesso modo, ma per ora fai clic sul link "Hai problemi di installazione X non risolti ..." per gestire altri problemi.

Problema 3: i demoni Phabricator non sono in esecuzione

Fai clic sul link "I demoni Phabricator non sono in esecuzione" per accedere alla pagina dei dettagli.

Per risolvere questo problema, eseguire il comando seguente sul terminale SSH:

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

Fai clic sul pulsante "Ricarica pagina" per confermare il risultato.

Problema 4: PHP post_max_sizenon configurato

Esegui i seguenti comandi sul tuo terminale SSH per risolvere questo problema:

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

Fai clic sul pulsante "Ricarica pagina" per confermare le modifiche.

Problema 5-10: problemi relativi a MySQL

Ci sono sei problemi relativi a MySQL in totale:

• Piccolo " pacchetto massimo consentito " di MySQL
• MySQL STRICT ALL TABLES Modalità non impostata
• MySQL utilizza il file di parole d'ordine predefinito
• MySQL utilizza la lunghezza minima della parola predefinita
• MySQL utilizza la sintassi booleana predefinita
• MySQL può funzionare lentamente

Per comodità, ripariamoli in un batch.

Sul tuo terminale SSH, modifica il file di configurazione di MySQL con vi:

sudo vi /etc/my.cnf

Sotto le tre linee in alto:

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

Aggiungi le sei righe seguenti:

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

Avvertenza: è necessario impostare le dimensioni corrette del pool di buffer Innodb in base alle dimensioni del server specifico. Di solito, la dimensione del pool di buffer Innodb dovrebbe essere circa il 40% della quantità di memoria della macchina. Ad esempio, se si utilizza un computer con memoria 4G, la dimensione ragionevole del pool buffer Innodb sarebbe 1600M. Nel caso in cui si stia utilizzando una macchina con poca memoria (come 768 M), potrebbe essere necessario assegnare una dimensione inferiore al 40% della quantità di memoria della macchina (ad esempio 220 M) per risparmiare più memoria per il sistema.

Salva ed esci:

:wq

Riavvia il servizio MariaDB:

sudo systemctl restart mariadb.service

Infine, esegui il comando seguente:

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

Fai clic sul pulsante "Ricarica pagina" per esaminare i tuoi sforzi.

Problema 11: installa Pygments per migliorare l'evidenziazione della sintassi

Su CentOS 7, Pygments è stato installato ma non abilitato per impostazione predefinita, è necessario abilitarlo manualmente:

Fare clic sul collegamento: modificare "pygments.enabled", scegliere "Usa pigmenti" dal menu a discesa "Valore database", quindi fare clic sul pulsante "Salva voce di configurazione".

Problema 12: fuso orario del server non configurato

Modifica il php.inifile:

sudo vi /etc/php.ini

Sostituisci la linea:

;date.timezone =

Con:

date.timezone = America/Los_Angeles

Salva ed esci:

:wq

Nota: "America / Los_Angeles" è il valore fuso orario della mia macchina, è necessario trovare il valore di fuso orario appropriato per la propria istanza del server qui .

Riavvia il servizio Apache:

sudo systemctl restart httpd.service

Fai clic sul pulsante "Ricarica pagina" per esaminare il risultato.

Problema 13: archiviazione file di grandi dimensioni non configurata

È necessario distribuire un'adeguata soluzione di archiviazione di file di grandi dimensioni in base alle proprie impostazioni. Per ora, è possibile fare clic sul pulsante "Ignora problema di installazione" per saltare.

Problema 14: dominio file alternativo non configurato

Supponi di aver impostato un dominio di file alternativo o un CDN, quindi nel terminale SSH:

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

Fai clic sul pulsante "Ricarica pagina" per esaminare il risultato.

Problema 15: percorso locale del repository mancante

Utilizzare i comandi seguenti per risolvere questo problema:

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

Fai clic sul pulsante "Ricarica pagina" per esaminare il risultato.

Problema 16: estensione PHP 'APC' non installata

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

Durante il processo di installazione di APC, premere sempre Invio per utilizzare l'opzione predefinita.

sudo vi /etc/php.ini

Aggiungi le quattro righe alla fine del file:

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

Salva ed esci:

:wq

Riavvia il servizio Apache:

sudo systemctl restart httpd.service

Fai clic sul pulsante "Ricarica pagina" per verificare il risultato.

È tutto. Buona programmazione!