microsoft / microsoft/aspire.dev

[What's New Analysis] Create aspire do pipelines documentation

Open
#335 0 comments 1 reaction 2 assignees View on GitHub

@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

  1. What is aspire do - Pipeline concept overview
  2. Built-in steps - build, push, publish, deploy
  3. Running specific steps - aspire do <step-name>
  4. Custom pipeline steps - PipelineStep, dependencies, RequiredBySteps
  5. Migration guide - From WithPublishingCallback to WithPipelineStepFactory
  6. 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.