共用方式為


aspire add 命令

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

Name

aspire add - 將整合新增至 Aspire 專案。

Synopsis

aspire add [<integration>] [options]

Description

命令 aspire add 會搜尋整合套件,並將它新增至 Aspire AppHost。

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

  • 選項 --project

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

  • 設定檔 .aspire/settings.json

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

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

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

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

Arguments

下列參數可供使用:

  • integration

    要新增的整合名稱(例如:redis、postgres)。

    如果提供部分名稱或無效的名稱,CLI 會搜尋 NuGet 以取得近似相符專案,並在終端機中列印這些相符專案,以供用戶選取。 如果找不到任何結果,則會列出所有套件。

選項

有下列選項可供使用:

  • --project

    AppHost 專案檔案的路徑 Aspire。

  • -v, --version

    要添加的整合版本。

  • -s, --source

    要用於整合的 NuGet 來源。

  • -?, -h, --help

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

  • -d, --debug

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

  • --wait-for-debugger

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

Examples

  • 尋找 AppHost 專案,並列出 NuGet 中的所有 Aspire 整合套件:

    aspire add
    
  • 尋找 AppHost 專案,並新增 kafka (Aspire.Hosting.Kafka) 整合套件:

    aspire add kafka --version 9.3.2