start 命令

使用现有配置文件启动数据 API 生成器运行时。

Syntax

dab start [options]

快速浏览

选项 概要
-c, --config 使用特定的配置文件(默认值 dab-config.json 或环境特定的文件(如果存在)
--LogLevel <level> 显式设置日志级别(名称或数字 0–6)
--no-https-redirect 禁用自动 HTTP→HTTPS 重定向
--verbose 将日志级别设置为信息

-c, --config

配置文件的路径。 默认为 dab-config.json。 如果存在特定于环境的文件 dab-config.<DAB_ENVIRONMENT>.json ,则改用该文件(DAB_ENVIRONMENT 从环境变量中读取)。

行为

  • 如果基本文件和特定于环境的文件都存在,则会选择特定于环境的文件。
  • 配置不会发生突变, start 只消耗。

注释

提供 --config (或 -c) 会替代基于环境变量的选择逻辑。 如果显式传递路径,则 DAB_ENVIRONMENT 忽略该变量,并且仅使用指定的文件。 这意味着绕过特定于环境的分层。 如果需要自动环境解析,请省略 --config 并依赖于 DAB_ENVIRONMENT 匹配的文件命名约定。

Example

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

--LogLevel <level>

显式设置最小日志级别。 接受名称(Trace、、DebugWarningInformationError、、CriticalNone或数值0–6。 不区分大小写。

行为

  • 不能与 --verbose..

  • 导致启动失败的外部 0–6 值无效。

  • 如果两者 --verbose 均未设置, --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。 它不会创建或删除终结点。 终结点由 ASPNETCORE_URLS (或 Kestrel 默认值)确定。

  • 如果仅配置了 HTTP,则标志不会更改,因为没有要重定向到的 HTTPS 终结点。
  • 如果仅配置了 HTTPS,则标志不会更改,因为没有要升级的 HTTP 流量。
  • 如果同时配置了 HTTP 和 HTTPS,则标志将禁止自动重定向,从而允许两个终结点直接处理请求。

Example

dab start --no-https-redirect

--verbose

将最小日志级别设置为 Information

行为

  • 不能与 --LogLevel..
  • 替代主机模式默认值。

注释

等效于使用 --LogLevel Information。 分析程序可防止同时 --verbose 提供, --LogLevel 因此没有冲突路径。

Example

dab start --verbose