Add docs for Azure Front Door integration#730
Conversation
Adds a new integration page for Azure Front Door, adds it to the sidebar, and adds a section to the What's new in Aspire 13.3 doc. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
Adds new documentation for the Azure Front Door hosting integration and updates related navigation/release notes, alongside additional CLI reference and Azure networking documentation updates.
Changes:
- Added a new Azure Front Door integration page and sidebar entry, plus a new “What’s new in Aspire 13.3” page highlighting Front Door and NSPs.
- Added CLI reference docs for
aspire docs apiand documented a new--include-hiddenoption across relevant commands. - Expanded Azure Virtual Network docs with Network Security Perimeter (NSP) guidance.
Reviewed changes
Copilot reviewed 3 out of 4 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| src/frontend/src/content/docs/whats-new/aspire-13-3.mdx | New 13.3 release notes page (Front Door + NSP highlights). |
| src/frontend/src/content/docs/reference/cli/includes/option-include-hidden.md | New reusable include snippet documenting --include-hidden. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-logs.mdx | Document --include-hidden for logs and add example. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-export.mdx | Document --include-hidden for export and add example. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-docs.mdx | Add aspire docs api to the aspire docs command table and links. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-docs-api.mdx | New command-group reference page for aspire docs api. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-docs-api-search.mdx | New CLI reference page for aspire docs api search. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-docs-api-list.mdx | New CLI reference page for aspire docs api list. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-docs-api-get.mdx | New CLI reference page for aspire docs api get. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-describe.mdx | Document --include-hidden for describe and add example. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-virtual-network.mdx | Add NSP resource mention + full NSP section and links. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-front-door.mdx | New Azure Front Door integration documentation page. |
| src/frontend/src/assets/icons/azure-front-door-icon.png | Add Azure Front Door icon asset for docs pages. |
| src/frontend/config/sidebar/reference.topics.ts | Add sidebar group for aspire docs api commands. |
| src/frontend/config/sidebar/integrations.topics.ts | Add Azure Front Door entry to integrations sidebar. |
| src/frontend/config/sidebar/docs.topics.ts | Add “Aspire 13.3” under What’s new sidebar. |
Comments suppressed due to low confidence (2)
src/frontend/src/content/docs/whats-new/aspire-13-3.mdx:40
- The upgrade steps appear to be using incorrect CLI syntax. Elsewhere in the docs, updating the CLI is
aspire update --self, and updating packages/projects isaspire update(there’s no documentedaspire update project). Please align these commands with theaspire updatereference and Upgrade Aspire guidance.
The easiest way to upgrade to Aspire 13.3 is using the `aspire update` command:
<Steps>
1. Update the Aspire CLI:
```bash
aspire update
-
Update your projects:
aspire update project
**src/frontend/src/content/docs/whats-new/aspire-13-3.mdx:84**
* This sample also references `builder` without defining it, which makes the snippet non-runnable as written. Please add the builder creation line (or include enough context) so the example is complete.
var nsp = builder.AddNetworkSecurityPerimeter("my-nsp")
.WithAccessRule(new AzureNspAccessRule
{💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ```csharp title="C# — AppHost.cs" | ||
| var api = builder.AddProject<Projects.Api>("api") | ||
| .WithExternalHttpEndpoints(); | ||
|
|
||
| var web = builder.AddProject<Projects.Web>("web") | ||
| .WithExternalHttpEndpoints(); | ||
|
|
There was a problem hiding this comment.
This code sample uses builder without showing where it’s created (for example, DistributedApplication.CreateBuilder(args)). Since this is a standalone snippet in What's New, consider making it self-contained so readers can copy/paste it.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Adds documentation for the new Azure Front Door hosting integration added in microsoft/aspire#16137.
Changes
src/frontend/src/content/docs/integrations/cloud/azure/azure-front-door.mdxcovering hosting integration setup, single/multiple origins, health probes, generated Bicep, and customizing the provisioning infrastructure.src/frontend/config/sidebar/integrations.topics.ts(alphabetical, between Azure Event Hubs and Azure Functions).Azure Front Door integrationinsrc/frontend/src/content/docs/whats-new/aspire-13-3.mdx, placed above the NSP section.src/frontend/src/assets/icons/azure-front-door-icon.png.Related: microsoft/aspire#16137