Guia de início rápido: inicie seu primeiro aplicativo de microsserviço Java com componentes Java gerenciados em Aplicativos de Contêiner do Azure

Neste início rápido, você aprenderá a implantar um aplicativo em Aplicativos de Contêiner do Azure que usa componentes Java para lidar com gerenciamento de configuração, descoberta de serviços e integridade e métricas. O aplicativo de exemplo usado neste exemplo é o Java PetClinic, que usa o padrão de arquitetura de microsserviço. O diagrama a seguir descreve a arquitetura do aplicativo PetClinic em Aplicativos de Contêiner do Azure:

Diagrama de um ambiente de Aplicativos de Contêiner do Azure ilustrando a arquitetura de quatro aplicativos baseados em microsserviços implantados em um grupo de recursos do Azure. Um grupo de recursos contém o ambiente de Aplicativos de Contêiner do Azure. O ambiente inclui três componentes Java gerenciados dos Aplicativos de Contêiner do Azure: um servidor de configuração, um registro de serviço e um servidor de administração. O servidor de configuração busca dados de configuração armazenados como arquivos YAML versionados em um repositório Git externo ao ambiente de Aplicativos de Contêiner do Azure. O registro de serviço lida com a descoberta e o registro do serviço. O servidor de administração fornece uma visualização ao vivo do sistema. Um gateway de API encaminha solicitações para três microsserviços: serviço veterinário, atendimento ao cliente e serviço de visitas. Cada serviço é vinculado ao seu próprio banco de dados para persistência de dados. O ambiente suporta interações externas através de um browser e de uma aplicação móvel e integra-se com ferramentas de monitorização através dos Espaços de Trabalho do Azure Log Analytics para acompanhar o desempenho e o estado de funcionamento do sistema.

A aplicação PetClinic inclui as seguintes funcionalidades:

• O front-end é uma aplicação web Node.js autónoma hospedada na aplicação de gateway de API.
• O gateway de API roteia solicitações para aplicativos de serviço back-end.
• Os aplicativos back-end são criados com o Spring Boot.
• Cada aplicativo back-end usa um banco de dados HyperSQL como armazenamento persistente.
• Os aplicativos usam componentes Java gerenciados em Aplicativos de Contêiner do Azure, incluindo um registro de serviço, servidor de configuração e servidor de administração.
• O servidor de configuração lê dados de um repositório Git.
• Um espaço de trabalho do Log Analytics registra dados do servidor.

Neste tutorial, você:

• Crie um servidor de configuração, um servidor Eureka, um servidor de administração e componentes de administração
• Criar uma série de aplicativos de microsserviço
• Vincular os componentes do servidor aos seus aplicativos de microsserviços
• Implantar a coleção de aplicativos
• Revisar os aplicativos implantados

No final deste artigo, você implanta um aplicativo Web e três aplicativos back-end configurados para funcionar com três componentes Java diferentes. Em seguida, você pode gerenciar cada componente por meio do portal do Azure.

Pré-requisitos

• Conta do Azure: se você não tiver uma conta do Azure, crie uma gratuitamente. Você precisa da permissão de Colaborador ou Proprietário na assinatura do Azure para usar esse início rápido. Para obter mais informações, consulte Atribuir funções do Azure usando o portal do Azure.
• CLI do Azure: Instale a CLI do Azure.
• Extensão da CLI dos Aplicativos de Contêiner do Azure. Use a versão 0.3.47 ou superior. Use o az extension add --name containerapp --upgrade --allow-preview comando para instalar a versão mais recente.

Configuração

Para criar variáveis de ambiente, um grupo de recursos e um ambiente de Aplicativos de Contêiner do Azure, use as seguintes etapas:

1. As variáveis de ambiente contêm os seus valores personalizados, portanto, substitua os valores entre parênteses angulares, cercados por <>, pelos seus próprios valores antes de executar os comandos seguintes.

   export RESOURCE_GROUP=<RESOURCE_GROUP>
   export LOCATION=<LOCATION>
   export CONTAINER_APP_ENVIRONMENT=<CONTAINER_APPS_ENVIRONMENT>
   

