aspire exec 命令（预览版）

本文适用于： ✔️ Aspire CLI 9.4.0 及更高版本。

aspire config set features.execCommandEnabled true

Name

aspire exec - 运行 Aspire AppHost 以针对资源执行命令。

Synopsis

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

Description

该 aspire exec 命令在 AppHost 中定义的某个资源的上下文中运行命令。

必须指定--resource选项或--start-resource选项，并且必须为--选项提供参数。

Aspire CLI 使用以下逻辑来确定要处理的 AppHost 项目：

• 选项 --project 。

  此选项指定要处理的项目的路径。

• .aspire/settings.json配置文件。

  如果配置文件路径存在于当前目录中，则使用该文件。 否则，CLI 会逐层向上查找目录以寻找配置文件。 如果找到配置文件，它会读取 appHostPath 设置值并将其作为要处理的项目。

• 搜索当前目录和子目录。

  从当前目录中开始，CLI 从该目录和以下目录收集所有 AppHost 项目。 如果发现单个项目，则会自动选择它。 如果发现多个项目，则会将它们打印到终端，供用户手动选择其中一个项目。

  选择项目后，自动或手动选择项目的路径将存储在配置文件中 .aspire/settings.json 。

选项

可以使用以下选项：

• --

  将 aspire exec 的自变量与资源的自变量区分开。 此分隔符之后的所有参数都传递给资源。

• --project

  AppHost 项目文件的路径 Aspire 。

• -r, --resource

  要对其执行命令的目标资源的名称。

• -s, --start-resource

  要对其启动和执行命令的目标资源的名称。

• -?, -h, --help

  打印可用命令和选项的帮助和用法文档。

• -d, --debug

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

• --wait-for-debugger

  在运行命令之前等待调试器附加。

Examples

• 生成并运行 AppHost 项目，然后将命令 migrate 发送到 database1 资源：

  aspire exec --resource database1 -- migrate