Guia de início rápido: implantar aplicativos de microsserviço no Azure Spring Apps

• Uma subscrição do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.
• Git.
• Java Development Kit (JDK), versão 17.

• Uma subscrição do Azure. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
• Git.
• Java Development Kit (JDK), versão 17.
• CLI do Azure Developer, versão 1.2.0 ou superior.

• Uma subscrição do Azure. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
• Se você estiver implantando uma instância do plano do Azure Spring Apps Enterprise pela primeira vez na assinatura de destino, consulte a seção Requisitos do plano Enterprise no Azure Marketplace.
• (Opcional) Git.
• (Opcional) Java Development Kit (JDK), versão 17.

• Uma subscrição do Azure. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
• Se você estiver implantando uma instância do plano do Azure Spring Apps Enterprise pela primeira vez na assinatura de destino, consulte a seção Requisitos do plano Enterprise no Azure Marketplace.
• Git.
• (Opcional) Java Development Kit (JDK), versão 17.
• (Opcional) Node.js, versão 16.20 ou superior.
• CLI do Azure, versão 2.45.0 ou superior.

• Uma subscrição do Azure. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
• Se você estiver implantando uma instância do plano do Azure Spring Apps Enterprise pela primeira vez na assinatura de destino, consulte a seção Requisitos do plano Enterprise no Azure Marketplace.
• Git.
• Java Development Kit (JDK), versão 17.
• CLI do Azure, versão 2.55.0 ou superior.

Use as seguintes etapas para preparar o exemplo localmente:

1. Clone o projeto de exemplo usando o seguinte comando:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Navegue até o diretório raiz do projeto e use o seguinte comando para executar o projeto de exemplo localmente:

   bash ./scripts/run_all_without_infra.sh
   

3. 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 para inicializar o aplicativo Pet Clinic usando modelos da CLI do Azure Developer:

1. Na janela Bash, crie uma nova pasta vazia e navegue até ela.

2. Use o seguinte comando para inicializar o projeto:

   azd init --template Azure-Samples/spring-petclinic-microservices
   

   A lista a seguir descreve a interação de comando:

   • 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.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 uma instância do Azure Spring Apps

Use as seguintes etapas para criar a instância de serviço:

1. Selecione Criar um recurso no canto do portal do Azure.

2. Na guia Serviços do Azure, selecione Compute>Azure Spring Apps.

   

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

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

   

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

   

6. Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para provisionar a instância do Azure Spring Apps.

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

   

8. Selecione Ir para o recurso para ir para a página Visão Geral do Azure Spring Apps.

9. Selecione Config Server no painel de navegação.

10. Na página Config Server, para URI, digite https://github.com/Azure-Samples/spring-petclinic-microservices-config.git e selecione Validar.

    

11. 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:

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

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

Use as seguintes etapas para implantar os aplicativos de microsserviço usando o plug-in Maven para Azure Spring Apps:

1. Navegue até o diretório de projeto de exemplo e use o seguinte comando para configurar os aplicativos para o Azure Spring Apps:

   ./mvnw -P spring-apps com.microsoft.azure:azure-spring-apps-maven-plugin:1.17.0:config
   

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

3. Use o seguinte comando para criar e implantar cada aplicativo:

   ./mvnw azure-spring-apps:deploy
   

4. 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:

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

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

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:

1. Use o seguinte comando para clonar o aplicativo Pet Clinic do GitHub:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Navegue até o diretório raiz do projeto e use o seguinte comando para criar o projeto:

   ./mvnw clean package -DskipTests
   

Use as etapas a seguir se quiser executar o aplicativo localmente. Caso contrário, pode ignorar estes passos.

1. Abra uma nova janela Bash e, em seguida, use o seguinte comando para iniciar o Config Server:

   ./mvnw spring-boot:run -pl spring-petclinic-config-server
   

2. Abra uma nova janela Bash e use o seguinte comando para iniciar o Discovery Server:

   ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
   

3. 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:

   ./mvnw spring-boot:run -pl spring-petclinic-customers-service
   ./mvnw spring-boot:run -pl spring-petclinic-vets-service
   ./mvnw spring-boot:run -pl spring-petclinic-visits-service
   ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
       -pl spring-petclinic-api-gateway
   

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

