Add Azure App Service integration documentation (Preview)

[Copilot]

• Create new article for Azure App Services integration
• Add article to TOC (docs/toc.yml)
• Add entry to integrations overview page
• Add AI usage disclosure to frontmatter
• Follow Aspire documentation style guide
• Verify all links and cross-references
• Apply code review suggestions
• Combine Overview and Supported scenarios sections into single introduction paragraph
• Add section on connecting to existing Azure App Service plan

Summary

Added comprehensive documentation for the Azure App Service integration (Preview) following the established patterns for Azure hosting-only integrations.

Changes Made

New Documentation

Created /docs/azure/azure-app-service-integration.md with comprehensive coverage of:

• Overview: Concise introduction paragraph explaining Azure App Service integration capabilities and supported scenarios
• Installation: Instructions for adding the NuGet package via .NET CLI and PackageReference
• Adding App Service Environment: How to provision an Azure App Service environment (App Service Plan) with automatic Azure Container Registry provisioning
• Connecting to Existing Resources: How to connect to an existing Azure App Service plan using AsExisting() method with parameters
• Publishing Resources: How to use PublishAsAzureAppServiceWebsite to deploy compute resources
• Customization: Examples showing how to customize both websites and infrastructure using Azure.Provisioning APIs
• Bicep Generation: Information about the automatically generated Bicep modules for infrastructure provisioning

Table of Contents Updates

• Added "Azure App Service (Preview)" entry to docs/toc.yml in the Azure integrations section
• Positioned alphabetically between Azure App Configuration and Azure AI Foundry
• Includes appropriate display keywords for searchability

Integrations Overview Updates

• Added Azure App Service entry to the Azure integrations table in docs/fundamentals/integrations-overview.md
• Links to the new documentation and the NuGet package
• Marked as hosting-only integration (no client package)

Documentation Standards

This documentation follows the established patterns for Azure hosting integrations (similar to Container Registry, PostgreSQL, and Service Bus), and adheres to:

• Microsoft Writing Style Guide (active voice, second person, present tense)
• Aspire documentation guidelines (AI usage disclosure, preview disclaimers)
• Consistent structure with other Azure integration articles
• Proper cross-references using xref syntax for API documentation
• Validated internal and external links

The article provides developers with a complete reference for using Azure App Service as a deployment target for their Aspire applications during the preview period, including both provisioning new environments and connecting to existing ones.

Closes #4895

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[New article]: Aspire Azure App Services integration</issue_title>
<issue_description>### Proposed topic or title

Aspire Azure App Services integration (Preview)

Location in table of contents.

Integrations / Azure / App Services

Reason for the article

We need to include content for the preview Azure App Services hosting integration. The code is here: https://github.com/dotnet/aspire/tree/main/src/Aspire.Hosting.Azure.AppService

Article abstract

We need to follow the flow of existing Azure integrations that include only a hosting package.

Relevant searches

No response</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes #4974

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

---

Internal previews

📄 File	🔗 Preview link
docs/azure/azure-app-service-integration.md	docs/azure/azure-app-service-integration
docs/fundamentals/integrations-overview.md	docs/fundamentals/integrations-overview
docs/toc.yml	docs/toc

[davidfowl]

cc @ShilpiRach

[Copilot]

Pull Request Overview

This PR adds comprehensive documentation for the new Azure App Service integration (Preview), enabling developers to deploy Aspire applications to Azure App Service. The documentation follows established patterns for Azure hosting-only integrations and includes both provisioning new resources and connecting to existing ones.

Key changes:

• New comprehensive documentation for Azure App Service integration with installation, usage, and customization examples
• Added entry to table of contents for discoverability
• Updated integrations overview to include Azure App Service in the Azure integrations table

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
docs/azure/azure-app-service-integration.md	New comprehensive documentation covering Azure App Service integration installation, usage, and customization
docs/toc.yml	Added Azure App Service (Preview) entry to the Azure integrations section with appropriate display keywords
docs/fundamentals/integrations-overview.md	Added Azure App Service to the Azure integrations table with proper categorization as hosting-only

[IEvangelist]

cc @ShilpiRach

@davidfowl do I need to wait for their review? Or can this continue?

[davidfowl]

You dont need to wait, changes can be async.