Configurar o servidor de proxy

As versões da plataforma Tomcat baseadas na AMI do Amazon Linux (anterior ao Amazon Linux 2) usam o Apache 2.4 para o proxy por padrão. Você pode optar por usar o Apache 2.2 ou o nginx incluindo um arquivo de configuração no código-fonte. O exemplo a seguir configura o Elastic Beanstalk para usar nginx.

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: nginx

Se seu aplicativo foi desenvolvido para o Apache 2.2, leia esta seção para saber mais sobre como migrar para o Apache 2.4.

A partir das configurações da versão 3.0.0 da plataforma Tomcat, que foram lançadas com a atualização da plataforma Java com Tomcat em 24 de maio de 2018, o Apache 2.4 é o proxy padrão da plataforma Tomcat. Os arquivos .conf do Apache 2.4 são, em sua maioria, mas não inteiramente, compatíveis com os do Apache 2.2. O Elastic Beanstalk inclui arquivos .conf padrão que funcionam corretamente com cada versão do Apache. Se seu aplicativo não personalizar a configuração do Apache, conforme explicado em Estender e substituir a configuração padrão do Apache: Amazon Linux AMI (AL1), ele deve migrar para o Apache 2.4 sem problemas.

Se o seu aplicativo ampliar ou substituir a configuração do Apache, talvez você precise fazer algumas alterações para migrar para o Apache 2.4. Para obter mais informações, consulte Atualizar da versão 2.2 para 2.4 no site The Apache Software Foundation. Como uma medida temporária, até você migrar com êxito para o Apache 2.4, você pode optar por usar o Apache 2.2 com seu aplicativo incluindo o seguinte arquivo de configuração em seu código-fonte.

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: apache/2.2

Para uma correção rápida, também é possível selecionar o servidor de proxy no console do Elastic Beanstalk.

É possível estender a configuração padrão do Apache do Elastic Beanstalk com seus arquivos de configuração adicionais. Também há opção de substituir completamente a configuração padrão do Apache do Elastic Beanstalk.

Para estender a configuração padrão do Apache do Elastic Beanstalk, adicione arquivos de configuração .conf a uma pasta chamada .ebextensions/httpd/conf.d no pacote de origem da aplicação. A configuração do Apache do Elastic Beanstalk inclui os arquivos .conf nessa pasta automaticamente.

~/workspace/my-app/
|-- .ebextensions
|   -- httpd
|      -- conf.d
|         -- myconf.conf
|         -- ssl.conf
-- index.jsp

Por exemplo, a configuração do Apache 2.4 a seguir adiciona um ouvinte na porta 5000.

listen 5000
<VirtualHost *:5000>
  <Proxy *>
    Require all granted
  </Proxy>
  ProxyPass / http://localhost:8080/ retry=0
  ProxyPassReverse / http://localhost:8080/
  ProxyPreserveHost on

  ErrorLog /var/log/httpd/elasticbeanstalk-error_log
</VirtualHost>

Para substituir completamente a configuração padrão do Apache do Elastic Beanstalk, inclua uma configuração no pacote de origem em .ebextensions/httpd/conf/httpd.conf.

~/workspace/my-app/
|-- .ebextensions
|   `-- httpd
|       `-- conf
|           `-- httpd.conf
`-- index.jsp

Se você substituir a configuração do Apache do Elastic Beanstalk, adicione as linhas a seguir a httpd.conf para extrair as configurações do Elastic Beanstalk para Relatórios e monitoramento de integridade aprimorados do Elastic Beanstalk, compactação de resposta e arquivos estáticos.

IncludeOptional conf.d/*.conf
IncludeOptional conf.d/elasticbeanstalk/*.conf

Se seu ambiente usar o Apache 2.2 como o proxy, substitua as diretivas IncludeOptional por Include. Para obter detalhes sobre o comportamento dessas duas diretivas nas duas versões do Apache, consulte Include no Apache 2.4, IncludeOptional no Apache 2.4 e Include no Apache 2.2.

Para ver um exemplo prático, examine o arquivo de configuração padrão do Elastic Beanstalk em /etc/httpd/conf/httpd.conf em uma instância no ambiente. Todos os arquivos na pasta .ebextensions/httpd em seu pacote de origem são copiados para /etc/httpd durante as implantações.

Para estender a configuração padrão do nginx do Elastic Beanstalk, adicione arquivos de configuração .conf a uma pasta denominada .ebextensions/nginx/conf.d/ no pacote de origem da sua aplicação. A configuração nginx do Elastic Beanstalk inclui arquivos .conf nesta pasta automaticamente.

~/workspace/my-app/
|-- .ebextensions
|   `-- nginx
|       `-- conf.d
|           |-- elasticbeanstalk
|           |   `-- my-server-conf.conf
|           `-- my-http-conf.conf
`-- index.jsp

Os arquivos com a extensão .conf na pasta conf.d são incluídos no bloco http da configuração padrão. Os arquivos na pasta conf.d/elasticbeanstalk são incluídos no bloco server dentro do bloco http.

Para substituir completamente a configuração nginx padrão do Elastic Beanstalk, inclua uma configuração em seu pacote de origem em .ebextensions/nginx/nginx.conf.

~/workspace/my-app/
|-- .ebextensions
|   `-- nginx
|       `-- nginx.conf
`-- index.jsp

Para ver um exemplo prático, examine o arquivo de configuração padrão do Elastic Beanstalk em /etc/nginx/nginx.conf em uma instância no ambiente. Todos os arquivos na pasta .ebextensions/nginx em seu pacote de origem são copiados para /etc/nginx durante as implantações.