Deployment¶
Configure the application in its AppHost and infrastructure inputs, then deploy through Forge's Azure DevOps pipelines. Use Aspire Publish to generate pipeline YAML and infrastructure configuration.
| Task | Guide |
|---|---|
| Generate or refresh deployment configuration | Aspire Publish |
| Release with validation gates and rollback | Blue-Green Deployments |
| Preview a pull request in a live slot | PR Slot Deployments |
| Configure a frontend hostname | Custom Subdomains |
| Publish application documentation | Documentation Site |
Terraform workflow¶
For application delivery, set the inputs supplied by the project templates or generated configuration. Pipelines pass these values to Forge's Terraform modules; the normal consumer workflow does not require running Terraform locally. Open Terraform Cloud through the link on your identity-provider landing page to inspect the managed infrastructure workflow.
Use the Terraform module reference for inputs, outputs, and usage. For pipeline behavior, use Pipelines. Search Troubleshooting for the exact error when a deployment fails.
Generated documentation ownership¶
The documentation build generates everything under docs/reference/terraform/. Edit the module's README.md under src/terraform/, not the generated page:
- A top-level module README becomes
<module-name>/index.md. - A README in
modules/<name>/becomes<module-name>/<submodule-name>.md. - A README in
examples/<name>/becomes<module-name>/examples/<example-name>.md.
The generator qualifies nested page titles with the module name so identically named submodules remain distinguishable. The module-reference generator owns that publication mapping.
Why these deployment services¶
Forge uses Azure to host APIs and web applications and connect them to SAIF's on-premises resources. API Management and support for .NET runtimes motivated that platform choice. Azure DevOps supplies the deployment automation alongside SAIF's repository and work-planning workflows; these task guides document Forge's use of it rather than the generic product catalog.
For product-level guidance, use Terraform documentation, Terraform Cloud, or the Azure portal.