Aspire

免费且开源

Aspire 是一个开发者优先、始终免费的开源平台。加入充满活力的社区，共同塑造现代开发的未来。

开发者为何选择 Aspire

代码驱动

代码定义栈——类型安全、可读、易调试。先本地运行，再无缝切换到云。

模块化与可扩展

编排前端、API、容器与数据库，无需重写。按需扩展，随处部署。

开箱即用的可观测性

内置 OpenTelemetry：日志、追踪、健康检查自动化——更快洞察与调试。

灵活部署

部署到 Kubernetes、云或本地机房——一致、可重复，无需重构。

用代码定义你的技术栈

Aspire 模块化、可组合、可扩展。集中声明依赖、部署参数与开发开关。了解 AppHost。

构建你的 AppHost

切换不同功能，查看 Aspire 如何定义你的技术栈各部分。

Front end 数据库 API 服务 容器 部署选项

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// This would be a rather boring AppHost ☹️...
// Toggle the options above to see what an AppHost might look like.
// For example, select "Front end" to add a frontend service.

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT");

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT");

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata");

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT");

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata");

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT");

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj");

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT")
                      .WithReference(api);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj");

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT")
                      .WithReference(api);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata");

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
                 .WithReference(postgres);

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT")
                      .WithReference(api);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata");

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
                 .WithReference(postgres);

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT")
                      .WithReference(api);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata");

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata");

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj");

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj");

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata");

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
                 .WithReference(postgres);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata");

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
                 .WithReference(postgres);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080);

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT")
                      .WithNpmPackageInstallation()
                      .PublishAsDockerFile();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT")
                      .WithNpmPackageInstallation()
                      .PublishAsDockerFile();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080)
                             .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata")
                      .WithDataVolume()
                      .PublishAsAzurePostgresFlexibleServer();

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT")
                      .WithNpmPackageInstallation()
                      .PublishAsDockerFile();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata")
                      .WithDataVolume()
                      .PublishAsAzurePostgresFlexibleServer();

// Add frontend service
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT")
                      .WithNpmPackageInstallation()
                      .PublishAsDockerFile();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080)
                             .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj")
                 .PublishAsAzureContainerApp();

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT")
                      .WithReference(api)
                      .WithNpmPackageInstallation()
                      .PublishAsDockerFile();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj")
                 .PublishAsAzureContainerApp();

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT")
                      .WithReference(api)
                      .WithNpmPackageInstallation()
                      .PublishAsDockerFile();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080)
                             .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata")
                      .WithDataVolume()
                      .PublishAsAzurePostgresFlexibleServer();

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
                 .WithReference(postgres)
                 .WaitFor(postgres)
                 .PublishAsAzureContainerApp();

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT")
                      .WithReference(api)
                      .WithNpmPackageInstallation()
                      .PublishAsDockerFile();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata")
                      .WithDataVolume()
                      .PublishAsAzurePostgresFlexibleServer();

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
                 .WithReference(postgres)
                 .WaitFor(postgres)
                 .PublishAsAzureContainerApp();

// Add frontend service and reference the API
var frontend = builder.AddViteApp("frontend", "../frontend")
                      .WithHttpEndpoint(env: "PORT")
                      .WithReference(api)
                      .WithNpmPackageInstallation()
                      .PublishAsDockerFile();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080)
                             .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata")
                      .WithDataVolume()
                      .PublishAsAzurePostgresFlexibleServer();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata")
                      .WithDataVolume()
                      .PublishAsAzurePostgresFlexibleServer();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080)
                             .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj")
                 .PublishAsAzureContainerApp();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add API service
var api = builder.AddProject("api", "../api/ApiService.csproj")
                 .PublishAsAzureContainerApp();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080)
                             .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata")
                      .WithDataVolume()
                      .PublishAsAzurePostgresFlexibleServer();

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
                 .WithReference(postgres)
                 .WaitFor(postgres)
                 .PublishAsAzureContainerApp();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add database
var postgres = builder.AddPostgres("db")
                      .AddDatabase("appdata")
                      .WithDataVolume()
                      .PublishAsAzurePostgresFlexibleServer();

// Add API service and reference the database
var api = builder.AddProject("api", "../api/ApiService.csproj")
                 .WithReference(postgres)
                 .WaitFor(postgres)
                 .PublishAsAzureContainerApp();

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080)
                             .PublishAsKubernetes();

builder.Build().Run();

AppHost.cs

var builder = DistributedApplication.CreateBuilder(args);

// Add custom container
var customContainer = builder.AddContainer("mycustomcontainer", "myregistry/myapp", "latest")
                             .WithHttpEndpoint(targetPort: 8080)
                             .PublishAsKubernetes();

builder.Build().Run();

多语言生态

兼容现有技术栈 —— 编排 C#、Java、Python、JavaScript、TypeScript、Go、PHP、Ruby 等应用。团队继续使用熟悉语言。资源建模。

JavaScript TypeScript Java Go C# Python And more...

广泛语言与框架支持：继续使用偏好技术同时获得编排优势。

本地优先，生产就绪

本地优先设计：本地开发与测试接近生产，减少“在我机器上能跑”。部署与拓扑。

本地 测试 生产

使用容器化服务进行本地开发

启动和销毁完整的预备测试环境

生产环境云服务 — 无需修改代码

aspire run

aspire deploy -e test

aspire deploy

Redis

AWS ElastiCache

Redis

Shortlived container

Redis

Local container

PostgreSQL

Azure Database for PostgreSQL

PostgreSQL

Staged DB

PostgreSQL

Local container

Frontend

Azure Static Web Apps

Frontend

Dev tunnel

Frontend

Local process

API

Azure Container Apps

API

Staging environment

API

Local process

单一模型，多种环境

CLI 本地运行全栈或在 CI/CD 中生成制品。第一个应用。

本地开发

aspire run

• 本地容器 runtime
• Dashboard 在 localhost
• Dev secrets / volumes / config

生产部署

aspire deploy

• 同一模型随处部署
• 托管云或自有基础设施
• CI/CD 集成

面向开发者的 OpenTelemetry Dashboard

实时查看日志、指标与追踪 —— 内置 OpenTelemetry Dashboard 开箱即用。

Pause video

探索集成

多云与无限集成 —— 连接 Azure、AWS 或自建环境。丰富生态适配任意技术栈。集成图库。

用户推荐

不只我们这么说 —— 从个人到企业：更快开发、更自信发布。贡献者社区。

SK

Aspire was easy to integrate with our existing container orchestration.

Sean Killeen (VP Innovation, SCT Software)

NU

I've never wanted to commit to a Microsoft technology this much.

Nk54 (Reddit User)

DC

OpenTelemetry out-of-the-box in the Aspire dashboard is a game changer for observability!

Dan Clarke (Developer & Podcaster, Everstack)

NC

The best thing that happened in .NET since it went open source in 2014!

Nick Chapsas (Founder & Author, Dometrain)

CT

Hit F5 to begin — skip the setup boss fight, ship code faster.

Craig Taylor (Principal Architect, Xbox Live)

MJ

I was surprised by how quickly Aspire got me from idea to running services.

Milan Jovanović (Educator & Content Creator, MJ Tech)

SP

Aspire lets developers be developers again.

Steven Price (Software Engineering Manager, Iceland Foods)

RH

I had someone start on a Monday morning and they were contributing code by lunch.

Russ Harding (VP Engineering, EQengineered)

准备起飞？

安装 Aspire CLI，然后阅读文档以建模、运行与部署。

获取 Aspire 安装 Aspire，简化你的工作流。

查看文档 了解如何在 Aspire 中建模、运行与部署应用。