Refresh Azure deployment guidance

[davidfowl]

Summary

• restructure the Azure deployment docs around a shared Azure overview plus target-specific Azure Container Apps and Azure App Service guides
• split shared Azure customization from target-specific deployment customization and clarify local vs CI/CD Azure authentication and settings flows
• align the Azure docs with current implementation details for credential selection, local provisioning, ACR login and image pull behavior, and AZURE_TOKEN_CREDENTIALS=ManagedIdentityCredential
• address the latest review feedback on CI/CD --environment guidance, App Service wording, and shared Azure customization copy

Validation

• pnpm --dir ./src/frontend run lint
• pnpm --dir ./src/frontend run test:unit:docs

[Copilot]

Pull request overview

Reshapes the Azure deployment documentation to center on a shared “Deploy to Azure” overview with separate, target-specific guides for Azure Container Apps and Azure App Service, while consolidating shared Azure customization patterns into a single page and updating navigation/redirects accordingly.

Changes:

• Introduces new Azure deployment entrypoint docs (/deployment/azure/) plus new target guides for Container Apps and App Service.
• Reworks Azure customization docs to focus on shared patterns (existing resources, RBAC, naming/outputs, resolvers) and updates related references across the site.
• Updates the deployment sidebar and redirects, and refreshes older “what’s new” links to the new Azure docs structure.

Show a summary per file

File	Description
src/frontend/src/content/docs/whats-new/aspire-9-5.mdx	Updates link to the new Azure Container Apps deployment docs.
src/frontend/src/content/docs/whats-new/aspire-9-1.mdx	Updates link to the new Azure Container Apps deployment docs.
src/frontend/src/content/docs/integrations/cloud/azure/overview.mdx	Updates ACA guidance to emphasize environment targeting + customization via PublishAsAzureContainerApp.
src/frontend/src/content/docs/integrations/cloud/azure/customize-resources.mdx	Expands into a shared Azure customization hub (existing resources, RBAC, outputs, naming, resolvers).
src/frontend/src/content/docs/integrations/cloud/azure/configure-container-apps.mdx	Clarifies ACA env targeting vs PublishAsAzureContainerApp and adds mount/identity notes.
src/frontend/src/content/docs/integrations/cloud/azure/azure-app-service/azure-app-service-host.mdx	Reframes App Service behavior around environment targeting and optional PublishAsAzureAppServiceWebsite customization.
src/frontend/src/content/docs/integrations/cloud/azure/azure-app-service/azure-app-service-get-started.mdx	Updates quickstart narrative to match automatic targeting model and optional customization.
src/frontend/src/content/docs/integrations/cloud/azure/azure-app-service/azure-app-service-client.mdx	Adjusts wording to reflect environment-based deployment behavior.
src/frontend/src/content/docs/deployment/overview.mdx	Updates Azure link to point at the new /deployment/azure/ overview.
src/frontend/src/content/docs/deployment/index.mdx	Updates the deployment landing page card from “Azure Container Apps” to “Azure”.
src/frontend/src/content/docs/deployment/custom-deployments.mdx	Adds language tabs and clarifies TypeScript SDK limitation for custom resource extensibility.
src/frontend/src/content/docs/deployment/ci-cd.mdx	Updates Azure CI/CD link to the new /deployment/azure/ overview.
src/frontend/src/content/docs/deployment/azure/manifest-format.mdx	Collapses to a short “legacy manifest” page focused on azd compatibility/troubleshooting.
src/frontend/src/content/docs/deployment/azure/index.mdx	New shared Azure deployment overview (auth, settings, target comparison, guidance links).
src/frontend/src/content/docs/deployment/azure/container-apps.mdx	New target-specific Azure Container Apps deployment guide with mapping/customization details.
src/frontend/src/content/docs/deployment/azure/app-service.mdx	New target-specific Azure App Service deployment guide (workload constraints, slots, monitoring).
src/frontend/src/content/docs/deployment/azure/azure-security-best-practices.mdx	Reworks Azure security guidance around public vs private networking models and hardening steps.
src/frontend/src/content/docs/deployment/azure/azure-developer-cli.mdx	Refocuses azd content into a “keep existing workflows” compatibility page.
src/frontend/src/content/docs/deployment/azure/customize-container-apps.mdx	Removed; prior ACA customization guidance moved into new pages.
src/frontend/src/content/docs/deployment/azure/aca-deployment-aspire-cli.mdx	Removed; replaced by new /deployment/azure/ + /deployment/azure/container-apps/.
src/frontend/src/content.config.ts	Extends docs frontmatter schema with optional topic.
src/frontend/config/sidebar/deployment.topics.ts	Updates Azure section structure to “Overview / Deployment targets / Guidance”.
src/frontend/config/redirects.mjs	Adds redirects from removed Azure pages to the new structure.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

• Files reviewed: 23/23 changed files
• Comments generated: 3