Usare l'Acceleratore di applicazioni Tanzu VMware con il piano Enterprise Azure Spring Apps

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

Questo articolo mostra come usare l’Acceleratore di applicazioni per Tanzu VMware (Acceleratore di app) con il piano Enterprise Azure Spring Apps per avviare lo sviluppo delle applicazioni in modo individuabile e ripetibile.

L'Acceleratore di app consente di avviare lo sviluppo delle applicazioni e di distribuirle in modo individuabile e ripetibile. È possibile usare l'Acceleratore di app per creare nuovi progetti basati su progetti di acceleratore pubblicati. Per maggiori informazioni, vedere Acceleratore di applicazioni per Tanzu VMware nella documentazione di VMware.

Prerequisiti

• Una sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

• Comprendere e soddisfare i requisiti elencati nella sezione Requisiti del piano Enterprise in Azure Marketplace.

• Interfaccia della riga di comando di Azure con l'estensione Azure Spring Apps. Usare il comando seguente per rimuovere le versioni precedenti e installare l'estensione più recente. Se l'estensione spring-cloud è stata installata in precedenza, disinstallarla per evitare la mancata corrispondenza della configurazione e della versione.

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

• Per usare l'Acceleratore di app in VS Code, è anche necessario soddisfare i prerequisiti seguenti:

  • Visual Studio Code
  • Estensione Azure Spring Apps per Visual Studio Code

Abilitare l’Acceleratore di app

È possibile abilitare l'Acceleratore di app quando si effettua il provisioning di un'istanza del piano Enterprise Azure Spring Apps. Se si dispone già di una risorsa del piano Enterprise Azure Spring Apps, vedere la sezione Gestire Acceleratore di app in un'istanza del piano Enterprise esistente per abilitarla.

È possibile abilitare l'Acceleratore di app usando il portale di Azure o l'interfaccia della riga di comando di Azure.

Monitorare l'Acceleratore di app

L'Acceleratore di app consente di generare nuovi progetti dai file nei repository Git. La tabella seguente descrive i componenti dell'Acceleratore di applicazioni:

È possibile visualizzare le istanze in esecuzione e l'utilizzo delle risorse di tutti i componenti usando il portale di Azure e l'interfaccia della riga di comando di Azure.

az spring application-accelerator show \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

Configurare Strumenti di sviluppo per accedere all'Acceleratore di applicazioni

Per accedere all'Acceleratore di applicazioni, è necessario configurare Strumenti di sviluppo Tanzu. Per altre informazioni, vedere Configurare gli strumenti di sviluppo Tanzu nel piano Enterprise Azure Spring Apps.

Usare l'Acceleratore di applicazioni per l’avvio dei nuovi progetti

Per usare l'Acceleratore di applicazioni per l’avvio dei nuovi progetti, è necessario ottenere le autorizzazioni per gestire gli acceleratori. In seguito, sarà possibile gestire acceleratori predefiniti o acceleratori personalizzati.

Ottenere le autorizzazioni per gestire gli acceleratori

La gestione degli acceleratori richiede le autorizzazioni seguenti:

• Lettura: ottenere l'acceleratore predefinito di Azure Spring Apps
• Altro: disabilitare l'acceleratore predefinito di Azure Spring Apps
• Altro: abilitare l'acceleratore predefinito di Azure Spring Apps
• Scrittura: creare o aggiornare l'acceleratore personalizzato di Microsoft Azure Spring Apps
• Lettura: ottenere l'acceleratore personalizzato di Azure Spring Apps

Per maggiori informazioni, vedere Come usare le autorizzazioni in Azure Spring Apps.

Gestire acceleratori predefiniti

Per l’avvio dei nuovi progetti, è possibile iniziare con diversi acceleratori predefiniti. È possibile disabilitare o abilitare gli acceleratori predefiniti in base alle proprie preferenze.

È possibile gestire acceleratori predefiniti usando il portale di Azure o l'interfaccia della riga di comando di Azure.

az spring application-accelerator predefined-accelerator list \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

az spring application-accelerator predefined-accelerator disable \
    --name <predefined-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

az spring application-accelerator predefined-accelerator enable \
    --name <predefined-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

Gestire gli acceleratori

Oltre a usare gli acceleratori predefiniti, è possibile creare acceleratori personalizzati. È possibile usare qualsiasi archivio Git in Azure DevOps, GitHub, GitLab o BitBucket.

Usare la procedura seguente per creare e gestire acceleratori personalizzati:

Prima di tutto, creare un file denominato accelerator.yaml nella cartella di primo livello dell’archivio Git.

È possibile usare il file accelerator.yaml per dichiarare le opzioni di input compilate dagli utenti tramite un modulo nell'interfaccia utente. Questi valori di opzione controllano l'elaborazione da parte del motore di modelli prima di restituire i file di output compressi. Se non si include un file accelerator.yaml, l’archivio continua a funzionare come acceleratore, ma i file vengono restituiti agli utenti senza modifiche. Per maggiori informazioni, vedere Creazione di un file accelerator.yaml.

