Usare L'acceleratore di applicazioni VMware Tanzu con il piano Enterprise di Azure Spring Apps

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 usare Application Accelerator per VMware Tanzu (Acceleratore app) con il piano Azure Spring Apps Enterprise 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 altre informazioni, vedere Acceleratore di applicazioni per VMware Tanzu nella documentazione di VMware.

Prerequisiti

Abilitare l'acceleratore di app

È possibile abilitare l'acceleratore di app quando si effettua il provisioning di un'istanza del piano Enterprise di Azure Spring Apps. Se si dispone già di una risorsa del piano Enterprise di Azure Spring Apps, vedere la sezione Gestire l'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.

Usare la procedura seguente per abilitare l'acceleratore di app usando il portale di Azure:

  1. Apri il portale di Azure.

  2. Nella scheda Informazioni di base selezionare Livello Enterprise nella sezione Prezzi e specificare le informazioni necessarie. Selezionare quindi Avanti: Impostazioni di VMware Tanzu.

  3. Nella scheda Impostazioni di VMware Tanzu selezionare Abilita acceleratore app.

    Screenshot della portale di Azure che mostra la scheda Delle impostazioni di VMware Tanzu con la casella di controllo Abilita acceleratore app evidenziata.

  4. Specificare altre impostazioni e quindi selezionare Rivedi e crea.

  5. Nella scheda Rivedi una creazione verificare che l'opzione Abilita acceleratore app e Abilita portale di Dev Tools sia impostata su . Selezionare Crea per creare l'istanza del piano enterprise.

Monitorare l'acceleratore di app

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

Nome componente Numero di istanze vCPU per istanza Memoria per istanza Descrizione
accelerator-server 2 0.4 core 0.5Gi Serve l'API usata dal portale di Dev Tools per elencare gli acceleratori e le opzioni disponibili.
accelerator-engine 1 1 core 3Gi Elabora i valori e i file di input (estratti da uno snapshot di un repository Git) e applica trasformazioni dinamiche per generare progetti.
accelerator-controller 1 0.2 core 0.25Gi Riconcilia le risorse dell'acceleratore di applicazioni.
source-controller 1 0.2 core 0.25Gi Registra un controller per riconciliare le risorse e MavenArtifacts usate dall'acceleratore ImageRepositories di applicazioni.
flux-source-controller 1 0.2 core 0.25Gi Registra un controller per riconciliare GithubRepository le risorse usate dall'acceleratore di applicazioni. Supporta la gestione delle origini del repository Git per l'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.

È possibile visualizzare lo stato dell'acceleratore di applicazioni nella portale di Azure nella pagina Strumenti di sviluppo, come illustrato nello screenshot seguente:

Screenshot del portale di Azure che mostra la pagina Strumenti di sviluppo.

Configurare Dev Tools per accedere all'acceleratore di applicazioni

Per accedere all'acceleratore di applicazioni, è necessario configurare Tanzu Dev Tools. Per altre informazioni, vedere Configurare Gli strumenti di sviluppo Tanzu nel piano Enterprise di Azure Spring Apps.

Usare l'acceleratore di applicazioni per avviare il bootstrap dei nuovi progetti

Per usare l'acceleratore di applicazioni per eseguire il bootstrap dei nuovi progetti, è necessario ottenere le autorizzazioni per gestire gli acceleratori. È quindi 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 App Azure Spring
  • Altro: disabilitare l'acceleratore predefinito di App Azure Spring
  • Altro: abilitare l'acceleratore predefinito di App Azure Spring
  • Scrittura: creare o aggiornare l'acceleratore personalizzato di Microsoft Azure Spring Apps
  • Lettura: Ottenere l'acceleratore personalizzato di App Spring di Azure

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

Gestire acceleratori predefiniti

È possibile iniziare con diversi acceleratori predefiniti per eseguire il bootstrap dei nuovi progetti. È 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.