5. 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:

1. Use o seguinte comando para clonar o aplicativo Pet Clinic do GitHub:

   git clone https://github.com/Azure-Samples/spring-petclinic-microservices.git
   

2. Navegue até o diretório raiz do projeto e use o seguinte comando para criar o projeto:

   ./mvnw clean package -DskipTests
   

Use as etapas a seguir se quiser executar o aplicativo localmente. Caso contrário, pode ignorar estes passos.

1. Abra uma nova janela Bash e, em seguida, use o seguinte comando para iniciar o Config Server:

   ./mvnw spring-boot:run -pl spring-petclinic-config-server
   

2. Abra uma nova janela Bash e use o seguinte comando para iniciar o Discovery Server:

   ./mvnw spring-boot:run -pl spring-petclinic-discovery-server
   

3. 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:

   ./mvnw spring-boot:run -pl spring-petclinic-customers-service
   ./mvnw spring-boot:run -pl spring-petclinic-vets-service
   ./mvnw spring-boot:run -pl spring-petclinic-visits-service
   ./mvnw spring-boot:run -Dspring-boot.run.profiles=default,development \
       -pl spring-petclinic-api-gateway
   

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

5. Depois que o script for concluído com sucesso, vá para http://localhost:8080 o seu navegador para acessar o aplicativo PetClinic.

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:

1. Selecione o seguinte botão Implantar no Azure para iniciar a experiência de implantação no portal do Azure:

   

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

   

3. Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para implantar o aplicativo no Azure Spring Apps.

4. 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:

1. Selecione Criar um recurso no canto do portal do Azure.

2. Selecione Compute>Azure Spring Apps.

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

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

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

6. Selecione Rever e Criar para rever as suas seleções. Em seguida, selecione Criar para provisionar a instância do Azure Spring Apps.

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

   

8. 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:

1. No painel de navegação, selecione Aplicativos e, em seguida, selecione Criar aplicativo.

2. Na página Criar aplicativo, para o nome do aplicativo, use frontend e deixe todos os outros campos com seus valores padrão.

3. Repita a etapa anterior usando cada um dos seguintes nomes de aplicativo:

   • customers-service
   • vets-service
   • visits-service

4. 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:

1. No painel de navegação, selecione Registro de Serviço.

2. Selecione Vinculação de aplicativo, selecione Vincular aplicativo, selecione customers-service na lista e selecione Aplicar.

3. 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:

1. No painel de navegação, selecione Serviço de Configuração de Aplicativo e, em seguida, selecione Configurações.

2. Preencha o repositório com as seguintes informações e selecione Validar:

   • Nome: padrão
   • Padrões: aplicação,api-gateway,customers-service,vets-service,visits-service
   • URI:https://github.com/Azure-Samples/spring-petclinic-microservices-config.git .
   • Gravadora: master

   

3. Após a validação, selecione Aplicar para concluir a configuração do Serviço de Configuração do Aplicativo.

4. Selecione Vinculação de aplicativo, selecione Vincular aplicativo, selecione customers-service na lista e selecione Aplicar.

5. 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:

1. No painel de navegação, selecione Aplicativos e, em seguida, selecione o customers-service aplicativo.

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

3. 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:

1. No painel de navegação, selecione Spring Cloud Gateway.

2. 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:

1. Use o seguinte comando para entrar na CLI do Azure:

   az login
   

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

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

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

   export SUBSCRIPTION_ID=<subscription-ID>
   export RESOURCE_GROUP=<resource-group-name>
   export SPRING_APPS_NAME=<Azure-Spring-Apps-instance-name>
   export APP_CUSTOMERS_SERVICE=customers-service
   export APP_VETS_SERVICE=vets-service
   export APP_VISITS_SERVICE=visits-service
   export APP_FRONTEND=frontend
   

5. Use o seguinte comando para definir a assinatura padrão:

   az account set --subscription ${SUBSCRIPTION_ID}
   

