aspire run 命令

本文適用於： ✔️ Aspire CLI 9.4.0 和更新版本。

Name

aspire run - 在開發模式中執行 Aspire AppHost。

Synopsis

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

Description

此 aspire run 命令會在開發模式中執行 AppHost 專案，以設定 Aspire 環境、建置和啟動 AppHost 定義的資源、啟動 Web 儀表板，以及列印端點清單。

Aspire CLI 會使用下列邏輯來判斷要處理的 AppHost 專案：

• 選項 --project 。

  這個選項會指定要處理之項目的路徑。

• 設定檔 .aspire/settings.json。

  如果組態檔路徑存在於目前目錄中，則會使用它。 如果沒有找到，CLI 會往上尋找目錄結構中的配置檔案。 如果找到組態檔，它會讀取 appHostPath 設定值做為要處理的專案。

• 搜尋目前的目錄和子目錄。

  從目前目錄開始，CLI 會從該目錄和下方收集所有 AppHost 專案。 如果探索到單一專案，則會自動選取該專案。 如果發現多個專案，則會列印到終端機，讓使用者手動選取其中一個專案。

  一旦專案被自動或手動選擇，專案的路徑就會儲存在 .aspire/settings.json 組態檔中。

此指令會執行下列步驟來執行 Aspire AppHost：

• 建立或修改 .aspire/settings.json 目前目錄中的組態檔，並將組態值設定 appHostPath 為AppHost專案檔的路徑。
• 安裝或驗證 Aspire 的本機托管憑證是否已安裝並被信任。
• 建置AppHost專案及其資源。
• 啟動AppHost及其資源。
• 啟動儀表板。

以下是 aspire run 命令顯示的輸出範例：

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

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

選項

有下列選項可供使用：

• --

  將引數 aspire run 定為正在執行之 AppHost 的引數。 此分隔符號之後的所有引數都會傳遞至 AppHost 執行。

• --project

  AppHost 專案檔案的路徑 Aspire。

• -w, --watch

  以監看模式啟動項目資源。

• -?, -h, --help

  列印可用命令和選項的說明和使用說明檔。

• -d, --debug

  啟用對主控台的偵錯記錄，主控台會列印有關執行命令時 CLI 正在執行的動作 Aspire 的詳細資訊。

• --wait-for-debugger

  等待偵錯工具附加後再執行命令。

Examples

• 搜尋 AppHost 專案的目前目錄結構，以建置並執行：

  aspire run
  

• 執行特定的 AppHost 專案：

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

• 使用自變數執行特定的 AppHost 專案：

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