How microsoft/aspire works
Aspire is a multi-language, code-first toolchain for defining distributed applications, running them locally, observing them, and carrying their definitions into deployment. The principal workflow starts with a developer defining services and dependencies in an AppHost; the CLI runs the application, while the dashboard provides observability. The same model can be published through deployment pipelines and provider integrations. The repository also includes a VS Code extension for AppHost development and lifecycle operations. Several subsystem links below reflect README-level capabilities; unsampled implementation details are not inferred.
Main entry points: Resource.cs AppHost SDK · PipelineStepContext.cs Pipeline step context · extension.ts VS Code extension · PipelineCommandBase.cs Aspire CLI
Components 17
Developer entry points
- Aspire CLI
src/Aspire.Cli/Commands/PipelineCommandBase.cs
Application definition
- AppHost SDK
src/Aspire.Hosting/ApplicationModel/Resource.cs - Resource model
src/Aspire.Hosting/ApplicationModel/IResource.cs
Local runtime and observability
- Execution context
src/Aspire.Hosting/DistributedApplicationExecutionContext.cs - Dashboard
src/Aspire.Dashboard/Model/BrowserStorage/SessionBrowserStorage.cs - DCP services
extension/src/dcp/AspireDcpServer.ts
Deployment
- Pipeline context
src/Aspire.Hosting/Pipelines/PipelineContext.cs - Pipeline step context
src/Aspire.Hosting/Pipelines/PipelineStepContext.cs - Deployment reporting
src/Aspire.Hosting/Pipelines/ReportingStep.cs - Helm deployment
src/Aspire.Hosting.Kubernetes/Deployment/HelmDeploymentEngine.cs - AKS deployment
src/Aspire.Hosting.Azure.Kubernetes/AzureKubernetesEnvironmentResource.AksPipeline.cs - Radius deployment
src/Aspire.Hosting.Radius/Publishing/RadiusDeploymentPipelineStep.cs
Editor and integrations
- Azure Storage integration
src/Aspire.Hosting.Azure.Storage/AzureStorageExtensions.cs - VS Code extension
extension/src/extension.ts - AppHost CLI data
extension/src/data/AppHostDataRepository.ts - Debug sessions
extension/src/debugger/AspireDebugSession.ts
Other components
- Developer
Connections 19
- Developer → AppHost SDK: defines services
README.md - AppHost SDK → Resource model: models resources
src/Aspire.Hosting/ApplicationModel/Resource.cs - Developer → Aspire CLI: runs application
README.md - Aspire CLI → Execution context: runs locally
- Aspire CLI → Pipeline context: starts publishing
- Pipeline context → Pipeline step context: provides context
src/Aspire.Hosting/Pipelines/PipelineStepContext.cs - Pipeline step context → Deployment reporting: exposes reporting
src/Aspire.Hosting/Pipelines/PipelineStepContext.cs - Pipeline step context → Helm deployment: deployment context
src/Aspire.Hosting.Kubernetes/Deployment/HelmDeploymentEngine.cs - Pipeline step context → AKS deployment: deployment context
src/Aspire.Hosting.Azure.Kubernetes/AzureKubernetesEnvironmentResource.AksPipeline.cs - Pipeline step context → Radius deployment: deployment context
src/Aspire.Hosting.Radius/Publishing/RadiusDeploymentPipelineStep.cs - AppHost SDK → Dashboard: enables observability
README.md - AppHost SDK → Helm deployment: publishes model
README.md - AppHost SDK → AKS deployment: publishes model
README.md - AppHost SDK → Radius deployment: publishes model
README.md - AppHost SDK → Azure Storage integration: configures resources
src/Aspire.Hosting.Azure.Storage/AzureStorageExtensions.cs - Developer → VS Code extension: uses editor tools
- VS Code extension → AppHost CLI data: reads AppHost data
- VS Code extension → Debug sessions: starts debug sessions
- VS Code extension → DCP services: uses lifecycle services