Adicionar um banco de dados ao seu ambiente Elastic Beanstalk - AWS Elastic Beanstalk

Adicionar 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 ao 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.

Adicionar 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 e, na lista Regiões, selecione 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. 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 (Nome de usuário) – insira um nome de usuário de sua preferência usando caracteres alfanuméricos.

  • Password (Senha) – insira 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:

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 dados, ebdb

Na guia Configuration (Configuração) do 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: Master username (Nome de usuário principal).

RDS_PASSWORD

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

Não disponível para referência no console do Amazon RDS.

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

É possível 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 e, na lista Regiões, selecione 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).

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