kommandot "aspire deploy" (förhandsversion)

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

Name

aspire deploy – Distribuera en kodbas som samordnats med Aspire till angivna mål.

Important

Det här kommandot är i förhandsversion och kan komma att ändras.

Synopsis

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

Description

Kommandot aspire deploy anropar först kommandot aspire publish. Aspire Därefter anropar alla DeployingCallbackAnnotation resursanteckningar i den ordning de deklareras.

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 distribuera en app som är orkestrerad med Aspire:

• 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.
• Anropar alla PublishingCallbackAnnotation resursanteckningar.
• Anropar alla DeployingCallbackAnnotation resursanteckningar.

Options

Följande alternativ är tillgängliga:

• --

  Avgränsar argument till aspire publish från argument för AppHost. Alla argument efter den här avgränsare skickas till apphost.

• --project

  Sökvägen till Aspire AppHost-projektfilen.

• -e, --environment

  Namnet på distributionsmiljön. Standardinställningen är production. Varje miljö har en egen isolerad distributionstillståndsfil.

• --clear-cache

  Rensar det cachelagrade distributionstillståndet för den angivna miljön innan du distribuerar. När den används frågar distributionen efter alla värden men sparar dem inte i cacheminnet.

• -o, --output-path

  Sökväg för leveransartefakter. Standardvärdet är en mapp med namnet deploy i den nuvarande katalogen.

• -?, -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, publicera och distribuera:

  aspire deploy
  

• Publicera och distribuera en Aspire apphost och dess beroenden:

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

• Publicera och distribuera en Aspire AppHost med argument:

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

• Distribuera till en specifik miljö:

  aspire deploy --environment staging
  

• Rensa cachelagrat distributionstillstånd och distribuera:

  aspire deploy --clear-cache
  

• Rensa cachelagrat distributionstillstånd för en specifik miljö:

  aspire deploy --environment staging --clear-cache
  

Se även

• Cachning av distributionsstatus