Eseguire la migrazione di un'istanza di piano Basic o Standard di Azure Spring Apps al piano Enterprise

Nota

Azure Spring Apps è il nuovo nome del servizio Azure Spring Cloud. Anche se il servizio ha un nuovo nome, il nome precedente verrà visualizzato in alcune posizioni per un po' mentre si lavora per aggiornare gli asset, ad esempio screenshot, video e diagrammi.

Questo articolo si applica a: ✔️ Basic/Standard ✔️ Enterprise

Questo articolo illustra come eseguire la migrazione di un'applicazione esistente nel piano Basic o Standard al piano Enterprise. Quando si esegue la migrazione dal piano Basic o Standard al piano Enterprise, i componenti VMware Tanzu sostituiscono i componenti Open Source (OSS) Spring Cloud per fornire maggiore supporto per le funzionalità.

Questo articolo usa le app di esempio Pet Clinic come esempi di come eseguire la migrazione.

Prerequisiti

• Una sottoscrizione di Azure. Se non si ha già una sottoscrizione, creare un account gratuito prima di iniziare.
• Interfaccia della riga di comando di Azure versione 2.45.0 o successiva.
• Estensione del piano Enterprise di Azure Spring Apps. Usare il comando seguente per rimuovere le versioni precedenti e installare l'estensione del piano Enterprise più recente. Se l'estensione spring-cloud è stata installata in precedenza, disinstallarla per evitare la mancata corrispondenza della configurazione e della versione.

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

• Git.

Effettuare il provisioning di un'istanza del servizio

Nel piano Enterprise di Azure Spring Apps, i componenti VMware Tanzu sostituiscono i componenti di OSS Spring Cloud per fornire ulteriore supporto per le funzionalità. I componenti Tanzu sono abilitati su richiesta in base alle esigenze. È necessario abilitare i componenti necessari prima di creare l'istanza del servizio Azure Spring Apps.

Nota

Per usare i componenti Tanzu, è necessario abilitarli quando si effettua il provisioning dell'istanza del servizio Azure Spring Apps. Non è possibile abilitarli al momento dopo il provisioning.

Usare la procedura seguente per effettuare il provisioning di un'istanza del servizio Azure Spring Apps:

Azure portal

1. Apri il portale di Azure.

2. Nella casella di ricerca superiore cercare Azure Spring Apps.

3. Selezionare Azure Spring Apps nei risultati e quindi selezionare Crea.

4. Nella pagina Crea app Spring di Azure impostare la sottoscrizione, il gruppo di risorse e il nome per l'istanza.

5. Per Plan in Service Details (Dettagli servizio) selezionare Change (Modifica).

   

6. Nella pagina Scegliere il piano selezionare la riga Enterprise nella tabella e quindi selezionare Seleziona.

   

7. Nella pagina Crea app Azure Spring selezionare Condizioni per accettare le condizioni legali e le informative sulla privacy dell'offerta del piano Enterprise in Azure Marketplace.

8. Selezionare Avanti: Impostazioni di VMware Tanzu.

9. Nella scheda Impostazioni Tanzu di VMWare scorrere l'elenco per esaminare i componenti Tanzu. Tutti i componenti sono abilitati per impostazione predefinita.

   

   Nota

   Valutare attentamente i componenti Tanzu da usare o abilitare durante la fase di provisioning. Dopo il provisioning dell'istanza di Azure Spring Apps, non è possibile abilitare o disabilitare i componenti Tanzu.

10. Selezionare la scheda Application Insights e quindi selezionare Abilita Application Insights. Esaminare le impostazioni seguenti:

    • Abilitare Application Insights deve essere selezionato.
    • Scegliere un'istanza di Application Insights esistente o creare una nuova istanza di Application Insights.
    • Immettere una frequenza di campionamento nell'intervallo compreso tra 0 e 100 oppure usare il valore predefinito 10.

    È anche possibile abilitare Application Insights dopo il provisioning dell'istanza di Azure Spring Apps. Per altre informazioni sui prezzi di Application Insights, vedere la sezione relativa alla fatturazione di Application Insights dei calcoli dei costi e delle opzioni dei log di Monitoraggio di Azure.

    Nota

    Si pagherà l'utilizzo di Application Insights quando si integra con Azure Spring Apps.

11. Selezionare Rivedi e crea e attende il completamento della convalida, quindi selezionare Crea per avviare il provisioning dell'istanza del servizio.

Il provisioning delle risorse richiede circa 5 minuti.

Interfaccia della riga di comando di Azure

1. Usare il comando seguente per aggiornare l'interfaccia della riga di comando di Azure con l'estensione Azure Spring Apps:

   az extension add --upgrade --name spring
   

2. Usare i comandi seguenti per accedere all'interfaccia della riga di comando di Azure e scegliere la sottoscrizione attiva:

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

