Implantar uma aplicação rails no Elastic Beanstalk

Rails é uma framework MVC (controlador de visualização de modelo) de código aberto para Ruby. Este tutorial explica o processo de criação de uma aplicação Rails e sua implantação em um ambiente do AWS Elastic Beanstalk.

Pré-requisitos

Conhecimento básico do Elastic Beanstalk

Este tutorial pressupõe que você tenha conhecimento das operações básicas e do console do Elastic Beanstalk. Caso ainda não tenha, siga as instruções em Introdução ao Elastic Beanstalk para iniciar seu primeiro ambiente do Elastic Beanstalk.

Linha de comando

Para seguir os procedimentos neste manual, você precisa de um terminal de linha de comando ou de um shell para executar os comandos. Nas listagens, os comandos são mostrados precedidos por um símbolo de prompt ($) e pelo nome do diretório atual, quando apropriado.

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

No Linux e no macOS, você pode usar seu gerenciador de pacotes e de shell preferido. No Windows, você pode instalar o subsistema Windows para Linux para obter uma versão do Ubuntu e Bash integrada ao Windows.

Dependências do rails

O framework Rails 6.1.4.1 tem as dependências a seguir. Certifique-se de que você tem todas elas instaladas.

Iniciar um ambiente do Elastic Beanstalk

Use o console do Elastic Beanstalk para criar um ambiente do Elastic Beanstalk. Escolha a configuração da Plataforma Ruby e aceite as configurações padrão e o código de exemplo.

A criação de ambiente leva cerca de 5 minutos e cria os seguintes recursos:

Todos esses recursos são gerenciados pelo Elastic Beanstalk. Quando você encerra o ambiente, o Elastic Beanstalk encerra todos os recursos dele.

Instalar o rails e gerar um site

Instale o Rails e suas dependências com o 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
...

Teste a instalação do Rails.

~$ rails --version
Rails 6.1.4.1

Use rails new com o nome do aplicativo para criar um novo projeto Rails.

~$ rails new ~/eb-rails

O Rails cria um diretório com o nome especificado, gera todos os arquivos necessários para executar um projeto de exemplo localmente e, em seguida, executa o bundler para instalar todas as dependências (Gems) definidas no Gemfile do projeto.

Teste a instalação do Rails executando o projeto padrão 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 em um navegador da web para ver o projeto padrão em ação.

Essa página só está visível em modo de desenvolvimento. Adicione algum conteúdo à página inicial da aplicação para oferecer suporte à implantação de produção no Elastic Beanstalk. Use rails generate para criar um controlador, uma rota e uma visualização de sua página de boas-vindas.

~/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.

Isso fornece tudo o que você precisa para acessar a página na /welcome_page/welcome. No entanto, antes de publicar as alterações, altere o conteúdo na visualização e adicione uma rota para que essa página apareça no nível superior do site.

Use um editor de texto para editar o conteúdo em app/views/welcome_page/welcome.html.erb. Para este exemplo, você usará cat para simplesmente substituir o conteúdo do arquivo existente.

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

Por fim, adicione a seguinte rota a config/routes.rb:

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

Isso instrui o Rails a rotear as solicitações à raiz do site para o método de boas-vindas do controlador da página de boas-vindas, que renderiza o conteúdo na visualização de boas-vindas (welcome.html.erb).

Para que o Elastic Beanstalk implante com sucesso a aplicação na plataforma Ruby, precisamos atualizar o Gemfile.lock. Algumas dependências do Gemfile.lock talvez sejam específicas da plataforma. Portanto, precisamos adicionar platform ruby a Gemfile.lock para que todas as dependências necessárias sejam instaladas com a implantação.

~/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

Definir as configurações do rails

Use o console do Elastic Beanstalk para configurar o Rails com propriedades do ambiente. Defina a propriedade do ambiente SECRET_KEY_BASE para uma string de até 256 caracteres alfanuméricos.

O Rails usa essa propriedade para criar chaves. Portanto, você deve mantê-la em segredo e não armazená-la no controle de origem em texto sem formatação. Em vez disso, você a fornece ao código do Rails no ambiente por meio de uma propriedade de ambiente.

Agora você está pronto para implantar o site no ambiente.

Implantar o aplicativo

Crie um pacote de origem com os arquivos criados pelo Rails. O comando a seguir cria um pacote de origem chamado rails-default.zip.

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

Faça upload do pacote de origem no Elastic Beanstalk para implantar o Rails no ambiente.

Limpeza

Ao terminar de trabalhar com o Elastic Beanstalk, você pode encerrar o ambiente. O Elastic Beanstalk termina todos os recursos da AWS associados ao seu ambiente, como instâncias do Amazon EC2, instâncias de banco de dados, balanceadores de carga, grupos de segurança e alarmes.

Com o Elastic Beanstalk, é possível criar facilmente um ambiente para a aplicação a qualquer momento.

Próximas etapas

Para obter mais informações sobre o Rails, visite rubyonrails.org.

À medida que você desenvolva a aplicação, provavelmente vai precisar de uma maneira de gerenciar ambientes e implantá-la sem criar manualmente um arquivo .zip e carregá-la no console do Elastic Beanstalk. A Interface de Linhas de Comando do Elastic Beanstalk (CLI do EB) oferece comandos fáceis de usar para criar, configurar e implantar aplicações em ambientes do Elastic Beanstalk na linha de comando.

Por fim, se você planeja usar seu aplicativo em um ambiente de produção, configure um nome de domínio personalizado para seu ambiente e habilite HTTPS para conexões seguras.