[docs] Document Azure Front Door origin naming change - #1646
[docs] Document Azure Front Door origin naming change#1646aspire-repo-bot[bot] wants to merge 2 commits into
Conversation
Azure Front Door origins now derive their name from the backend hostname in addition to the resource group ID, so switching backends creates a new origin instead of reusing the previous origin's Azure identity. This is a breaking deployment change. - Update the Azure Front Door integration doc with the new generated origin name, a breaking-change caution, and a ConfigureInfrastructure override to preserve pre-13.6 origin names. - Add a breaking-change entry to What's new in Aspire 13.6, plus a mention in the Integration updates section. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
🟢 Approval recommended
The documentation updates are consistent with the described breaking change and the samples/guidance align with the stated new naming behavior.
Pull request overview
This PR updates the Aspire 13.6 documentation to reflect a breaking change in the Azure Front Door hosting integration: generated origin names now incorporate the backend hostname (in addition to the resource group ID), affecting upgrade/deployment behavior.
Changes:
- Update the Azure Front Door integration doc’s generated Bicep example to use
uniqueString(resourceGroup().id, <backendHost>)for origin names. - Add/expand upgrade guidance warning that incremental ARM deployments can leave old and new origins coexisting after upgrading to 13.6.
- Add a breaking-change entry to the Aspire 13.6 “What’s new” page, including a
ConfigureInfrastructurefallback snippet to preserve pre-13.6 origin naming.
File summaries
| File | Description |
|---|---|
| src/frontend/src/content/docs/whats-new/aspire-13-6.mdx | Adds a new breaking-change entry and highlights the Front Door origin naming behavior change in 13.6. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-front-door.mdx | Updates the generated Bicep example and adds an upgrade caution specific to the 13.6 origin naming change. |
Review details
- Files reviewed: 2/2 changed files
- Comments generated: 0
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Documents changes from microsoft/aspire#20035
@eerhardtTargeting
release/13.6based on the source PR milestone13.6.Why
microsoft/aspire#20035 changes how the Aspire Azure Front Door hosting
integration derives generated origin names: origin names now combine the
resource-group ID with the origin's backend hostname, instead of hashing the
resource-group ID alone. This is called out in the source PR as a breaking
deployment change (the PR carries the
breaking-changelabel) — upgradingchanges origin resource names even when the backend hostname hasn't changed,
and incremental ARM deployments can leave old and new origins coexisting in
the same origin group.
What changed
src/frontend/src/content/docs/integrations/cloud/azure/azure-front-door.mdxuniqueString(resourceGroup().id, my_api_host)origin name.<Aside type="caution">describing the 13.6 breaking change,alongside the existing 13.4 upgrade caution.
"Customize provisioning infrastructure" with the
ConfigureInfrastructureoverride (taken from the source PR body) that restores the pre-13.6
default origin names.
src/frontend/src/content/docs/whats-new/aspire-13-6.mdxchanges" to include the Front Door change.
section, linking to the breaking-changes section.
breaking-change entry (with the
ConfigureInfrastructureoverrideexample and a
LearnMorelink back to the source PR and the Front Doorintegration doc).
Both pages were updated in place; no new pages were created.