È possibile visualizzare gli acceleratori predefiniti nella portale di Azure nella scheda Acceleratori, come illustrato nello screenshot seguente:

Screenshot del portale di Azure che mostra la scheda Acceleratori con acceleratori predefiniti, con il pulsante Disabilita acceleratore evidenziato.

Gestire i propri acceleratori

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

Usare la procedura seguente per creare e gestire acceleratori personalizzati:

Creare prima di tutto un file denominato accelerator.yaml nella directory radice del repository Git.

È possibile usare il file accelerator.yaml per dichiarare le opzioni di input compilate dagli utenti usando 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 , il repository funziona ancora come acceleratore, ma i file vengono passati agli utenti senza modifiche. Per altre informazioni, vedere Creazione di un file accelerator.yaml.

Pubblicare quindi il nuovo acceleratore.

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

Per creare un acceleratore personalizzato, aprire la sezione Acceleratori e quindi selezionare Aggiungi acceleratore nella sezione Acceleratori personalizzati.

Screenshot del portale di Azure che mostra la scheda Acceleratori della pagina Strumenti di sviluppo con il pulsante Aggiungi acceleratore evidenziato.

Nella tabella seguente vengono descritti i campi dell'acceleratore personalizzabili.

Portale CLI Descrizione Obbligatorio/facoltativo
Nome name Nome univoco per l'acceleratore. Il nome non può cambiare dopo averlo creato. Obbligatorio
Descrizione display-name Descrizione più lunga dell'acceleratore. Facoltativo
URL icona icon-url URL di un'immagine che rappresenta l'acceleratore nell'interfaccia utente. Facoltativo
Tag accelerator-tags Matrice di stringhe che definiscono gli attributi dell'acceleratore che possono essere usati in una ricerca nell'interfaccia utente. Facoltativo
URL Git git-url URL del repository git dell'origine dell'acceleratore. L'URL può essere un indirizzo HTTP/S o SSH. La sintassi scp-like non è supportata per gli indirizzi SSH , ad esempio user@example.com:repository.git. Il formato url valido è ssh://user@example.com:22/repository.gitinvece . Richiesto
Intervallo Git git-interval-in-seconds Intervallo in cui verificare la disponibilità di aggiornamenti del repository. Se non specificato, per impostazione predefinita l'intervallo è 10 minuti. Esiste anche un intervallo di aggiornamento (attualmente 10 secondi) prima che gli acceleratori vengano visualizzati nell'interfaccia utente. Potrebbe verificarsi un ritardo di 10 secondi prima che le modifiche vengano riflesse nell'interfaccia utente. Facoltativo
Ramo Git git-branch Ramo Git da controllare e monitorare le modifiche. È necessario specificare solo il ramo Git, il commit Git o il tag Git. Facoltativo
Commit Git git-commit Eseguire il commit di GIT SHA per eseguire il check-out. È necessario specificare solo il ramo Git, il commit Git o il tag Git. Facoltativo
Tag Git git-tag Tag di commit Git da controllare. È necessario specificare solo il ramo Git, il commit Git o il tag Git. Facoltativo
Percorso secondario Git git-sub-path Percorso della cartella all'interno del repository Git da considerare come radice dell'acceleratore o del frammento. Facoltativo
Tipo di autenticazione N/A Tipo di autenticazione del repository di origine dell'acceleratore. Il tipo può essere Public, Basic autho SSH. Richiesto
Nome utente username Nome utente per accedere al repository di origine dell'acceleratore il cui tipo di autenticazione è Basic auth. Obbligatorio quando il tipo di autenticazione è Basic auth.
Token di accesso personale/password password Password per accedere al repository di origine dell'acceleratore il cui tipo di autenticazione è Basic auth. Obbligatorio quando il tipo di autenticazione è Basic auth.
Chiave privata private-key Chiave privata per accedere al repository di origine dell'acceleratore il cui tipo di autenticazione è SSH. È supportata solo la chiave privata OpenSSH. Obbligatorio quando il tipo di autenticazione è SSH.
Chiave host host-key Chiave host per accedere al repository di origine dell'acceleratore il cui tipo di autenticazione è SSH. Obbligatorio quando il tipo di autenticazione è SSH.
Algoritmo chiave host host-key-algorithm Algoritmo della chiave host per accedere al repository di origine dell'acceleratore il cui tipo di autenticazione è SSH. Può essere ecdsa-sha2-nistp256 o ssh-rsa. Obbligatorio quando il tipo di autenticazione è SSH.
Nome certificato CA ca-cert-name Nome del certificato DELLA CA per accedere al repository di origine dell'acceleratore con certificato autofirmato il cui tipo di autenticazione è Public o Basic auth. Obbligatorio quando viene usato un certificato autofirmato per l'URL del repository Git.
Type type Tipo di acceleratore personalizzato. Il tipo può essere Accelerator o Fragment. Il valore predefinito è Accelerator. Facoltativo

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 di Dev Tools:

