Migrar uma instância do plano Básico ou Standard do Azure Spring Apps para o plano Enterprise

Nota

Azure Spring Apps é o novo nome para o serviço Azure Spring Cloud. Embora o serviço tenha um novo nome, você verá o nome antigo em alguns lugares por um tempo enquanto trabalhamos para atualizar ativos, como capturas de tela, vídeos e diagramas.

Este artigo aplica-se a: ✔️ Basic/Standard ✔️ Enterprise

Este artigo mostra como migrar um aplicativo existente no plano Básico ou Padrão para o plano Enterprise. Quando você migra do plano Básico ou Standard para o plano Enterprise, os componentes do VMware Tanzu substituem os componentes do Spring Cloud de software de código aberto (OSS) para fornecer mais suporte a recursos.

Este artigo usa os aplicativos de exemplo da Pet Clinic como exemplos de como migrar.

Pré-requisitos

• Uma subscrição do Azure. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
• Azure CLI versão 2.45.0 ou superior.
• A extensão do plano do Azure Spring Apps Enterprise. Use o comando a seguir para remover versões anteriores e instalar a extensão de plano Enterprise mais recente. Se você instalou spring-cloud a extensão anteriormente, desinstale-a para evitar incompatibilidades de configuração e versão.

  az extension add --upgrade --name spring
  az extension remove --name spring-cloud
  

• Git.

Provisionar uma instância de serviço

No plano do Azure Spring Apps Enterprise, os componentes do VMware Tanzu substituem os componentes do OSS Spring Cloud para fornecer mais suporte a recursos. Os componentes Tanzu são ativados sob demanda de acordo com suas necessidades. Você deve habilitar os componentes necessários antes de criar a instância de serviço do Azure Spring Apps.

Nota

Para usar os Componentes Tanzu, você deve habilitá-los ao provisionar sua instância de serviço do Azure Spring Apps. Não é possível habilitá-los após o provisionamento no momento.

Use as seguintes etapas para provisionar uma instância de serviço do Azure Spring Apps:

Portal do Azure

1. Abra o portal do Azure.

2. Na caixa de pesquisa superior, procure Azure Spring Apps.

3. Selecione Azure Spring Apps nos resultados e, em seguida, selecione Criar.

4. Na página Criar Aplicativos de primavera do Azure, defina sua Assinatura, Grupo de recursos e Nome para a instância.

5. Em Planejar em Detalhes do Serviço, selecione Alterar.

   

6. Na página Escolha seu plano, selecione a linha Empresa na tabela e selecione Selecionar.

   

7. De volta à página Criar Azure Spring Apps , selecione Termos para concordar com os termos legais e as declarações de privacidade da oferta do plano Enterprise no Azure Marketplace.

8. Selecione Next: VMware Tanzu settings.

9. Na guia Configurações do VMWare Tanzu, role pela lista para revisar os componentes do Tanzu. Todos os componentes são habilitados por padrão.

   

   Nota

   Considere cuidadosamente quais componentes Tanzu você deseja usar ou habilitar durante a fase de provisionamento. Depois de provisionar a instância do Azure Spring Apps, você não pode habilitar ou desabilitar os componentes do Tanzu.

10. Selecione a guia Application Insights e, em seguida, selecione Enable Application Insights. Analise as seguintes configurações:

    • Ativar Application Insights deve ser selecionado.
    • Escolha uma instância existente do Application Insights ou crie uma nova instância do Application Insights.
    • Insira uma Taxa de amostragem no intervalo de 0 a 100 ou use o valor padrão 10.

    Você também pode habilitar o Application Insights depois de provisionar a instância do Azure Spring Apps. Para obter mais informações sobre os preços do Application Insights, consulte a seção de faturamento do Application Insights de cálculos de custo e opções do Azure Monitor Logs.

    Nota

    Você pagará pelo uso do Application Insights quando integrado ao Azure Spring Apps.

11. Selecione Rever e criar e aguarde a conclusão da validação e, em seguida, selecione Criar para iniciar o aprovisionamento da instância de serviço.