2. Agora você cria mais variáveis de ambiente que contêm as configurações para seu aplicativo de microsserviços. Esses valores são usados para definir os nomes e as configurações dos componentes Java e dos Aplicativos de Contêiner do Azure que você usa para implantar os microsserviços. Crie essas variáveis de ambiente usando os seguintes comandos:

   export CONFIG_SERVER_COMPONENT=configserver
   export ADMIN_SERVER_COMPONENT=admin
   export EUREKA_SERVER_COMPONENT=eureka
   export CONFIG_SERVER_URI=https://github.com/spring-petclinic/spring-petclinic-microservices-config.git
   export CUSTOMERS_SERVICE=customers-service
   export VETS_SERVICE=vets-service
   export VISITS_SERVICE=visits-service
   export API_GATEWAY=api-gateway
   export CUSTOMERS_SERVICE_IMAGE=ghcr.io/azure-samples/javaaccelerator/spring-petclinic-customers-service
   export VETS_SERVICE_IMAGE=ghcr.io/azure-samples/javaaccelerator/spring-petclinic-vets-service
   export VISITS_SERVICE_IMAGE=ghcr.io/azure-samples/javaaccelerator/spring-petclinic-visits-service
   export API_GATEWAY_IMAGE=ghcr.io/azure-samples/javaaccelerator/spring-petclinic-api-gateway
   

3. Entre na CLI do Azure e escolha sua assinatura ativa usando o seguinte comando:

   az login
   

4. Crie um grupo de recursos para organizar seus serviços do Azure usando o seguinte comando:

   az group create \
       --name $RESOURCE_GROUP \
       --location $LOCATION
   

5. Crie seu ambiente de Aplicativos de Contêiner do Azure, que hospeda os componentes Java e seus aplicativos de contêiner, usando o seguinte comando:

   az containerapp env create \
       --resource-group $RESOURCE_GROUP \
       --name $CONTAINER_APP_ENVIRONMENT \
       --location $LOCATION
   

Criar componentes Java

Agora você cria os seguintes componentes Java que suportam seu aplicativo:

• Configuração do servidor. Usado para gerenciar definições de configuração para seus aplicativos de microsserviços.
• Servidor Eureka. Usado para gerenciar o registro e a descoberta do serviço.
• Servidor de administração. Usado para monitorar e gerenciar a integridade e as métricas de seus aplicativos de microsserviços.

Para criar esses componentes de servidor, use as seguintes etapas:

CLI do Azure

1. Crie o servidor de configuração para seus componentes Java usando o seguinte comando:

   az containerapp env java-component config-server-for-spring create \
       --resource-group $RESOURCE_GROUP \
       --name $CONFIG_SERVER_COMPONENT \
       --environment $CONTAINER_APP_ENVIRONMENT \
       --configuration spring.cloud.config.server.git.uri=$CONFIG_SERVER_URI
   

2. Crie o servidor Eureka para seus componentes Java usando o seguinte comando:

   az containerapp env java-component eureka-server-for-spring create \
       --resource-group $RESOURCE_GROUP \
       --name $EUREKA_SERVER_COMPONENT
       --environment $CONTAINER_APP_ENVIRONMENT \
   

3. Crie o servidor de administração para seus componentes Java usando o seguinte comando:

   az containerapp env java-component admin-for-spring create \
       --resource-group $RESOURCE_GROUP \
       --name $ADMIN_SERVER_COMPONENT
       --environment $CONTAINER_APP_ENVIRONMENT \
   

Portal do Azure

Para criar os três componentes Java, use as seguintes etapas:

1. Abra seu ambiente de Aplicativos de Contêiner no portal do Azure.

2. Aceda a Serviços, selecione Serviço e escolha o seu serviço.

