Jak zainstalować i skonfigurować Phabricator na CentOS 7

• Wymagania wstępne
• Krok 1: Aktualizacja systemu
• Krok 2: Zainstaluj MariaDB
• Krok 3: Zainstaluj Apache
• Krok 4: Zainstaluj PHP
• Krok 5: Zainstaluj git
• Krok 6: Pobierz i zainstaluj Phabricator
• Krok 7: Skonfiguruj wirtualny host dla Phabricator
• Krok 8: Skonfiguruj poświadczenia MariaDB dla Phabricator
• Krok 9: Zmodyfikuj reguły zapory i skonfiguruj konto administratora Phabricator
• Krok 10: Napraw nierozwiązane problemy z konfiguracją

Phabricator to zaawansowana platforma programistyczna typu open source, której można użyć do:

• Przejrzyj i przeprowadź audyt.
• Repozytoria hostów Git / Hg / SVN.
• Śledź błędy.
• Zarządzaj projektami.
• Komunikuj się z członkami zespołu.
• I rób znacznie więcej!

Dzięki licznym funkcjom i wyjątkowej wydajności Phabricator zyskuje coraz większą popularność w społeczności oprogramowania typu open source.

W tym artykule pokażę, jak zainstalować Phabricator na instancji serwera Vultr CentOS 7.

Wymagania wstępne

• Wdróż instancję serwera Vultr CentOS 7 od podstaw;
• Zaloguj się z terminala SSH, używając innego użytkownika niż sudo.

Krok 1: Aktualizacja systemu

Zaktualizuj system CentOS 7, a następnie uruchom ponownie:

yum update -y && shutdown -r now

Po uruchomieniu systemu zaloguj się jako użytkownik inny niż root z dostępem sudo.

Krok 2: Zainstaluj MariaDB

Zainstaluj serwer MariaDB:

sudo yum install mariadb mariadb-server

Uruchom i włącz usługę MariaDB:

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

Ze względów bezpieczeństwa uruchom narzędzie do bezpiecznej instalacji MySQL:

sudo /usr/bin/mysql_secure_installation

Zakończ ten proces zgodnie z poniższymi instrukcjami:

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

Krok 3: Zainstaluj Apache

Zainstaluj serwer WWW Apache za pomocą YUM:

sudo yum install httpd

Zmodyfikuj domyślną konfigurację, aby zwiększyć bezpieczeństwo:

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

Uruchom i włącz usługę Apache:

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

Krok 4: Zainstaluj PHP

Zainstaluj PHP i niezbędne rozszerzenia:

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

Krok 5: Zainstaluj git

sudo yum install git

Krok 6: Pobierz i zainstaluj 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

Krok 7: Skonfiguruj wirtualny host dla Phabricator

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

Wypełnij następujący segment kodu:

Uwaga: Należy zastąpić [email protected], phabricator.example.com, www.phabricator.example.com, /var/log/httpd/phabricator.example.com-error_log, i /var/log/httpd/phabricator.example.com-access_logwłasnymi wartościami.

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

Zapisz i wyjdź:

:wq

Zrestartuj usługę Apache, aby wprowadzić zmiany:

sudo systemctl restart httpd.service

Krok 8: Skonfiguruj poświadczenia MariaDB dla Phabricator

Aby móc korzystać z Phabricatora, musisz skonfigurować poświadczenia 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>

Wypełnij schematy Phabricator:

./bin/storage upgrade

Podczas tego procesu musisz dwukrotnie wpisać „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

Krok 9: Zmodyfikuj reguły zapory i skonfiguruj konto administratora Phabricator

Musisz zezwolić na ruch przychodzący na domyślnym porcie HTTP 80:

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

Następnie użyj przeglądarki internetowej, aby odwiedzić:

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

Zostanie wyświetlona strona internetowa rejestracji Phabricator. Utwórz konto administratora do codziennego zarządzania.

Teraz przyjrzyjmy się, jak skonfigurować Phabricator.

Krok 10: Napraw nierozwiązane problemy z konfiguracją

Aby móc używać Phabricatora bez obaw, musisz rozwiązać kilka problemów z konfiguracją. Liczba problemów z konfiguracją jest różna, w moim przypadku było ich 16. Rozwiążmy je jeden po drugim.

Problem 1: Nie skonfigurowano podstawowego identyfikatora URI

Kliknij link „Podstawowy identyfikator URI nieskonfigurowany”, aby przejść do strony szczegółów problemu, na której możesz dowiedzieć się więcej o tym problemie.

Aby rozwiązać ten problem, musisz wykonać następujące polecenia na terminalu SSH. Pamiętaj, aby użyć właściwego adresu IP.

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

Następnie w przeglądarce internetowej kliknij przycisk „Przeładuj stronę” na stronie szczegółów problemu. Jeśli naprawa zadziałała, tekst na stronie zmieni się na „Problem rozwiązany”. Kliknij link „Powrót do listy otwartych problemów”, aby zbadać inne problemy.

Problem 2: Brak skonfigurowanych dostawców uwierzytelniania

Kliknij link „Brak skonfigurowanych dostawców uwierzytelniania”, aby przejść do strony szczegółów problemu.

Aby rozwiązać ten problem, musisz określić dostawcę uwierzytelnienia.