Leva cerca de 5 minutos para concluir o provisionamento de recursos.

CLI do Azure

1. Use o seguinte comando para atualizar a CLI do Azure com a extensão Azure Spring Apps:

   az extension add --upgrade --name spring
   

2. Use os seguintes comandos para entrar na CLI do Azure e escolher sua assinatura ativa:

   az login
   az account list --output table
   az account set --subscription <subscription-ID>
   

3. Use o comando a seguir para aceitar os termos legais e as declarações de privacidade do plano Enterprise. Esta etapa é necessária somente na primeira vez que você cria uma instância do Azure Spring Apps no plano Enterprise.

   az provider register --namespace Microsoft.SaaS
   az term accept --publisher vmware-inc --product azure-spring-cloud-vmware-tanzu-2 --plan asa-ent-hr-mtr
   

4. Crie um nome para sua instância de serviço do Azure Spring Apps. O nome deve ter entre 4 e 32 caracteres e só pode conter 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.

5. Use o seguinte comando para criar um grupo de recursos e uma instância de serviço do Azure Spring Apps:

   az spring create \
       --resource-group <resource-group-name> \
       --name <Azure-Spring-Apps-service-instance-name> \
       --sku enterprise
   

   Para obter mais informações sobre grupos de recursos, consulte O que é o Azure Resource Manager?.

Criar e configurar aplicativos

As etapas de criação do aplicativo são as mesmas do plano Padrão.

1. Use o comando a seguir para definir os padrões da CLI do Azure. Certifique-se de substituir os espaços reservados pelos seus próprios valores.

   az config set defaults.group=<resource-group-name>
   az config set defaults.spring=<Azure-Spring-Apps-service-instance-name>
   

2. Use os seguintes comandos para criar os dois aplicativos principais para PetClinic api-gateway e customers-service:

   az spring app create --name api-gateway --instance-count 1 --memory 2Gi --assign-endpoint
   az spring app create --name customers-service --instance-count 1 --memory 2Gi
   

Usar o Serviço de Configuração de Aplicativo para configuração externa

Para configuração externalizada em um sistema distribuído, o Spring Cloud Config Server (OSS) gerenciado está disponível apenas nos planos Basic e Standard. No plano Enterprise, o Application Configuration Service for Tanzu fornece funções semelhantes para seus aplicativos. A tabela a seguir descreve algumas diferenças no uso entre o servidor de configuração OSS e o Serviço de Configuração de Aplicativo.

Componente	Planos de suporte	Ativado(a)	Vincular ao aplicativo	Profile
Servidor de configuração do Spring Cloud	Básico/Padrão	Sempre ativado.	Ligação automática	Configurado no código-fonte do aplicativo.
Serviço de configuração de aplicativos para Tanzu	Grandes Empresas	Habilite sob demanda.	Ligação manual	Fornecido como config-file-pattern em uma implantação do Azure Spring Apps.

Ao contrário do modo cliente-servidor no servidor de configuração OSS, o Serviço de Configuração de Aplicativo gerencia a configuração usando o Kubernetes-native ConfigMap, que é preenchido a partir de propriedades definidas em repositórios Git de back-end. O Serviço de Configuração de Aplicativo não pode obter o perfil ativo configurado no código-fonte do aplicativo para corresponder à configuração correta, portanto, a configuração config-file-pattern explícita deve ser especificada no nível de implantação do Azure Spring Apps.

Configurar o Serviço de Configuração de Aplicativo para Tanzu

Siga estas etapas para usar o Serviço de Configuração de Aplicativo para Tanzu como um serviço de configuração centralizado.

Portal do Azure

1. Na sua instância do Azure Spring Apps Enterprise, selecione Serviço de Configuração de Aplicativo no painel de navegação. Exiba o estado de execução e os recursos alocados ao Serviço de Configuração de Aplicativo para Tanzu.

   

