microsoft / microsoft/aspire.dev
[What's New Analysis] Create aspire do pipelines documentation
Open
@IEvangelist is already working on this.
Since Feb 18, 2026.
external feedback
- Dominant language
- MDX
- Stars
- 193
- Forks
- 87
- Avg merge
- 1d 22h
- Merged PRs (30d)
- 73
Description
Summary
Aspire 13.0 introduced aspire do pipelines as the replacement for publishing callbacks. This is only documented in what's-new, with no standalone reference.
What's Missing
Core Concepts
// Old way (deprecated)
.WithPublishingCallback(async (context, ct) => { ... });
// New way
.WithPipelineStepFactory(context => {
return new PipelineStep() {
Name = "CustomDeployStep",
Action = CustomDeployAsync,
RequiredBySteps = [WellKnownPipelineSteps.Publish]
};
});
CLI Commands
aspire do # Run default pipeline
aspire do build # Run build step
aspire do push # Push to container registry
aspire do deploy # Deploy to target
aspire do deploy-api # Run specific named step
WellKnownPipelineSteps
Build/Publish/Deploy- standard steps- Custom step registration and dependencies
Suggested Content
- What is aspire do - Pipeline concept overview
- Built-in steps - build, push, publish, deploy
- Running specific steps -
aspire do <step-name> - Custom pipeline steps - PipelineStep, dependencies, RequiredBySteps
- Migration guide - From WithPublishingCallback to WithPipelineStepFactory
- Examples - Multi-environment deploys, custom build steps
Why It Matters
Publishing callbacks are deprecated. Users upgrading from 9.x need migration guidance, and the pipeline system is central to deployment.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.