Skip to content

Add docs for Azure Front Door integration#730

Merged
IEvangelist merged 2 commits intorelease/13.3from
eerhardt/AzureFrontDoorDocs
Apr 21, 2026
Merged

Add docs for Azure Front Door integration#730
IEvangelist merged 2 commits intorelease/13.3from
eerhardt/AzureFrontDoorDocs

Conversation

@eerhardt
Copy link
Copy Markdown
Member

Adds documentation for the new Azure Front Door hosting integration added in microsoft/aspire#16137.

Changes

  • New integration page: src/frontend/src/content/docs/integrations/cloud/azure/azure-front-door.mdx covering hosting integration setup, single/multiple origins, health probes, generated Bicep, and customizing the provisioning infrastructure.
  • Sidebar entry added in src/frontend/config/sidebar/integrations.topics.ts (alphabetical, between Azure Event Hubs and Azure Functions).
  • New section Azure Front Door integration in src/frontend/src/content/docs/whats-new/aspire-13-3.mdx, placed above the NSP section.
  • Added the official Azure Front Door icon at src/frontend/src/assets/icons/azure-front-door-icon.png.

Related: microsoft/aspire#16137

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>
Copilot AI review requested due to automatic review settings April 20, 2026 21:17
@eerhardt eerhardt changed the base branch from main to release/13.3 April 20, 2026 21:19
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 api and documented a new --include-hidden option 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 is aspire update (there’s no documented aspire update project). Please align these commands with the aspire update reference 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
  1. 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.

Comment thread src/frontend/src/content/docs/whats-new/aspire-13-3.mdx Outdated
Comment on lines +57 to +63
```csharp title="C# — AppHost.cs"
var api = builder.AddProject<Projects.Api>("api")
.WithExternalHttpEndpoints();

var web = builder.AddProject<Projects.Web>("web")
.WithExternalHttpEndpoints();

Copy link

Copilot AI Apr 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Copilot uses AI. Check for mistakes.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@IEvangelist IEvangelist merged commit a7cbb09 into release/13.3 Apr 21, 2026
1 check passed
@IEvangelist IEvangelist deleted the eerhardt/AzureFrontDoorDocs branch April 21, 2026 20:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants