resumen: Laravel Toolkit es una extensión gratuita de Plesk que puede usar para simplificar tareas rutinarias relacionadas con el hosting aplicaciones Laravel.

En este tema detallaremos cómo cargar, configurar y ejecutar aplicaciones Laravel en Plesk. Tenga en cuenta que damos por sentado que ya tiene su aplicación lista o bien tiene previsto crear una nueva. Esto no es una guía sobre cómo crear aplicaciones Laravel.

Requisitos mínimos

Antes de poder alojar aplicaciones Laravel, la extensión Laravel Toolkit gratuita debe estar instalada en el servidor Plesk:

Una vez instalada la extensión, ya puede empezar. Verá el botón Laravel en el cajón a la izquierda de la pantalla, así como el botón Instalar aplicación Laravel en las tarjetas de dominio de todos sus dominios.

laravel drawer

laravel domain card install

Carga de su aplicación

Antes de poder configurar y ejecutar su aplicación, deberá cargarla al servidor Plesk y registrarla en Laravel Toolkit. Puede hacerlo de las siguientes formas:

  • Creando un esqueleto de Laravel. Si su aplicación se almacena en una carpeta o archivo comprimido de su equipo o si desea crear su aplicación desde cero, Laravel Toolkit puede crear la estructura de directorios requerida, así como un repositorio Git local.
  • Procediendo con la instalación desde un repositorio Git remoto. Si su aplicación se almacena en un repositorio remoto, puede desplegarla en el servidor Plesk.
  • Detectando una aplicación existente. Si ya ha cargado su aplicación a Plesk, puede registrarla en Laravel Toolkit procediendo con su detección.

Nota: Para crear un esqueleto de Laravel o llevar a cabo una instalación desde un repositorio Git remoto es necesario que la extensión Git esté instalada en el servidor Plesk.

Creación de un esqueleto de Laravel

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, busque el dominio que alojará su aplicación y haga clic en Instalar aplicación Laravel.
  3. Seleccione «Instalar esqueleto» y haga clic en Instalar aplicación.
  4. Una vez instalado el esqueleto deberá cargar los archivos de su aplicación a Plesk (por ejemplo, mediante FTP o el Administrador de archivos), reemplazando los archivos predeterminados como es necesario.

Instalación mediante un repositorio Git

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, busque el dominio que alojará su aplicación y haga clic en Instalar aplicación Laravel.
  3. Seleccione «Instalar mediante un repositorio remoto».
  4. Introduzca o pegue la URL del repositorio remoto que contiene los archivos de su aplicación.
  5. Si el repositorio remoto requiere autenticación, añada la clave pública que puede ver en esta página al repositorio.
  6. Haga clic en Instalar aplicación.

Detección de una aplicación existente

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, encuentre el dominio que alojará su aplicación y abra la pestaña «Hosting y DNS».
  3. Haga clic en Configuración de hosting.
  4. Cambie el valor de «Raíz de documentos» para que coincida con la ruta al directorio público de su aplicación (que por defecto es /httpdocs/public) y haga clic en ACEPTAR.
  5. Haga clic en Instalar aplicación Laravel, haga clic en Cancelar y en Analizar.

Una vez haya cargado o desplegado los archivos de su aplicación y la aplicación se haya registrado en Laravel Toolkit, el botón Instalar aplicación Laravel se reemplaza por el botón Administrar aplicación Laravel para el dominio que aloja su aplicación.

laravel domain card manage

Ahora puede ir al próximo paso.

Ejecución de comandos de Node.js, Artisan y Composer

Para ejecutar su aplicación Laravel, probablemente deberá ejecutar comandos de Artisan, Composer y/o Node.js. Laravel Toolkit simplifica su ejecución mediante la interfaz de Plesk sin necesidad de acceso al shell.

Si no está seguro sobre si necesita ejecutar algún comando de Artisan, Composer y/o Node.js para que su aplicación funcione correctamente, consúlteselo a la persona o empresa que le proporcionó la aplicación.

Nota: Para poder ejecutar comandos de Node.js, es necesario haber instalado la extensión gratuita Node.js en el servidor Plesk.

laravel run commands

Ejecución de un comando Artisan, Composer o Node.js

  1. Acceso a Plesk.

  2. Vaya a Sitios web y dominios, encuentre el dominio que aloja su aplicación y haga clic en Administrar aplicación Laravel.

  3. Vaya a la pestaña correspondiente, introduzca el comando que desea ejecutar o seleccione un comando de la lista y presione la tecla Enter o bien haga clic en el botón laravel run button.

    Nota: Cuando se ejecutan comandos de Node.js, es posible que deba indicar una versión concreta de Node.js y/o un administrador de paquetes para que el comando tenga el efecto deseado. Si no está seguro sobre lo que escoger, consúlteselo a la persona o empresa que le proporcionó la aplicación.

