Dela via

Aspire CLI-översikt

Aspire CLI (aspirekommandot) är ett plattformsoberoende verktyg som tillhandahåller kommandoradsfunktioner för att skapa, hantera, köra och publicera flerspråkiga Aspire projekt. Aspire Använd CLI för att effektivisera arbetsflöden för utveckling och samordna tjänster för distribuerade program.

Aspire CLI är en interaktiv första upplevelse.

Tip

För en steg-för-steg handledning som använder aspire deploy-kommandot, se Distribuera ett Aspire projekt till Azure Container Apps med Aspire CLI.

Använd mallar

Kommandoreferens: aspire new

Kommandot aspire new är en interaktiv första CLI-upplevelse och används för att skapa ett eller flera Aspire projekt. Som en del av skapandet av ett projekt Aspire ser CLI till att de senaste Aspire projektmallarna installeras i dotnet systemet.

aspire new Använd kommandot för att skapa ett Aspire projekt från en lista med mallar. När en mall har valts anges namnet på projektet och utdatamappen väljs, aspire de senaste mallarna hämtas och ett eller flera projekt genereras.

Kommandoradsparametrar kan användas för att automatisera skapandet av ett Aspire projekt, men Aspire CLI är en interaktiv upplevelse.

Starta AppHost Aspire

Kommandoreferens: aspire run

Kommandot aspire run kör AppHost-projektet i utvecklingsläge, som konfigurerar Aspire miljön, skapar och startar resurser som definierats av AppHost, startar webbinstrumentpanelen och skriver ut en lista med slutpunkter.

När aspire run startar söker den i den aktuella katalogen efter ett AppHost-projekt. Om ett projekt inte hittas genomsöks underkatalogerna tills ett hittas. Om inget AppHost-projekt hittas Aspire stoppas. När ett projekt har hittats Aspire utför CLI följande steg:

  • Installerar eller verifierar att Aspirelokala värdcertifikat är installerade och betrodda.
  • Skapar AppHost-projektet och dess resurser.
  • Startar AppHost och dess resurser.
  • Startar instrumentpanelen.

Följande kodfragment är ett exempel på utdata som visas av aspire run kommandot:

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

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

Lägga till integreringar

Kommandoreferens: aspire add

Kommandot aspire add är ett enkelt sätt att lägga till officiella integreringspaket i ditt AppHost-projekt. Använd detta som ett alternativ till en NuGet-sökning via din IDE. Du kan köra aspire add <name|id> om du känner till namnet eller NuGet-ID:t för integrationspaketet. Om du utelämnar ett namn eller ID innehåller verktyget en lista över paket att välja mellan. Om du anger ett partiellt namn eller ID filtrerar verktyget listan över paket med objekt som matchar det angivna värdet.

Publicera Aspire program (förhandsversion)

Kommandoreferens: aspire publish

Kommandot aspire publish publicerar resurser genom att serialisera dem till disk. När det här kommandot körs, anropas registrerade resursanteckningar i den ordning de deklareras. Dessa anteckningar serialiserar en resurs så att den kan användas av distributionsverktyg.

Vissa integreringar registrerar automatiskt en PublishingCallbackAnnotation åt dig, till exempel:

Distribuera Aspire program (förhandsversion)

Kommandoreferens: aspire deploy

Kommandot aspire deploy liknar aspire publish. Efter Aspire har anropat publiceringsanteckningar för att serialisera resurser till disk, anropar DeployingCallbackAnnotation resursanteckningar i den ordning de deklareras.

Aspire Från och med 9.4 Aspire innehåller inga standarddistributionsanteckningar för dess resurser, du måste använda DeployingCallbackAnnotation för att skapa dina egna.

Tip

Det här är ett bra sätt att distribuera din Aspire lösning till en mellanlagrings- eller testmiljö.

Hantera Aspire konfiguration

Kommandoreferens: aspire config

Med aspire config kommandot kan du hantera Aspire CLI-konfigurationsinställningar. Använd den till list, get, seteller delete konfigurationsvärden som styr CLI-beteendet. Det här kommandot används också för att aktivera eller inaktivera funktioner.

Mer information om Aspire CLI-konfiguration finns i Vad är Aspire konfiguration?

Köra kommandon i resurskontext (förhandsversion)

Kommandoreferens: aspire exec

Kommandot aspire exec kör ett kommando i kontexten för en specifik Aspire resurs och ärver resursens konfiguration, inklusive miljövariabler, anslutningssträngar och arbetskatalog. Detta är särskilt användbart för scenarier som att köra Entity Framework-migreringar där du behöver köra kommandon med samma konfiguration som ditt program. Du kan till exempel köra aspire exec --resource api -- dotnet ef migrations add Init Entity Framework-kommandon med rätt databasanslutningssträngar automatiskt konfigurerade.

Viktigt!

🧪 Funktionsflagga: Kommandot aspire exec ligger bakom en funktionsflagga och inaktiveras som standard i den här versionen. Den måste uttryckligen aktiveras för användning med aspire config set features.execCommandEnabled true.

  • Last updated on