aspire deploy 指令（預覽）

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

Name

aspire deploy - 將由 Aspire 協調的代碼基底部署到指定的目標。

Important

此命令處於預覽狀態，而且可能會變更。

Synopsis

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

Description

命令 aspire deploy 會先叫用 aspire publish 命令。 之後， Aspire 會依宣告的順序叫用所有 DeployingCallbackAnnotation 資源批注。

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

• 選項 --project 。

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

• 設定檔 .aspire/settings.json。

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

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

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

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

此命令會執行下列步驟，以部署與 Aspire協調的應用程式：

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

選項

有下列選項可供使用：

• --

  區分 aspire publish 的參數與 AppHost 的參數。 這個分隔符之後的所有自變數都會傳遞至 apphost。

• --project

  AppHost 專案檔案的路徑 Aspire。

• -e, --environment

  部署環境名稱。 預設為 production。 每個環境都會維護自己的隔離部署狀態檔案。

• --clear-cache

  在部署之前，清除指定環境的快取部署狀態。 使用時，部署會提示輸入所有值，但不會將它們儲存到快取中。

• -o, --output-path

  部署工件的輸出路徑。 預設為目前目錄中名為 deploy 的資料夾。

• -?, -h, --help

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

• -d, --debug

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

• --wait-for-debugger

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

Examples

• 搜尋 AppHost 專案的目前目錄結構，以建置、發佈及部署：

  aspire deploy
  

• 發佈及部署 Aspire 應用主機及其相依項：

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

• 發佈及部署具有自變數的 Aspire AppHost：

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

• 部署至特定環境：

  aspire deploy --environment staging
  

• 清除快取的部署狀態並部署：

  aspire deploy --clear-cache
  

• 清除特定環境的快取部署狀態：

  aspire deploy --environment staging --clear-cache
  

另請參閱

• 部署狀態快取