

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

# Implantar uma aplicação PHP de alta disponibilidade com um banco de dados externo do Amazon RDS no Elastic Beanstalk
<a name="php-ha-tutorial"></a>

Este tutorial mostra o processo de [iniciar uma instância de banco de dados RDS](AWSHowTo.RDS.md) externa e configurar um ambiente de alta disponibilidade executando um aplicativo PHP para se conectar a ela. AWS Elastic Beanstalk A execução de uma instância de banco de dados externa ao Elastic Beanstalk desvincula o banco de dados do ciclo de vida do ambiente. Com isso, é possível se conectar ao mesmo banco de dados de vários ambientes, trocar um banco de dados por outro ou realizar uma implantação azul/verde sem afetar seu banco de dados.

O tutorial usa um [exemplo de aplicativo PHP](https://github.com/awslabs/eb-demo-php-simple-app) que usa um banco de dados MySQL para armazenar dados de texto fornecidos pelo usuário. O aplicativo de exemplo usa [arquivos de configuração](ebextensions.md) para definir as [configurações de PHP](create_deploy_PHP.container.md#php-namespaces) e para criar uma tabela no banco de dados para o aplicativo usar. Ele também mostra como usar um [arquivo do Composer](create_deploy_PHP.container.md#php-configuration-composer) para instalar pacotes durante a implantação.

**Topics**
+ [Pré-requisitos](#php-hawrds-tutorial-prereqs)
+ [Executar uma instância de banco de dados no Amazon RDS](#php-hawrds-tutorial-database)
+ [Criar um ambiente do Elastic Beanstalk](#php-hawrds-tutorial-create)
+ [Configurar grupos de segurança, propriedades de ambiente e escalabilidade](#php-hawrds-tutorial-configure)
+ [Implantar o aplicativo de exemplo](#php-hawrds-tutorial-deploy)
+ [Limpeza](#php-hawrds-tutorial-cleanup)
+ [Próximas etapas](#php-hawrds-tutorial-nextsteps)

## Pré-requisitos
<a name="php-hawrds-tutorial-prereqs"></a>

[Antes de começar, baixe o pacote de origem do aplicativo de amostra em GitHub: -app-1.3.zip eb-demo-php-simple](https://github.com/aws-samples/eb-demo-php-simple-app/releases/download/v1.3/eb-demo-php-simple-app-v1.3.zip)

Os procedimentos neste tutorial para tarefas do Amazon Relational Database Service (Amazon RDS) assumem que você esteja iniciando recursos em uma [Amazon Virtual Private Cloud](https://docs.aws.amazon.com/vpc/latest/userguide/) (Amazon VPC) padrão. Todas as novas contas incluem uma VPC padrão em cada região. Se você não tem uma VPC padrão, os procedimentos podem variar. Consulte [Usar o Elastic Beanstalk com o Amazon RDS](AWSHowTo.RDS.md) para obter instruções sobre EC2 plataformas VPC clássicas e personalizadas.

## Executar uma instância de banco de dados no Amazon RDS
<a name="php-hawrds-tutorial-database"></a>

Para usar um banco de dados externo com uma aplicação em execução no Elastic Beanstalk, primeiro execute uma instância de banco de dados com o Amazon RDS. Quando uma instância é executada com o Amazon RDS, ela é completamente independente do Elastic Beanstalk e dos seus ambientes do Elastic Beanstalk e não será encerrada nem monitorada pelo Elastic Beanstalk.

Use o console do Amazon RDS para executar uma instância de banco de dados **MySQL** Multi-AZ. Escolha uma implantação Multi-AZ para garantir que seu banco de dados execute o failover e continue disponível se a instância de banco de dados de origem ficar fora de serviço.

**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 security group anexado à sua instância de banco de dados para permitir o tráfego de entrada na porta apropriada. Este é o mesmo grupo de segurança a ser anexado ao ambiente do Elastic Beanstalk mais tarde, para que a regra adicionada conceda permissão 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**.

A criação de uma instância de banco de dados leva cerca de 10 minutos. Enquanto isso, crie o ambiente do Elastic Beanstalk.

## Criar um ambiente do Elastic Beanstalk
<a name="php-hawrds-tutorial-create"></a>

Use o console do Elastic Beanstalk para criar um ambiente do Elastic Beanstalk. Escolha a configuração da Plataforma **PHP** e aceite as configurações padrão e código de exemplo. Depois de iniciar o ambiente, você pode configurar o ambiente para se conectar ao banco de dados e, em seguida, implantar o aplicativo de amostra do qual você baixou GitHub.

**Para iniciar um ambiente (console)**

1. [Abra o console do Elastic Beanstalk usando este link pré-configurado: console.aws.amazon. com/elasticbeanstalk/home\$1/newApplication? Nome do aplicativo = Tutoriais](https://console.aws.amazon.com/elasticbeanstalk/home#/newApplication?applicationName=tutorials&environmentType=LoadBalanced) e tipo de ambiente = LoadBalanced

1. Em **Platform (Plataforma)**, selecione a plataforma e a ramificação da plataforma que correspondem à linguagem usada pelo seu aplicativo.

1. Para **Application code**, escolha **Sample application**.

1. Selecione **Review and launch**.

1. Examine as opções disponíveis. Escolha a opção disponível que deseja usar e, quando estiver pronto, escolha **Create app (Criar aplicativo)**.

A criação de ambiente leva cerca de 5 minutos e cria os seguintes recursos:
+ **EC2 instância** — Uma máquina virtual Amazon Elastic Compute Cloud (Amazon EC2) configurada para executar aplicativos web na plataforma que você escolher.

  Cada plataforma executa um conjunto específico de software, arquivos de configuração e scripts para oferecer suporte a uma versão de linguagem, framework, contêiner da web específicos ou a uma combinação deles. A maioria das plataformas usa o Apache ou o NGINX como um proxy reverso que fica na frente da aplicação Web, encaminha solicitações para ela, atende ativos estáticos e gera logs de acesso e de erro.
+ **Grupo de segurança da instância** — Um grupo EC2 de segurança da Amazon configurado para permitir tráfego de entrada na porta 80. Esse recurso permite que o tráfego HTTP do balanceador de carga chegue à EC2 instância que executa seu aplicativo web. Por padrão, o tráfego não é permitido em outras portas.
+ **Balanceador de carga**: um balanceador de carga do Elastic Load Balancing configurado para distribuir solicitações para as instâncias que executam a aplicação. Um load balancer também elimina a necessidade de expor suas instâncias diretamente à Internet.
+ **Grupo de segurança do balanceador de carga** — Um grupo EC2 de segurança da Amazon configurado para permitir tráfego de entrada na porta 80. Esse recurso permite que o tráfego HTTP da Internet acesse o load balancer. Por padrão, o tráfego não é permitido em outras portas.
+ **Grupo de Auto Scaling**: grupo de Auto Scaling configurado para substituir uma instância se ela for encerrada ou ficar indisponível.
+ **Bucket do Amazon S3**: um local de armazenamento do seu código-fonte, logs e outros artefatos criados quando o Elastic Beanstalk é utilizado.
+ ** CloudWatch Alarmes da Amazon** — Dois CloudWatch alarmes que monitoram a carga nas instâncias em seu ambiente e que são acionados se a carga for muito alta ou muito baixa. Quando um alarme é acionado, o seu grupo de Auto Scaling pode aumentar ou diminuir.
+ **CloudFormation stack** — O Elastic CloudFormation Beanstalk usa para lançar os recursos em seu ambiente e propagar as alterações de configuração. Os recursos são definidos em um modelo que você pode visualizar no [console do CloudFormation](https://console.aws.amazon.com/cloudformation).
+ **Nome de domínio** — Um nome de domínio que é direcionado para seu aplicativo da web no formulário **subdomain*. *region*.elasticbeanstalk.com*.
**Segurança de domínios**  
Para aumentar a segurança de suas aplicações do Elastic Beanstalk, o domínio *elasticbeanstalk.com* é registrado na [Lista Pública de Sufixos (PSL)](https://publicsuffix.org/).  
Se precisar definir cookies confidenciais no nome de domínio padrão para suas aplicações Elastic Beanstalk, recomendamos usar cookies com um prefixo `__Host-` para maior segurança. Essa prática defende seu domínio contra tentativas de falsificação de solicitação entre sites (CSRF). Para obter mais informações, consulte a página [Set-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#cookie_prefixes) na Mozilla Developer Network.

Todos esses recursos são gerenciados pelo Elastic Beanstalk. Quando você encerra o ambiente, o Elastic Beanstalk encerra todos os recursos dele. A instância de banco de dados RDS que você executou está fora do seu ambiente, portanto você é responsável por gerenciar o ciclo de vida dela.

**nota**  
O bucket do Amazon S3 que o Elastic Beanstalk cria é compartilhado entre ambientes e não é excluído durante o encerramento do ambiente. Para obter mais informações, consulte [Usar o Elastic Beanstalk com o Amazon S3](AWSHowTo.S3.md).

## Configurar grupos de segurança, propriedades de ambiente e escalabilidade
<a name="php-hawrds-tutorial-configure"></a>

Adicione o security group da instância de banco de dados ao seu ambiente em execução. Esse procedimento faz com que o Elastic Beanstalk provisione novamente todas as instâncias no 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, use as propriedades do ambiente para passar as informações de conexão para o ambiente. A aplicação demonstrativa usa um conjunto padrão de propriedades que correspondem àquelas que o Elastic Beanstalk configura quando você provisiona um banco de dados no ambiente.

**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/php-ha-tutorial.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.

Por fim, configure o grupo de Auto Scaling do seu ambiente com uma contagem mínima de instâncias mais alta. Execute pelo menos duas instâncias o tempo todo para impedir que os servidores Web em seu ambiente sejam um ponto único de falha e para permitir que você implante alterações sem colocar seu site fora do serviço.

**Para configurar o grupo de Auto Scaling de seu ambiente para alta disponibilidade**

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 **Capacity (Capacidade)**, escolha **Edit (Editar)**.

1. Na seção **Auto Scaling group (Grupo de Auto Scaling)** defina **Min instances (Mínimo de instâncias)** como **2**.

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

## Implantar o aplicativo de exemplo
<a name="php-hawrds-tutorial-deploy"></a>

Agora, o ambiente está pronto para executar a aplicação demonstrativa e conectar-se ao Amazon RDS. Implante o aplicativo de exemplo em seu ambiente.

**nota**  
[Faça o download do pacote de origem em GitHub, se ainda não o fez: eb-demo-php-simple -app-1.3.zip](https://github.com/aws-samples/eb-demo-php-simple-app/releases/download/v1.3/eb-demo-php-simple-app-v1.3.zip)

**Para implantar um pacote de origem**

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. Na página de visão geral do ambiente, escolha **Upload and deploy (Fazer upload e implantar)**.

1. Use a caixa de diálogo na tela para carregar o pacote de origem.

1. Escolha **Deploy (Implantar)**.

1. Quando a implantação for concluída, é possível escolher o URL do site para abri-lo em uma nova guia.

O site coleta os comentários do usuário e usa um banco de dados MySQL para armazenar os dados. Para adicionar um comentário, escolha **Share Your Thought (Compartilhar sua opinião)**, insira um comentário e escolha **Submit Your Thought (Enviar sua opinião)**. O aplicativo Web grava o comentário no banco de dados para que qualquer instância do ambiente possa ler e ele não será perdido se as instâncias ficarem fora de serviço.

![\[User interface for sharing thoughts, with a posted comment about Elastic Beanstalk on AWS.\]](http://docs.aws.amazon.com/pt_br/elasticbeanstalk/latest/dg/images/php-ha-tutorial-app.png)


## Limpeza
<a name="php-hawrds-tutorial-cleanup"></a>

Depois de terminar de trabalhar com o código de demonstração, você pode encerrar seu ambiente. [O Elastic Beanstalk exclui todos os recursos AWS relacionados, [como instâncias da EC2 Amazon](using-features.managing.ec2.md), [instâncias de banco de dados, balanceadores de carga[,](using-features.managing.elb.md)](using-features.managing.db.md) grupos de segurança e alarmes.](using-features.alarms.md#using-features.alarms.title) 

Como a remoção de recursos não exclui a aplicação Elastic Beanstalk, é possível criar ambientes para a aplicação a qualquer momento.

**Para encerrar seu ambiente Elastic Beanstalk do console**

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 **Terminate Environment** (Encerrar ambiente).

1. Use a caixa de diálogo na tela para confirmar o encerramento do ambiente.

Além disso, é possível encerrar recursos do banco de dados que você criou fora do ambiente do Elastic Beanstalk. Ao encerrar uma instância de banco de dados do Amazon RDS, você poderá criar um snapshot e restaurar os dados em outra instância posteriormente.

**Para encerrar sua instância de banco de dados do RDS**

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

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

1. Escolha a instância de banco de dados.

1. Escolha **Ações** e, em seguida, escolha **Excluir**.

1. Escolha se deseja criar um snapshot. Depois, escolha **Excluir**.

## Próximas etapas
<a name="php-hawrds-tutorial-nextsteps"></a>

À 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 [linha de comando do Elastic Beanstalk](eb-cli3.md) (EB CLI easy-to-use) fornece comandos para criar, configurar e implantar aplicativos nos ambientes do Elastic Beanstalk a partir da linha de comando.

O aplicativo de exemplo usa os arquivos de configuração para especificar as configurações de PHP e criar uma tabela no banco de dados, se ainda não existir. Você também pode usar um arquivo de configuração para definir as configurações de security group das instâncias durante a criação do ambiente para evitar atualizações de configuração demoradas. Consulte [Personalização avançada de ambiente com arquivos de configuração (`.ebextensions`)](ebextensions.md) para obter mais informações.

Para desenvolvimento e teste, convém usar a funcionalidade do Elastic Beanstalk para adicionar uma instância de banco de dados gerenciada diretamente ao seu ambiente. Para obter instruções sobre como configurar um banco de dados no ambiente, consulte [Adição de um banco de dados ao seu ambiente do Elastic Beanstalk](using-features.managing.db.md).

Se você precisa de um banco de dados de alta performance, considere usar o [Amazon Aurora](https://aws.amazon.com/rds/aurora/). O Amazon Aurora é um mecanismo de banco de dados compatível com MySQL que oferece recursos de banco de dados comerciais a baixo custo. Para conectar seu aplicativo a outro banco de dados, repita as etapas de [configuração de grupo de segurança](#php-hawrds-tutorial-database) e [atualize as propriedades de ambiente relacionadas ao RDS](#php-hawrds-tutorial-configure). 

Por fim, se você planeja usar seu aplicativo em um ambiente de produção, [configure um nome de domínio personalizado](customdomains.md) para seu ambiente e [habilite HTTPS](configuring-https.md) para conexões seguras.