2. Selecione Configurações e preencha o formulário em Repositórios para adicionar uma nova entrada com as seguintes informações:

   • Nome: default
   • Padrões: api-gateway,customers-service
   • URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config
   • Rótulo: master

   

3. Selecione Validar para validar o acesso ao URI de destino.

4. Depois que a validação for concluída com êxito, selecione Aplicar para atualizar as definições de configuração.

CLI do Azure

Use o seguinte comando para definir o repositório padrão:

az spring application-configuration-service git repo add \
    --name default \
    --patterns api-gateway,customers-service \
    --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
    --label master

Vincular aplicativos ao Serviço de Configuração de Aplicativo para Tanzu

Ao usar o Serviço de Configuração de Aplicativo para Tanzu com um back-end Git, você deve vincular o aplicativo ao Serviço de Configuração de Aplicativo para Tanzu. Depois de vincular o aplicativo, você precisará configurar qual padrão é usado pelo aplicativo. Use as etapas a seguir para vincular e configurar o padrão para o aplicativo.

Portal do Azure

Use as etapas a seguir para vincular aplicativos ao Application Configuration Service for VMware Tanzu.

1. Na sua instância do Azure Spring Apps Enterprise, selecione Serviço de Configuração de Aplicativo no painel de navegação.

2. Selecione Vinculação de aplicativo e, em seguida, selecione Vincular aplicativo.

   

3. Selecione um aplicativo no menu suspenso e, em seguida, selecione Aplicar para vincular o aplicativo ao Serviço de Configuração de Aplicativo para Tanzu.

CLI do Azure

Use os seguintes comandos para vincular aplicativos ao Application Configuration Service for VMware Tanzu e ao VMware Tanzu Service Registry:

az spring application-configuration-service bind --app api-gateway
az spring application-configuration-service bind --app customers-service

Para obter mais informações, consulte Usar o serviço de configuração de aplicativo para Tanzu.

Usando o registro de serviço para Tanzu

O Service Registry é um dos componentes proprietários do VMware Tanzu. Ele fornece aos seus aplicativos uma implementação do padrão Service Discovery, um dos conceitos-chave de uma arquitetura baseada em microsserviços. No plano Enterprise, o Service Registry for Tanzu fornece registro de serviço e descobre suporte para seus aplicativos. O Managed Spring Cloud Eureka está disponível apenas nos planos Basic e Standard e não está disponível no plano Enterprise.

Componente	Plano Standard	Plano empresarial
Registo de Serviços	OSS eureka Ligação automática (sempre injeção) Sempre provisionado	Registro de serviço para Tanzu Precisa de vinculação manual ao aplicativo Ativar sob demanda

Vincular um aplicativo ao Tanzu Service Registry

Para vincular aplicativos ao Application Configuration Service for VMware Tanzu, siga estas etapas.

Portal do Azure

1. Na sua instância do Azure Spring Apps Enterprise, selecione Registro de Serviço.

2. Selecione Vinculação de aplicativo. As aplicações atualmente associadas aparecem em Nome da aplicação.

3. Selecione Vincular aplicativo.

4. Selecione um aplicativo no menu suspenso e, em seguida, selecione Aplicar para vincular o aplicativo ao Tanzu Service Registry.

   

CLI do Azure

Use os seguintes comandos para vincular aplicativos ao Application Configuration Service for VMware Tanzu e ao VMware Tanzu Service Registry:

az spring service-registry bind --app api-gateway
az spring service-registry bind --app customers-service

Nota

Ao alterar o status de vinculação/desvinculação, você deve reiniciar ou reimplantar o aplicativo para que a alteração entre em vigor.

Para obter mais informações, consulte Usar o Tanzu Service Registry.

Crie e implante aplicativos

No plano Enterprise, o Tanzu Build Service é usado para criar aplicativos. Ele fornece mais recursos, como aplicativos poliglotas para implantar a partir de artefatos como código-fonte e arquivos zip.

Para usar o Tanzu Build Service, você precisa especificar um recurso para a tarefa de compilação e o construtor usarem. Você também pode especificar o --build-env parâmetro para definir ambientes de compilação.

