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

Articolo
11/05/2024

Nota

I piani Basic, Standard ed Enterprise saranno deprecati a partire dalla metà di marzo 2025, con un periodo di ritiro di 3 anni. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere l'annuncio di ritiro di Azure Spring Apps.

Il piano Standard a consumo e dedicato sarà deprecato a partire dal 30 settembre 2024, con un arresto completo dopo sei mesi. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere Eseguire la migrazione del consumo di Azure Spring Apps Standard e del piano dedicato alle app Azure Container.

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
Interfaccia della riga di comando di Azure

Apri il portale di Azure.
Nella casella di ricerca in alto cercare Azure Spring Apps.
Selezionare Azure Spring Apps nei risultati quindi selezionare Crea.
Nella pagina Crea Azure Spring Apps impostare la Sottoscrizione,il Gruppo di risorse e il Nome per l'istanza.
Per Piano in Dettagli di servizio, selezionare Cambia.
Nella pagina Scegliere il piano selezionare la riga Enterprise nella tabella quindi selezionare Seleziona.
Indietro alla 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.
Selezionare Avanti: Impostazioni di Tanzu VMware.
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.
Selezionare la scheda Application Insights quindi selezionare Abilita Application Insights. Esaminare le impostazioni seguenti:
- Abilita 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 Fatturazione di Application Insights di 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.
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.

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
```
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>
```
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
```
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.
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 maggiori informazioni sui gruppi di risorse, vedere Che cos'è Azure Resource Manager?.

Creare e configurare app

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

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

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	Enterprise	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 ConfigMap Kubernetes nativo, popolato dalle proprietà definite nei repository Git back-end. 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 esplicita config-file-pattern 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
Interfaccia della riga di comando di Azure

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.
Selezionare Impostazioni e completare il modulo in Repository per aggiungere una nuova voce con le informazioni seguenti:
- Nome: default
- Criteri: api-gateway,customers-service
- URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config
- Etichetta: master
Selezionare Convalida per convalidare l'accesso all'URI di destinazione.
Al termine della convalida, selezionare Applica per aggiornare le impostazioni di configurazione.

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
Interfaccia della riga di comando di Azure

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

Nell'istanza di Azure Spring Apps Enterprise selezionare Servizio di configurazione dell'applicazione nel riquadro di spostamento.
Selezionare Associazione app quindi Selezionare Associa app.
Selezionare un'app nel menu a discesa quindi selezionare Applica per associare l'applicazione al servizio di configurazione dell'applicazione per Tanzu.

Usare i comandi seguenti per associare app al Servizio di configurazione dell'applicazione per VMware Tanzu e al 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
Interfaccia della riga di comando di Azure

Nell'istanza di Azure Spring Apps Enterprise selezionare Registro dei servizi.
Selezionare Associazione app. Le app attualmente associate vengono visualizzate in Nome app.
Selezionare Associa app.
Selezionare un'app nel menu a discesa quindi selezionare Applica per associare l'applicazione al Registro di sistema del servizio Tanzu.

Usare i comandi seguenti per associare app al Servizio di configurazione dell'applicazione per VMware Tanzu e al 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 parametro --build-env 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

Per compilare a livello locale, seguire questa procedura:

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.

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

Usare il comando seguente per eseguire una query sullo stato dell'applicazione dopo la distribuzione:

az spring app list --output table

L'output generato dal comando sarà 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 CA.

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

Piano Standard	Piano Enterprise
Application Insights New Relic Dynatrace AppDynamics	Application Insights New Relic Dynatrace AppDynamics ElasticAPM

Azure portal
Interfaccia della riga di comando di Azure

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

Nell'istanza di Azure Spring Apps Enterprise selezionare Application Insights.
Abilitare o disabilitare Application Insights selezionando Modifica associazione o Annulla associazione.
Selezionare Modifica associazione. Modificare le impostazioni di associazione quindi selezionare Salva.

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.

Condividi tramite

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

Prerequisiti

Effettuare il provisioning di un'istanza del servizio

Creare e configurare app

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

Configurare il servizio di configurazione dell'applicazione per Tanzu

Associare applicazioni al servizio di configurazione dell'applicazione per Tanzu

Uso del Registro dei servizi per Tanzu

Associare un'applicazione al Registro di sistema del servizio Tanzu

Compilare e distribuire applicazioni

Compilare applicazioni in locale

Usare Application Insights

Passaggi successivi

Commenti e suggerimenti

Risorse aggiuntive