Kliknij link „Auth Application”, a następnie przycisk „+ Add Provider”, aby przejść do strony „Add Auth Provider”. Wybierz odpowiedniego dostawcę uwierzytelnienia, a następnie kliknij przycisk „Kontynuuj”. Tutaj wybrałem „Nazwa użytkownika / Hasło”.

Na stronie „Dodaj dostawcę: nazwa użytkownika / hasło” możesz przejrzeć bardziej szczegółowe ustawienia, a następnie kliknąć przycisk „Dodaj dostawcę”.

Możesz dodać więcej dostawców uwierzytelniania w ten sam sposób, ale na razie kliknij link „Masz X nierozwiązanych problemów z konfiguracją ...”, aby poradzić sobie z innymi problemami.

Problem 3: Demony fabrykatora nie działają

Kliknij link „Demony Phabricator nie działają”, aby przejść do strony szczegółów.

Aby rozwiązać ten problem, uruchom poniższe polecenie na terminalu SSH:

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

Kliknij przycisk „Załaduj ponownie stronę”, aby potwierdzić wynik.

Problem 4: PHP post_max_sizenieskonfigurowany

Uruchom następujące polecenia na terminalu SSH, aby rozwiązać ten problem:

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

Kliknij przycisk „Załaduj ponownie stronę”, aby potwierdzić zmiany.

Problem 5-10: Problemy związane z MySQL

Istnieje łącznie sześć problemów związanych z MySQL:

• Mały MySQL „max dozwolony pakiet”
• MySQL STRICT ALL TABLES Nie ustawiono trybu
• MySQL używa domyślnego pliku Stopword
• MySQL używa domyślnej minimalnej długości słowa
• MySQL używa domyślnej składni logicznej
• MySQL może działać wolno

Dla wygody naprawmy je w jednej partii.

Na terminalu SSH edytuj plik konfiguracyjny MySQL za pomocą vi:

sudo vi /etc/my.cnf

Pod trzema liniami u góry:

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

Dodaj sześć wierszy poniżej:

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

Ostrzeżenie: Musisz ustawić odpowiedni rozmiar puli buforów Innodb zgodnie z konkretnym rozmiarem serwera. Zwykle wielkość puli buforów Innodb powinna wynosić około 40% ilości pamięci komputera. Na przykład, jeśli używasz komputera z pamięcią 4G, rozsądna wielkość puli buforów Innodb wynosiłaby 1600M. Jeśli używasz urządzenia z małą ilością pamięci (np. 768M), może być konieczne przypisanie rozmiaru mniejszego niż 40% ilości pamięci urządzenia (powiedzmy 220M), aby zaoszczędzić więcej pamięci dla systemu.

Zapisz i wyjdź:

:wq

Uruchom ponownie usługę MariaDB:

sudo systemctl restart mariadb.service

Na koniec uruchom następujące polecenie:

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

Kliknij przycisk „Załaduj ponownie stronę”, aby sprawdzić swoje wysiłki.

Problem 11: Zainstaluj Pygments, aby poprawić podświetlanie składni

W CentOS 7 Pygments został zainstalowany, ale domyślnie nie jest włączony, musisz włączyć go ręcznie:

Kliknij link: Edytuj „pygments.enabled”, wybierz „Użyj Pygments” z menu rozwijanego „Wartość bazy danych”, a następnie kliknij przycisk „Zapisz wpis konfiguracji”.

Problem 12: Strefa czasowa serwera nie jest skonfigurowana

Zmodyfikuj php.iniplik:

sudo vi /etc/php.ini

Zamień wiersz:

;date.timezone =

Z:

date.timezone = America/Los_Angeles

Zapisz i wyjdź:

:wq

Uwaga: „Ameryka / Los_Angeles” jest wartością stref czasowych z moim komputerze, trzeba znaleźć odpowiednią wartość strefy czasowej dla własnej instancji serwera tutaj .

Uruchom ponownie usługę Apache:

sudo systemctl restart httpd.service

Kliknij przycisk „Załaduj ponownie stronę”, aby sprawdzić wynik.

Problem 13: Nie skonfigurowano przechowywania dużych plików

Musisz wdrożyć odpowiednie rozwiązanie do przechowywania dużych plików zgodnie z własnymi ustawieniami. Na razie możesz kliknąć przycisk „Ignoruj ​​problem z instalacją”, aby pominąć.

Problem 14: Nie skonfigurowano domeny alternatywnego pliku

Załóżmy, że skonfigurowałeś alternatywną domenę plików lub CDN, a następnie w terminalu SSH:

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

Kliknij przycisk „Załaduj ponownie stronę”, aby sprawdzić wynik.

Problem 15: Brak ścieżki lokalnej repozytorium

Aby rozwiązać ten problem, użyj następujących poleceń:

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

Kliknij przycisk „Załaduj ponownie stronę”, aby sprawdzić wynik.

Problem 16: Rozszerzenie PHP „APC” nie zostało zainstalowane

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

Podczas instalacji APC zawsze naciśnij Enter, aby użyć opcji domyślnej.

sudo vi /etc/php.ini

Dodaj cztery linie na końcu pliku:

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

Zapisz i wyjdź:

:wq

Uruchom ponownie usługę Apache:

sudo systemctl restart httpd.service

Kliknij przycisk „Załaduj ponownie stronę”, aby sprawdzić wynik.

To wszystko. Miłego kodowania!