Cómo instalar y configurar Phabricator en CentOS 7

• Prerrequisitos
• Paso 1: actualización del sistema
• Paso 2: instalar MariaDB
• Paso 3: instala Apache
• Paso 4: instalar PHP
• Paso 5: instala git
• Paso 6: descargue e instale Phabricator
• Paso 7: configurar un host virtual para Phabricator
• Paso 8: Configurar las credenciales MariaDB para Phabricator
• Paso 9: modifique las reglas del firewall y configure una cuenta de administrador de Phabricator
• Paso 10: solucione los problemas de configuración no resueltos

Phabricator es una plataforma avanzada de desarrollo de software de código abierto que se puede utilizar para:

• Código de revisión y auditoría.
• Host Git / Hg / SVN repos.
• Seguimiento de errores.
• Gestionar proyectos.
• Comunicarse con los miembros del equipo.
• ¡Y haz mucho más!

Gracias a sus abundantes características y rendimiento excepcional, Phabricator se está volviendo cada vez más popular en la comunidad de software de código abierto.

En este artículo, le mostraré cómo instalar Phabricator en una instancia de servidor Vultr CentOS 7.

Prerrequisitos

• Implemente una instancia de servidor Vultr CentOS 7 desde cero;
• Inicie sesión desde el terminal SSH utilizando un usuario de sudo no root.

Paso 1: actualización del sistema

Actualice su sistema CentOS 7, luego reinicie:

yum update -y && shutdown -r now

Después de que se inicie el sistema, inicie sesión como usuario no root con acceso a sudo.

Paso 2: instalar MariaDB

Instale el servidor MariaDB:

sudo yum install mariadb mariadb-server

Inicie y habilite el servicio MariaDB:

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

Por razones de seguridad, ejecute la utilidad de instalación segura MySQL:

sudo /usr/bin/mysql_secure_installation

Termine este proceso de acuerdo con las instrucciones a continuación:

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

Paso 3: instala Apache

Instale el servidor web Apache usando YUM:

sudo yum install httpd

Modifique la configuración predeterminada para mejorar la seguridad:

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

Inicie y habilite el servicio Apache:

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

Paso 4: instalar PHP

Instale PHP y las extensiones necesarias:

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

Paso 5: instala git

sudo yum install git

Paso 6: descargue e instale 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

Paso 7: configurar un host virtual para Phabricator

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

Rellene el siguiente segmento de código:

Nota: Es necesario sustituir [email protected], phabricator.example.com, www.phabricator.example.com, /var/log/httpd/phabricator.example.com-error_log, y /var/log/httpd/phabricator.example.com-access_logcon sus propios valores.

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

Guardar y Salir:

:wq

Reinicie el servicio Apache para que sus modificaciones surtan efecto:

sudo systemctl restart httpd.service

Paso 8: Configurar las credenciales MariaDB para Phabricator

Antes de poder utilizar Phabricator, debe configurar las credenciales de 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>

Completar esquemas de Phabricator:

./bin/storage upgrade

Durante este proceso, debe ingresar "y" dos veces:

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

Paso 9: modifique las reglas del firewall y configure una cuenta de administrador de Phabricator

Debe permitir el tráfico entrante en el puerto HTTP 80 predeterminado:

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

Luego use su navegador web para visitar:

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

Se le presentará la página web de registro de Phabricator. Cree una cuenta de administrador para la gestión diaria.

Ahora, echemos un vistazo a cómo configurar Phabricator.

Paso 10: solucione los problemas de configuración no resueltos

Antes de poder usar Phabricator con tranquilidad, debe solucionar varios problemas de configuración. El número de problemas de configuración varía, en mi caso, fueron 16. Resolvamos uno por uno.

Problema 1: URI base no configurado

Haga clic en el enlace "URI base no configurado" para acceder a la página de detalles del problema en la que puede obtener más información sobre este problema.

Para solucionar este problema, debe ejecutar los siguientes comandos en su terminal SSH. Asegúrese de usar la dirección IP correcta.

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

Luego, en su navegador web, haga clic en el botón "Recargar página" en la página de detalles del problema. Si su reparación funcionó, el texto en la página se convertirá en "Problema resuelto". Haga clic en el enlace "Volver a la lista de problemas abiertos" para investigar otros problemas.

Problema 2: no se configuraron proveedores de autenticación

Haga clic en el enlace "No se han configurado proveedores de autenticación" para acceder a la página de detalles del problema.

Para solucionar este problema, debe especificar el proveedor de autenticación.

Haga clic en el enlace "Aplicación de autenticación" y luego en el botón "+ Agregar proveedor" para acceder a la página "Agregar proveedor de autenticación". Elija un proveedor de autenticación apropiado y luego haga clic en el botón "Continuar". Aquí elegí "Nombre de usuario / Contraseña".

