Implementación de una aplicación de Laravel en Elastic Beanstalk

Laravel es un marco de controlador de vista de modelos (MVC) de código abierto de PHP. Este tutorial lo guía en el proceso de generación de una aplicación de Laravel, su implementación en un entorno de AWS Elastic Beanstalk y su configuración para conectarse a una instancia de base de datos de Amazon Relational Database Service (Amazon RDS).

Requisitos previos

Este tutorial asume que tiene conocimiento de las operaciones básicas de Elastic Beanstalk y de la consola de Elastic Beanstalk. Si aún no lo ha hecho, siga las instrucciones que se indican en Introducción a Elastic Beanstalk para lanzar su primer entorno de Elastic Beanstalk.

Para seguir los procedimientos de esta guía, necesitará un shell o un terminal de línea de comando donde pueda ejecutar los comandos. Los comandos aparecen en listas y van precedidos del símbolo del sistema ($) y del nombre del directorio actual, si es aplicable.

~/eb-project$ this is a command
this is output

En Linux y macOS, puede utilizar el administrador de shell y paquetes preferido. En Windows, puede instalar Windows Subsystem para Linux para obtener una versión de Ubuntu y Bash integrada con Windows.

Laravel 6 requiere PHP 7.2 o posterior. También requiere las extensiones de PHP enumeradas en el tema requisitos del servidor en la documentación oficial de Laravel. Siga las instrucciones del tema Configuración del entorno de desarrollo de PHP para Elastic Beanstalk para instalar PHP y Composer.

Para obtener información sobre soporte y mantenimiento de Laravel, consulte el tema de la política de soporte en la documentación oficial de Laravel.

Lance un entorno de Elastic Beanstalk

Utilice la consola de Elastic Beanstalk para crear un entorno de Elastic Beanstalk. Elija la plataforma PHP y acepte la configuración predeterminada y el código de muestra.

El entorno tarda unos cinco minutos en crearse e incluye los recursos siguientes:

Todos estos recursos los administra Elastic Beanstalk. Cuando termina su entorno, Elastic Beanstalk termina todos los recursos que este contiene.

Instalación de Laravel y creación de un sitio web

Composer puede instalar Laravel y crear un proyecto de trabajo con un único comando:

~$ composer create-project --prefer-dist laravel/laravel eb-laravel

Composer instala Laravel y sus dependencias, y genera un proyecto predeterminado.

Si tiene algún problema al instalar Laravel, vaya al tema de instalación en la documentación oficial: https://laravel.com/docs/6.x.

Implementar la aplicación

Cree un paquete de código fuente que contenga los archivos creados por Composer. El comando siguiente crea un paquete de código fuente denominado laravel-default.zip. Excluye los archivos de la carpeta vendor, que ocupan mucho espacio y no se requieren para implementar la aplicación en Elastic Beanstalk.

~/eb-laravel$ zip ../laravel-default.zip -r * .[^.]* -x "vendor/*"

Cargue el paquete de origen en Elastic Beanstalk para implementar Laravel en su entorno.

Configuración de los ajustes de Composer

Cuando la implementación se complete, haga clic en la URL para abrir la aplicación de Laravel en el navegador:

¿Qué es esto? De forma predeterminada, Elastic Beanstalk proporciona la raíz del proyecto en la ruta raíz del sitio web. En este caso, sin embargo, la página predeterminada (index.php) está un nivel por debajo de la carpeta public. Puede comprobarlo agregando /public a la URL. Por ejemplo, http://laravel.us-east-2.elasticbeanstalk.com/public.

Para que la aplicación Laravel esté disponible en la ruta raíz, utilice la consola Elastic Beanstalk con el fin de configurar la raíz del documento del el sitio web.

Hasta el momento, todo fue bien. A continuación, debe agregar una base de datos al entorno y configurar Laravel para que se conecte a ella.

Agregar una base de datos al entorno

Inicie una instancia de base de datos de RDS en su entorno de Elastic Beanstalk. Puede utilizar bases de datos de MySQL, SQLServer o PostgreSQL con Laravel en Elastic Beanstalk. En este ejemplo, utilizaremos MySQL.