6. Use o seguinte comando para definir o roteamento para o customers-service aplicativo:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --app-name ${APP_CUSTOMERS_SERVICE} \
       --routes-json \
         '[
           {
             "predicates": [
               "Path=/api/customer/**"
             ],
             "filters": [
               "StripPrefix=2"
             ]
           }
         ]'
   

7. Use o seguinte comando para definir o roteamento para o vets-service aplicativo:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_VETS_SERVICE} \
       --app-name ${APP_VETS_SERVICE} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/api/vet/**"
              ],
              "filters": [
                "StripPrefix=2"
              ]
            }
          ]'
   

8. Use o seguinte comando para definir o roteamento para o visits-service aplicativo:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_VISITS_SERVICE} \
       --app-name ${APP_VISITS_SERVICE} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/api/visit/**"
              ],
              "filters": [
                "StripPrefix=2"
              ]
            }
          ]'
   

9. Use o seguinte comando para definir o roteamento para o aplicativo frontend:

   az spring gateway route-config create \
       --resource-group ${RESOURCE_GROUP} \
       --service ${SPRING_APPS_NAME} \
       --name ${APP_FRONTEND} \
       --app-name ${APP_FRONTEND} \
       --routes-json \
         '[
            {
              "predicates": [
                "Path=/**"
              ],
              "filters": [
                "StripPrefix=0"
              ],
              "order": 1000
            }
          ]'
   

Configurar ferramentas de desenvolvedor

Use as etapas a seguir para configurar as Ferramentas de Desenvolvedor.

1. No painel de navegação, selecione Ferramentas de Desenvolvimento.

2. Selecione Atribuir ponto de extremidade para atribuir um ponto de extremidade para as Ferramentas de Desenvolvedor.

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

export LOCATION=<location>
export RESOURCE_GROUP=myresourcegroup
export SPRING_APPS=myasa
export APP_FRONTEND=frontend
export APP_CUSTOMERS_SERVICE=customers-service
export APP_VETS_SERVICE=vets-service
export APP_VISITS_SERVICE=visits-service
export GIT_CONFIG_REPO=default

3.2. Entrar na CLI do Azure

Use as seguintes etapas para entrar:

1. Use o seguinte comando para entrar na CLI do Azure:

   az login
   

2. Use o comando a seguir para listar todas as assinaturas disponíveis para determinar a ID da assinatura a ser usada:

   az account list --output table
   

3. Use o seguinte comando para definir a assinatura padrão:

   az account set --subscription <subscription-ID>
   

3.3. Criar um novo grupo de recursos

Use as seguintes etapas para criar um novo grupo de recursos:

1. Use o seguinte comando para definir o local padrão:

   az configure --defaults location=${LOCATION}
   

2. Use o seguinte comando para criar um grupo de recursos:

   az group create --resource-group ${RESOURCE_GROUP}
   

3. Use o seguinte comando para definir o grupo de recursos recém-criado como o grupo de recursos padrão:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.4. Instalar extensão e registrar namespace

Use os seguintes comandos para instalar a extensão Azure Spring Apps para a CLI do Azure e registrar o Microsoft.SaaS namespace:

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.5. Criar uma instância do Azure Spring Apps

Use as seguintes etapas para criar a instância de serviço:

1. Use o seguinte comando para aceitar os termos legais e as declarações de privacidade do plano Enterprise:

   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
   

2. Use o seguinte comando para criar uma instância de serviço do Azure Spring Apps com os componentes Tanzu necessários:

   az spring create \
       --name ${SPRING_APPS} \
       --sku Enterprise \
       --enable-application-configuration-service \
       --enable-service-registry \
       --enable-gateway \
       --enable-application-live-view
   

3.6. Configurar a instância do Azure Spring Apps

Use as seguintes etapas para configurar a instância de serviço:

1. Use o seguinte comando para definir as configurações de diagnóstico para a instância do Azure Spring Apps:

   export SPRING_APPS_RESOURCE_ID=$(az spring show \
       --name ${SPRING_APPS} \
       --query id \
       --output tsv)
   az monitor diagnostic-settings create \
       --resource ${SPRING_APPS_RESOURCE_ID} \
       --name logs-and-metrics \
       --workspace ${SPRING_APPS} \
       --logs '[
         {
           "category": "ApplicationConsole",
           "enabled": true,
           "retentionPolicy": {
             "enabled": false,
             "days": 0
           }
         },
         {
            "category": "SystemLogs",
            "enabled": true,
            "retentionPolicy": {
              "enabled": false,
              "days": 0
            }
         },
         {
            "category": "IngressLogs",
            "enabled": true,
            "retentionPolicy": {
              "enabled": false,
              "days": 0
             }
         }
       ]' \
       --metrics '[
         {
           "category": "AllMetrics",
           "enabled": true,
           "retentionPolicy": {
             "enabled": false,
             "days": 0
           }
         }
       ]'
   

2. 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}
   

3. 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}
   

4. Use o seguinte comando para criar um repositório de configuração para o Serviço de Configuração de Aplicativo:

   az spring application-configuration-service git repo add \
       --service ${SPRING_APPS} \
       --name ${GIT_CONFIG_REPO} \
       --patterns application,api-gateway,customers-service,vets-service,visits-service \
       --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
       --label master
   

5. 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}
   

6. Use o seguinte comando para atribuir um ponto de extremidade ao Spring Cloud Gateway:

   az spring gateway update --service ${SPRING_APPS} --assign-endpoint
   

7. Use o seguinte comando para definir o roteamento para o customers-service aplicativo:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --app-name ${APP_CUSTOMERS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/customer/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
      ]'
   

8. Use o seguinte comando para definir o roteamento para o vets-service aplicativo:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_VETS_SERVICE} \
       --app-name ${APP_VETS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/vet/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
       ]'
   

9. Use o seguinte comando para definir o roteamento para o visits-service aplicativo:

   az spring gateway route-config create \
       --service ${SPRING_APPS} \
       --name ${APP_VISITS_SERVICE} \
       --app-name ${APP_VISITS_SERVICE} \
       --routes-json '[
         {
           "predicates": [
             "Path=/api/visit/**"
           ],
           "filters": [
             "StripPrefix=2"
           ]
         }
       ]'
   

10. Use o seguinte comando para definir o roteamento para o frontend aplicativo:

    az spring gateway route-config create \
        --service ${SPRING_APPS} \
        --name ${APP_FRONTEND} \
        --app-name ${APP_FRONTEND} \
        --routes-json '[
          {
            "predicates": [
              "Path=/**"
            ],
            "filters": [
              "StripPrefix=0"
            ],
            "order": 1000
          }
        ]'
    

11. Use o seguinte comando para atribuir um ponto de extremidade ao Application Live View:

    az spring dev-tool update --service ${SPRING_APPS} --assign-endpoint
    

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.

Use as seguintes etapas para implantar usando o plug-in Maven para Azure Spring Apps:

1. Navegue até o diretório raiz do projeto e execute o seguinte comando para configurar os aplicativos no Azure Spring Apps:

   ./mvnw -P spring-apps-enterprise com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   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.

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

3. 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:

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

2. Use o seguinte comando para criar e implantar o customers-service aplicativo:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_CUSTOMERS_SERVICE} \
       --source-path \
       --config-file-pattern application,customers-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-customers-service \
           BP_JVM_VERSION=17
   

3. Use o seguinte comando para criar e implantar o vets-service aplicativo:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_VETS_SERVICE} \
       --source-path \
       --config-file-pattern application,vets-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-vets-service \
           BP_JVM_VERSION=17
   

4. Use o seguinte comando para criar e implantar o visits-service aplicativo:

   az spring app deploy \
       --service ${SPRING_APPS} \
       --name ${APP_VISITS_SERVICE} \
       --source-path \
       --config-file-pattern application,visits-service \
       --build-env \
           BP_MAVEN_BUILT_MODULE=spring-petclinic-visits-service \
           BP_JVM_VERSION=17
   

5.1. Aceda às aplicações

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:

Use as seguintes etapas para excluir todo o grupo de recursos, incluindo a instância de serviço recém-criada:

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

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

Use as seguintes etapas para excluir todo o grupo de recursos:

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

2. 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:

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

2. 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:

az group delete --name ${RESOURCE_GROUP}