En la página "Agregar proveedor de autenticación: nombre de usuario / contraseña", puede revisar configuraciones más detalladas y luego hacer clic en el botón "Agregar proveedor".

Puede agregar más proveedores de autenticación de la misma manera, pero por ahora, haga clic en el enlace "Tiene X problemas de configuración no resueltos ..." para manejar otros problemas.

Problema 3: los demonios Phabricator no se están ejecutando

Haga clic en el enlace "Los demonios de Phabricator no se están ejecutando" para ingresar a la página de detalles.

Para resolver este problema, ejecute el siguiente comando en su terminal SSH:

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

Haga clic en el botón "Recargar página" para confirmar el resultado.

Problema 4: PHP post_max_sizeno configurado

Ejecute los siguientes comandos en su terminal SSH para solucionar este problema:

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

Haga clic en el botón "Recargar página" para confirmar sus modificaciones.

Problema 5-10: problemas relacionados con MySQL

Hay seis problemas relacionados con MySQL en total:

• Pequeño " paquete máximo permitido " de MySQL
• MySQL ESTRICTA TODAS LAS TABLAS Modo no establecido
• MySQL está utilizando el archivo de palabra de parada predeterminado
• MySQL está utilizando la longitud mínima de palabra predeterminada
• MySQL está utilizando la sintaxis booleana predeterminada
• MySQL puede ejecutarse lentamente

Por conveniencia, reparémoslos en un lote.

En su terminal SSH, edite el archivo de configuración de MySQL con vi:

sudo vi /etc/my.cnf

Debajo de las tres líneas en la parte superior:

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

Agregue las seis líneas a continuación:

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

Advertencia: debe establecer un tamaño de agrupación de almacenamiento intermedio Innodb adecuado según el tamaño de su servidor específico. Por lo general, el tamaño de la agrupación de almacenamiento intermedio de Innodb debe ser aproximadamente el 40% de la cantidad de memoria de su máquina. Por ejemplo, si está utilizando una máquina con memoria 4G, el tamaño razonable de la agrupación de almacenamiento intermedio de Innodb sería 1600M. En caso de que esté utilizando una máquina con poca memoria (como 768M), es posible que deba asignar un tamaño inferior al 40% de la cantidad de memoria de su máquina (por ejemplo, 220M) para ahorrar más memoria para el sistema.

Guardar y Salir:

:wq

Reinicie el servicio MariaDB:

sudo systemctl restart mariadb.service

Finalmente, ejecute el siguiente comando:

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

Haga clic en el botón "Recargar página" para examinar sus esfuerzos.

Problema 11: Instale Pygments para mejorar el resaltado de sintaxis

En CentOS 7, Pygments se ha instalado pero no está habilitado de forma predeterminada, debe habilitarlo manualmente:

Haga clic en el enlace: Edite "pygments.enabled", elija "Usar Pygments" en el menú desplegable "Valor de la base de datos", luego haga clic en el botón "Guardar entrada de configuración".

Problema 12: zona horaria del servidor no configurada

Modificar el php.iniarchivo:

sudo vi /etc/php.ini

Reemplace la línea:

;date.timezone =

Con:

date.timezone = America/Los_Angeles

Guardar y Salir:

:wq

Nota: "América / Los_Angeles" es el valor de zona horaria de mi máquina, es necesario encontrar el valor de zona horaria correspondiente a su propia instancia del servidor aquí .

Reinicie el servicio Apache:

sudo systemctl restart httpd.service

Haga clic en el botón "Recargar página" para examinar el resultado.

Problema 13: almacenamiento de archivos grandes no configurado

Debe implementar una solución adecuada de almacenamiento de archivos grandes de acuerdo con su propia configuración. Por ahora, puede hacer clic en el botón "Ignorar problema de configuración" para omitir.

Problema 14: dominio de archivo alternativo no configurado

Supongamos que ha configurado un dominio de archivo alternativo o un CDN, luego en el terminal SSH:

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

Haga clic en el botón "Recargar página" para examinar el resultado.

Problema 15: Ruta local del repositorio faltante

Use los siguientes comandos para resolver este problema:

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

Haga clic en el botón "Recargar página" para examinar el resultado.

Problema 16: la extensión PHP 'APC' no está instalada

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

Durante el proceso de instalación de APC, siempre presione Entrar para usar la opción predeterminada.

sudo vi /etc/php.ini

Agregue las cuatro líneas al final del archivo:

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

Guardar y Salir:

:wq

Reinicie el servicio Apache:

sudo systemctl restart httpd.service

Haga clic en el botón "Recargar página" para verificar el resultado.

Eso es todo. ¡Feliz codificación!