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

Conceitos básicos do Java no Elastic Beanstalk

Para começar a usar os aplicativos Java no AWS Elastic Beanstalk, tudo o que você precisa é de um pacote de origem de aplicativo para fazer upload como a primeira versão do aplicativo e implantar em um ambiente. Quando você cria um ambiente, o Elastic Beanstalk aloca todos os recursos da AWS necessários para executar uma aplicação Web escalável.

Iniciar um ambiente com um aplicativo Java de exemplo

O Elastic Beanstalk fornece aplicações demonstrativas de página única para cada plataforma e também exemplos mais complexos que mostram o uso de recursos adicionais da AWS, como o Amazon RDS e linguagem ou recursos e APIs específicos da plataforma.

Os exemplos de página única são o mesmo código que você obtém ao criar um ambiente sem fornecer seu próprio código-fonte. Os exemplos mais complexos são hospedados no GitHub e podem ser compilados ou criados antes da implantação em um ambiente do Elastic Beanstalk.

Amostras

Name (Nome)

Versões com suporte

Tipo de ambiente

Origem

Descrição

Tomcat (página única)

Todas as ramificações da plataforma Tomcat com Corretto

Servidor Web

Operador

tomcat.zip

Aplicativo web Tomcat com uma única página (index.jsp) configurada para ser exibida na raiz do site.

Para ambientes de operador, este exemplo inclui um arquivo cron.yaml que configura uma tarefa programada que chama scheduled.jsp uma vez por minuto. Quando scheduled.jsp é chamado, ele grava em um arquivo de log em /tmp/sample-app.log. Por fim, um arquivo de configuração é incluído em .ebextensions que copia os logs de /tmp/ para os locais lidos pelo Elastic Beanstalk quando você solicita logs de ambiente.

Se você habilitar a integração com o X-Ray em um ambiente que executa este exemplo, a aplicação mostrará conteúdo adicional relativo ao X-Ray e fornecerá uma opção para gerar informações de depuração que você pode visualizar no console do X-Ray.

Corretto (página única)

Corretto 11

Corretto 8

Servidor Web

corretto.zip

Aplicação Corretto com arquivos de configuração Buildfile e Procfile.

Se você habilitar a integração com o X-Ray em um ambiente que executa este exemplo, a aplicação mostrará conteúdo adicional relativo ao X-Ray e fornecerá uma opção para gerar informações de depuração que você pode visualizar no console do X-Ray.

Scorekeep

Java 8 Servidor Web Clonar o repo em GitHub.com

O Scorekeep é uma API web RESTful que usa o Spring framework para fornecer uma interface para a criar e gerenciar usuários, sessões e jogos. A API faz parte do pacote de um aplicativo Web Angular 1.5 que a consome via HTTP.

O aplicativo usa recursos da plataforma Java SE para fazer download de dependências e criar na instância, minimizando o tamanho do pacote de origem. O aplicativo também inclui arquivos de configuração nginx que substituem a configuração padrão para servir o aplicativo web de front-end estaticamente na porta 80 através do proxy e encaminhar as solicitações para atalhos em /api para a API em execução em localhost:5000.

O Scorekeep também inclui uma ramificação xray que mostra como instrumentar uma aplicação Java para uso com o AWS X-Ray. Ele mostra a instrumentação de solicitações HTTP de entrada com um filtro de servlet, instrumentação de cliente AWS SDK automática e manual, configuração de gravador e instrumentação de solicitações HTTP de saída e clientes SQL.

Consulte o arquivo readme para obter instruções ou use o tutorial sobre conceitos básicos do AWS X-Ray para experimentar a aplicação com o X-Ray.

Does it Have Snakes?

Tomcat 8 com Java 8 Servidor Web Clonar o repo em GitHub.com

Does it Have Snakes? é uma aplicação Web Tomcat que mostra o uso de arquivos de configuração do Elastic Beanstalk, Amazon RDS, JDBC, PostgreSQL, servlets, JSPs, Simple Tag Support, arquivos de tag, Log4J, Bootstrap e Jackson.

O código-fonte deste projeto inclui um script de compilação mínimo que compila os servlets e os modelos em arquivos de classe e empacota os arquivos necessários em um arquivo web que você pode implantar em um ambiente do Elastic Beanstalk. Consulte o arquivo readme no repositório do projeto para obter instruções completas.

Locust Load Generator

Java 8

Servidor Web

Clonar o repo em GitHub.com

Aplicação Web que pode ser usada para fazer um teste de carga em outra aplicação Web em execução em um ambiente diferente do Elastic Beanstalk. Mostra o uso de arquivos Buildfile e Procfile, DynamoDB e Locust, uma ferramenta de teste de carga de código aberto.

Faça download de qualquer uma das aplicações demonstrativas e implante-a no Elastic Beanstalk seguindo estas etapas:

