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_log
con 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_size
non 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.ini
file:
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!