kommandot aspire run

Den här artikeln gäller för: ✔️ Aspire CLI 9.4.0 och senare versioner.

Name

aspire run – Kör en Aspire AppHost i utvecklingsläge.

Synopsis

aspire run [options] [[--] <additional arguments>...]

Description

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.

Aspire CLI använder följande logik för att avgöra vilket AppHost-projekt som ska bearbetas:

• Alternativet --project.

  Det här alternativet anger sökvägen till ett projekt som ska bearbetas.

• Konfigurationsfilen .aspire/settings.json .

  Om konfigurationsfilsökvägen finns i den aktuella katalogen används den. Annars går CLI upp i katalogstrukturen och letar efter konfigurationsfilen. Om den hittar en konfigurationsfil läser den appHostPath inställningsvärdet som det projekt som ska bearbetas.

• Söker i den aktuella katalogen och underkatalogerna.

  Från och med den aktuella katalogen samlar CLI in alla AppHost-projekt från den katalogen och nedan. Om ett enskilt projekt identifieras väljs det automatiskt. Om flera projekt identifieras skrivs de ut till terminalen så att användaren kan välja ett av projekten manuellt.

  När ett projekt har valts, antingen automatiskt eller manuellt, lagras sökvägen till projektet i konfigurationsfilen .aspire/settings.json .

Kommandot utför följande steg för att köra en Aspire AppHost:

• Skapar eller ändrar konfigurationsfilen .aspire/settings.json i den aktuella katalogen och anger appHostPath konfigurationsvärdet till sökvägen till AppHost-projektfilen.
• 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

Options

Följande alternativ är tillgängliga:

• --

  Avgränsar argument till aspire run från argument för AppHost som körs. Alla argument efter denna avgränsare skickas till AppHost-körningen.

• --project

  Sökvägen till Aspire AppHost-projektfilen.

• -w, --watch

  Starta projektresurser i övervakningsläge.

• -?, -h, --help

  Skriver ut hjälp- och användningsdokumentation för tillgängliga kommandon och alternativ.

• -d, --debug

  Aktivera felsökningsloggning till konsolen, vilket skriver ut detaljerad information om vad Aspire CLI gör när ett kommando körs.

• --wait-for-debugger

  Vänta tills ett felsökningsprogram har bifogats innan du kör ett kommando.

Examples

• Sök i den aktuella katalogstrukturen efter AppHost-projekt för att skapa och köra:

  aspire run
  

• Kör ett specifikt AppHost-projekt:

  aspire run --project './projects/apphost/orchestration.AppHost.csproj'
  

• Kör ett specifikt AppHost-projekt med argument:

  aspire run --project './projects/apphost/orchestration.AppHost.csproj' -- -fast