Screenshot del portale di Azure che mostra la pagina Strumenti di sviluppo con l'URL dell'acceleratore di app evidenziato.

Per visualizzare l'acceleratore appena pubblicato, aggiornare il portale di Dev Tools.

Screenshot della pagina Strumenti di sviluppo VMware Tanzu per Acceleratori di applicazioni di Azure Spring Apps.

Nota

Il portale di Dev Tools potrebbe richiedere alcuni secondi per aggiornare il catalogo e aggiungere una voce per il nuovo acceleratore. L'intervallo di aggiornamento viene configurato come git-interval quando si crea l'acceleratore. Dopo aver modificato l'acceleratore, è necessario anche tempo per riflettersi nel portale di Dev Tools. La procedura consigliata consiste nel modificare per git-interval velocizzare la verifica dopo l'applicazione delle modifiche al repository Git.

Fare riferimento a un frammento nei propri acceleratori

La scrittura e la gestione degli acceleratori possono diventare ripetitive e dettagliate man mano che vengono aggiunti nuovi acceleratori. Alcune persone creano nuovi progetti copiando quelli esistenti e apportando modifiche, ma questo processo può essere 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.

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

    Screenshot della portale di Azure che mostra gli acceleratori personalizzati di tipo 'Fragment'.

  2. Modificare il file accelerator.yaml nel progetto dell'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 di Dev Tools.

    Per riflettere le modifiche nel portale di Dev Tools 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 nel repository 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.

    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 altre informazioni, vedere Usare frammenti nell'acceleratore di applicazioni nella documentazione di VMware.

Usare gli acceleratori per eseguire il bootstrap di un nuovo progetto

Usare la procedura seguente per eseguire il bootstrap di un nuovo progetto usando gli acceleratori:

  1. Nella pagina Strumenti di sviluppo selezionare l'URL dell'acceleratore di app per aprire il portale di Dev Tools.

    Screenshot del portale di Azure che mostra la pagina Strumenti di sviluppo con l'URL dell'acceleratore di app evidenziato.

  2. Nel portale di Dev Tools selezionare un acceleratore.

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

    Screenshot della pagina VMware Tanzu Dev Tools for Azure Spring Apps Generate Accelerators (Genera acceleratori) di VMware Tanzu Dev Tools per Azure Spring Apps che mostra la sezione Configura acceleratore.

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

    Screenshot del riquadro Esplora progetto di VMware Tanzu Dev Tools for Azure Spring Apps.

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

    Screenshot della pagina VMware Tanzu Dev Tools for Azure Spring Apps Generate Accelerators che mostra la sezione Rivedi e genera.

  6. È quindi possibile visualizzare o scaricare il progetto come file ZIP.

    Screenshot di VMware Tanzu Dev Tools per Azure Spring Apps che mostra il riquadro Attività.

