aspire 执行命令

本文适用于： ✔️ 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

  启用控制台的调试日志记录，以便在 Aspire 运行命令时输出 CLI 所执行操作的详细信息。

• --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