Se o aplicativo se associar ao Serviço de Configuração de Aplicativo para Tanzu, você precisará especificar um argumento —config-file-patternextra.

Para obter mais informações, consulte Usar o Tanzu Build Service.

Crie aplicativos localmente

Use as seguintes etapas para criar localmente:

1. Use os seguintes comandos para clonar o repositório de aplicativo de exemplo em sua conta do Azure, alterar o diretório e criar o projeto:

   git clone -b enterprise https://github.com/azure-samples/spring-petclinic-microservices
   cd spring-petclinic-microservices
   mvn clean package -DskipTests
   

   A compilação do projeto pode levar vários minutos. Quando concluído, você tem arquivos JAR individuais para cada serviço em sua respetiva pasta.

2. Use os seguintes comandos para implantar os arquivos JAR criados na etapa anterior:

   az spring app deploy \
       --name api-gateway \
       --artifact-path spring-petclinic-api-gateway/target/spring-petclinic-api-gateway-2.3.6.jar \
       --config-file-patterns api-gateway
   az spring app deploy \
       --name customers-service \
       --artifact-path spring-petclinic-customers-service/target/spring-petclinic-customers-service-2.3.6.jar \
       --config-file-patterns customers-service
   

3. Use o seguinte comando para consultar o status do aplicativo após a implantação:

   az spring app list --output table
   

   Este comando produz uma saída semelhante ao exemplo a seguir:

   Name                  Location    ResourceGroup       Public Url                                                 Production Deployment    Provisioning State    CPU    Memory    Running Instance    Registered Instance    Persistent Storage    Bind Service Registry    Bind Application Configuration Service
   --------------------  ----------  ---------------  ---------------------------------------------------------  -----------------------  --------------------  -----  --------  ------------------  ---------------------  --------------------  -----------------------  ----------------------------------------
   api-gateway           eastus      <resource group>   https://<service_name>-api-gateway.asc-test.net                    default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
   customers-service     eastus      <resource group>                                                                      default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
   

Usar o Application Insights

O plano do Azure Spring Apps Enterprise usa associações buildpack para integrar o Application Insights com o tipo ApplicationInsights , em vez de In-Process Agent. Para obter mais informações, consulte Como configurar a integração APM e certificados de CA.

A tabela a seguir lista os provedores de APM disponíveis nos planos.

Plano Standard	Plano empresarial
Visão geral do aplicativo Nova Relíquia Dynatrace AppDynamics	Visão geral do aplicativo Nova Relíquia Dynatrace AppDynamics ElasticAPM

Portal do Azure

Para verificar ou atualizar as configurações atuais no Application Insights, use as seguintes etapas:

1. Na sua instância do Azure Spring Apps Enterprise, selecione Application Insights.

2. Habilite ou desabilite o Application Insights selecionando Editar vinculação ou Desvincular vinculação.

   

3. Selecione Editar vinculação. Edite as configurações de vinculação e selecione Salvar.

   

CLI do Azure

Os comandos a seguir mostram como verificar ou atualizar as configurações atuais no Application Insights.

Use o seguinte comando para criar uma associação buildpack do Application Insights:

az spring build-service builder buildpack-binding create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

Use o comando a seguir para listar todas as associações buildpack e encontrar associações do Application Insights para o tipo ApplicationInsights:

az spring build-service builder buildpack-binding list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --builder-name <your-builder-name>

Use o seguinte comando para substituir uma associação buildpack do Application Insights:

az spring build-service builder buildpack-binding set \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

Use o seguinte comando para obter uma associação buildpack do Application Insights:

az spring build-service builder buildpack-binding show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \

Use o seguinte comando para excluir uma associação buildpack do Application Insights:

az spring build-service builder buildpack-binding delete \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \

Para obter mais informações, consulte Usar o Application Insights Java In-Process Agent no Azure Spring Apps.

Próximos passos

• Azure Spring Apps
• Usar o portal API para VMware Tanzu
• Usar o Spring Cloud Gateway