Aspire Panoramica della CLI

Il Aspire CLI (aspire comando) è uno strumento multipiattaforma che fornisce funzionalità della riga di comando per creare, gestire, eseguire e pubblicare progetti poliglotta Aspire. Usare l'interfaccia della Aspire riga di comando per semplificare i flussi di lavoro di sviluppo e coordinare i servizi per le applicazioni distribuite.

L'interfaccia della Aspire riga di comando è un'esperienza principalmente interattiva.

• Installare la CLI Aspire.
• aspire riferimento al comando.

Tip

Per un'esercitazione dettagliata che usa il comando aspire deploy, vedere Distribuire un Aspire progetto in Azure Container Apps con il Aspire CLI.

Usare modelli

Informazioni di riferimento sul comando: aspire new

Il comando aspire new offre un'esperienza a riga di comando interattiva ed è usato per creare uno o più progetti Aspire. Nell'ambito della creazione di un progetto, Aspire l'interfaccia della riga di comando garantisce che nel sistema siano installati Aspire i modelli di progetto più recentidotnet.

Usare il aspire new comando per creare un Aspire progetto da un elenco di modelli. Dopo aver selezionato un modello, il nome del progetto viene impostato e la cartella di output viene scelta, aspire scarica i modelli più recenti e genera uno o più progetti.

Anche se i parametri della riga di comando possono essere usati per automatizzare la creazione di un progetto Aspire, la CLI Aspire offre principalmente un'esperienza interattiva.

Aspire Avviare AppHost

Informazioni di riferimento sul comando: aspire run

Il aspire run comando esegue il progetto AppHost in modalità di sviluppo, che configura l'ambiente Aspire , compila e avvia le risorse definite da AppHost, avvia il dashboard Web e stampa un elenco di endpoint.

Quando aspire run si avvia, cerca nella directory corrente un progetto AppHost. Se non viene trovato un progetto, le sottodirectory vengono cercate fino a quando non ne viene trovata una. Se non viene trovato alcun progetto AppHost, Aspire si arresta. Dopo aver trovato un progetto, Aspire l'interfaccia della riga di comando esegue la procedura seguente:

• Installa o verifica che Aspirei certificati di hosting locali siano installati e attendibili.
• Compila il progetto AppHost e le relative risorse.
• Avvia AppHost e le relative risorse.
• Avvia il dashboard.

Il frammento di codice seguente è un esempio dell'output visualizzato dal aspire run comando :

Dashboard:  https://localhost:17178/login?t=17f974bf68e390b0d4548af8d7e38b65

    Logs:  /home/vscode/.aspire/cli/logs/apphost-1295-2025-07-14-18-16-13.log

Aggiungere integrazioni

Informazioni di riferimento sul comando: aspire add

Il aspire add comando è un modo semplice per aggiungere pacchetti di integrazione ufficiali al progetto AppHost. Usare questa opzione come alternativa a una ricerca NuGet tramite l'IDE. È possibile eseguire aspire add <name|id> se si conosce il nome o l'ID NuGet del pacchetto di integrazione. Se si omette un nome o un ID, lo strumento fornisce un elenco di pacchetti tra cui scegliere. Se si specifica un nome o un ID parziale, lo strumento filtra l'elenco di pacchetti con elementi che corrispondono al valore specificato.

Pubblicare Aspire applicazioni (anteprima)

Informazioni di riferimento sul comando: aspire publish

Il aspire publish comando pubblica le risorse serializzandole su disco. Quando questo comando viene eseguito, Aspire richiama le annotazioni delle risorse registrate PublishingCallbackAnnotation , nell'ordine in cui vengono dichiarate. Queste annotazioni serializzano una risorsa in modo che possa essere utilizzata dagli strumenti di distribuzione.

Alcune integrazioni registrano automaticamente un oggetto PublishingCallbackAnnotation per l'utente, ad esempio:

• AzureEnvironmentResource genera risorse Bicep.
• DockerComposeEnvironmentResource genera il file YAML di docker-compose.
• KubernetesEnvironmentResource genera Kubernetes grafici Helm.

Distribuire Aspire applicazioni (anteprima)

Informazioni di riferimento sul comando: aspire deploy

Il comando aspire deploy è simile a aspire publish. Dopo Aspire aver richiamato le annotazioni di pubblicazione per serializzare le risorse su disco, richiama DeployingCallbackAnnotation le annotazioni delle risorse, nell'ordine in cui vengono dichiarate.

A partire dalla Aspire versione 9.4, Aspire non include le annotazioni di distribuzione predefinite per le proprie risorse; è necessario utilizzare DeployingCallbackAnnotation per crearle.

Tip

Considerate questo un buon modo per distribuire la soluzione Aspire in un ambiente di staging o di test.

Gestire la Aspire configurazione

Informazioni di riferimento sul comando: aspire config

Il comando aspire config consente di gestire le impostazioni di configurazione della CLI Aspire. Usa list, i valori di configurazione get, set, o delete che controllano il comportamento della CLI. Questo comando viene usato anche per attivare o disattivare le funzionalità.

Per altre informazioni sulla configurazione dell'interfaccia Aspire della riga di comando, vedere Che cos'è la Aspire configurazione?

Eseguire comandi nel contesto delle risorse (anteprima)

Informazioni di riferimento sul comando: aspire exec

Il aspire exec comando esegue un comando nel contesto di una risorsa specifica Aspire , ereditando la configurazione della risorsa, incluse variabili di ambiente, stringhe di connessione e directory di lavoro. Ciò è particolarmente utile per scenari come l'esecuzione di migrazioni di Entity Framework in cui è necessario eseguire comandi con la stessa configurazione dell'applicazione. Ad esempio, è possibile eseguire aspire exec --resource api -- dotnet ef migrations add Init per eseguire i comandi di Entity Framework con le stringhe di connessione del database appropriate configurate automaticamente.

Importante

🧪 Flag di funzionalità: il aspire exec comando è dietro un flag di funzionalità e disabilitato per impostazione predefinita in questa versione. Deve essere abilitato in modo esplicito per l'uso con aspire config set features.execCommandEnabled true.