In seguito, pubblicare il nuovo acceleratore.

Dopo aver creato il file accelerator.yaml, è possibile creare l'acceleratore. È quindi possibile visualizzarlo nel portale di Azure o nella pagina Acceleratore di applicazioni nel portale degli strumenti di sviluppo. È possibile pubblicare il nuovo acceleratore usando il portale di Azure o l'interfaccia della riga di comando di Azure.

az spring application-accelerator customized-accelerator create \
    --name <customized-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name> \
    --display-name <display-name> \
    --git-url <git-repo-url> \
   [--description <description>] \
   [--icon-url <icon-url>] \
   [--accelerator-tags <tags-on-accelerator>] \
   [--git-interval <git-repository-refresh-interval-in-seconds>] \
   [--git-branch <git-branch-name>] \
   [--git-commit <git-commit-ID>] \
   [--git-tag <git-tag>] \
   [--ca-cert-name <ca-cert-name>] \
   [--username] \
   [--password] \
   [--private-key] \
   [--host-key] \
   [--host-key-algorithm]

Nella tabella seguente vengono descritti i campi dell'acceleratore che è possibile personalizzare.

Per visualizzare tutti gli acceleratori pubblicati, vedere la sezione Acceleratori di app della pagina Strumenti di sviluppo. Selezionare l'URL dell'Acceleratore di app per visualizzare gli acceleratori pubblicati nel portale degli strumenti di sviluppo:

Per visualizzare l'acceleratore appena pubblicato, aggiornare il portale degli strumenti di sviluppo.

Fare riferimento a un frammento nei propri acceleratori

La scrittura e la gestione degli acceleratori possono diventare ripetitive e sempre più specifiche man mano che si aggiungono nuovi acceleratori. Alcune persone creano nuovi progetti copiando quelli esistenti e apportando modifiche, ma questo processo può risultare noioso e soggetto a errori. Per semplificare la creazione e la manutenzione degli acceleratori, l'Acceleratore di applicazioni supporta una funzionalità denominata Composition che consente il riutilizzo di parti di un acceleratore, denominate frammenti.

Usare la procedura seguente per fare riferimento a un frammento nell'acceleratore:

1. Pubblicare il nuovo acceleratore di tipo Fragment usando il portale di Azure o l'interfaccia della riga di comando di Azure.

   • Azure portal
   • Interfaccia della riga di comando di Azure

   Per creare un acceleratore di frammenti, aprire la sezione Acceleratori, selezionareAggiungi acceleratore nella sezioneAcceleratori personalizzati e quindi selezionare Frammento.

   

2. Modificare il file accelerator.yaml nel progetto del proprio acceleratore. Usare l'istruzione imports nella accelerator sezione e l'istruzione InvokeFragment nella engine sezione per fare riferimento al frammento nell'acceleratore, come illustrato nell'esempio seguente:

   accelerator:
       ...
     # options for the UI
     options:
       ...
     imports:
     - name: <fragment-accelerator-name>
     ...
   
   engine:
     chain:
       ...
     - merge:
       - include: [ "**" ]
       - type: InvokeFragment
         reference: <fragment-accelerator-name>
   

3. Sincronizzare la modifica con il portale degli strumenti di sviluppo.

   Per effettuare la reflection delle modifiche nel portale degli strumenti di sviluppo più rapidamente, è possibile fornire un valore per il campo Intervallo Git dell'acceleratore personalizzato. Il valore dell'intervallo Git indica la frequenza con cui il sistema controlla la disponibilità di aggiornamenti nell’archivio Git.

4. Sincronizzare la modifica con l'acceleratore personalizzato nel portale di Azure, usando il portale di Azure o l'interfaccia della riga di comando di Azure.

   • Azure portal
   • Interfaccia della riga di comando di Azure

   L'elenco seguente illustra i due modi in cui è possibile sincronizzare le modifiche:

   • Creare o aggiornare l'acceleratore personalizzato.
   • Aprire la sezione Acceleratori e quindi selezionare Sincronizza certificato.

Per maggiori informazioni, vedere Usare frammenti nell'Acceleratore di applicazioni nella documentazione di VMware.

Usare gli acceleratori per l’avvio di un nuovo progetto

Seguire la procedura seguente per l’avvio di un nuovo progetto usando gli acceleratori:

1. Nella pagina Strumenti di sviluppo, selezionare l'URL dell'Acceleratore di app per aprire il portale degli strumenti di sviluppo.

   

2. Nel portale degli strumenti di sviluppo, selezionare un acceleratore.

3. Specificare le opzioni di input nella sezione Configura acceleratore della pagina Genera acceleratori.

   

4. Selezionare ESPLORA FILE per visualizzare la struttura del progetto e il codice sorgente.

5. Selezionare Rivedi e genera per esaminare i parametri specificati, quindi selezionare Genera acceleratore.

   

6. In seguito, è possibile visualizzare o scaricare il progetto come file ZIP.

   

Configurare gli acceleratori con un certificato autofirmato

