Script para hacer deploy de una aplicación Laravel usando Laravel Envoy

En este artículo te voy a mostrar como hacer deploy de tu aplicación Laravel en un VPS usando Laravel Envoy, es más sencillo de lo que piensas. 😎

Ok, para iniciar debes tener en cuenta que vas a necesitar ciertos conocimientos de administración de servidores pero no te preocupes que solo necesitas saber como instalar paquetes dentro de tu VPS.

#Lo que vas hacer es:

• Loguarte dentro de tu VPS, haciendo ssh.
• Dentro de tu VPS vas a instalar GIT sudo apt get install git (o con el gestor de paquetería de tu servidor, aca asumo que estás usando ubuntu)
• Luego de instalar git tienes que clonar tu proyecto en un directorio específico. Yo te recomendaria clonar el proyecto dentro del directorio home de tu usuario en el VPS, creando una estructura parecida a esta: /home/USUARIO_VPS/project

Luego de esto lo único que tienes que hacer es ingresar a tu proyecto y hacer todo lo necesario para instalar las dependencias (composer) y hacer las configuraciones para la base de datos y todo lo que necesites.

En este punto, si sigues mi recomendación de clonar el proyecto en tu directorio home el siguiente paso es cambiar el path del directorio root en el archivo de configuración de tu servidor web, nuevamente asumiendo que usas NGINX el cambio lo debes hacer en la siguiente línea

 1server {
 2    listen 80;
 3    listen [::]:80;
 4    server_name example.com;
 5    root /home/USUARIO_VPS/project/public; 
 6
 7    add_header X-Frame-Options "SAMEORIGIN";
 8    add_header X-Content-Type-Options "nosniff";
 9
10    // ...
11}

#En tu proyecto

Vas a instalar envoy como una dependencia de desarrollo de la siguiente forma:

1composer require laravel/envoy --dev

Luego de esto, debes crear un archivo Envoy.blade.php donde vas a incluir la siguiente información:

 1@servers(['main' => ['user@host_ip']])
 2 
 3@task('deploy', ['on' => 'main'])
 4    cd /home/USUARIO_VPS/project
 5    php artisan down
 6    git pull origin master
 7    composer install --optimize-autoloader --no-interaction --no-plugins --no-scripts --no-dev
 8    php artisan migrate --force
 9    php artisan cache:clear
10    php artisan config:cache
11    php artisan view:cache
12    composer dumpautoload -o
13    php artisan up
14@endtask

Los cambios que debes implementar son los siguientes:

• Modificar el usuario y el host ip
• Listo 🤣

Lo que hace el archivo creo que se explica solo pero por si acaso:

• Ingresa al directorio del proyecto
• Activa el modo mantenimiento
• Hace un pull a tu proveedor de control de versiones para bajar los cambios mas recientes
• Hace composer install para instalar las dependencias del proyecto (no incluye dependencias de desarrollo)
• Ejecuta las migraciones (si existe algo para migrar)
• Limpia y crea el cache
• Optimiza el autoload de composer
• Sale del modo de mantenimiento

Para ejecutar envoy puedes hacer lo siguiente:

1php vendor/bin/envoy

Espero que te sirva.