Guia de início rápido: implantar aplicativos de microsserviço no Azure Spring Apps
Artigo
Nota
Os planos Basic, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de aposentadoria de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.
O plano de consumo padrão e dedicado será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte Migrar consumo padrão e plano dedicado do Azure Spring Apps para Aplicativos de Contêiner do Azure.
Este artigo explica como implantar aplicativos de microsserviço no Azure Spring Apps usando o conhecido aplicativo de exemplo PetClinic.
O exemplo Pet Clinic demonstra o padrão de arquitetura de microsserviços. O diagrama a seguir mostra a arquitetura do aplicativo PetClinic no plano do Azure Spring Apps Enterprise.
O diagrama mostra os seguintes fluxos e relações arquitetônicas do exemplo da Pet Clinic:
Usa o Azure Spring Apps para gerenciar os aplicativos frontend e back-end. Os aplicativos de back-end são criados com o Spring Boot e cada aplicativo usa HSQLDB como o armazenamento persistente. O aplicativo frontend reforjado se baseia no Pet Clinic API Gateway App com Node.js servindo como um aplicativo Web frontend autônomo.
Usa os componentes gerenciados no Azure Spring Apps, incluindo Registro de Serviço, Serviço de Configuração de Aplicativo, Spring Cloud Gateway e Exibição ao Vivo de Aplicativo. O Serviço de Configuração de Aplicativo lê a configuração do repositório Git.
Expõe a URL do Spring Cloud Gateway para rotear a solicitação para aplicativos de serviço de back-end e expõe a URL do Application Live View para monitorar os aplicativos de back-end.
Analisa logs usando o espaço de trabalho do Log Analytics.
Monitora o desempenho com o Application Insights.
Nota
Este artigo usa uma versão simplificada do PetClinic, usando um banco de dados na memória que não está pronto para produção para implantar rapidamente no Azure Spring Apps.
O Tanzu Developer Tools expõe o acesso público para o Application Live View, que é um ponto de risco. O ambiente de produção precisa proteger o acesso. Para obter mais informações, consulte a seção Configurar Portal de Ferramentas de Desenvolvimento de Configurar Ferramentas de Desenvolvimento Tanzu no plano do Azure Spring Apps Enterprise.
O exemplo Pet Clinic demonstra o padrão de arquitetura de microsserviços. O diagrama a seguir mostra a arquitetura do aplicativo PetClinic no plano Azure Spring Apps Standard.
O diagrama mostra os seguintes fluxos e relações arquitetônicas do exemplo da Pet Clinic:
Usa o Azure Spring Apps para gerenciar os aplicativos Spring Boot. Cada aplicativo usa HSQLDB como o armazenamento persistente.
Usa os componentes gerenciados Spring Cloud Config Server e Eureka Service Registry no Azure Spring Apps. O Config Server lê a configuração do repositório Git.
Expõe a URL do API Gateway para solicitações de balanceamento de carga para aplicativos de serviço e expõe a URL do Admin Server para gerenciar os aplicativos.
Analisa logs usando o espaço de trabalho do Log Analytics.
Monitora o desempenho com o Application Insights.
Nota
Este artigo usa uma versão simplificada do PetClinic, usando um banco de dados na memória que não está pronto para produção para implantar rapidamente no Azure Spring Apps.
O aplicativo admin-server implantado expõe o acesso público, que é um ponto de risco. O ambiente de produção precisa proteger o aplicativo Spring Boot Admin.
Este artigo fornece as seguintes opções para implantação no Azure Spring Apps:
A opção de portal do Azure é a maneira mais fácil e rápida de criar recursos e implantar aplicativos com um único clique. Essa opção é adequada para desenvolvedores do Spring que desejam implantar rapidamente aplicativos nos serviços de nuvem do Azure.
A opção de plug-in do portal do Azure + Maven é uma maneira mais convencional de criar recursos e implantar aplicativos passo a passo. Essa opção é adequada para desenvolvedores do Spring que usam os serviços de nuvem do Azure pela primeira vez.
A opção CLI do Azure usa uma poderosa ferramenta de linha de comando para gerenciar recursos do Azure. Essa opção é adequada para desenvolvedores do Spring que estão familiarizados com os serviços de nuvem do Azure.
A opção de plug-in do portal do Azure + Maven é uma maneira mais convencional de criar recursos e implantar aplicativos passo a passo. Essa opção é adequada para desenvolvedores do Spring que usam os serviços de nuvem do Azure pela primeira vez.
A opção CLI do Desenvolvedor do Azure é uma maneira mais eficiente de criar recursos e implantar aplicativos automaticamente por meio de comandos simples. A CLI do Desenvolvedor do Azure usa um modelo para provisionar os recursos do Azure necessários e implantar o código do aplicativo. Essa opção é adequada para desenvolvedores do Spring que estão familiarizados com os serviços de nuvem do Azure.
Insira um novo nome de ambiente: forneça um nome de ambiente, que é usado como um sufixo para o grupo de recursos criado para armazenar todos os recursos do Azure. Esse nome deve ser exclusivo em sua assinatura do Azure.
O console emite mensagens semelhantes ao exemplo a seguir:
Initializing a new project (azd init)
Downloading template code to: <your-local-path>
(✓) Done: Initialized git repository
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Prepare o ambiente de nuvem
Esta seção descreve como criar uma instância de serviço do Azure Spring Apps e preparar o ambiente de nuvem do Azure.
Aceda ao portal do Azure, introduza as suas credenciais e inicie sessão no portal. A vista predefinida é o dashboard de serviço.
3.2. Criar uma instância do Azure Spring Apps
Use as seguintes etapas para criar a instância de serviço:
Selecione Criar um recurso no canto do portal do Azure.
Na guia Serviços do Azure, selecione Compute>Azure Spring Apps.
Na página Criar Aplicativos de primavera do Azure, preencha o formulário na guia Noções básicas.
Use a tabela a seguir como um guia para preencher o formulário. O plano recomendado é Standard.
Definição
Valor sugerido
Description
Subscrição
O nome da subscrição.
A subscrição do Azure que quer utilizar para o servidor. Se tiver várias subscrições, escolha a subscrição pela qual pretende ser cobrado pelo recurso.
Grupo de recursos
myresourcegroup
Um nome de grupo de recursos novo ou um já existente na sua subscrição.
Nome
Miasa
Um nome exclusivo que identifica sua instância do Azure Spring Apps. O nome deve ter entre 4 e 32 caracteres e pode conter apenas letras minúsculas, números e hífenes. O primeiro caractere do nome do serviço deve ser uma letra e o último caractere deve ser uma letra ou um número.
Planear
Standard
O plano de preços determina os recursos e o custo associados à sua instância.
Região
A região mais próxima dos seus utilizadores.
A localização que esteja mais próxima dos seus utilizadores.
Zona redundante
não selecionado
Cria seu serviço Azure Spring Apps em uma zona de disponibilidade do Azure. Atualmente não é suportado em todas as regiões.
Navegue até a guia Configurações de diagnóstico na página Criar Azure Spring Apps e selecione Criar novo para criar uma nova instância de espaços de trabalho do Log Analytics. Na página Criar novo espaço de trabalho do Log Analytics, atualize o nome do espaço de trabalho do Log Analytics conforme necessário e selecione OK para confirmar a criação.
Navegue até a guia Application Insights na página Criar Azure Spring Apps e selecione Criar novo para criar uma nova instância do Application Insights. Na página Criar novo recurso do Application Insights, atualize o nome do Application Insights conforme necessário, selecione Baseado em espaço de trabalho para o modo de recurso e selecione OK para confirmar a criação.
Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para provisionar a instância do Azure Spring Apps.
Selecione o ícone Notificações (um sino) para monitorar o processo de implantação. Após a conclusão da implantação, você pode selecionar Fixar no painel para criar um atalho no painel do portal do Azure para a página Visão geral do serviço.
Selecione Ir para o recurso para ir para a página Visão Geral do Azure Spring Apps.
Após a validação, selecione Aplicar para concluir a configuração do Config Server.
Use as seguintes etapas para criar os recursos necessários:
Use o comando a seguir para entrar no Azure com OAuth2. Ignore este passo se já tiver iniciado sessão.
azd auth login
O console emite mensagens semelhantes ao exemplo a seguir:
Logged in to Azure.
Use o seguinte comando para empacotar uma cópia implantável do seu aplicativo, provisionar a infraestrutura do modelo no Azure e implantar o código do aplicativo nesses recursos recém-provisionados:
azd provision
A lista a seguir descreve as interações de comando:
Selecione uma Assinatura do Azure para usar: use as setas para mover, digite para filtrar e pressione Enter.
Selecione um local do Azure para usar: use as setas para mover, digite para filtrar e pressione Enter.
O console emite mensagens semelhantes ao exemplo a seguir:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Nota
A conclusão deste comando poderá demorar algum tempo. É mostrado um indicador de progresso à medida que provisiona recursos do Azure.
4. Implantar os aplicativos no Azure Spring Apps
Agora você pode implantar o aplicativo no Azure Spring Apps.
A lista a seguir descreve as interações de comando:
Selecione módulos filho para configurar (números de entrada separados por vírgula, por exemplo: [1-2,4,6], ENTER para selecionar ALL): Pressione Enter para selecionar todos.
Login OAuth2: autorize a entrada no Azure com base no protocolo OAuth2.
Selecionar assinatura: selecione o número da lista de assinaturas da instância do Azure Spring Apps que você criou, que assume como padrão a primeira assinatura na lista. Se você usar o número padrão, pressione Enter diretamente.
Selecione Azure Spring Apps para implantação: selecione o número da lista da instância do Azure Spring Apps que você criou. Se você usar o número padrão, pressione Enter diretamente.
Selecione aplicativos para expor o acesso público:(números de entrada separados por vírgula, por exemplo: [1-2,4,6], ENTER para selecionar NENHUM): Digite 1,5 para admin-server e api-gateway.
Confirme para salvar todas as configurações acima (S/n): Pressione y. Se você pressionar n, a configuração não será salva nos arquivos POM.
Use o seguinte comando para criar e implantar cada aplicativo:
./mvnw azure-spring-apps:deploy
Para o prompt de logon OAuth2, autorize o logon no Azure com base no protocolo OAuth2.
Nota
A implantação no Azure Spring Apps pode levar até 25 minutos.
Depois que o comando é executado, um log exibe uma saída semelhante ao exemplo a seguir, que indica que todas as implantações foram bem-sucedidas:
[INFO] Deployment(default) is successfully updated.
[INFO] Deployment Status: Running
[INFO] InstanceName:admin-server-default-xx-xx-xxx Status:Running Reason:null DiscoverStatus:UP
[INFO] Getting public url of app(admin-server)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io
...
[INFO] Getting public url of app(api-gateway)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io
Use as etapas a seguir para empacotar o aplicativo, provisionar os recursos do Azure exigidos pelo aplicativo Web e implantar no Azure Spring Apps:
Use o seguinte comando para empacotar uma cópia implantável do seu aplicativo:
azd package
O console emite mensagens semelhantes ao exemplo a seguir:
SUCCESS: Your application was packaged for Azure in xx minutes xx seconds.
Use o seguinte comando para implantar o código do aplicativo nesses recursos recém-provisionados:
azd deploy
O console emite mensagens semelhantes ao exemplo a seguir:
Deploying services (azd deploy)
(✓) Done: Deploying service admin-server
- Endpoint: https://<your-Azure-Spring-Apps-instance-name>-admin-server.azuremicroservices.io
(✓) Done: Deploying service api-gateway
- Endpoint: https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io
(✓) Done: Deploying service customers-service
- No endpoints were found
(✓) Done: Deploying service vets-service
- No endpoints were found
(✓) Done: Deploying service visits-service
- No endpoints were found
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Nota
Você também pode usar azd up para combinar os três comandos anteriores: azd package (empacota uma cópia implantável do seu aplicativo), azd provision (provisiona recursos do Azure) e (implanta azd deploy o código do aplicativo). Para obter mais informações, consulte Azure-Samples/spring-petclinic-microservices.
O botão Implantar no Azure na próxima seção inicia uma experiência de portal do Azure que implanta o código-fonte do repositório Spring PetClinic . Não são necessárias etapas de preparação locais.
Use as seguintes etapas em sua máquina local quando quiser verificar o aplicativo antes de implantá-lo na nuvem:
Use o seguinte comando para clonar o aplicativo Pet Clinic do GitHub:
Para os serviços Clientes, Veterinários, Visitas e Spring Cloud Gateway, abra uma nova janela Bash e use os seguintes comandos para iniciar os serviços:
Abra uma nova janela Bash e navegue até o diretório do projeto spring-petclinic-frontend . Use os seguintes comandos para instalar dependências e executar o aplicativo frontend:
npm install
npm run start
Depois que o script for concluído com sucesso, vá para http://localhost:8080 o seu navegador para acessar o aplicativo PetClinic.
Use as seguintes etapas em sua máquina local quando quiser verificar o aplicativo antes de implantá-lo na nuvem:
Use o seguinte comando para clonar o aplicativo Pet Clinic do GitHub:
Para os serviços Clientes, Veterinários, Visitas e Spring Cloud Gateway, abra uma nova janela Bash e use os seguintes comandos para iniciar os serviços:
Abra uma nova janela Bash e navegue até o diretório do projeto spring-petclinic-frontend . Use os seguintes comandos para instalar dependências e executar o aplicativo frontend:
npm install
npm run start
Depois que o script for concluído com sucesso, vá para http://localhost:8080 o seu navegador para acessar o aplicativo PetClinic.
3. Prepare o ambiente de nuvem
O principal recurso necessário para executar este exemplo é uma instância do Azure Spring Apps. Esta seção descreve como criar esse recurso.
Esta seção usa um botão Implantar no Azure para iniciar uma experiência de implantação no portal do Azure. Essa experiência usa um modelo ARM para criar recursos do Azure.
3.1. Inicie sessão no portal do Azure
Aceda ao portal do Azure, introduza as suas credenciais e inicie sessão no portal. A vista predefinida é o dashboard de serviço.
3.2. Criar recursos do Azure
Use as seguintes etapas para criar todos os recursos do Azure dos quais o aplicativo depende:
Selecione o seguinte botão Implantar no Azure para iniciar a experiência de implantação no portal do Azure:
Preencha o formulário na guia Noções básicas . Use a tabela a seguir como um guia para preencher o formulário:
Definição
Valor sugerido
Description
Subscrição
O nome da subscrição.
A subscrição do Azure que quer utilizar para o servidor. Se tiver várias subscrições, escolha a subscrição na qual pretende ser cobrado pelo recurso.
Grupo de recursos
myresourcegroup
Um nome de grupo de recursos novo ou um já existente na sua subscrição.
Região
A região mais próxima dos seus utilizadores.
A região é usada para criar o grupo de recursos.
Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para implantar o aplicativo no Azure Spring Apps.
Na barra de ferramentas, selecione o ícone Notificações (um sino) para monitorizar o processo de implementação. Após a conclusão da implantação, você pode selecionar Fixar no painel, que cria um bloco para esse serviço no painel do portal do Azure como um atalho para a página Visão geral do serviço. Selecione Ir para recurso para abrir a página Visão geral do serviço.
3.1. Inicie sessão no portal do Azure
Vá para o portal do Azure e insira suas credenciais para entrar no portal. A vista predefinida é o dashboard de serviço.
3.2. Criar uma instância do Azure Spring Apps
Use as seguintes etapas para criar a instância de serviço:
Selecione Criar um recurso no canto do portal do Azure.
Selecione Compute>Azure Spring Apps.
Preencha o formulário na guia Noções básicas . Use a tabela a seguir como um guia para preencher o formulário:
Definição
Valor sugerido
Description
Subscrição
O nome da subscrição.
A subscrição do Azure que quer utilizar para o servidor. Se tiver várias subscrições, escolha a subscrição na qual pretende ser cobrado pelo recurso.
Grupo de recursos
myresourcegroup
Um nome de grupo de recursos novo ou um já existente na sua subscrição.
Nome
Miasa
Um nome exclusivo que identifica seu serviço Azure Spring Apps. O nome deve ter entre 4 e 32 caracteres e pode conter apenas letras minúsculas, números e hífenes. O primeiro caractere do nome do serviço deve ser uma letra e o último caractere deve ser uma letra ou um número.
Região
A região mais próxima dos seus utilizadores.
A localização que esteja mais próxima dos seus utilizadores.
Opções e planos de hospedagem
Enterprise
O plano de preços que determina o recurso e o custo associados à sua instância.
Zona redundante
não selecionado
A opção para criar seu serviço Azure Spring Apps em uma zona de disponibilidade do Azure. Atualmente, esse recurso não é suportado em todas as regiões.
Plano IP de Software
Pay as you go
O plano de preços que lhe permite pagar à medida que avança com as Aplicações Azure Spring.
Implantar projeto de exemplo
não selecionado
A opção para usar o aplicativo de exemplo interno.
Navegue até a guia Configurações de diagnóstico na página Criar Azure Spring Apps e selecione Criar novo para criar uma nova instância de espaços de trabalho do Log Analytics. Na página Criar novo espaço de trabalho do Log Analytics, atualize o nome do espaço de trabalho do Log Analytics conforme necessário e selecione OK para confirmar a criação.
Navegue até a guia Application Insights na página Criar Azure Spring Apps e selecione Criar novo para criar uma nova instância do Application Insights. Na página Criar novo recurso do Application Insights, atualize o nome do Application Insights conforme necessário, selecione Baseado em espaço de trabalho para o modo de recurso e selecione OK para confirmar a criação.
Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para provisionar a instância do Azure Spring Apps.
Selecione o ícone Notificações (um sino) para monitorar o processo de implantação. Após a conclusão da implantação, você pode selecionar Fixar no painel para criar um atalho no painel do portal do Azure para a página Visão geral do serviço.
Selecione Ir para o recurso para ir para a página Visão Geral do Azure Spring Apps.
3.3. Configurar a instância do Azure Spring Apps
As seções a seguir mostram como configurar a instância de serviço.
Criar as aplicações
Use as seguintes etapas para criar os aplicativos:
No painel de navegação, selecione Aplicativos e, em seguida, selecione Criar aplicativo.
Na página Criar aplicativo, para o nome do aplicativo, use frontend e deixe todos os outros campos com seus valores padrão.
Repita a etapa anterior usando cada um dos seguintes nomes de aplicativo:
customers-service
vets-service
visits-service
Selecione Criar para concluir a criação do aplicativo.
Configurar o Registro de Serviço
Use as seguintes etapas para configurar o Registro de Serviço:
No painel de navegação, selecione Registro de Serviço.
Selecione Vinculação de aplicativo, selecione Vincular aplicativo, selecione customers-service na lista e selecione Aplicar.
Repita a etapa anterior para vincular os seguintes aplicativos:
vets-service
visits-service
Configurar o Serviço de Configuração do Aplicativo
Use as seguintes etapas para configurar o Serviço de Configuração do Aplicativo:
No painel de navegação, selecione Serviço de Configuração de Aplicativo e, em seguida, selecione Configurações.
Preencha o repositório com as seguintes informações e selecione Validar:
Após a validação, selecione Aplicar para concluir a configuração do Serviço de Configuração do Aplicativo.
Selecione Vinculação de aplicativo, selecione Vincular aplicativo, selecione customers-service na lista e selecione Aplicar.
Repita a etapa anterior para vincular os seguintes aplicativos:
vets-service
visits-service
Definir os padrões de arquivo de configuração para aplicativos
Use as seguintes etapas para definir os padrões do arquivo de configuração:
No painel de navegação, selecione Aplicativos e, em seguida, selecione o customers-service aplicativo.
Na página Visão geral do aplicativo, selecione Configuração, selecione Padrões de arquivo de configuração na guia Configurações gerais e, em seguida, selecione aplicativo e customers-service. Selecione Salvar para definir os padrões do arquivo de configuração.
Repita a etapa anterior para salvar os padrões de arquivo de configuração para os seguintes aplicativos:
vets-service: Selecione o aplicativo e vets-service.
visits-service: Selecione o aplicativo e visits-service.
Configurar o Spring Cloud Gateway
Esta seção mostra como configurar o Spring Cloud Gateway.
Primeiro, use as seguintes etapas para atribuir um ponto de extremidade para o acesso ao gateway:
No painel de navegação, selecione Spring Cloud Gateway.
Na guia Visão geral, selecione Sim para atribuir um ponto de extremidade. Salve o URL do ponto de extremidade para usar mais tarde.
Em seguida, configure o roteamento para o Spring Cloud Gateway. Como o portal do Azure atualmente não oferece suporte à configuração de rota para o Spring Cloud Gateway, abra uma janela Bash e use as seguintes etapas da CLI do Azure para configurar o roteamento:
Use o seguinte comando para entrar na CLI do Azure:
az login
Use os seguintes comandos para instalar a extensão Azure Spring Apps para a CLI do Azure e registrar o namespace Microsoft.SaaS:
az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS
Use o seguinte comando para aceitar os termos legais e as declarações de privacidade:
Nota
Esta etapa é necessária somente se sua assinatura nunca tiver sido usada para criar uma instância do plano Enterprise do Azure Spring Apps.
az term accept \
--publisher vmware-inc \
--product azure-spring-cloud-vmware-tanzu-2 \
--plan asa-ent-hr-mtr
Crie variáveis para manter os nomes dos recursos usando os comandos a seguir. Certifique-se de substituir os espaços reservados pelos seus próprios valores.
Use as etapas a seguir para configurar as Ferramentas de Desenvolvedor.
No painel de navegação, selecione Ferramentas de Desenvolvimento.
Selecione Atribuir ponto de extremidade para atribuir um ponto de extremidade para as Ferramentas de Desenvolvedor.
Salve o ponto de extremidade do App Live View para usar mais tarde.
3.1. Fornecer nomes para cada recurso
Crie variáveis para manter os nomes dos recursos usando os comandos a seguir. Certifique-se de substituir os espaços reservados pelos seus próprios valores.
Use os seguintes comandos para criar aplicativos para a instância do Azure Spring Apps:
az spring app create --service ${SPRING_APPS} --name ${APP_FRONTEND}
az spring app create --service ${SPRING_APPS} --name ${APP_CUSTOMERS_SERVICE}
az spring app create --service ${SPRING_APPS} --name ${APP_VETS_SERVICE}
az spring app create --service ${SPRING_APPS} --name ${APP_VISITS_SERVICE}
Use os seguintes comandos para vincular aplicativos para o Registro de Serviço:
az spring service-registry bind --service ${SPRING_APPS} --app ${APP_CUSTOMERS_SERVICE}
az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VETS_SERVICE}
az spring service-registry bind --service ${SPRING_APPS} --app ${APP_VISITS_SERVICE}
Use o seguinte comando para criar um repositório de configuração para o Serviço de Configuração de Aplicativo:
Use os seguintes comandos para vincular aplicativos ao Serviço de Configuração de Aplicativo:
az spring application-configuration-service bind \
--service ${SPRING_APPS} \
--app ${APP_CUSTOMERS_SERVICE}
az spring application-configuration-service bind \
--service ${SPRING_APPS} \
--app ${APP_VETS_SERVICE}
az spring application-configuration-service bind \
--service ${SPRING_APPS} \
--app ${APP_VISITS_SERVICE}
Use o seguinte comando para atribuir um ponto de extremidade ao Spring Cloud Gateway:
az spring gateway update --service ${SPRING_APPS} --assign-endpoint
Use o seguinte comando para definir o roteamento para o customers-service aplicativo:
O botão Implantar no Azure na seção anterior inicia uma experiência de portal do Azure que inclui a implantação de aplicativos, portanto, nada mais é necessário.
A lista a seguir descreve as interações de comando:
Selecione módulos filho para configurar: pressione Enter para selecionar todos.
Selecionar assinatura: selecione o número da lista de assinaturas da instância do Azure Spring Apps que você criou, que assume como padrão a primeira assinatura na lista. Se você usar o número padrão, pressione Enter diretamente.
Usar aplicativos Azure Spring existentes no Azure: pressione y para usar a instância existente do Azure Spring Apps.
Selecione aplicativos para expor o acesso público: pressione Enter para selecionar nenhum.
Confirme para salvar todas as configurações acima: Pressione y. Se você pressionar n, a configuração não será salva nos arquivos POM.
Use o seguinte comando para implantar os aplicativos de back-end:
./mvnw azure-spring-apps:deploy
Depois que o comando for executado, você poderá ver nas seguintes mensagens de log que a implantação foi bem-sucedida:
[INFO] Start deploying artifact(customers-service-3.0.1.jar) to deployment(default) of app(customers-service)...
[INFO] Artifact(customers-service-3.0.1.jar) is successfully deployed to deployment(default) of app(customers-service).
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
...
[INFO] Start deploying artifact(vets-service-3.0.1.jar) to deployment(default) of app(vets-service)...
[INFO] Artifact(vets-service-3.0.1.jar) is successfully deployed to deployment(default) of app(vets-service).
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
...
[INFO] Start deploying artifact(visits-service-3.0.1.jar) to deployment(default) of app(visits-service)...
[INFO] Artifact(visits-service-3.0.1.jar) is successfully deployed to deployment(default) of app(visits-service).
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
O portal do Azure não oferece suporte à implantação dos aplicativos front-end, portanto, use o seguinte comando da CLI do Azure para implantar o aplicativo front-end:
az spring app deploy \
--resource-group ${RESOURCE_GROUP} \
--service ${SPRING_APPS_NAME} \
--name ${APP_FRONTEND} \
--source-path spring-petclinic-frontend \
--build-env BP_WEB_SERVER=nginx
Depois que o comando for executado, você poderá ver nas seguintes mensagens de log que a implantação foi bem-sucedida:
[5/5] Updating deployment in app "frontend" (this operation can take a while to complete)
Azure Spring Apps will use rolling upgrade to update your deployment, you have 1 instance, Azure Spring Apps will update the deployment in 1 round.
The deployment is in round 1, 1 old instance is deleted/deleting and 1 new instance is started/starting
Your application is successfully deployed.
Use as seguintes etapas para implantar os aplicativos:
Insira o diretório raiz do projeto e use o seguinte comando para criar e implantar o aplicativo frontend:
az spring app deploy \
--service ${SPRING_APPS} \
--name ${APP_FRONTEND} \
--build-env BP_WEB_SERVER=nginx \
--source-path ./spring-petclinic-frontend
Use o seguinte comando para criar e implantar o customers-service aplicativo:
Após a conclusão da implantação, você poderá encontrar a URL do Spring Cloud Gateway nas saídas de implantação, conforme mostrado na captura de tela a seguir:
Abra o URL do gateway. O aplicativo deve ser semelhante à seguinte captura de tela:
5.2. Consultar os logs do aplicativo
Depois de navegar por cada função da Clínica Pet, o espaço de trabalho do Log Analytics coleta logs de cada aplicativo. Você pode verificar os logs usando consultas personalizadas, conforme mostrado na captura de tela a seguir:
5.3. Monitorizar as aplicações
O Application Insights monitora as dependências do aplicativo, conforme mostrado pelo seguinte mapa de rastreamento de aplicativos:
Você pode encontrar a URL do Application Live View nas saídas de implantação. Abra a URL do Application Live View para monitorar os tempos de execução do aplicativo, conforme mostrado na captura de tela a seguir:
5.1. Aceda às aplicações
Use o ponto de extremidade atribuído pelo Spring Cloud Gateway - por exemplo, https://<your-Azure-Spring-Apps-instance-name>-gateway-xxxxx.svc.azuremicroservices.io. O aplicativo deve ser semelhante à seguinte captura de tela:
5.2. Consultar os logs do aplicativo
Depois de navegar por cada função da Clínica Pet, o espaço de trabalho do Log Analytics coleta logs de cada aplicativo. Você pode verificar os logs usando consultas personalizadas, conforme mostrado na captura de tela a seguir:
5.3. Monitorizar as aplicações
O Application Insights monitora as dependências do aplicativo, conforme mostrado pelo seguinte mapa de rastreamento de aplicativos:
Abra a URL do Application Live View exposta pelas Ferramentas de Desenvolvimento para monitorar os tempos de execução do aplicativo, conforme mostrado na captura de tela a seguir:
5.1. Aceda às aplicações
Use os seguintes comandos para recuperar a URL do Spring Cloud Gateway:
export GATEWAY_URL=$(az spring gateway show \
--service ${SPRING_APPS} \
--query properties.url \
--output tsv)
echo "https://${GATEWAY_URL}"
O aplicativo deve ser semelhante à seguinte captura de tela:
5.2. Consultar os logs do aplicativo
Depois de navegar por cada função da Clínica Pet, o espaço de trabalho do Log Analytics coleta logs de cada aplicativo. Você pode verificar os logs usando consultas personalizadas, conforme mostrado na captura de tela a seguir:
5.3. Monitorizar as aplicações
O Application Insights monitora as dependências do aplicativo, conforme mostrado pelo seguinte mapa de rastreamento de aplicativos:
Use os seguintes comandos para recuperar a URL do Application Live View:
export DEV_TOOL_URL=$(az spring dev-tool show \
--service ${SPRING_APPS} \
--query properties.url \
--output tsv)
echo "https://${DEV_TOOL_URL}/app-live-view"
Abra a URL do Application Live View para monitorar os tempos de execução do aplicativo, conforme mostrado na captura de tela a seguir:
5.1. Aceda às aplicações
Usando as informações de URL na saída do log de implantação, abra a URL exposta pelo aplicativo nomeado api-gateway - por exemplo, https://<your-Azure-Spring-Apps-instance-name>-api-gateway.azuremicroservices.io. O aplicativo deve ser semelhante à seguinte captura de tela:
5.2. Consultar os logs do aplicativo
Depois de navegar por cada função da Clínica Pet, o espaço de trabalho do Log Analytics coleta logs de cada aplicativo. Você pode verificar os logs usando consultas personalizadas, conforme mostrado na captura de tela a seguir:
5.3. Monitorizar as aplicações
O Application Insights monitora as dependências do aplicativo, conforme mostrado pelo seguinte mapa de rastreamento de aplicativos:
Abra a URL exposta pelo aplicativo admin-server para gerenciar os aplicativos por meio do Spring Boot Admin Server, conforme mostrado na captura de tela a seguir:
6. Limpar os recursos
Se você planeja continuar trabalhando com guias de início rápido e tutoriais subsequentes, convém deixar esses recursos no lugar. Quando não precisar mais dos recursos, você poderá limpar recursos desnecessários para evitar cobranças do Azure.
Use as seguintes etapas para excluir todo o grupo de recursos, incluindo a instância de serviço recém-criada:
Localize o grupo de recursos no portal do Azure. No menu de navegação, selecione Grupos de recursos e, em seguida, selecione o nome do seu grupo de recursos.
Na página Grupo de recursos , selecione Excluir. Introduza o nome do seu grupo de recursos na caixa de texto para confirmar a eliminação e, em seguida, selecione Eliminar.
Use o seguinte comando para excluir todos os recursos do Azure usados neste aplicativo de exemplo:
azd down
A lista a seguir descreve a interação de comando:
Total de recursos a eliminar: <recursos-total>, tem a certeza de que pretende continuar?: Prima y.
O console emite mensagens semelhantes ao exemplo a seguir:
SUCCESS: Your application was removed from Azure in xx minutes xx seconds.
Certifique-se de excluir os recursos criados neste artigo quando não precisar mais deles. Pode eliminar o grupo de recursos do Azure, que inclui todos os recursos no grupo de recursos.
Use as seguintes etapas para excluir todo o grupo de recursos:
Localize o grupo de recursos no portal do Azure. No menu de navegação, selecione Grupos de recursos e, em seguida, selecione o nome do seu grupo de recursos.
Na página Grupo de recursos , selecione Excluir. Introduza o nome do seu grupo de recursos na caixa de texto para confirmar a eliminação e, em seguida, selecione Eliminar.
Use as seguintes etapas para excluir todo o grupo de recursos:
Localize o grupo de recursos no portal do Azure. No menu de navegação, selecione Grupos de recursos e, em seguida, selecione o nome do seu grupo de recursos.
Na página Grupo de recursos , selecione Excluir. Introduza o nome do seu grupo de recursos na caixa de texto para confirmar a eliminação e, em seguida, selecione Eliminar.
Use o seguinte comando para excluir o grupo de recursos:
