Adicionar uma instância de banco de dados do Amazon RDS ao ambiente de aplicações Ruby

É possível usar uma instância de banco de dados do Amazon Relational Database Service (Amazon RDS) para armazenar dados coletados e modificados pela aplicação. O banco de dados pode ser acoplado ao seu ambiente e gerenciado pelo Elastic Beanstalk ou pode ser criado como desacoplado e gerenciado externamente por outro serviço. Este tópico fornece instruções para criar o Amazon RDS usando o console do Elastic Beanstalk. O banco de dados será acoplado ao ambiente e gerenciado pelo Elastic Beanstalk. Para obter mais informações sobre como integrar um Amazon RDS com o Elastic Beanstalk, consulte Adição de um banco de dados ao seu ambiente do Elastic Beanstalk.

Adicionar uma instância de banco de dados ao seu ambiente

Para adicionar uma instância de banco de dados ao ambiente

1. Abra o console do Elastic Beanstalk e, na lista Regions (Regiões), selecione a sua Região da AWS.

2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

   nota

   Se você tiver muitos ambientes, use a barra de pesquisa para filtrar a lista de ambientes.

3. No painel de navegação, escolha Configuration (Configuração).

4. Na categoria de configuração Database (Banco de dados), escolha Edit (Editar).

5. Escolha um mecanismo de banco de dados e insira um nome de usuário e senha.

6. Para salvar as alterações, escolha Apply (Aplicar) na parte inferior da página.

A adição de uma instância de banco de dados leva cerca de 10 minutos. Quando a atualização do ambiente for concluída, o nome de host da instância de banco de dados e outras informações de conexão estarão disponíveis para o seu aplicativo por meio das seguintes propriedades de ambiente:

Nome da propriedade	Descrição	Valor da propriedade
RDS_HOSTNAME	O nome do host da instância de banco de dados.	Na guia Connectivity & security (Conectividade e segurança) no console do Amazon RDS: Endpoint.
RDS_PORT	A porta na qual a instância de banco de dados aceita conexões. O valor padrão varia entre os mecanismos de banco de dados.	Na guia Connectivity & security (Conectividade e segurança) do console do Amazon RDS: Port (Porta).
RDS_DB_NAME	O nome do banco de dado, ebdb.	Na guia Configuration (Configuração) no console do Amazon RDS: DB Name (Nome do banco de dados).
RDS_USERNAME	O nome de usuário que você configurou para seu banco de dados.	Na guia Configuration (Configuração) do console do Amazon RDS: Nome de usuário primário.
RDS_PASSWORD	A senha que você configurou para seu banco de dados.	Não disponível para referência no console do Amazon RDS.

Para obter mais informações sobre como configurar uma instância de banco de dados acoplada a um ambiente Elastic Beanstalk, consulte Adição de um banco de dados ao seu ambiente do Elastic Beanstalk.

Download de adaptador

Adicione o adaptador de banco de dados ao arquivo de gem de seu projeto.

exemplo Gemfile: Rails com o MySQL

source 'https://rubygems.org'
gem 'puma'
gem 'rails', '~> 6.1.4', '>= 6.1.4.1'
gem 'mysql2'

Gems de adaptadores comuns para Ruby

• MySQL – mysql2

• PostgreSQL – pg

• Oracle: activerecord-oracle_enhanced-adapter

• SQL Server – activerecord-sqlserver-adapter

Conectar-se a um banco de dados

O Elastic Beanstalk fornece informações de conexão referentes às instâncias de banco de dados associadas nas propriedades de ambiente. Use ENV['VARIABLE'] para ler as propriedades e configurar uma conexão de banco de dados.

exemplo config/database.yml: configuração do banco de dados de Ruby on Rails (MySQL)

production:
  adapter: mysql2
  encoding: utf8
  database: <%= ENV['RDS_DB_NAME'] %>
  username: <%= ENV['RDS_USERNAME'] %>
  password: <%= ENV['RDS_PASSWORD'] %>
  host: <%= ENV['RDS_HOSTNAME'] %>
  port: <%= ENV['RDS_PORT'] %>