3. Usare il comando seguente per accettare le condizioni legali e le informative sulla privacy per il piano Enterprise. Questo passaggio è necessario solo la prima volta che si crea un'istanza di Azure Spring Apps nel piano 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. Creare un nome per l'istanza del servizio Azure Spring Apps. Il nome deve avere una lunghezza compresa tra 4 e 32 caratteri e può contenere solo lettere minuscole, numeri e trattini. Il primo carattere del nome del servizio deve essere una lettera e l'ultimo deve essere una lettera o un numero.

5. Usare il comando seguente per creare un gruppo di risorse e un'istanza del servizio Azure Spring Apps:

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

   Per altre informazioni sui gruppi di risorse, vedere Informazioni su Azure Resource Manager.

Creare e configurare app

I passaggi di creazione dell'app sono gli stessi del piano Standard.

1. Usare il comando seguente per impostare le impostazioni predefinite dell'interfaccia della riga di comando di Azure. Assicurarsi di sostituire i segnaposto con i propri valori.

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

2. Usare i comandi seguenti per creare le due applicazioni principali per 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
   

Usare il servizio di configurazione dell'applicazione per la configurazione esterna

Per la configurazione esterna in un sistema distribuito, Spring Cloud Config Server (OSS) gestito è disponibile solo nei piani Basic e Standard. Nel piano Enterprise, il servizio di configurazione delle applicazioni per Tanzu fornisce funzioni simili per le app. La tabella seguente descrive alcune differenze nell'utilizzo tra il server di configurazione oss e il servizio di configurazione dell'applicazione.

Componente	Piani di supporto	Attivata	Eseguire l'associazione all'app	Profilo
Spring Cloud Config Server	Basic/Standard	Sempre abilitata.	Associazione automatica	Configurato nel codice sorgente dell'app.
Servizio di configurazione dell'applicazione per Tanzu	Funzionalità per le aziende	Abilitare su richiesta.	Binding manuale	Fornito come config-file-pattern in una distribuzione di Azure Spring Apps.

A differenza della modalità client-server nel server di configurazione oss, il servizio di configurazione dell'applicazione gestisce la configurazione usando kubernetes nativo, popolato dalle proprietà definite nei repository Git back-end ConfigMap. Il servizio di configurazione dell'applicazione non può ottenere il profilo attivo configurato nel codice sorgente dell'app in modo che corrisponda alla configurazione corretta, quindi la configurazione config-file-pattern esplicita deve essere specificata a livello di distribuzione di Azure Spring Apps.

Configurare il servizio di configurazione dell'applicazione per Tanzu

Seguire questa procedura per usare il servizio di configurazione dell'applicazione per Tanzu come servizio di configurazione centralizzato.

Azure portal

1. Nell'istanza di Azure Spring Apps Enterprise selezionare Servizio di configurazione dell'applicazione nel riquadro di spostamento. Visualizzare lo stato di esecuzione e le risorse allocate al servizio di configurazione dell'applicazione per Tanzu.

   

2. Selezionare Impostazioni e completare il modulo in Repository per aggiungere una nuova voce con le informazioni seguenti:

   • Nome: default
   • Modelli: api-gateway,customers-service
   • URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config
   • Etichetta: master

   

3. Selezionare Convalida per convalidare l'accesso all'URI di destinazione.

4. Al termine della convalida, selezionare Applica per aggiornare le impostazioni di configurazione.

Interfaccia della riga di comando di Azure

Usare il comando seguente per impostare il repository predefinito:

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

Associare applicazioni al servizio di configurazione dell'applicazione per Tanzu

Quando si usa il servizio di configurazione dell'applicazione per Tanzu con un back-end Git, è necessario associare l'app al servizio di configurazione dell'applicazione per Tanzu. Dopo l'associazione dell'app, è necessario configurare il modello usato dall'app. Usare la procedura seguente per associare e configurare il modello per l'app.

Azure portal

Usare la procedura seguente per associare le app al servizio di configurazione dell'applicazione per VMware Tanzu.

1. Nell'istanza di Azure Spring Apps Enterprise selezionare Servizio di configurazione dell'applicazione nel riquadro di spostamento.

2. Selezionare Associazione app e quindi Selezionare Associa app.

   

3. Selezionare un'app nel menu a discesa e quindi selezionare Applica per associare l'applicazione al servizio di configurazione dell'applicazione per Tanzu.

Interfaccia della riga di comando di Azure

Usare i comandi seguenti per associare le app al servizio di configurazione dell'applicazione per VMware Tanzu e il Registro di sistema del servizio VMware Tanzu:

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

Per altre informazioni, vedere Usare il servizio di configurazione dell'applicazione per Tanzu.

Uso del Registro dei servizi per Tanzu

