Guia de início rápido: implantar em aplicativos de contêiner do Azure usando o IntelliJ IDEA

Este artigo mostra como implantar um aplicativo em contêiner nos Aplicativos de Contêiner do Azure usando o Kit de Ferramentas do Azure para IntelliJ IDEA. O artigo usa um exemplo de serviço de API da Web de back-end que retorna uma coleção estática de álbuns de música.

Pré-requisitos

• Uma conta do Azure com uma subscrição ativa. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
• Um Java Development Kit (JDK) suportado. Para obter mais informações sobre os JDKs disponíveis para uso ao desenvolver no Azure, consulte Suporte a Java no Azure e Azure Stack.
• IntelliJ IDEA, Ultimate ou Community Edition.
• Maven 3.5.0+.
• Um cliente Docker.
• O Kit de Ferramentas do Azure para IntelliJ. Para obter mais informações, consulte Instalar o Kit de Ferramentas do Azure para IntelliJ. Você também precisa entrar em sua conta do Azure para o Kit de Ferramentas do Azure para IntelliJ. Para obter mais informações, consulte Instruções de entrada para o Kit de Ferramentas do Azure para IntelliJ.

Clone o projeto

1. Use os seguintes comandos para clonar o aplicativo de exemplo e fazer check-out da IDE ramificação:

   git clone https://github.com/Azure-Samples/containerapps-albumapi-java
   cd containerapps-albumapi-java
   git checkout IDE
   

2. Selecione Abrir para abrir o projeto no IntelliJ IDEA.

Construir e executar o projeto localmente

1. Use o seguinte comando para criar o projeto com o Maven:

   mvn clean package -DskipTests
   

2. Para verificar se o aplicativo está em execução, abra um navegador e vá para http://localhost:8080/albums. A página retorna uma lista de objetos JSON semelhante à saída do seguinte comando:

   java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar
   

Enviar imagem por push para um Registro de Contêiner do Azure

Para implantar seu projeto nos Aplicativos de Contêiner do Azure, você precisa criar a imagem do contêiner e enviá-la por push para um Registro de Contêiner do Azure primeiro.

1. No modo de exibição do Azure Explorer, expanda o nó do Azure, clique com o botão direito do mouse em Registros de Contêiner e selecione Criar no Portal do Azure.

2. Na página Criar registro de contêiner, insira as seguintes informações:

   • Assinatura: especifica a assinatura do Azure que você deseja usar para seu registro de contêiner.
   • Grupo de Recursos: Especifica o grupo de recursos para o registro do contêiner. Selecione uma das seguintes opções:
     • Criar novo: especifica que você deseja criar um novo grupo de recursos.
     • Usar existente: especifica que você deve selecionar em uma lista de grupos de recursos associados à sua conta do Azure.
   • Nome do Registro: Especifica um nome para o novo registro de contêiner.
   • Local: especifica a região onde o registro de contêiner é criado (por exemplo, Oeste dos EUA).
   • SKU: Especifica a camada de serviço para o registro do contêiner. Para este tutorial, selecione Básico.

3. Selecione Rever + criar e verifique se as informações estão corretas. Em seguida, selecione Criar.

4. Na guia Projeto, navegue até o projeto e abra o Dockerfile.

5. Selecione o ícone do Azure e, em seguida, selecione Enviar imagem por push para o Registro de Contêiner do Azure.

6. Selecione o registo que criou no passo anterior, preencha as seguintes informações e, em seguida, selecione Executar.

   • Nome do repositório: especifica o nome do repositório.
   • Nome da tag: especifica a versão de uma imagem ou outro artefato.

   

Criar um ambiente e um aplicativo de contêiner

Use as seguintes etapas para configurar seu ambiente e implantar um aplicativo de contêiner no Azure:

1. Clique com o botão direito do mouse em Ambiente de Aplicativos de Contêiner no modo de exibição do Azure Explorer e selecione Criar Ambiente de Aplicativos de Contêiner.