Para iniciar um ambiente com um aplicativo de exemplo (console)
  1. Abra o console do Elastic Beanstalk e, na lista Regions (Regiões), selecione a sua Região da AWS.

  2. No painel de navegação, escolha Aplicativos e o nome de um aplicativo existente na lista ou crie um.

  3. Na página de visão geral da aplicação, escolha Create a new environment (Criar um novo ambiente).

    A página de visão geral da aplicação com uma lista de ambientes da aplicação no console do Elastic Beanstalk

    Isso inicia o assistente Create environment (Criar ambiente). O assistente fornece um conjunto de etapas para a criação de um novo ambiente.

    O assistente Create environment (Criar ambiente) no console do Elastic Beanstalk
  4. Para nível de ambiente, escolha o nível de ambiente Web server environment (Ambiente do servidor Web) ou Worker environment (Ambiente do operador). Você não pode alterar o nível de um ambiente após a criação.

    nota

    O .NET na Plataforma de servidor Windows não tem suporte para a camada de ambiente do operador.

  5. Em Plataforma, selecione a plataforma e a ramificação da plataforma que correspondem à linguagem usada pelo seu aplicativo.

    nota

    O Elastic Beanstalk é compatível com várias versões para a maioria das plataformas listadas. Por padrão, o console seleciona a versão recomendada da plataforma e a ramificação da plataforma escolhida. Se a aplicação exigir outra versão, você poderá selecioná-la aqui. Para obter informações sobre versões de plataforma compatíveis, consulte Plataformas compatíveis com Elastic Beanstalk.

  6. Para Application code, escolha Sample application.

  7. Em Configuration presets (Predefinições de configuração), escolha Single instance (Instância única).

  8. Escolha Next (Próximo).

  9. A página Configurar acesso ao serviço é exibida.

    Configurar o acesso a serviço
  10. Escolha Usar um perfil de serviço existente em Perfil de serviço.

  11. Em seguida, vamos nos concentrar na lista suspensa Perfil de instância do EC2. Os valores exibidos nessa lista suspensa podem variar, dependendo de a conta ter criado anteriormente um novo ambiente.

    Escolha uma das opções a seguir com base nos valores exibidos na lista.

    • Se aws-elasticbeanstalk-ec2-role for exibido na lista suspensa, selecione-o na lista suspensa Perfil de instância do EC2.

    • Se outro valor for exibido na lista e for o perfil padrão de instância do EC2 para seus ambientes, selecione-o na lista suspensa Perfil de instância do EC2.

    • Se a lista suspensa Perfil de instância do EC2 não mostrar nenhum valor para seleção, expanda o procedimento que se segue, Criar um perfil do IAM para ser o perfil de instância do EC2.

      Conclua as etapas em Criar perfil do IAM para ser o perfil de instância do EC2 para criar um perfil do IAM que você possa selecionar posteriormente para ser o  perfil de instância do EC2. Depois, retorne para esta etapa.

      Agora que você criou um perfil do IAM e atualizou a lista, ele será exibido como uma opção na lista suspensa. Selecione o perfil do IAM que você acabou de criar na lista suspensa Perfil de instância do EC2.

  12. Escolha Skip to Review (Pular para revisão) na página Configure service access (Configurar acesso a serviço).

    Isso selecionará os valores padrão para essa etapa e pulará as etapas opcionais.

  13. A página Review (Revisão) exibe um resumo de todas as suas escolhas.

    Para personalizar ainda mais o ambiente, escolha Edit (Editar) ao lado da etapa que inclui os itens que você deseja configurar. Você pode configurar as opções a seguir somente durante a criação do ambiente:

    • Nome do ambiente

    • Nome de domínio

    • Versão da plataforma

    • Processor

    • VPC

    • Nível

    Você pode alterar as configurações a seguir após a criação do ambiente, mas elas exigem que novas instâncias ou outros recursos sejam provisionados, e pode levar muito tempo para que elas sejam aplicadas:

    • Tipo de instância, volume raiz, par de chaves e função do AWS Identity and Access Management (IAM)

    • Banco de dados interno do Amazon RDS

    • Load balancer

    Para obter detalhes sobre todas as configurações disponíveis, consulte O assistente de criação de novo ambiente.

  14. Escolha Submit (enviar) na parte inferior da página para inicializar a criação do novo ambiente.

Configurar o acesso a serviço
Para criar um perfil do IAM para ser o perfil de instância do EC2
  1. Escolha Visualizar detalhes de permissão. Essa opção exibe a lista suspensa Perfil de instância do EC2.

    Uma janela modal intitulada Visualizar permissões de perfil de instância é exibida. Essa janela lista os perfis gerenciados que deverão ser anexados ao novo perfil de instância do EC2 que você criar. Ela também fornece um link para iniciar o console do IAM.

  2. Escolha o link Console do IAM exibido na parte superior da janela.

  3. No painel de navegação do console do IAM, escolha Roles (Perfis).

  4. Selecione Create role (Criar função).

  5. Em Tipo de entidade confiável, selecione Serviço da AWS.

  6. Em Use case (Caso de uso), selecione EC2.

  7. Escolha Next (Próximo).

  8. Anexe as políticas gerenciadas apropriadas. Role a janela modal Visualizar permissões de perfil de instância para ver as políticas gerenciadas. As políticas também estão listadas aqui:

    • AWSElasticBeanstalkWebTier

    • AWSElasticBeanstalkWorkerTier

    • AWSElasticBeanstalkMulticontainerDocker

  9. Escolha Next (Próximo).

  10. Insira um nome para a função.

  11. (Opcional) Adicione tags à função.

  12. Selecione Create role (Criar função).

  13. Retorne à janela do console do Elastic Beanstalk que está aberta.

  14. Feche a janela modal Visualizar permissões de perfil de instância.

    Importante

    Não feche a página do navegador que exibe o console do Elastic Beanstalk.

  15. Escolha refresh icon (atualizar), ao lado da lista suspensa Perfil de instância do EC2.

    Essa opção atualiza a lista suspensa para que o perfil que você acabou de criar seja exibido na lista suspensa.

Próximas etapas

Depois que um ambiente estiver executando um aplicativo, você poderá implantar uma nova versão do aplicativo ou um aplicativo completamente diferente a qualquer momento. A implantação de uma nova versão do aplicativo é muito rápida, pois não é necessário provisionar ou reiniciar as instâncias do EC2.

Depois de implantar um ou dois aplicativos de exemplo e estiver pronto para começar a desenvolver e executar aplicativos Java localmente, consulte a próxima seção para configurar um ambiente de desenvolvimento Java com todas as ferramentas e bibliotecas necessárias.