Visualización de los archivos de registro de su aplicación

Mientras está en ejecución, su aplicación Laravel escribe su registro en un archivo de registro independiente. Puede ver el contenido de dicho archivo directamente mediante la interfaz de Laravel para así simplificar la monitorización de su aplicación y la resolución de cualquier incidencia.

laravel view logs

Visualización del registro de su aplicación

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, encuentre el dominio que aloja su aplicación y haga clic en Administrar aplicación Laravel.
  3. Haga clic en Registros.

Esto hará que se abra el explorador de registros del dominio, que solo mostrará las entradas de registro del registro de Laravel.

Visualización de las tareas programadas de su aplicación

Laravel le permite programar tareas en el código de la aplicación en vez de usar un programador externo, como puede ser cron. Con Laravel Toolkit puede ver todas las tareas programadas configuradas directamente desde la interfaz de Laravel Toolkit, así como activar o desactivar tareas programadas de Laravel.

Nota: No es posible añadir, eliminar o editar tareas programadas de Laravel desde la interfaz de Laravel Toolkit. Descubra cómo programar tareas en el código de la aplicación

laravel view scheduled tasks

Visualización de las tareas programadas de su aplicación

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, encuentre el dominio que aloja su aplicación y haga clic en Administrar aplicación Laravel.
  3. Vaya a la pestaña «Tareas programadas» (esta solo es visible cuando se ha configurado un mínimo de una tarea programada).

Nota: Para poder activar o desactivar las tareas programadas de su aplicación, primero es necesario llevar a cabo una operación, que varía en función de si está ejecutando Plesk para Linux o Plesk para Windows. Deberá efectuarla para cada dominio que aloje una aplicación Laravel cuyas tareas programadas desee ejecutar.

Activación de la gestión de tareas programadas en Plesk para Linux

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, encuentre el dominio que aloja su aplicación, vaya a la pestaña «Hosting y DNS» y haga clic en Acceso a hosting web.
  3. Debajo de «Acceder al servidor vía SSH», seleccione cualquier opción que no sea «Prohibido» y haga clic en ACEPTAR.

Activación de la gestión de tareas programadas en Plesk para Windows

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios y localice el dominio que aloja su aplicación.
  3. Debajo de «Cuenta», haga clic en Personalizar.
  4. Vaya a la pestaña «Permisos», seleccione la casilla al lado de «Administración de tareas programadas» y haga clic en Actualizar y bloquear.

Ahora puede activar o desactivar las tareas programadas de su aplicación.

Activación de las tareas programadas de su aplicación

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, encuentre el dominio que aloja su aplicación y haga clic en Administrar aplicación Laravel.
  3. Haga clic en el botón de alternancia Tareas programadas para que muestre «Activado».

Ahora las tareas programadas están activadas para su aplicación Laravel.

Edición de variables de entorno

Es posible que su aplicación necesite una o más variables de entorno personalizadas para poderse ejecutar correctamente o bien que cambie su comportamiento en función de las variables de entorno establecidas. Si no está seguro sobre si su aplicación necesita cualquier variable de entorno para ejecutarse correctamente, consúlteselo a la persona o empresa que le proporcionó la aplicación.

Edición de variables de entorno

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, encuentre el dominio que aloja su aplicación y haga clic en Administrar aplicación Laravel.
  3. Haga clic en el botón Editar al lado de «Variables de entorno (.env)».
  4. Edite las variables de entorno y haga clic en Actualizar.

Ahora se aplican las variables de entorno actualizadas.

Cómo pasar su aplicación al modo de mantenimiento

Con el fin de impedir que los visitantes de un sitio web vean errores cuando usted esté usando o actualizando su aplicación, puede poner la aplicación en modo de mantenimiento. Mientras su aplicación se encuentra en este modo, los visitantes del sitio verán una página que muestra el error «503 SERVICE UNAVAILABLE».

Cómo pasar su aplicación al modo de mantenimiento

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, encuentre el dominio que aloja su aplicación y haga clic en Administrar aplicación Laravel.
  3. Haga clic en el botón de alternancia Modo de mantenimiento para que muestre «Activado».

