

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Iniciar e conectar-se a uma instância externa do Amazon RDS em uma VPC padrão
<a name="rds-external-defaultvpc"></a>

Os procedimentos a seguir descrevem o processo de conexão a uma instância externa do Amazon RDS em uma [VPC padrão](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html). O processo é o mesmo se você estiver usando uma VPC personalizada. Os únicos requisitos adicionais são que o seu ambiente e instância de banco de dados estejam na mesma sub-rede ou em sub-redes que possam se comunicar umas com as outras. Para obter mais informações sobre como configurar uma VPC personalizada para usar com o Elastic Beanstalk, consulte [Usar o Elastic Beanstalk com Amazon VPC](vpc.md).

**nota**  
Uma alternativa para iniciar uma nova instância de banco de dados é começar com um banco de dados que foi criado anteriormente pelo Elastic Beanstalk e posteriormente [desacoplado](using-features.managing.db.md#using-features.decoupling.db) de um ambiente do Beanstalk. Para obter mais informações, consulte [Adição de um banco de dados ao seu ambiente do Elastic Beanstalk](using-features.managing.db.md). Com essa opção, você não precisa realizar o procedimento para iniciar um novo banco de dados. Mas, você precisa realizar os procedimentos subsequentes descritos neste tópico.
Se estiver começando com um banco de dados que foi criado pelo Elastic Beanstalk e posteriormente desacoplado de um ambiente do Beanstalk, você pode pular o primeiro grupo de etapas e continuar com as etapas em *Para modificar as regras de entrada no grupo de segurança da instância do RDS*.
 Se planeja usar o banco de dados que você desacopla para um ambiente de produção, verifique se o tipo de armazenamento usado pelo banco de dados é adequado para sua workload. Para obter mais informações, consulte [DB Instance Storage](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html) (Armazenamento de instâncias de banco de dados) e [Modifying a DB instance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.DBInstance.Modifying.html) (Modificar uma instância de banco de dados) no *Amazon RDS User Guide* (Guia do usuário do Amazon RDS). 

**Para executar uma instância de banco de dados do RDS em uma VPC padrão**

1. Abra o [console do RDS](https://console.aws.amazon.com/rds/home).

1. No painel de navegação, escolha **Databases** (Bancos de dados).

1. Selecione **Criar banco de dados**.

1. Escolha **Standard Create (Criação padrão)**.
**Importante**  
Não escolha **Easy Create (Criação fácil)**. Se o escolher, você não poderá definir as configurações necessárias para iniciar esse banco de dados do RDS.

1. Em **Additional configuration (Configuração adicional)**, para **Initial database name (Nome do banco de dados inicial)**, digite **ebdb**. 

1. Revise as configurações padrão e ajuste essas configurações de acordo com seus requisitos específicos. Preste atenção às seguintes opções:
   + **DB instance class** (Classe de instância de banco de dados): escolha um tamanho de instância que tem uma quantidade apropriada de memória e energia de CPU para sua workload.
   + **Implantação Multi-AZ** — Para alta disponibilidade, defina isso como **Criar um nó Replica/Reader Aurora em uma** AZ diferente.
   + **Master username (Nome do usuário principal)** e **Master password (Senha principal)**:o nome de usuário do banco de dados e senha. Anote essas configurações porque você vai usá-las mais tarde.

1. Verifique as configurações padrão para as opções restantes e selecione **Create database (Criar banco de dados)**.

Em seguida, modifique o grupo de segurança anexado à sua instância de banco de dados para permitir tráfego de entrada na porta apropriada. Este é o mesmo grupo de segurança que você vai anexar ao ambiente do Elastic Beanstalk mais tarde. Como resultado, a regra que você adiciona concederá permissão de acesso de entrada a outros recursos no mesmo grupo de segurança.

**Para modificar as regras de entrada no grupo de segurança anexado à instância do RDS**

1. Abra o [ console do Amazon RDS](https://console.aws.amazon.com/rds/home).

1. Escolha **Databases (Bancos de dados)**.

1. Escolha o nome da sua instância de banco de dados para visualizar detalhes.

1. Na seção **Conectividade**, anote as **Sub-redes**, os **Grupos de segurança** e o **Endpoint** que são exibidos nesta página. Faça isso para poder usar essas informações mais tarde.

1. Em **Security** (Segurança), você pode ver o grupo de segurança associado à instância de banco de dados. Abra o link para ver o grupo de segurança no EC2 console da Amazon.

1. Nos detalhes do grupo de segurança, escolha a guia **Inbound (Entrada)**.

1. Escolha **Editar**.

1. Escolha **Add Rule**.

1. Para **Tipo**, escolha o mecanismo de banco de dados usado pelo aplicativo.

1. Em **Source (Origem)**, digite **sg-** para exibir uma lista dos grupos de segurança disponíveis. Escolha o grupo de segurança associado ao grupo do Auto Scaling usado com seu ambiente do Elastic Beanstalk. Isso é para que as EC2 instâncias da Amazon no ambiente possam ter acesso ao banco de dados.  
![\[Imagem da tela para editar as regras de entrada para um grupo de segurança no EC2 console da Amazon.\]](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/ec2-securitygroup-rds.png)

1. Escolha **Salvar**.

Em seguida, adicione o grupo de segurança da instância de banco de dados ao seu ambiente em execução. Nesse procedimento, o Elastic Beanstalk reprograma todas as instâncias em seu ambiente com o grupo de segurança adicional anexado.

**Para adicionar um security group ao seu ambiente**
+ Execute um destes procedimentos:
  + Como adicionar um grupo de segurança usando o console do Elastic Beanstalk

    1. Abra o console do [Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS

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

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

    1. Na categoria de configuração **Instances (Instâncias)**, escolha **Edit (Editar)**.

    1. Em **grupos EC2 de segurança**, escolha o grupo de segurança a ser anexado às instâncias, além do grupo de segurança de instâncias que o Elastic Beanstalk cria.

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

    1. Leia o aviso e escolha **Confirm**.
  + Para adicionar um grupo de segurança usando um [arquivo de configuração](ebextensions.md), use o exemplo de arquivo [https://github.com/awsdocs/elastic-beanstalk-samples/tree/main/configuration-files/aws-provided/security-configuration/securitygroup-addexisting.config](https://github.com/awsdocs/elastic-beanstalk-samples/tree/main/configuration-files/aws-provided/security-configuration/securitygroup-addexisting.config).

Em seguida, passe as informações de conexão para o seu ambiente usando as propriedades de ambiente. Quando você [adiciona uma instância de banco de dados ao ambiente](using-features.managing.db.md) com o console do Elastic Beanstalk, o Elastic Beanstalk usa propriedades de ambiente, como **RDS\$1HOSTNAME**, para passar informações de conexão à aplicação. Você pode usar as mesmas propriedades. Fazendo isso, você usa o mesmo código de aplicação com as instâncias de banco de dados integradas e externas. Ou, alternativamente, você pode escolher seus próprios nomes de propriedade.

**Como configurar as propriedades do ambiente para uma instância de banco de dados do Amazon RDS**

1. Abra o console do [Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS

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

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

1. Na categoria de configuração **Updates, monitoring, and logging (Atualizações, monitoramento e logs)**, escolha **Edit (Editar)**.

1. Na seção **Environment properties**, defina as variáveis que seu aplicativo lê para construir uma string de conexão. Para compatibilidade com ambientes que têm uma instância de banco de dados do RDS integrada, use os seguintes nomes e valores. É possível encontrar todos os valores, exceto sua senha, no [console do RDS](https://console.aws.amazon.com/rds/home).    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/rds-external-defaultvpc.html)  
![\[Seção de configuração de propriedades de ambiente com a adição de propriedades do RDS\]](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/environment-cfg-envprops-rds.png)

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

Se você ainda não programou a aplicação para ler as propriedades de ambiente e criar uma sequência de conexão, consulte os seguintes tópicos específicos de cada linguagem para obter instruções:
+ Java SE: [Conectar a um banco de dados (plataformas Java SE)](java-rds.md#java-rds-javase)
+ Java com Tomcat: [Conectar a um banco de dados (plataformas Tomcat)](java-rds.md#java-rds-tomcat)
+ Node.js: [Conectar-se a um banco de dados](create-deploy-nodejs.rds.md#nodejs-rds-connect)
+ .NET: [Conectar-se a um banco de dados](create_deploy_NET.rds.md#dotnet-rds-connect)
+ PHP: [Conectando-se a um banco de dados com um PDO ou My SQLi](create_deploy_PHP.rds.md#php-rds-connect)
+ Python: [Conectar-se a um banco de dados](create-deploy-python-rds.md#python-rds-connect)
+ Ruby: [Conectar-se a um banco de dados](create_deploy_Ruby.rds.md#ruby-rds-connect)

Finalmente, dependendo de quando seu aplicativo lê as variáveis de ambiente, pode ser necessário reiniciar o servidor de aplicativo nas instâncias em seu ambiente.

**Para reiniciar os servidores de aplicativos do ambiente**

1. Abra o console do [Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS

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

1. Escolha **Actions** (Ações) e depois **Restart app server(s)** (Reiniciar servidores de aplicações).