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 Symfony no Elastic Beanstalk
O [Symfony](http://symfony.com/) é uma framework de código aberto para o desenvolvimento de aplicações web de PHP dinâmico. Este tutorial mostra o processo de geração de um aplicativo Symfony e sua implantação em um ambiente. AWS Elastic Beanstalk
**Topics**
+ [Pré-requisitos](#php-symfony-tutorial-prereqs)
+ [Iniciar um ambiente do Elastic Beanstalk](#php-symfony-tutorial-launch)
+ [Instalar o Symfony e gerar um site](#php-symfony-tutorial-generate)
+ [Implantar o aplicativo](#php-symfony-tutorial-deploy)
+ [Definir as configurações do Composer](#php-symfony-tutorial-configure)
+ [Limpeza](#php-symfony-tutorial-cleanup)
+ [Próximas etapas](#php-symfony-tutorial-nextsteps)
## Pré-requisitos
Este tutorial pressupõe que você tenha conhecimento das operações básicas e do console do Elastic Beanstalk. Caso ainda não tenha, siga as instruções em [Saiba como começar a usar o Elastic Beanstalk](GettingStarted.md) para iniciar seu primeiro ambiente do Elastic Beanstalk.
Para seguir os procedimentos neste manual, você precisa de um terminal de linha de comando ou de um shell para executar os comandos. Nas listagens, os comandos são mostrados precedidos por um símbolo de prompt (\$1) e pelo nome do diretório atual, quando apropriado.
```
~/eb-project$ this is a command
this is output
```
No Linux e no macOS, você pode usar seu gerenciador de pacotes e de shell preferido. No Windows, você pode [instalar o subsistema Windows para Linux](https://docs.microsoft.com/en-us/windows/wsl/install-win10) para obter uma versão do Ubuntu e Bash integrada ao Windows.
O Symfony 4.4.9 requer PHP 7.1.3 ou posterior. Ele também requer as extensões PHP listadas no tópico [requisitos técnicos](https://symfony.com/doc/4.4/setup.html ) na documentação de instalação oficial do Symfony. Neste tutorial, usamos o PHP 7.2 e a [versão correspondente da plataforma](https://docs.aws.amazon.com/elasticbeanstalk/latest/platforms/platforms-supported.html#platforms-supported.PHP) do Elastic Beanstalk. Antes de continuar, você deve instalar o PHP e o Composer.
Para obter informações sobre suporte e manutenção do Symfony, consulte o tópico [lançamentos do symfony](https://symfony.com/releases) no site do Symfony. Para obter mais informações sobre atualizações relacionadas ao suporte à versão do PHP para o Symfony 4.4.9, consulte o tópico [notas de release do Symfony 4.4.9](https://symfony.com/blog/symfony-4-4-9-released) no site do Symfony.
## Iniciar um ambiente do Elastic Beanstalk
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.
**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.
**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).
## Instalar o Symfony e gerar um site
O Composer pode instalar o Symfony e criar um projeto de trabalho com um comando:
```
~$ composer create-project symfony/website-skeleton eb-symfony
```
O Composer instala o Symfony e suas dependências e gera um projeto padrão.
Se tiver problemas com a instalação do Symfony, consulte o tópico [instalação](https://symfony.com/doc/4.4/setup.html) na documentação oficial do Symfony.
## Implantar o aplicativo
Acesse o diretório do projeto.
```
~$ cd eb-symfony
```
Crie um [pacote de origem](applications-sourcebundle.md) com os arquivos criados pelo Composer. O comando a seguir cria um pacote de origem chamado `symfony-default.zip`. Ele exclui arquivos na pasta `vendor`, que tomam muito espaço e não são necessários para implantação da aplicação no Elastic Beanstalk.
```
eb-symfony$ zip ../symfony-default.zip -r * .[^.]* -x "vendor/*"
```
Faça upload do pacote de origem para o Elastic Beanstalk para implantar o Symfony no ambiente.
**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.
**nota**
Para otimizar mais o pacote de origem, inicie um repositório Git e use o comando [`git archive`](applications-sourcebundle.md#using-features.deployment.source.git)para criar o pacote de origem. O projeto do Symfony padrão inclui um arquivo `.gitignore` que diz para o Git excluir a pasta `vendor` e outros arquivos que não são necessários para implantação.
## Definir as configurações do Composer
Quando a implantação for concluída, clique na URL para abrir a aplicação Symfony no navegador:
O que é isso? Por padrão, o Elastic Beanstalk fornece a raiz do seu projeto no caminho raiz do site. Neste caso, contudo, a página padrão (`app.php`) está em um nível abaixo na pasta `web`. Você pode verificar isso adicionando `/public` ao URL. Por exemplo, .`http://symfony.us-east-2.elasticbeanstalk.com/public`
Para fornecer a aplicação Symfony no caminho raiz, use o console do Elastic Beanstalk para configurar a *raiz do documento* para o site.
**Para configurar a raiz do documento do seu site**
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. Para **Document Root (Raiz do documento)**, insira **/public**.
1. Para salvar as alterações, escolha **Apply (Aplicar)** na parte inferior da página.
1. Quando a atualização for concluída, clique no URL para reabrir seu site no navegador.
## Limpeza
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.
## Próximas etapas
Para obter mais informações sobre Symfony, consulte [O que é o Symfony?](https://symfony.com/what-is-symfony) no site symfony.com.
À 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.
Neste tutorial, você usou o console do Elastic Beanstalk para configurar as opções do Composer. Para tornar essa configuração parte de origem do aplicativo, você pode usar um arquivo de configuração, como o seguinte.
**Example .ebextensions/composer.config**
```
option_settings:
aws:elasticbeanstalk:container:php:phpini:
document_root: /public
```
Para obter mais informações, consulte [Personalização avançada de ambiente com arquivos de configuração (`.ebextensions`)](ebextensions.md).
O Symfony usa seus próprios arquivos de configuração para configurar as conexões do banco de dados. Para obter instruções sobre como se conectar a um banco de dados com o Symfony, consulte [Conexão a um banco de dados com Symfony](create_deploy_PHP.rds.md#php-rds-symfony).
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.