AWS Elastic Beanstalk
Guia do desenvolvedor

Adição de um banco de dados ao seu ambiente Elastic Beanstalk

O Elastic Beanstalk fornece integração com o Amazon Relational Database Service (Amazon RDS) para ajudar a adicionar uma instância de banco de dados em seu ambiente do Elastic Beanstalk. Você pode usar o Elastic Beanstalk para adicionar um banco de dados MySQL, PostgreSQL, Oracle ou SQL Server ao seu ambiente durante ou após a criação do ambiente. Quando você adiciona uma instância de banco de dados ao seu ambiente, o Elastic Beanstalk fornece informações de conexão para seu aplicativo configurando as propriedades do ambiente para o nome de host do banco de dados, a porta, o nome de usuário, a senha e o nome do banco de dados.

Uma instância do banco de dados que faz parte de seu ambiente é vinculada ao ciclo de vida do seu ambiente. Você não pode removê-la do seu ambiente depois de adicioná-la. Se você encerrar o ambiente, a instância do banco de dados será encerrada também. Você pode configurar o Elastic Beanstalk para salvar um snapshot do banco de dados ao encerrar seu ambiente e restaurar um banco de dados a partir de um snapshot quando você adicionar uma instância de banco de dados a um ambiente. Pode haver cobrança do armazenamento de snapshots de banco de dados. Para obter mais informações, consulte a seção Armazenamento de backup em Definição de preço do Amazon RDS.

Para um ambiente de produção, você pode iniciar uma instância do banco de dados fora do seu ambiente e configurar seu aplicativo para se conectar a ela fora da funcionalidade fornecida pelo Elastic Beanstalk. Usar uma instância de banco de dados fora do seu ambiente exige configurações adicionais de security group e de string de conexão. No entanto, ela também permite que você se conecte ao banco de dados de vários ambientes, use tipos de bancos de dados não compatíveis com bancos de dados integrados, realize implantações azul/verde e descarte seu ambiente sem afetar a instância de banco de dados.

Adição de uma instância de banco de dados Amazon RDS ao seu ambiente

Você pode adicionar uma instância do banco de dados ao seu ambiente usando o Console do Elastic Beanstalk.

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

  1. Abra o Console do Elastic Beanstalk.

  2. Navegue até a página de gerenciamento do ambiente.

  3. Escolher configuração.

  4. Na categoria de configuração Database (Banco de dados), selecione Modify (Modificar).

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

  6. Escolha Aplicar.

Você pode configurar as seguintes opções:

  • Snapshot – Escolha um snapshot de banco de dados existente. O Elastic Beanstalk restaura o snapshot e o adiciona ao seu ambiente. O valor padrão é None (Nenhum), o que permite que você configure um novo banco de dados usando as outras configurações dessa página.

  • Engine – Escolha um mecanismo de banco de dados.

  • Engine version – Escolha uma versão específica do mecanismo de banco de dados.

  • Instance class – Escolha uma classe de instância de banco de dados. Para obter mais informações sobre as classes de instância de banco de dados, consulte https://aws.amazon.com/rds/.

  • Storage – Escolha a quantidade de armazenamento que deve ser provisionada para seu banco de dados. Você pode aumentar o armazenamento alocado posteriormente, mas não pode diminuí-lo. Para obter mais informações sobre a alocação de armazenamento, consulte Recursos.

  • Username – Digite um nome de usuário de sua preferência usando caracteres alfanuméricos.

  • Password – Digite uma senha de sua preferência que contenha de 8 a 16 caracteres ASCII imprimíveis (exceto /, \ e @).

  • Retention – Escolha Create snapshot (Criar snapshot) para criar um snapshot do banco de dados quando você encerrar seu ambiente.

  • Availability – Escolha High (Multi-AZ) (Alta [Multi-AZ]) para executar um backup quente em uma segunda zona de disponibilidade para alta disponibilidade.

nota

O Elastic Beanstalk cria um usuário principal para o banco de dados usando o nome de usuário e a senha fornecidos. Para saber mais sobre o usuário principal e seus privilégios, consulte Master User Account Privileges (Privilégios da conta de usuário principal).


        Janela de configuração do Auto Scaling do Elastic Beanstalk

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:

  • RDS_HOSTNAME – O nome de host da instância de banco de dados.

    Rótulo do console do Amazon RDS – Endpoint (este é o nome do host)

  • 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.

    Rótulo do console do Amazon RDS – Porta

  • RDS_DB_NAME – O nome do banco de dados, ebdb.

    Rótulo do console do Amazon RDS – Nome do banco de dados

  • RDS_USERNAME – O nome de usuário que você configurou para seu banco de dados.

    Rótulo do console do Amazon RDS – Username

  • RDS_PASSWORD – A senha que você configurou para seu banco de dados.

Conectar ao banco de dados

Use as informações de conectividade para se conectar ao seu banco de dados de dentro do seu aplicativo por meio de variáveis do ambiente. Para obter mais informações sobre como usar o Amazon RDS com seus aplicativos, consulte os tópicos a seguir.

Configurar uma instância de banco de dados do RDS integrada usando o console

Você pode visualizar e modificar as definições de configuração de sua instância de banco de dados na seção Database (Banco de dados) na página Configuration (Configuração) do ambiente, no Console do Elastic Beanstalk.

Para configurar a instância de banco de dados do seu ambiente no Console do Elastic Beanstalk

  1. Abra o Console do Elastic Beanstalk.

  2. Navegue até a página de gerenciamento do ambiente.

  3. Escolher configuração.

  4. Na categoria de configuração Database (Banco de dados), selecione Modify (Modificar).

Você pode modificar as configurações de Instance class (Classe de instância), Storage (Armazenamento), Password (Senha), Retention (Retenção) e Availability (Disponibilidade) após a criação do banco de dados. Se alterar a classe da instância, o Elastic Beanstalk provisionará novamente a instância de banco de dados.

Aviso

Não modifique as configurações na instância do banco de dados fora da funcionalidade fornecida pelo Elastic Beanstalk (por exemplo, no console do Amazon RDS). Se fizer isso, a configuração de banco de dados do Amazon RDS poderá ficar fora de sincronia com a definição de seu ambiente. Quando você atualiza ou reinicia seu ambiente, as configurações especificadas no ambiente substituem todas as configurações feitas fora do Elastic Beanstalk.

Se precisar modificar as configurações que o Elastic Beanstalk não comporta diretamente, use os arquivos de configuração do Elastic Beanstalk.

Configurar uma instância de banco de dados do RDS integrada usando arquivos de configuração

Você pode configurar a instância de banco de dados do seu ambiente usando arquivos de configuração. Use as opções no namespace aws:rds:dbinstance. O exemplo a seguir modifica o tamanho de armazenamento alocado do banco de dados para 100 GB.

exemplo .ebextensions/db-instance-options.config

option_settings: aws:rds:dbinstance: DBAllocatedStorage: 100

Se precisar configurar propriedades de instância de banco de dados que o Elastic Beanstalk não comporta, também poderá usar um arquivo de configuração e especificar as configurações usando a chave resources. O exemplo a seguir define valores para as propriedades StorageType e Iops do Amazon RDS.

exemplo .ebextensions/db-instance-properties.config

Resources: AWSEBRDSDatabase: Type: AWS::RDS::DBInstance Properties: StorageType:io1 Iops: 1000