aspire exec-kommando (förhandsversion)

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

Note

Det här kommandot är inaktiverat som standard. Om du vill använda den aktiverar du funktionsväxlingsknappen genom att köra:

aspire config set features.execCommandEnabled true

Mer information finns i aspire config-kommandot.

Name

aspire exec – Kör en Aspire AppHost för att köra ett kommando mot resursen.

Important

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

Synopsis

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

Description

Kommandot aspire exec kör ett kommando i kontexten för en av de resurser som definierats i AppHost.

Du måste ange antingen --resource alternativet eller --start-resource och du måste ange parametrar med alternativet -- .

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 .

Options

Följande alternativ är tillgängliga:

  • --

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

  • --project

    Sökvägen till Aspire AppHost-projektfilen.

  • -r, --resource

    Namnet på målresursen som kommandot ska köras mot.

  • -s, --start-resource

    Namnet på målresursen som kommandot ska startas och köras mot.

  • -?, -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

  • Skapar och kör AppHost-projektet och skickar sedan kommandot migrate till resursen database1 :

    aspire exec --resource database1 -- migrate