快速开始

更新: 2026-06-29 16:39:57   字数: 0 字   时长: 0 分钟

1. 创建一个新应用

要创建您的第一个 Aspire 应用，请使用 Aspire CLI 从模板中生成新的解决方案。这些模板包含多个项目，例如 API 服务、Web 前端和 Aspire AppHost。

aspire new aspire-starter -n AspireApp -o AspireApp

该模板提供了多个项目，包括一个 API 服务、Web 前端和 AppHost。

2. 查看模板代码

AppHost 是您 Aspire 应用的核心。它定义了哪些服务运行、它们如何连接以及启动的顺序。让我们来看看生成的代码：

var builder = DistributedApplication.CreateBuilder(args);

var apiService = builder
    .AddProject<Projects.AspireApp_ApiService>("apiservice")
    .WithHttpHealthCheck("/health");

builder
    .AddProject<Projects.AspireApp_Web>("webfrontend")
    .WithExternalHttpEndpoints()
    .WithHttpHealthCheck("/health")
    .WithReference(apiService)
    .WaitFor(apiService);

builder.Build().Run();

• CreateBuilder 用于创建分布式应用构建器
• AddProject 用于注册您的 API 服务和 Web 前端
• WithReference 可连接多个服务，它会将 API 的 URL 注入为环境变量，并设置服务发现功能，使您能够使用服务名称而非硬编码的 URL
• WaitFor 确保 API 正常运行后再启动前端，避免因竞态条件导致的连接错误
• WithHttpHealthCheck 用于监控服务的健康状态

3. 本地运行

cd ./AspireApp

aspire run

4. 容器化部署

在您之前快速入门中创建的 Aspire 解决方案根目录下，通过在终端中运行以下命令添加相应的托管部署包：

Docker Compose

aspire add docker

Azure

aspire add azure-appcontainers

在 AppHost 中，通过调用相应的环境 API 方法来配置目标的部署环境。

Docker Compose

var builder = DistributedApplication.CreateBuilder(args);

// Add the following line to configure the Docker Compose environment
builder.AddDockerComposeEnvironment("env");

var apiService = builder
    .AddProject<Projects.AspireApp_ApiService>("apiservice")
    .WithHttpHealthCheck("/health");

builder
    .AddProject<Projects.AspireApp_Web>("webfrontend")
    .WithExternalHttpEndpoints()
    .WithHttpHealthCheck("/health")
    .WithReference(apiService)
    .WaitFor(apiService);

builder.Build().Run();

Azure

var builder = DistributedApplication.CreateBuilder(args);

// Add the following line to configure the Azure App Container environment
builder.AddAzureContainerAppEnvironment("env");

var apiService = builder
    .AddProject<Projects.AspireApp_ApiService>("apiservice")
    .WithHttpHealthCheck("/health");

builder
    .AddProject<Projects.AspireApp_Web>("webfrontend")
    .WithExternalHttpEndpoints()
    .WithHttpHealthCheck("/health")
    .WithReference(apiService)
    .WaitFor(apiService);

builder.Build().Run();

现在您已添加部署包并更新了 AppHost，就可以部署您的 Aspire 应用了。

aspire deploy