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

CakePHP es un marco MVC de código abierto para PHP. En este tutorial, se explica paso a paso cómo se genera un proyecto de CakePHP, cómo se implementa en un entorno de Elastic Beanstalk y cómo se configura para conectarlo a una instancia de base de datos de 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 10, puede instalar Windows Subsystem para Linux para obtener una versión de Ubuntu y Bash integrada con Windows.

CakePHP 4 requiere PHP 7.2 o posterior. También requiere las extensiones de PHP enumeradas en la documentación oficial de instalación de CakePHP . Siga las instrucciones del tema Configuración del entorno de desarrollo de PHP para instalar PHP y Composer.

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.

Para lanzar un entorno (consola)

1. Abra la consola de Elastic Beanstalk mediante este enlace preconfigurado: console.aws.amazon.com/elasticbeanstalk/home#/ newApplication?applicationName=Tutorials &EnvironmentType= LoadBalanced

2. En Platform (Plataforma), seleccione la plataforma y la ramificación de plataforma que coincidan con el idioma utilizado por la aplicación.

3. En Application code (Código de aplicación), seleccione Sample application (Aplicación de muestra).

4. Elija Review and launch (Revisar y lanzar).

5. Revise las opciones disponibles. Elija la opción disponible que quiera usar y, cuando esté listo, elija Create app (Crear aplicación).

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

• Instancia de EC2: una máquina virtual de Amazon Elastic Compute Cloud (Amazon EC2) configurada para ejecutar aplicaciones web en la plataforma que elija.

  Cada plataforma ejecuta un conjunto específico de software, archivos de configuración y scripts compatibles con una determinada versión de lenguaje, marco de trabajo y contenedor web (o una combinación de estos). La mayoría de las plataformas utilizan Apache o nginx como un proxy inverso que se sitúa delante de la aplicación web, reenvía las solicitudes a esta, administra los recursos estáticos y genera registros de acceso y errores.

• Instance security group (Grupo de seguridad de la instancia): grupo de seguridad de Amazon EC2 configurado para permitir el tráfico entrante en el puerto 80. Este recurso permite que el tráfico HTTP procedente del balanceador de carga llegue a la instancia EC2 en la que se ejecuta la aplicación web. De forma predeterminada, el tráfico no está permitido en otros puertos.

• Balanceador de carga: balanceador de carga de Elastic Load Balancing configurado para distribuir solicitudes a las instancias que se ejecutan en la aplicación. Los balanceadores de carga también permiten que las instancias no estén expuestas directamente a Internet.

• Grupo de seguridad del balanceador de carga: grupo de seguridad de Amazon EC2 configurado para permitir el tráfico entrante en el puerto 80. Este recurso permite que el tráfico HTTP procedente de Internet llegue al balanceador de carga. De forma predeterminada, el tráfico no está permitido en otros puertos.

• Grupo de Auto Scaling: grupo de Auto Scaling configurado para reemplazar una instancia si termina o deja de estar disponible.

• Bucket de Amazon S3: ubicación de almacenamiento para el código fuente, los registros y otros artefactos que se crean al utilizar Elastic Beanstalk.

• CloudWatch Alarmas de Amazon: dos CloudWatch alarmas que monitorean la carga de las instancias de su entorno y que se activan si la carga es demasiado alta o demasiado baja. Cuando se activa una alarma, en respuesta, el grupo de Auto Scaling aumenta o reduce los recursos.

• AWS CloudFormation pila: Elastic AWS CloudFormation Beanstalk se utiliza para lanzar los recursos de su entorno y propagar los cambios de configuración. Los recursos se definen en una plantilla que puede verse en la consola deAWS CloudFormation.

• Nombre de dominio: nombre de dominio que direcciona el tráfico a la aplicación web con el formato subdominio.región.elasticbeanstalk.com.

  nota

  Para aumentar la seguridad de las aplicaciones de Elastic Beanstalk, el dominio elasticbeanstalk.com está registrado en la lista de sufijos públicos (PSL). Para mayor seguridad, se recomienda que utilice cookies con un prefijo __Host- en caso de que necesite configurar cookies confidenciales en el nombre de dominio predeterminado de sus aplicaciones de Elastic Beanstalk. Esta práctica le ayudará a defender su dominio contra intentos de falsificación de solicitudes entre sitios (CSRF). Para obtener más información, consulte la página de configuración de cookies en la red de desarrolladores de Mozilla.

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

nota

El bucket de Amazon S3 que Elastic Beanstalk crea se comparte entre los entornos y no se elimina durante la terminación del entorno. Para obtener más información, consulte Usar Elastic Beanstalk con Amazon S3.

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

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

~$ composer create-project --prefer-dist cakephp/app eb-cake

Composer instala CakePHP y unas 20 dependencias, y genera un proyecto predeterminado.

Si tiene algún problema al instalar CakePHP, visite el tema de instalación en la documentación oficial: http://book.cakephp.org/4.0/en/installation.html

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 cake-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-cake zip ../cake-default.zip -r * .[^.]* -x "vendor/*"

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

Para implementar un paquete de código fuente

1. Abra la consola de Elastic Beanstalk y, en la lista Regiones, seleccione su. Región de AWS

2. En el panel de navegación, elija Environments (Entornos) y, a continuación, elija el nombre del entorno en la lista.

   nota

   Si tiene muchos entornos, utilice la barra de búsqueda para filtrar la lista de entornos.

3. En la página de información general del entorno, elija Upload and deploy (Cargar e implementar).

4. Utilice el cuadro de diálogo en pantalla para cargar el paquete de código fuente.

5. Elija Deploy (Implementar).

6. Cuando se complete la implementación, seleccione la URL del para abrir el sitio web en una nueva pestaña.

nota