Se tarda alrededor de 10 minutos en crear una instancia de base de datos. Para obtener más información sobre las bases de datos acopladas a un entorno de Elastic Beanstalk, consulte Añadir una base de datos al entorno de Elastic Beanstalk.

Mientras tanto, puede actualizar el código fuente para que pueda leer la información de conexión del entorno. Elastic Beanstalk proporciona la información de la conexión a través de variables de entorno, como RDS_HOSTNAME, a las que puede obtener acceso desde la aplicación.

La configuración de base de datos de Laravel se guarda en un archivo llamado database.php en la carpeta config del proyecto de código. Busque la entrada mysql y modifique las variables host, database, username y and password de forma que lean los valores correspondientes en Elastic Beanstalk:

...
    'connections' => [

        'sqlite' => [
            'driver' => 'sqlite',
            'database' => env('DB_DATABASE', database_path('database.sqlite')),
            'prefix' => '',
        ],

        'mysql' => [
            'driver' => 'mysql',
            'host' => env('RDS_HOSTNAME', '127.0.0.1'),
            'port' => env('RDS_PORT', '3306'),
            'database' => env('RDS_DB_NAME', 'forge'),
            'username' => env('RDS_USERNAME', 'forge'),
            'password' => env('RDS_PASSWORD', ''),
            'unix_socket' => env('DB_SOCKET', ''),
            'charset' => 'utf8mb4',
            'collation' => 'utf8mb4_unicode_ci',
            'prefix' => '',
            'strict' => true,
            'engine' => null,
        ],
...

Para comprobar que la conexión de la base de datos está configurada correctamente, agregue código a index.php para conectarse a la base de datos y también para la respuesta predeterminada:

...
if(DB::connection()->getDatabaseName())
{
   echo "Connected to database ".DB::connection()->getDatabaseName();
}
$response->send();
...

Cuando finalice el lanzamiento de la instancia de base de datos, empaquete e implemente la aplicación actualizada en el entorno.

La implementación de una nueva versión de la aplicación tarda menos de un minuto. Cuando se haya completado, actualice la página web de nuevo para comprobar que la conexión con la base de datos es correcta:

Limpieza

Cuando termine de trabajar con Elastic Beanstalk, puede terminar su entorno. Elastic Beanstalk termina todos los recursos de AWS asociados al entorno, tales como las instancias de Amazon EC2, las instancias de base de datos, los equilibradores de carga, los grupos de seguridad y las alarmas.

Con Elastic Beanstalk, puede crear fácilmente un nuevo entorno para su aplicación en cualquier momento.

Además, puede terminar los recursos de base de datos creados fuera del entorno de Elastic Beanstalk. Cuando termine una instancia de base de datos de Amazon RDS, puede hacer una instantánea para restaurar los datos posteriormente en otra instancia.

Siguientes pasos

Para obtener más información sobre Laravel, visite el sitio web oficial de Laravel en laravel.com.

A medida que siga desarrollando la aplicación, es probable que desee contar con un mecanismo que le permita administrar los entornos e implementar la aplicación sin tener que crear manualmente un archivo .zip y cargarlo en la consola de Elastic Beanstalk. La interfaz de línea de comandos de Elastic Beanstalk (CLI de EB) proporciona comandos fáciles de usar para crear, configurar e implementar aplicaciones en entornos de Elastic Beanstalk desde la línea de comandos.

En este tutorial, ha utilizado la consola de Elastic Beanstalk para configurar las opciones de Composer. Para integrar esta configuración en el código fuente de la aplicación, puede utilizar un archivo de configuración similar al siguiente.

option_settings:
  aws:elasticbeanstalk:container:php:phpini:
    document_root: /public

Para obtener más información, consulte Personalización avanzada de entornos con archivos de configuración (.ebextensions).

Ejecutar una instancia de base de datos de Amazon RDS; en el entorno de Elastic Beanstalk es ideal para desarrollo y pruebas, pero supedita el ciclo de vida de la base de datos al entorno. Consulte Adición de una instancia de base de datos de Amazon RDS a su entorno de PHP Elastic Beanstalk para obtener instrucciones acerca de cómo conectarse a una base de datos que se ejecute fuera del entorno.

Por último, si pretende utilizar la aplicación en un entorno de producción, querrá configurar un nombre de dominio personalizado para el entorno y habilitar HTTPS para las conexiones seguras.