Com instal·lar DreamFactory Open Source a CentOS 7

DreamFactory és un programa de codi obert que pot convertir qualsevol base de dades en una plataforma d'API RESTful.

DreamFactory es pot desplegar en diverses plataformes. En aquest article, instal·larem DreamFactory Open Source Edition en un servidor CentOS 7.

Requisits previs

• Una instància de servidor CentOS 7 x64.
• Un usuari de sudo .

Pas 1: actualitzeu el sistema

Inicieu sessió al vostre sistema com a usuari sudo des d'un terminal SSH i, a continuació, actualitzeu el sistema de la següent manera:

sudo yum install epel-release -y
sudo yum update -y
sudo shutdown -r now

Pas 2: instal·leu Apache

Tal com requereix DreamFactory, heu d'instal·lar el servidor web Apache mitjançant YUM:

sudo yum install httpd -y

Elimina la pàgina de benvinguda d'Apache predeterminada:

sudo sed -i 's/^/#&/g' /etc/httpd/conf.d/welcome.conf

Desactiveu el directori públic i la llista de fitxers d'Apache:

sudo sed -i "s/Options Indexes FollowSymLinks/Options FollowSymLinks/" /etc/httpd/conf/httpd.conf

Inicieu el servei Apache i activeu-lo a l'arrencada del sistema:

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

Pas 3: instal·leu MariaDB

Per a aquest tutorial, utilitzarem MariaDB 10.1 com el servidor de bases de dades que utilitzarà DreamFactory.

3.1 Configura el dipòsit MariaDB 10.1 YUM

Utilitzeu el segment de codi següent per crear el dipòsit MariaDB 10.1 YUM:

cat <<EOF | sudo tee -a /etc/yum.repos.d/MariaDB.repo
# MariaDB 10.1 CentOS repository list - created 2017-01-14 03:11 UTC
# http://downloads.mariadb.org/mariadb/repositories/
[mariadb]
name = MariaDB
baseurl = http://yum.mariadb.org/10.1/centos7-amd64
gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
gpgcheck=1
EOF

3.2 Instal·leu MariaDB 10.1 mitjançant YUM

sudo yum install MariaDB-server MariaDB-client -y

3.3 Inicieu i activeu el servei MariaDB

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

3.4 Assegureu la instal·lació de MariaDB

sudo /usr/bin/mysql_secure_installation

Contesteu les preguntes de la següent manera i assegureu-vos d'introduir la vostra pròpia contrasenya d'arrel de MariaDB.

• Introduïu la contrasenya actual per a root (introduïu-ne cap): només heu de prémer el Enterbotó
• Definiu la contrasenya d'arrel? [S/n]:Y
• Nova contrasenya: <your-password>
• Torneu a introduir la contrasenya nova: <your-password>
• Vols suprimir usuaris anònims? [S/n]:Y
• No permeteu l'inici de sessió d'arrel de forma remota? [S/n]:Y
• Eliminar la base de dades de prova i accedir-hi? [S/n]:Y
• Torneu a carregar les taules de privilegis ara? [S/n]:Y

3.5 Crear una base de dades MariaDB per a DreamFactory

Inicieu sessió al shell de MySQL com a root:

mysql -u root -p

Introduïu la contrasenya d'arrel de MariaDB que heu establert al pas 3.4 per iniciar la sessió.

A l'intèrpret d'ordres de MySQL, creeu una base de dades dreamfactory, un usuari de la base de dades dreamfactoryuseri la seva contrasenya de la yourpasswordmanera següent.

Nota: per motius de seguretat, HEU de substituir els tres paràmetres de mostra esmentats anteriorment pels vostres.

CREATE DATABASE dreamfactory;
CREATE USER 'dreamfactoryuser'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON dreamfactory.* TO 'dreamfactoryuser'@'localhost' IDENTIFIED BY 'yourpassword' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;

Pas 4: instal·leu PHP 7.x i Composer

4.1 Instal·leu PHP 7.1 i les extensions necessàries

A CentOS 7, podeu instal·lar PHP 7.1 i les extensions PHP necessàries mitjançant el dipòsit Webtatic YUM:

sudo rpm -Uvh https://mirror.webtatic.com/yum/el7/webtatic-release.rpm
sudo yum install mod_php71w php71w-common php71w-cli php71w-gd php71w-mbstring php71w-mcrypt php71w-xml php71w-mysqlnd php71w-pecl-mongodb -y

4.2 Instal·leu Composer

