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
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:
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:
Apri il portale di Azure.
Nella scheda Informazioni di base selezionare Livello Enterprise nella sezione Prezzi e specificare le informazioni necessarie. Selezionare quindi Avanti: Impostazioni di VMware Tanzu.
Nella scheda Impostazioni di VMware Tanzu selezionare Abilita acceleratore app.
Specificare altre impostazioni e quindi selezionare Rivedi e crea.
Nella scheda Rivedi una creazione verificare che l'opzione Abilita acceleratore app e Abilita portale di Dev Tools sia impostata su Sì. 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:
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:
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.
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.git invece . |
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 auth o 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:
Per visualizzare l'acceleratore appena pubblicato, aggiornare il portale di Dev Tools.
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:
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.
Modificare il file accelerator.yaml nel progetto dell'acceleratore. Usare l'istruzione
imports
nellaaccelerator
sezione e l'istruzioneInvokeFragment
nellaengine
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>
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.
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:
Nella pagina Strumenti di sviluppo selezionare l'URL dell'acceleratore di app per aprire il portale di Dev Tools.
Nel portale di Dev Tools selezionare un acceleratore.
Specificare le opzioni di input nella sezione Configura acceleratore della pagina Genera acceleratori .
Selezionare ESPLORA FILE per visualizzare la struttura del progetto e il codice sorgente.
Selezionare Rivedi e genera per esaminare i parametri specificati e quindi selezionare Genera acceleratore.
È quindi possibile visualizzare o scaricare il progetto come file ZIP.
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:
- 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.
- 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.
Ruotare i certificati
Quando i certificati scadono, è necessario ruotare i certificati in Spring Cloud Apps attenendosi alla procedura seguente:
- Generare nuovi certificati da una CA attendibile.
- 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.
- 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:
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:
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:
Passare alla risorsa del servizio e quindi selezionare Strumenti di sviluppo.
Selezionare Gestisci strumenti.
Selezionare Abilita acceleratore app e quindi applica.
È 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:
In Visual Studio Code aprire l'estensione Azure Spring Apps e quindi accedere all'account Azure.
Espandere l'istanza del servizio desiderata e fare clic con il pulsante destro del mouse per selezionare l'istanza del servizio.
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.
Selezionare un acceleratore per avviare il progetto.
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.
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.Selezionare Consenti, selezionare Apri e quindi selezionare di nuovo 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 passare al menu Autenticazione e aggiungere URI di reindirizzamento alle applicazioni per dispositivi mobili e desktop nelle configurazioni della piattaforma.