2. Na página Criar Ambiente de Aplicativos de Contêiner, insira as seguintes informações e selecione OK.

   • Assinatura: especifica a assinatura do Azure que você deseja usar.
   • Grupo de recursos: especifica o grupo de recursos para seus aplicativos de contêiner. Selecione uma das seguintes opções:
     • Criar novo: especifica que você deseja criar um novo grupo de recursos.
     • Usar existente: especifica que você deve selecionar em uma lista de grupos de recursos associados à sua conta do Azure.
   • Nome: especifica o nome do novo ambiente de aplicativos de contêiner.
   • Região: Especifica a região apropriada (por exemplo, Leste dos EUA).
   • Espaço de trabalho do Log Analytics: especifica o espaço de trabalho do Log Analytics que você deseja usar ou aceitar o padrão.

   

3. Clique com o botão direito do mouse no ambiente de aplicativos de contêiner que você criou e selecione Criar>Aplicativo de Contêiner no Azure Explorer. Introduza as informações seguintes:

   • Assinatura: especifica a assinatura do Azure que você deseja usar.
   • Grupo de recursos: especifica o grupo de recursos para seus aplicativos de contêiner. Selecione uma das seguintes opções:
     • Criar novo: especifica que você deseja criar um novo grupo de recursos.
     • Usar existente: especifica que você deve selecionar em uma lista de grupos de recursos associados à sua conta do Azure.
   • Nome: especifica o nome de um novo aplicativo de contêiner.
   • Região: Especifica a região apropriada (por exemplo, Leste dos EUA).
   • Ambiente: Especifica o Ambiente de Aplicativos de Contêiner que você deseja usar.
   • Guia de início rápido: selecione Usar imagem de início rápido.

   

4. Selecione OK. O kit de ferramentas exibe uma mensagem de status quando a criação do aplicativo é bem-sucedida.

Implementar a aplicação de contentor

1. Na guia Projeto, navegue até o projeto e abra o Dockerfile.

   

2. Selecione o ícone do Azure e, em seguida, selecione Implantar imagem no aplicativo de contêiner.

   

3. Na página Implantar Imagem em Aplicativos de Contêiner do Azure, insira as seguintes informações e selecione Executar.

   • Dockerfile/Image: Especifica o caminho do Dockerfile ou aceita o padrão.
   • Registro de Contêiner: Especifica o Registro de Contêiner que você deseja usar.
   • Nome do repositório: especifica o nome do repositório que você deseja usar no Registro de contêiner.
   • Nome da tag: especifica o nome da tag que você deseja usar no Registro de contêiner.
   • Aplicativo de contêiner: especifica o aplicativo de contêiner no qual você deseja implantar.
   • Ingresso: habilite a entrada para aplicativos que exigem um ponto de extremidade HTTP ou TCP. Selecione Ativar.
   • Tráfego externo: habilite o tráfego externo para aplicativos que precisam de um ponto de extremidade HTTP ou TCP. Selecione Ativar.
   • Porta de destino: defina esse valor como o número da porta que seu contêiner usa. Abra a porta 8080 nesta etapa.

   

4. Após a conclusão da implantação, o Kit de Ferramentas do Azure para IntelliJ exibe uma notificação. Selecione Procurar para abrir o aplicativo implantado em um navegador.

   

Na barra de endereço do navegador, acrescente o /albums caminho até o final da URL do aplicativo para exibir dados de uma solicitação de API de exemplo.

Clean up resources (Limpar recursos)

Se quiser limpar e remover um recurso de Aplicativos de Contêiner do Azure, você pode excluir o recurso ou grupo de recursos. A exclusão do grupo de recursos também exclui quaisquer outros recursos associados a ele. Use as seguintes etapas para limpar recursos:

1. Para excluir seus recursos de Aplicativos de Contêiner do Azure, navegue até a barra lateral esquerda do Azure Explorer e localize o item Ambiente de Aplicativos de Contêiner.

2. Clique com o botão direito do rato no serviço Aplicações de Contentor do Azure que pretende eliminar e, em seguida, selecione Eliminar.

3. Para excluir seu grupo de recursos, visite o portal do Azure e exclua manualmente os recursos em sua assinatura.

Próximos passos

• Visão geral do Java on Azure Container Apps