Para optimizar aun más el paquete de código fuente, inicialice un repositorio Git y use el comando git archive para crear el paquete de código fuente. El proyecto Symfony predeterminado incluye un archivo .gitignore que indica a Git que debe excluir la carpeta vendor y los demás archivos que no se requieren para la implementación.

Cuando el proceso se complete, haga clic en la URL para abrir su aplicación CakePHP en el navegador.

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

Agregar una base de datos al entorno

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

Para agregar una instancia de base de datos de Amazon RDS a su entorno de Elastic Beanstalk

1. Abra la consola de Elastic Beanstalk y, en la lista Regiones, seleccione su. Región de AWS

2. En el panel de navegación, elija Environments (Entornos) y, a continuación, elija el nombre del entorno en la lista.

   nota

   Si tiene muchos entornos, utilice la barra de búsqueda para filtrar la lista de entornos.

3. En el panel de navegación, elija Configuration (Configuración).

4. En Database (Base de datos), elija Edit (Editar).

5. En DB engine (Motor de base de datos), seleccione postgres.

6. Escriba un nombre de usuario y contraseña maestros. Elastic Beanstalk proporcionará estos valores a la aplicación a través de propiedades de entorno.

7. Para guardar los cambios, elija Aplicar en la parte inferior de la página.

Se tarda alrededor de 10 minutos en crear una instancia de base de datos. 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 CakePHP se encuentra en un archivo llamado app.php de la carpeta config del proyecto de código. Abra este archivo y agregue código que permita leer las variables de entorno de $_SERVER y las asigne a variables locales. Inserte las líneas resaltadas en el siguiente ejemplo, detrás de la primera línea (<?php):

ejemplo ~/Eb-cake/config/app.php

<?php
if (!defined('RDS_HOSTNAME')) {
  define('RDS_HOSTNAME', $_SERVER['RDS_HOSTNAME']);
  define('RDS_USERNAME', $_SERVER['RDS_USERNAME']);
  define('RDS_PASSWORD', $_SERVER['RDS_PASSWORD']);
  define('RDS_DB_NAME', $_SERVER['RDS_DB_NAME']);
}
return [
...

La conexión de la base de datos está configurada más adelante en el archivo app.php. Busque la sección siguiente y modifique la configuración predeterminada de las fuentes de datos con el nombre del controlador que corresponda al motor de base de datos (Mysql, Sqlserver o Postgres) y configure las variables host, username, password y database para que lean los valores correspondientes en Elastic Beanstalk:

ejemplo ~/Eb-cake/config/app.php

...
     /**
     * Connection information used by the ORM to connect
     * to your application's datastores.
     * Drivers include Mysql Postgres Sqlite Sqlserver
     * See vendor\cakephp\cakephp\src\Database\Driver for complete list
     */
    'Datasources' => [
        'default' => [
            'className' => 'Cake\Database\Connection',
            'driver' => 'Cake\Database\Driver\Postgres',
            'persistent' => false,
            'host' => RDS_HOSTNAME,
            /*
             * CakePHP will use the default DB port based on the driver selected
             * MySQL on MAMP uses port 8889, MAMP users will want to uncomment
             * the following line and set the port accordingly
             */
            //'port' => 'non_standard_port_number',
            'username' => RDS_USERNAME,
            'password' => RDS_PASSWORD,
            'database' => RDS_DB_NAME,
            /*
             * You do not need to set this flag to use full utf-8 encoding (internal default since CakePHP 3.6).
             */
            //'encoding' => 'utf8mb4',
            'timezone' => 'UTC',
            'flags' => [],
            'cacheMetadata' => true,
            'log' => false,
...

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

Para actualizar su entorno de Elastic Beanstalk

1. Cree un nuevo paquete de código fuente:

   ~/eb-cake$ zip ../cake-v2-rds.zip -r * .[^.]* -x "vendor/*"

2. Abra la consola de Elastic Beanstalk y, en la lista Regiones, seleccione su. Región de AWS

3. En el panel de navegación, elija Environments (Entornos) y, a continuación, elija el nombre del entorno en la lista.

   nota

   Si tiene muchos entornos, utilice la barra de búsqueda para filtrar la lista de entornos.

4. Elija Upload and Deploy (Cargar e implementar).

5. Seleccione Browse (Examinar) y cargue cake-v2-rds.zip.

6. Seleccione Implementar.

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 AWS cancela todos los recursos asociados al entorno, como las instancias de Amazon EC2, las instancias de bases de datos, los balanceadoresde carga, los grupos de seguridad y las alarmas.

Para terminar su entorno de Elastic Beanstalk

1. Abra la consola de Elastic Beanstalk y, en la lista Regiones, seleccione su. Región de AWS

2. En el panel de navegación, elija Environments (Entornos) y, a continuación, elija el nombre del entorno en la lista.

   nota

   Si tiene muchos entornos, utilice la barra de búsqueda para filtrar la lista de entornos.

3. Elija Actions (Acciones) y, a continuación, Terminate Environment (Terminar el entorno).

4. Utilice el cuadro de diálogo en pantalla para confirmar la terminación del entorno.

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.

Para terminar la instancia de base de datos de RDS

1. Abra la consola de Amazon RDS.

2. Seleccione Databases (Bases de datos).

3. Seleccione la instancia de base de datos.

4. Elija Acciones y, a continuación, elija Eliminar.

5. Decida si desea crear una instantánea y seleccione Delete (Eliminar).

Siguientes pasos

Para obtener más información sobre CakePHP, consulte el libro en book.cakephp.org.

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 (EB CLI easy-to-use ) proporciona comandos para crear, configurar e implementar aplicaciones en entornos de Elastic Beanstalk desde la línea de comandos.

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 Agregar una instancia de base de datos de Amazon RDS a un entorno de aplicaciones PHP 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.