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

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

• --wait-for-debugger

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

Examples

• 查找 AppHost 项目并列出 NuGet 中的所有 Aspire 集成包：

  aspire add
  

• 查找 AppHost 项目并添加 kafka (Aspire.Hosting.Kafka) 集成包。

  aspire add kafka --version 9.3.2