aspire-deploy-pipeline

name	aspire-deploy-pipeline
description	Reference for adding and ordering Aspire deploy pipeline steps, tagging steps, parameterizing deployment with AddParameter, configuring per-environment values with WithEnvironment, and using PipelineStepContext services. Use when asked to add a pipeline step, order deploy steps, set up infrastructure provisioning, configure deployment, or wire up aspire deploy.

Pipeline APIs live under Aspire.Hosting.Pipelines. All files that reference them need #pragma warning disable ASPIREPIPELINES001.

References

• Adding steps — WithPipelineStepFactory, PipelineStepAnnotation, direct PipelineStep construction
• Well-known steps — the 14 WellKnownPipelineSteps constants, deploy order, Docker Compose dynamic step names, common placement patterns
• Ordering steps — WithPipelineConfiguration, DependsOn, removing built-in steps, tag-based selection
• Tagging steps — WellKnownPipelineTags, custom tags, context.GetSteps(tag)
• Parameters and config — AddParameter, GetValueAsync, publish vs run mode, per-environment values
• Pipeline services — IPipelineOutputService, IDeploymentStateManager, IHostEnvironment, context.Summary
• Multi-step factory and keyed DI — returning multiple steps from one factory, resource-scoped DI
• Gotchas — validation rules, concurrency traps, pragma requirements, env file patching