3. Para criar o componente de servidor de configuração, use estas etapas:

   1. Selecione Configurar e escolha o componente Java para criar um novo componente Java.

   2. Use a tabela a seguir para adicionar os valores na janela do portal:

      Configurações	Valor	Observações
      Tipo de componente Java	Selecione Config Server for Spring.
      Nome do componente Java	Digite configserver.	Esse valor corresponde ao que você definiu para a $CONFIG_SERVER_COMPONENT variável.

   3. Na seção Repositórios Git , selecione Adicionar.

   4. Para o campo URI , digite https://github.com/spring-petclinic/spring-petclinic-microservices-config.git. (Não inclua o período final.)

   5. Selecione Adicionar.

   6. Selecione Avançar.

   7. Selecione Configurar para concluir a configuração.

4. Para criar o componente de servidor Eureka, use estas etapas:

   1. Selecione Configurar e escolha Componente Java para criar um novo componente Java.

   2. Use a tabela a seguir para adicionar os valores na janela do portal:

      Configurações	Valor	Observações
      Tipo de componente Java	Selecione Eureka Server for Spring.
      Nome do componente Java	Digite eureka.	Esse valor corresponde ao que você definiu para a $EUREKA_SERVER_COMPONENT variável.

   3. Selecione Avançar.

   4. Selecione Configurar para concluir a configuração.

5. Para criar o componente de servidor de administração, use as seguintes etapas:

   1. Selecione Configurar e escolha o componente Java para criar um novo componente Java.

   2. Use a tabela a seguir para adicionar os valores na janela do portal:

      Configurações	Valor	Observações
      Tipo de componente Java	Selecione Admin para Spring.
      Nome do componente Java	Digite admin.	Esse valor corresponde ao que você definiu para a $ADMIN_SERVER_COMPONENT variável.

   3. Selecione Avançar.

   4. Selecione Configurar para concluir a configuração.

Implantar os aplicativos de microsserviço

Para implantar os aplicativos de microsserviço Java nos Aplicativos de Contêiner do Azure usando as imagens de contêiner pré-criadas, use as seguintes etapas:

Observação

Neste artigo, você usa uma série de imagens criadas para os aplicativos de microsserviço Spring Petclinic. Você também tem a opção de personalizar o código de exemplo e usar suas próprias imagens. Para obter mais informações, consulte o repositório do GitHub azure-container-apps-java-samples.

1. Crie o aplicativo de dados do cliente usando o seguinte comando:

   az containerapp create \
       --resource-group $RESOURCE_GROUP \
       --name $CUSTOMERS_SERVICE \
       --environment $CONTAINER_APP_ENVIRONMENT \
       --image $CUSTOMERS_SERVICE_IMAGE
   

2. Crie o aplicativo vet usando o seguinte comando:

   az containerapp create \
       --resource-group $RESOURCE_GROUP \
       --name $VETS_SERVICE \
       --environment $CONTAINER_APP_ENVIRONMENT \
       --image $VETS_SERVICE_IMAGE
   

3. Crie o aplicativo de visitas usando o seguinte comando:

   az containerapp create \
       --resource-group $RESOURCE_GROUP \
       --name $VISITS_SERVICE \
       --environment $CONTAINER_APP_ENVIRONMENT \
       --image $VISITS_SERVICE_IMAGE
   

4. Crie o aplicativo de gateway de API usando o seguinte comando:

   az containerapp create \
       --resource-group $RESOURCE_GROUP \
       --name $API_GATEWAY \
       --environment $CONTAINER_APP_ENVIRONMENT \
       --image $API_GATEWAY_IMAGE \
       --ingress external \
       --target-port 8080 \
       --query properties.configuration.ingress.fqdn 
   

Vincular aplicativos de contêiner a componentes Java

Em seguida, vincule os componentes Java aos seus aplicativos de contêiner. As associações que você cria nesta seção fornecem a seguinte funcionalidade:

• Injete dados de configuração em cada aplicativo a partir do servidor de configuração gerenciado na inicialização.
• Registe a aplicação no servidor Eureka gerido para deteção de serviços.
• Habilite o servidor de administração para monitorar o aplicativo.

CLI do Azure

Use o containerapp update comando para criar associações para cada aplicativo usando as seguintes etapas:

