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

Rails es un marco de código abierto model-view-controller (MVC) para Ruby. Este tutorial explica el proceso de generar una aplicación de Rails y desplegarla en un AWS Elastic Beanstalk entorno.

Requisitos previos

Conocimiento básico de Elastic Beanstalk

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.

Línea de comandos

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.

Dependencias de Rails

El marco de Rails 6.1.4.1 cuenta con las siguientes dependencias. Asegúrese de que las tiene todas instaladas.

• Ruby 2.5.0 o posterior: para obtener instrucciones de instalación, consulte Configuración del entorno de desarrollo de Ruby.

  En este tutorial utilizamos Ruby 3.0.2 y la versión correspondiente de la plataforma de Elastic Beanstalk.

• Node.js: para obtener instrucciones de instalación, consulte Instalación de Node.js con un gestor de paquetes.

• Yarn: para obtener instrucciones de instalación, consulte la sección Instalación en el sitio web de Yarn.

Lance un entorno de Elastic Beanstalk

Utilice la consola de Elastic Beanstalk para crear un entorno de Elastic Beanstalk. Elija la plataforma Ruby 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 Rails y generación de un sitio web

Instale Rails y sus dependencias con el comando gem.

~$ gem install rails
Fetching: concurrent-ruby-1.1.9.gem
Successfully installed concurrent-ruby-1.1.9
Fetching: rack-2.2.3.gem
Successfully installed rack-2.2.3
...

Pruebe la instalación de Rails.

~$ rails --version
Rails 6.1.4.1

Utilice rails new con el nombre de la aplicación para crear un nuevo proyecto de Rails.

~$ rails new ~/eb-rails

Rails crea un directorio con el nombre especificado, genera todos los archivos necesarios para ejecutar localmente un proyecto de ejemplo y, a continuación, ejecuta bundler para instalar todas las dependencias (Gems) definidas en el Gemfile del proyecto.

nota

Este proceso instala la última versión de Puma para el proyecto. Esta versión puede ser diferente de la versión que Elastic Beanstalk proporciona en la versión de la plataforma Ruby de su entorno. Para ver las versiones de Puma proporcionadas por Elastic Beanstalk, consulte el Historial de la plataforma Rubyen la AWS Elastic Beanstalk Guía de plataformas. Para obtener más información acerca de la versión más reciente de Puma, consulte el sitio web de Puma.io. Si hay una discrepancia entre las dos versiones de Puma, utilice una de las opciones siguientes:

• Uso de la versión Puma instalada por el comando rails new anterior. En este caso, debe agregar un Procfile para que la plataforma utilice la versión del servidor Puma propia que usted proporcionó. Para obtener más información, consulte Configuración del proceso de la aplicación con un Procfile.

• Actualice la versión de Puma para que sea consistente con la versión preinstalada en la versión de la plataforma Ruby de su entorno. Para hacerlo, modifique la versión de Puma en Gemfile ubicada en la raíz del directorio fuente del proyecto. A continuación, ejecute bundle update. Para obtener más información, consulte la página de actualización de Bundle en el sitio web de Bundler.io.

Pruebe su instalación de Rails ejecutando el proyecto predeterminado localmente.

~$ cd eb-rails
~/eb-rails$ rails server
=> Booting Puma
=> Rails 6.1.4.1 application starting in development
=> Run `bin/rails server --help` for more startup options
Puma starting in single mode...
* Puma version: 5.5.2 (ruby 3.0.2-p107) ("Zawgyi")
*  Min threads: 5
*  Max threads: 5
*  Environment: development
*          PID: 77857
* Listening on http://127.0.0.1:3000
* Listening on http://[::1]:3000
Use Ctrl-C to stop
...

Abra http://localhost:3000 en un navegador web para ver el proyecto predeterminado en acción.

En esta página solo es visible en el modo de desarrollo. Agregue contenido a la página de inicio de la aplicación para admitir la implementación de producción en Elastic Beanstalk. Use rails generate para crear un controlador, una ruta y una vista para la página de bienvenida.

~/eb-rails$ rails generate controller WelcomePage welcome
      create  app/controllers/welcome_page_controller.rb
       route  get 'welcome_page/welcome'
      invoke  erb
      create    app/views/welcome_page
      create    app/views/welcome_page/welcome.html.erb
      invoke  test_unit
      create    test/controllers/welcome_page_controller_test.rb
      invoke  helper
      create    app/helpers/welcome_page_helper.rb
      invoke    test_unit
      invoke  assets
      invoke    coffee
      create      app/assets/javascripts/welcome_page.coffee
      invoke    scss
      create      app/assets/stylesheets/welcome_page.scss.

Con esto dispondrá de todo lo necesario para obtener acceso a la página en /welcome_page/welcome. Sin embargo, antes de publicar los cambios, cambie el contenido de la vista y añada una ruta para que esta página aparezca en el nivel superior del sitio.

Utilice un editor de texto para modificar el contenido de app/views/welcome_page/welcome.html.erb. En este ejemplo, usará cat para sobrescribir el contenido del archivo existente.

ejemplo app/views/welcome_page/welcome.html.erb

<h1>Welcome!</h1>
<p>This is the front page of my first Rails application on Elastic Beanstalk.</p>

Por último, añada la siguiente ruta a config/routes.rb:

ejemplo config/routes.rb

Rails.application.routes.draw do
  get 'welcome_page/welcome'
  root 'welcome_page#welcome'

Esto indica a Rails que dirija las solicitudes a la raíz del sitio web al método de bienvenida del controlador de la página de bienvenida, que presenta el contenido en la vista de bienvenida (welcome.html.erb).

Para que Elastic Beanstalk implemente correctamente la aplicación en la plataforma Ruby, es necesario actualizar Gemfile.lock. Es posible que algunas de las dependencias de Gemfile.lock sean específicas de la plataforma. Por lo tanto, es necesario agregar platform ruby a Gemfile.lock de modo que todas las dependencias requeridas se instalen con la implementación.

~/eb-rails$ bundle lock --add-platform ruby
Fetching gem metadata from https://rubygems.org/............
Resolving dependencies...
Writing lockfile to /Users/janedoe/EBDPT/RubyApps/eb-rails-doc-app/Gemfile.lock

Configuración de los ajustes de Rails

Utilice la consola de Elastic Beanstalk para configurar Rails con propiedades de entorno. Establezca la propiedad del entorno de SECRET_KEY_BASE en una cadena de hasta 256 caracteres alfanuméricos.

Rails utiliza esta propiedad para crear claves. Por lo tanto, debe mantenerla en secreto y no almacenarla en el control de código fuente en texto no cifrado. En su lugar, debe incorporarla al código de Rails de su entorno mediante una propiedad de entorno.

Para configurar las propiedades del entorno en la consola 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 la categoría de configuración Actualizaciones, supervisión y registro, seleccione Editar.

5. Desplácese hacia abajo hasta Propiedades del entorno.

6. Seleccione Agregar propiedad de entorno.

7. Introduzca los pares Nombre y Valor de la propiedad.

8. Si necesita agregar más variables, repita Paso 6 y Paso 7.

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

Ahora ya está listo para implementar el sitio en su entorno.

Implementar la aplicación

Cree un paquete de código fuente que contenga los archivos creados por Rails. El comando siguiente crea un paquete de código fuente denominado rails-default.zip.

~/eb-rails$ zip ../rails-default.zip -r * .[^.]*

Cargue el paquete de origen en Elastic Beanstalk para implementar Rails 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.

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.

Siguientes pasos

Para obtener más información acerca de Rails, visite rubyonrails.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.

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.