aspire deploy 命令 （预览版）

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

Name

aspire deploy - 将包含 Aspire 协调的代码库部署到指定的目标。

Synopsis

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

Description

该aspire deploy命令首先调用aspire publish命令。 之后， Aspire 按声明的顺序调用所有 DeployingCallbackAnnotation 资源批注。

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

• 选项 --project 。

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

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

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

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

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

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

该命令执行以下步骤，以部署使用 Aspire 协调的应用程序：

• 在当前目录中创建或修改 .aspire/settings.json 配置文件，并将配置值设置为 appHostPath AppHost 项目文件的路径。
• 安装或验证 Aspire 的本地托管证书已安装并受信任。
• 生成 AppHost 项目及其资源。
• 启动 AppHost 及其资源。
• 调用所有 PublishingCallbackAnnotation 资源注释。
• 调用所有 DeployingCallbackAnnotation 资源注释。

选项

可以使用以下选项：

• --

  将参数与 aspire publish 中的 AppHost 参数分隔开。 此分隔符之后的所有参数都传递给 apphost。

• --project

  AppHost 项目文件的路径 Aspire 。

• -o, --output-path

  部署工件的输出路径。 默认为当前目录中名为 deploy 的文件夹。

• -?, -h, --help

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

• -d, --debug

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

• --wait-for-debugger

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

Examples

• 搜索要生成、发布和部署的 AppHost 项目的当前目录结构：

  aspire deploy
  

• 发布并部署 Aspire apphost 及其依赖项：

  aspire deploy --project './projects/apphost/orchestration.AppHost.csproj'
  

• 使用参数发布并部署 Aspire AppHost：

  aspire deploy --project './projects/apphost/orchestration.AppHost.csproj' -- -fast