1. Adicione associações ao aplicativo de dados do cliente usando o seguinte comando:

   az containerapp update \
       --resource-group $RESOURCE_GROUP \
       --name $CUSTOMERS_SERVICE \
       --bind $CONFIG_SERVER_COMPONENT $EUREKA_SERVER_COMPONENT $ADMIN_SERVER_COMPONENT
   

2. Adicione associações ao serviço veterinário usando o seguinte comando:

   az containerapp update \
       --resource-group $RESOURCE_GROUP \
       --name $VETS_SERVICE \
       --bind $CONFIG_SERVER_COMPONENT $EUREKA_SERVER_COMPONENT $ADMIN_SERVER_COMPONENT
   

3. Adicione associações ao serviço de visitas usando o seguinte comando:

   az containerapp update \
       --resource-group $RESOURCE_GROUP \
       --name $VISITS_SERVICE \
       --bind $CONFIG_SERVER_COMPONENT $EUREKA_SERVER_COMPONENT $ADMIN_SERVER_COMPONENT
   

4. Adicione associações ao gateway de API. Use o seguinte comando para retornar a URL do aplicativo front-end e abra esse local no navegador:

   az containerapp update \
       --resource-group $RESOURCE_GROUP \
       --name $API_GATEWAY \
       --bind $CONFIG_SERVER_COMPONENT $EUREKA_SERVER_COMPONENT $ADMIN_SERVER_COMPONENT \
       --query properties.configuration.ingress.fqdn 
   

Portal do Azure

Use as seguintes etapas para criar associações para cada aplicativo:

1. Abra seu ambiente de Aplicativos de Contêiner no portal do Azure.

2. Vá para Serviços e selecione Serviço.

3. Para cada um dos três componentes, selecione o componente pelo nome.

4. Na seção Ligações , adicione os quatro aplicativos criados neste início rápido.

   

Verificar o status do aplicativo

Use as seguintes etapas para verificar o status do aplicativo:

1. Usando a URL retornada do comando az containerapp update do gateway de API, visualize o aplicativo front-end no seu navegador. O aplicativo deve ser semelhante à seguinte captura de tela:

   

2. Exiba o painel do servidor Eureka usando as seguintes etapas:

   Importante

   Para visualizar o painel do Eureka Server e o painel Admin for Spring, você precisa ter pelo menos a Microsoft.App/managedEnvironments/write função atribuída à sua conta no recurso de ambiente gerenciado. Você pode atribuir explicitamente a função Owner ou Contributor no recurso. Você também pode seguir as etapas para criar uma definição de função personalizada e atribuí-la à sua conta.

   1. Execute o seguinte comando para retornar a URL do painel:

      az containerapp env java-component eureka-server-for-spring show \
          --resource-group $RESOURCE_GROUP \
          --name $EUREKA_SERVER_COMPONENT \
          --environment $CONTAINER_APP_ENVIRONMENT \
          --query properties.ingress.fqdn
      

   2. Abra o URL no seu navegador. Você verá um aplicativo semelhante à seguinte captura de tela:

      

3. Exiba o painel Admin for Spring usando as seguintes etapas:

   1. Use o seguinte comando para retornar a URL do painel:

      az containerapp env java-component admin-for-spring show \
          --resource-group $RESOURCE_GROUP \
          --name $ADMIN_SERVER_COMPONENT \
          --environment $CONTAINER_APP_ENVIRONMENT \
          --query properties.ingress.fqdn
      

   2. Abra o URL no seu navegador. Você verá um aplicativo semelhante à seguinte captura de tela:

      

Opcional: Configurar componentes Java

Você pode configurar os componentes Java criados neste início rápido por meio do portal do Azure usando a seção Configurações .

Para obter mais informações sobre como configurar os três componentes Java criados neste início rápido, consulte os seguintes links:

• Servidor de configuração
• Servidor Eureka
• Servidor de administração

Limpeza de recursos

Os recursos criados neste início rápido têm um efeito na sua fatura do Azure. Se você não vai usar esses serviços a longo prazo, use o seguinte comando para remover tudo o que foi criado neste início rápido:

az group delete --resource-group $RESOURCE_GROUP

Conteúdo relacionado

• Componentes Java