共用方式為


start 命令

使用現有的組態檔啟動資料 API 產生器執行階段。

語法

dab start [options]

快速瀏覽

Option 總結
-c, --config 使用特定的組態檔 (預設為 dab-config.json 或環境特定檔案 (如果有的話)
--LogLevel <level> 明確設定記錄層級 (名稱或數字 0-6)
--no-https-redirect 停用自動 HTTP→HTTPS 重新導向
--verbose 將記錄層級設定為 Information

-c, --config

組態檔的路徑。 預設為 dab-config.json。 如果存在環境特定的檔案 dab-config.<DAB_ENVIRONMENT>.json ,則會改用該檔案 (DAB_ENVIRONMENT 從環境變數讀取)。

行為

  • 如果基本檔案和環境特定檔案都存在,則會選擇環境特定檔案。
  • 不會發生配置的突變, start 只會消耗。

備註

提供 --config (或 -c) 會置換以環境變數型選取邏輯。 如果您明確傳遞路徑,則會忽略變數 DAB_ENVIRONMENT ,且只會使用指定的檔案。 這意味著會繞過特定於環境的分層。 如果您想要自動環境解析,請省略 --config 並依賴 DAB_ENVIRONMENT plus 相符的檔案命名慣例。

Example

dab start --config ./settings/dab-config.json

--LogLevel <level>

明確設定最低記錄層級。 接受名稱 (TraceDebugErrorWarningCriticalInformationNone) 或數值 。0–6 不區分大小寫。

行為

  • 不能與 --verbose結合使用。

  • 外部 0–6 值無效會導致啟動失敗。

  • 如果兩者都 --verbose 未設定 nor --LogLevel ,則預設值為:

    • 開發主機模式: Debug
    • 生產主機模式: Error

Example

dab start --LogLevel Warning
dab start --LogLevel 1   # Debug

如需層級的詳細資訊,請參閱 .NET 記錄層級

備註

--LogLevel--verbose 一律置換組態檔中的任何日誌層級設定。 即使您未提供記載旗標,CLI 也會在啟動執行時期時插入基準記錄層次。 因此,使用 dab start時不會套用組態中定義的每個命名空間或精細記錄器過濾器。

--no-https-redirect

停用自動 HTTP→HTTPS 重新導向。

行為

  • 預設值為啟用安全重定向。
  • 提供此旗標會停用重新導向。

備註

此旗標僅控制是否將 HTTP 流量重新導向至 HTTPS。 它不會建立或移除端點。 端點由 (或 Kestrel 預設值) 決定 ASPNETCORE_URLS

  • 如果只設定 HTTP,則旗標不會變更任何內容,因為沒有要重新導向的 HTTPS 端點。
  • 如果只配置了HTTPS,則該標誌不會更改任何內容,因為沒有要升級的HTTP流量。
  • 如果同時設定了 HTTP 和 HTTPS,則旗標會抑制自動重新導向,允許兩個端點直接提供請求。

Example

dab start --no-https-redirect

--verbose

將最低日誌層次設定為 Information

行為

  • 不能與 --LogLevel結合使用。
  • 覆寫主機模式預設值。

備註

相當於使用 --LogLevel Information. 剖析器會防止同時 --verbose 提供 和 --LogLevel ,因此沒有衝突路徑。

Example

dab start --verbose