Skip to content

Improve discoverability of Azure deployment customization patterns #3712

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Jun 5, 2025

This PR addresses the discoverability issue with Azure deployment customization patterns in .NET Aspire documentation. The ConfigureInfrastructure capability was previously buried in the Azure integrations overview, making it difficult for developers to find deployment customization guidance.

Changes Made

📄 New dedicated documentation page

  • Created docs/deployment/azure/customize-infrastructure.md with comprehensive guidance on customizing Azure infrastructure during deployment
  • Includes common patterns for tagging, role assignments, SKU configuration, and Bicep customization
  • Features the SQL Server tagging example specifically mentioned in the issue

🗺️ Improved navigation and discoverability

  • Added the new page to the TOC under Deploy → Azure section with descriptive display names
  • Updated deployment overview to mention infrastructure customization capabilities
  • Added cross-references from Azure integrations overview to the new dedicated page

🔗 Enhanced cross-linking

  • Added references to the deployment customization guide from 5 Azure integration pages:
    • Azure Service Bus
    • Azure App Configuration
    • Azure Key Vault
    • Azure OpenAI
    • Azure SignalR Service

📝 Code examples and snippets

  • Created Program.ConfigureSqlServerInfra.cs snippet file demonstrating the SQL Server tagging pattern from the issue
  • All examples follow existing documentation patterns and coding standards

Impact

Developers looking for deployment customization guidance can now easily find it through multiple intuitive entry points:

  • Deploy section (primary location)
  • Azure integrations overview (technical reference)
  • Individual Azure integration pages (contextual links)

The new dedicated page provides comprehensive examples and patterns for enterprise deployment requirements like tagging policies, compliance configurations, and infrastructure governance.

Fixes #3668.


💡 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.

Copilot AI and others added 2 commits June 5, 2025 20:33
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
…on pages

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
@Copilot Copilot AI changed the title [WIP] Improve discoverability of deployment customization patterns Improve discoverability of Azure deployment customization patterns Jun 5, 2025
@Copilot Copilot AI requested a review from IEvangelist June 5, 2025 20:37
Copilot finished work on behalf of IEvangelist June 5, 2025 20:37
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.

Improve discoverability of deployment customization patterns
2 participants