aspire publish 命令（预览版）

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

Name

aspire publish - 为 Aspire AppHost 项目生成部署项目。

Synopsis

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

Description

该 aspire publish 命令通过将资源序列化到磁盘来进行发布。 运行此命令时， Aspire 按声明资源的顺序调用已注册 PublishingCallbackAnnotation 的批注。 这些批注序列化资源，以便部署工具可以使用它。

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

• 选项 --project 。

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

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

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

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

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

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

此命令执行以下步骤来运行 Aspire AppHost：

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

选项

可以使用以下选项：

• --

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

• --project

  AppHost 项目文件的路径 Aspire 。

• -o, --output-path

  生成的项目的输出路径。 默认为当前目录。

• -?, -h, --help

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

• -d, --debug

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

• --wait-for-debugger

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

Examples

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

  aspire publish
  

• 发布特定的 AppHost 项目：

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

• 使用参数发布特定的 AppHost 项目：

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