Registro dei servizi è uno dei componenti proprietari di VMware Tanzu. Fornisce alle app un'implementazione del modello di individuazione dei servizi, uno dei concetti chiave di un'architettura basata su microservizi. Nel piano Enterprise, Registro dei servizi per Tanzu fornisce il registro dei servizi e individua il supporto per le app. Spring Cloud Gestito Eureka è disponibile solo nel piano Basic e Standard e non è disponibile nel piano Enterprise.

Componente	Piano Standard	Piano Enterprise
Service Registry	OSS eureka Associazione automatica (inserimento sempre) Provisioning sempre effettuato	Registro dei servizi per Tanzu Richiede l'associazione manuale all'app Abilitare su richiesta

Associare un'applicazione al Registro di sistema del servizio Tanzu

Per associare le app al servizio di configurazione dell'applicazione per VMware Tanzu, seguire questa procedura.

Azure portal

1. Nell'istanza di Azure Spring Apps Enterprise selezionare Registro dei servizi.

2. Selezionare Associazione app. Le app attualmente associate vengono visualizzate in Nome app.

3. Selezionare Associa app.

4. Selezionare un'app nel menu a discesa e quindi selezionare Applica per associare l'applicazione al Registro di sistema del servizio Tanzu.

   

Interfaccia della riga di comando di Azure

Usare i comandi seguenti per associare le app al servizio di configurazione dell'applicazione per VMware Tanzu e il Registro di sistema del servizio VMware Tanzu:

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

Nota

Quando modifichi lo stato bind/unbind, devi riavviare o ridistribuire l'app per rendere effettiva la modifica.

Per altre informazioni, vedere Usare il Registro di sistema del servizio Tanzu.

Compilare e distribuire applicazioni

Nel piano Enterprise il servizio di compilazione Tanzu viene usato per creare app. Offre più funzionalità come le app poliglotte da distribuire da artefatti, ad esempio il codice sorgente e i file ZIP.

Per usare il servizio di compilazione Tanzu, è necessario specificare una risorsa per l'attività di compilazione e il generatore da usare. È anche possibile specificare il --build-env parametro per impostare gli ambienti di compilazione.

Se l'app viene associata al servizio di configurazione dell'applicazione per Tanzu, è necessario specificare un argomento aggiuntivo —config-file-pattern.

Per altre informazioni, vedere Usare il servizio di compilazione Tanzu.

Compilare applicazioni in locale

Usare la procedura seguente per compilare localmente:

1. Usare i comandi seguenti per clonare il repository di app di esempio nell'account Azure, modificare la directory e compilare il progetto:

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

   La compilazione del progetto può richiedere alcuni minuti. Al termine, sono presenti singoli file JAR per ogni servizio nella rispettiva cartella.

2. Usare i comandi seguenti per distribuire i file JAR compilati nel passaggio precedente:

   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. Usare il comando seguente per eseguire una query sullo stato dell'applicazione dopo la distribuzione:

   az spring app list --output table
   

   Questo comando genera un output simile all'esempio seguente:

   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
   

Usare Application Insights

Il piano Enterprise di Azure Spring Apps usa associazioni buildpack per integrare Application Insights con il tipo ApplicationInsights anziché con l'agente in-process. Per altre informazioni, vedere Come configurare l'integrazione di APM e i certificati della CA.

Nella tabella seguente sono elencati i provider APM disponibili per i piani.

Piano Standard	Piano Enterprise
Informazioni dettagliate sull'applicazione New Relic Dynatrace AppDynamics	Informazioni dettagliate sull'applicazione New Relic Dynatrace AppDynamics ElasticAPM

Azure portal

Per controllare o aggiornare le impostazioni correnti in Application Insights, seguire questa procedura:

1. Nell'istanza di Azure Spring Apps Enterprise selezionare Application Insights.

2. Abilitare o disabilitare Application Insights selezionando Modifica binding o Unbind binding.

   

3. Selezionare Modifica associazione. Modificare le impostazioni di associazione e quindi selezionare Salva.

   

Interfaccia della riga di comando di Azure

I comandi seguenti illustrano come controllare o aggiornare le impostazioni correnti in Application Insights.

Usare il comando seguente per creare un'associazione buildpack di 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>

Usare il comando seguente per elencare tutte le associazioni buildpack e trovare associazioni di Application Insights per il 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>

Usare il comando seguente per sostituire un'associazione buildpack di 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>

Usare il comando seguente per ottenere un'associazione buildpack di 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> \

Usare il comando seguente per eliminare un'associazione buildpack di 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> \

Per altre informazioni, vedere Usare l'agente in-process Java di Application Insights in Azure Spring Apps.

Passaggi successivi

• Azure Spring Apps
• Usare il portale API per VMware Tanzu
• Usare Spring Cloud Gateway