Quando si configura un archivio Git privato e si abilita HTTPS con un certificato autofirmato, è necessario configurare il nome del certificato della CA per l'acceleratore per la verifica del certificato client dall'acceleratore all’archivio Git.

Usare la procedura seguente per configurare gli acceleratori con un certificato autofirmato:

1. Importare i certificati in Azure Spring Apps. Per altre informazioni, vedere la sezione Importare un certificato in Usare certificati TLS/SSL nell'applicazione in Azure Spring Apps.
2. Configurare il certificato per l'acceleratore usando il portale di Azure o l'interfaccia della riga di comando di Azure.

az spring application-accelerator customized-accelerator create \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <customized-accelerator-name> \
    --git-url <git-repo-URL> \
    --ca-cert-name <ca-cert-name>

Ruotare i certificati

Quando i certificati scadono, è necessario ruotare i certificati in Spring Cloud Apps seguendo i seguenti passaggi:

1. Generare nuovi certificati da una CA attendibile.
2. Importare i certificati in Azure Spring Apps. Per altre informazioni, vedere la sezione Importare un certificato in Usare certificati TLS/SSL nell'applicazione in Azure Spring Apps.
3. Sincronizzare i certificati usando il portale di Azure o l'interfaccia della riga di comando di Azure.

Gli acceleratori non useranno automaticamente il certificato più recente. È consigliabile sincronizzare uno o tutti i certificati usando il portale di Azure o l'interfaccia della riga di comando di Azure.

az spring application-accelerator customized-accelerator sync-cert \
    --name <customized-accelerator-name> \
    --service <service-instance-name> \
    --resource-group <resource-group-name>

Gestire l'Acceleratore di app in un'istanza del piano Enterprise esistente

È possibile abilitare l'Acceleratore di app in un'istanza del piano Enterprise Azure Spring Apps esistente usando il portale di Azure o l'interfaccia della riga di comando di Azure.

az spring application-accelerator create \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

az spring application-accelerator delete \
    --service <Azure-Spring-Apps-service-instance-name> \
    --resource-group <resource-group-name>

az spring dev-tool create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --assign-endpoint

Usare l'Acceleratore di app in VS Code

È possibile l’avvio del progetto da qualsiasi acceleratore di Acceleratore di app in un'istanza del piano Enterprise Azure Spring Apps direttamente in VS Code.

Visualizzare l'elenco degli Acceleratori di app

Usare la procedura seguente per visualizzare l'elenco degli Acceleratori di app in un'istanza del servizio piano Enterprise Azure Spring Apps:

1. In Visual Studio Code, aprire l'estensione Azure Spring Apps ed accedere all'account Azure.

2. Espandere l'istanza del servizio desiderata e fare clic con il pulsante destro del mouse per selezionare l'istanza del servizio.

3. Dal menù, selezionare Apri Acceleratore di applicazioni per aprire l'elenco degli Acceleratori di app. Se non è installata, il sistema richiede di installare l'estensione Visual Studio Code dell’Acceleratore di applicazioni Tanzu.

   

4. Selezionare un qualunque acceleratore per avviare il progetto.

   

Risolvere i problemi relativi all'Acceleratore di app

Se si tenta di aprire l'Acceleratore di app per un'istanza del servizio che non ha abilitato l'Acceleratore di app o non ha esposto un endpoint pubblico, viene visualizzato il messaggio di errore seguente: Application Accelerator of Spring Apps <instance-name> is not enabled or publically accessible.

Per abilitare l'Acceleratore di app ed esporre gli endpoint pubblici, seguire questa procedura. Per maggiori informazioni, vedere la sezione Gestire l'Acceleratore di app in un'istanza del piano Enterprise esistente.

1. Se è stato abilitato l'accesso Single Sign-On nel portale di strumenti di sviluppo, viene visualizzato il messaggio seguente quando si accede all'estensione: The extension 'Tanzu App Accelerator' wants to sign in using VMware Tanzu. Per maggiori informazioni, vedere la sezione Configurare il portale di strumenti di sviluppo di Configurare gli strumenti di sviluppo Tanzu nel piano Enterprise Azure Spring Apps.

2. Selezionare Consenti, selezionareApri e infine selezionare nuovamente Apri per aprire l'elenco delle estensioni di VS Code.

   

In alcuni casi, è possibile che venga visualizzato un messaggio di errore simile all'esempio seguente: AADSTS50011: The redirect URI 'vscode://VMware.tanzu-app-accelerator' specified in the request does not match the redirect URIs configured for the application 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'. Make sure the redirect URI sent in the request matches one added to your application in the Azure portal. Navigate to https://aka.ms/redirectUriMismatchError to learn more about how to fix this.

Per risolvere questo problema, aggiungere l'URI vscode://VMware.tanzu-app-accelerator di reindirizzamento al provider di identità (IdP) pertinente. In Microsoft Entra ID, andare al menù Autenticazione e aggiungere reindirizzare URI alle applicazioni per dispositivi mobili e desktop nelle configurazioni della piattaforma.

Passaggi successivi

• Azure Spring Apps