Instal·leu la darrera versió de Composer, que es troba 1.3.1en el moment d'escriure, com a continuació.

Nota: les instruccions anteriors poden canviar en cas que Composer actualitzi les seves instruccions d'instal·lació. Per tant, sempre hauríeu de consultar la pàgina oficial de descàrrega de Composer per obtenir les instruccions d'instal·lació més actualitzades.

cd
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '55d6ead61b29c7bdee5cccfb50076874187bd9f21f65d8991d46ec5cc90518f447387fb9f76ebae1fbbacf329e583e30') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

4.3 Fer que Composer estigui disponible a nivell mundial

sudo mv composer.phar /usr/local/bin/composer

Pas 5: instal·leu Git i DreamFactory

5.1 Instal·leu Git

sudo yum install git -y

5.2 Instal·leu DreamFactory

Baixeu la darrera versió estable de DreamFactory, que és 2.4.2en el moment en què es va escriure aquest article, després instal·leu DreamFactory i les dependències de la següent manera:

cd
wget https://github.com/dreamfactorysoftware/dreamfactory/archive/2.4.2.tar.gz
tar -zxvf 2.4.2.tar.gz
cd dreamfactory-2.4.2
composer install --no-dev
sudo mv ~/dreamfactory-2.4.2 /opt
sudo chown -R root:root /opt/dreamfactory-2.4.2
sudo chown -R apache:apache /opt/dreamfactory-2.4.2/storage/ /opt/dreamfactory-2.4.2/bootstrap/cache/
sudo chmod -R 2775 /opt/dreamfactory-2.4.2/storage/ /opt/dreamfactory-2.4.2/bootstrap/cache/
cd /opt/dreamfactory-2.4.2

Utilitzeu l'ordre següent per crear un .envfitxer per emmagatzemar les configuracions de DreamFactory:

sudo php artisan dreamfactory:setup

Quan se us demani, introduïu la configuració de la base de dades de la següent manera:

  Which database would you like to use for system tables? [sqlite]:
  [0] sqlite
  [1] mysql
  [2] pgsql
  [3] sqlsrv
 > 1

 Enter your mysql Host:
 > localhost

 Enter your database name:
 > dreamfactory

 Enter your database username:
 > dreamfactoryuser

 Enter your database password:
 > yourpassword

 Re-enter your database password:
 > yourpassword

 Enter your Database Port [3306]:
 > 3306

Torneu a executar la mateixa ordre per configurar el primer usuari administrador:

sudo php artisan dreamfactory:setup

Quan se us demani, introduïu les credencials de la manera següent:

Creating the first admin user...

 Enter your first name:
 > John

 Enter your last name:
 > Doe

 Enter display name:
 > John Doe

 Enter your email address?:
 > admin@example.com

 Choose a password:
 > <your-admin-password>

 Re-enter password:
  > <your-admin-password>

5.3 Prepareu-vos per accedir a la web

Configureu un amfitrió virtual per a DreamFactory. Utilitzeu el segment de codi següent per configurar un host virtual. Recordeu reemplaçar els valors de ServerAdmin, ServerName, ServerAlias, Errorlog, i CustomLogamb els seus propis.

cat <<EOF | sudo tee -a /etc/httpd/conf.d/dreamfactory.conf
<VirtualHost *:80>
ServerAdmin admin@example.com
DocumentRoot /opt/dreamfactory-2.4.2/public/
ServerName dreamfactory.example.com
ServerAlias www.dreamfactory.example.com
<Directory /opt/dreamfactory-2.4.2/public/>
Options FollowSymLinks
AllowOverride All
AllowOverride None
Require all granted
RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^.*$ /index.php [L]
<LimitExcept GET HEAD PUT DELETE PATCH POST>
    Allow from all
</LimitExcept>
</Directory>
ErrorLog /var/log/httpd/dreamfactory.example.com-error_log
CustomLog /var/log/httpd/dreamfactory.example.com-access_log common
</VirtualHost>
EOF

Poseu les vostres modificacions en vigor reiniciant el servei Apache:

sudo systemctl restart httpd.service

Modifiqueu les regles del tallafoc per permetre l'accés web:

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

Pas 6: accediu a DreamFactory

Apunteu el vostre navegador web http://203.0.113.1per accedir a DreamFactory i, a continuació, utilitzeu l'adreça de correu electrònic de l'administrador i la contrasenya que heu establert anteriorment per iniciar la sessió.

Això conclou el nostre tutorial. Gràcies per llegir.