Ahora, su aplicación Laravel se encuentra en modo de mantenimiento.

Nota: No olvide sacar su aplicación de este modo una vez ya no necesite usar o actualizar la aplicación.

Actualización de su aplicación

Tanto si los archivos de su aplicación Laravel se almacenan en un repositorio Git local como si se almacenan en un repositorio remoto, debe cerciorarse de que los cambios efectuados en el código de la aplicación se propagan al servidor Plesk. Puede escoger entre desplegar los cambios de forma manual o bien hacerlo de forma automática.

Si necesita disponer de un control preciso cuando se actualice su aplicación, le recomendamos actualizarla de forma manual. De esta forma, los cambios efectuados en el código de la aplicación en el repositorio no se propagarán al servidor Plesk hasta que desee hacerlo. El inconveniente de este enfoque es que debe llevar a cabo acciones manuales cada vez que deba actualizarse la aplicación.

Actualización manual de su aplicación

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, encuentre el dominio que aloja su aplicación y haga clic en Administrar aplicación Laravel.
  3. Vaya a la pestaña «Despliegue» y, debajo de «Modo de despliegue», seleccione el botón de opción «Manual».
  4. Debajo de «Escenario de despliegue», deseleccione las casillas correspondientes a los pasos que no desea efectuar durante el despliegue y haga clic en Desplegar.

Una vez efectuados todos los pasos de despliegue de Laravel Toolkit, se actualizará su aplicación y sus dependencias.

Si desea que los cambios efectuados en el código de la aplicación se propaguen al servidor Plesk de forma automática, el método varía en función de si el código de la aplicación se almacena en un repositorio Git local o remoto.

Actualización automática de su aplicación (repositorio local)

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, encuentre el dominio que aloja su aplicación y haga clic en Administrar aplicación Laravel.
  3. Vaya a la pestaña «Despliegue» y, debajo de «Modo de despliegue», seleccione el botón de opción «Automático».
  4. Debajo de «Escenario de despliegue», deseleccione las casillas correspondientes a los pasos que no desea ejecutar durante el despliegue.

Now, every time a commit is pushed to the master branch of the local repository storing the application’s code, your application and its dependencies will be updated.

Actualización automática de su aplicación (repositorio remoto)

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, encuentre el dominio que aloja su aplicación y haga clic en Administrar aplicación Laravel.
  3. Copie la URL del webhook que ve aquí y añádalo al repositorio remoto. Si desea conocer las instrucciones específicas, consulte la documentación del proveedor de su repositorio.
  4. Vaya a la pestaña «Despliegue» y, debajo de «Modo de despliegue», seleccione el botón de opción «Automático».
  5. Debajo de «Escenario de despliegue», deseleccione las casillas correspondientes a los pasos que no desea ejecutar durante el despliegue.

Ahora, cada vez que suceda el evento que desencadena el webhook en el repositorio remoto que almacena el código de la aplicación, se actualizará su aplicación y sus dependencias.

Configuración de un script de despliegue

Es posible que su aplicación requiera que en el servidor se ejecuten determinados comandos durante el despliegue para un correcto funcionamiento. Para evitar la ejecución manual de los comandos, puede configurar un script de despliegue que se ejecutará cada vez que se actualice la aplicación.

Si no está seguro sobre si su aplicación requiere de la ejecución de algún comando durante el despliegue para un correcto funcionamiento, consúlteselo a la persona o empresa que le proporcionó la aplicación.

Nota: En Plesk para Linux es necesario activar el acceso SSH para poder editar el script de despliegue mediante la interfaz de Laravel Toolkit. Esta acción solo debe realizarse una vez.

Activación de la habilidad para editar el script de despliegue en Plesk para Linux

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, encuentre el dominio que aloja su aplicación, vaya a la pestaña «Hosting y DNS» y haga clic en Acceso a hosting web.
  3. Debajo de «Acceder al servidor vía SSH», seleccione cualquier opción que no sea «Prohibido» y haga clic en ACEPTAR.

Ahora puede editar el script de despliegue mediante la interfaz de Laravel Toolkit.

Edición del script de despliegue

  1. Acceso a Plesk.
  2. Vaya a Sitios web y dominios, encuentre el dominio que aloja su aplicación y haga clic en Administrar aplicación Laravel.
  3. Vaya a la pestaña «Despliegue» y haga clic en Editar script.
  4. Introduzca o pegue su script de despliegue y haga clic en Actualizar.

Ahora el script de despliegue ya es efectivo y se ejecutará cada vez que actualice su aplicación.