Configurare gli acceleratori con un certificato autofirmato

Quando si configura un repository 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 al repository 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.

Per configurare un certificato per un acceleratore, aprire la sezione Acceleratori e quindi selezionare Aggiungi acceleratore nella sezione Acceleratori personalizzati. Selezionare quindi il certificato dall'elenco a discesa.

Screenshot del portale di Azure che mostra il riquadro Aggiungi acceleratore.

Ruotare i certificati

Quando i certificati scadono, è necessario ruotare i certificati in Spring Cloud Apps attenendosi alla procedura seguente:

  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.

Per sincronizzare i certificati per tutti gli acceleratori, aprire la sezione Acceleratori e quindi selezionare Sincronizza certificato, come illustrato nello screenshot seguente:

Screenshot del portale di Azure che mostra il riquadro Acceleratori personalizzati con il pulsante Sincronizza certificato evidenziato.

Per sincronizzare un certificato per un singolo acceleratore, aprire la sezione Acceleratori e quindi selezionare Sincronizza certificato dal menu di scelta rapida di un acceleratore, come illustrato nello screenshot seguente:

Screenshot o portale di Azure che mostra il riquadro Acceleratori personalizzati con l'opzione di menu di scelta rapida Sincronizza certificato evidenziata.

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

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

Se è già stato esposto un endpoint pubblico degli strumenti di sviluppo, è possibile abilitare l'acceleratore di app e quindi premere CTRL+F5 per disattivare la cache del browser per visualizzarla nel portale di Dev Tools.

Usare la procedura seguente per abilitare l'acceleratore di app in un'istanza del piano enterprise di Azure Spring Apps esistente usando il portale di Azure:

  1. Passare alla risorsa del servizio e quindi selezionare Strumenti di sviluppo.

  2. Selezionare Gestisci strumenti.

  3. Selezionare Abilita acceleratore app e quindi applica.

    Screenshot del portale di Azure che mostra il riquadro Gestisci strumenti con l'opzione Abilita acceleratore app evidenziata.

È possibile visualizzare se l'acceleratore di app è abilitato o disabilitato nella pagina Strumenti di sviluppo.

Usare l'acceleratore di app in VS Code

È possibile avviare il progetto da qualsiasi acceleratore di acceleratore di app in un'istanza del piano enterprise di Azure Spring Apps direttamente in VS Code.

Visualizzare l'elenco di acceleratori di app

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

  1. In Visual Studio Code aprire l'estensione Azure Spring Apps e quindi 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 menu selezionare Apri acceleratore di applicazioni per aprire l'elenco di Acceleratori di app. Il sistema richiede di installare l'estensione Tanzu Application Accelerator di Visual Studio Code, se non è installata.

    Screenshot dell'estensione VS Code che mostra l'opzione Apri acceleratore di applicazione per un'istanza del servizio.

  4. Selezionare un acceleratore per avviare il progetto.

    Screenshot di VS Code che mostra l'elenco delle estensioni dell'acceleratore di app.

Nota

Quando si usa l'estensione, se si verificano problemi che non è possibile correggere, disconnettersi dall'account dall'estensione.

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 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 altre 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 Dev Tools, viene visualizzato il messaggio seguente quando si accede all'estensione: The extension 'Tanzu App Accelerator' wants to sign in using VMware Tanzu. per altre informazioni, vedere la sezione Configurare il portale di Dev Tools di Tanzu nel piano Azure Spring Apps Enterprise.

  2. Selezionare Consenti, selezionare Apri e quindi selezionare di nuovo Apri per aprire l'elenco delle estensioni di VS Code.

    Screenshot di VS Code che mostra l'elenco delle estensioni dell'acceleratore di app.

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 passare al menu Autenticazione e aggiungere URI di reindirizzamento alle applicazioni per dispositivi mobili e desktop nelle configurazioni della piattaforma.

Passaggi successivi