azure-architecture

name	azure-architecture
description	Expert guidance for designing Azure solutions using Azure Architecture. Covers reference architectures, solution ideas, design patterns, technology choices, architecture styles, best practices, anti-patterns, example workloads, and migration guides. Use when designing AKS or AVD solutions, hybrid/Arc setups, multiregion DR, SAP/IoT platforms, or GenAI/RAG workloads, and other Azure Architecture related development tasks.
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-19","generator":"docs2skills/1.0.0"}

Azure Architecture Skill

This skill provides expert guidance for designing Azure solutions using Azure Architecture. Covers reference architectures, solution ideas, design patterns, technology choices, architecture styles, best practices, anti-patterns, example workloads, and migration guides. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Reference Architectures	L37-L92	End-to-end Azure solution blueprints for mission-critical, hybrid, and multiregion workloads: networking, security, data/ML, AKS, AVD, integration, and DR-ready reference architectures.
Solution Ideas	L93-L124	End-to-end solution patterns for AI, analytics, security, DevSecOps, SAP, and data platforms on Azure, including reference architectures and implementation guidance.
Design Patterns	L125-L178	Design and integration patterns for building resilient, scalable, secure Azure apps: messaging, gateways, multitenancy, caching, transactions, auth, monitoring, and legacy modernization.
Technology Choices	L179-L213	Guides for choosing the right Azure/Fabric services (AI, data, storage, compute, networking, containers, messaging) by comparing options for specific workload and architecture needs.
Architecture Styles	L214-L224	Azure app architecture patterns: when and how to use Big Compute, Big Data, event-driven, microservices, N-tier, and Web-Queue-Worker styles, with design guidance and tradeoffs.
Best Practices	L225-L279	Best-practice patterns for Azure apps: API design, autoscale, caching, DR/HA, networking/IPv4-6, AKS, IoT, SAP, Event Hubs, App Service, DevSecOps, and GenAI/RAG operations.
Anti-patterns	L280-L294	Diagnosing and fixing common Azure performance and scalability anti-patterns (busy DB/front end, chatty I/O, no caching, retry storms, noisy neighbors, sync I/O, monolithic persistence).
Example Workloads	L295-L371	End-to-end reference architectures and patterns for real-world Azure workloads, covering data/AI, mainframe migration, networking, security, hybrid/Arc, AKS, Fabric, VDI, and app modernization.
Migration Guides	L372-L406	Guides for migrating from AWS, GCP, on-prem Oracle, Kafka, and Kubernetes/EKS to Azure, including service mapping, architecture, governance, security, cost, and app modernization patterns.

Reference Architectures

Topic	URL
Deploy a baseline Microsoft Foundry chat architecture on Azure	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/architecture/baseline-microsoft-foundry-chat
Run baseline Foundry chat in Azure landing zones	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/architecture/baseline-microsoft-foundry-landing-zone
Deploy MLOps v2 CI/CD and retraining architectures	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/machine-learning-operations-v2
Design Azure data platform architecture with DR capabilities	https://learn.microsoft.com/en-us/azure/architecture/data-guide/disaster-recovery/dr-for-azure-data-platform-architecture
Enterprise-hardened Azure Data Factory lakehouse architecture	https://learn.microsoft.com/en-us/azure/architecture/databases/architecture/azure-data-factory-enterprise-hardened
Mission-critical Azure Data Factory analytics architecture	https://learn.microsoft.com/en-us/azure/architecture/databases/architecture/azure-data-factory-mission-critical
Baseline medallion lakehouse with Azure Data Factory	https://learn.microsoft.com/en-us/azure/architecture/databases/architecture/azure-data-factory-on-azure-landing-zones-baseline
Deploy MongoDB Atlas securely on Azure	https://learn.microsoft.com/en-us/azure/architecture/databases/architecture/mongodb-atlas-baseline
Move archive data from mainframes to Azure storage	https://learn.microsoft.com/en-us/azure/architecture/example-scenario/mainframe/move-archive-data-mainframes

Solution Ideas

Topic	URL
Generate AI-assisted documents from enterprise data	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/idea/generate-documents-from-your-data
Add image classification to apps on Azure	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/idea/intelligent-apps-image-processing
Scale many-models machine learning on Azure	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/idea/many-models-machine-learning-azure-machine-learning
Process multimodal content with Azure AI services	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/idea/multi-modal-content-processing
Design multi-agent workflow automation on Azure	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/idea/multiple-agent-workflow-automation
Forecast customer orders with Azure AI	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/idea/next-order-forecasting
Orchestrate MLOps pipelines with Azure Databricks	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/idea/orchestrate-machine-learning-azure-databricks
Design conversation analytics with Foundry Tools	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/idea/unlock-insights-from-conversational-data
Use Cosmos DB change feed for minimal-cost archival	https://learn.microsoft.com/en-us/azure/architecture/databases/idea/minimal-storage-change-feed-replicate-data
Load test Event Hubs and IoT Hub with custom JMeter plugins	https://learn.microsoft.com/en-us/azure/architecture/guide/testing/load-testing/load-testing-with-custom-plugins

Design Patterns

Topic	URL
Implement custom auth via an Azure OpenAI gateway	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/azure-openai-gateway-custom-authentication
Use a gateway pattern for Azure OpenAI access	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/azure-openai-gateway-guide
Pattern for advanced monitoring via OpenAI gateway	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/azure-openai-gateway-monitoring
Gateway pattern for multiple Azure OpenAI backends	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/azure-openai-gateway-multi-backend
Implement Transactional Outbox with Cosmos DB and Service Bus	https://learn.microsoft.com/en-us/azure/architecture/databases/guide/transactional-out-box-cosmos
Virtual hub extension pattern for shared services in Virtual WAN	https://learn.microsoft.com/en-us/azure/architecture/networking/guide/private-link-virtual-wan-dns-virtual-hub-extension-pattern
Implement the Ambassador pattern for helper services	https://learn.microsoft.com/en-us/azure/architecture/patterns/ambassador
Use the Anti-corruption Layer pattern with legacy systems	https://learn.microsoft.com/en-us/azure/architecture/patterns/anti-corruption-layer
Use the Asynchronous Request-Reply pattern for long tasks	https://learn.microsoft.com/en-us/azure/architecture/patterns/asynchronous-request-reply
Design Backends for Frontends for tailored clients	https://learn.microsoft.com/en-us/azure/architecture/patterns/backends-for-frontends

Technology Choices

Topic	URL
Compare Microsoft machine learning platforms and tools	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/data-science-and-machine-learning
Choose Azure AI services for image and video processing	https://learn.microsoft.com/en-us/azure/architecture/data-guide/ai-services/image-video-processing
Select Azure speech recognition and generation services	https://learn.microsoft.com/en-us/azure/architecture/data-guide/ai-services/speech-recognition-generation
Choose Azure targeted language processing services	https://learn.microsoft.com/en-us/azure/architecture/data-guide/ai-services/targeted-language-processing
Select Azure data transfer tools and services	https://learn.microsoft.com/en-us/azure/architecture/data-guide/scenarios/data-transfer
Select appropriate Azure AI services for applications	https://learn.microsoft.com/en-us/azure/architecture/data-guide/technology-choices/ai-services
Choose Azure technologies for analytics and reporting	https://learn.microsoft.com/en-us/azure/architecture/data-guide/technology-choices/analysis-visualizations-reporting
Select the right analytical data store in Azure	https://learn.microsoft.com/en-us/azure/architecture/data-guide/technology-choices/analytical-data-stores
Select Azure batch processing technologies for big data	https://learn.microsoft.com/en-us/azure/architecture/data-guide/technology-choices/batch-processing
Select big data storage technologies in Azure

Architecture Styles

Topic	URL
Understand and compare Azure architecture styles	https://learn.microsoft.com/en-us/azure/architecture/guide/architecture-styles/
Apply Big Compute architecture style on Azure	https://learn.microsoft.com/en-us/azure/architecture/guide/architecture-styles/big-compute
Design Big Data architecture style on Azure	https://learn.microsoft.com/en-us/azure/architecture/guide/architecture-styles/big-data
Apply event-driven architecture style on Azure	https://learn.microsoft.com/en-us/azure/architecture/guide/architecture-styles/event-driven
Adopt microservices architecture style on Azure	https://learn.microsoft.com/en-us/azure/architecture/guide/architecture-styles/microservices
Implement N-tier architecture style on Azure	https://learn.microsoft.com/en-us/azure/architecture/guide/architecture-styles/n-tier
Use Web-Queue-Worker architecture style on Azure	https://learn.microsoft.com/en-us/azure/architecture/guide/architecture-styles/web-queue-worker

Best Practices

Topic	URL
Extend existing MLOps to generative AI operations	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/genaiops-for-mlops
Manage foundation model versions and life cycles	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/manage-foundation-models-lifecycle
Securely design multitenant RAG inferencing solutions	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/secure-multitenant-rag
Design RESTful web APIs using Azure best practices	https://learn.microsoft.com/en-us/azure/architecture/best-practices/api-design
Implement and publish RESTful web APIs effectively	https://learn.microsoft.com/en-us/azure/architecture/best-practices/api-implementation
Implement autoscaling best practices on Azure	https://learn.microsoft.com/en-us/azure/architecture/best-practices/auto-scaling
Implement reliable, scalable background jobs on Azure	https://learn.microsoft.com/en-us/azure/architecture/best-practices/background-jobs
Apply effective caching strategies in Azure architectures	https://learn.microsoft.com/en-us/azure/architecture/best-practices/caching
Apply CDN strategies for low-latency content delivery	https://learn.microsoft.com/en-us/azure/architecture/best-practices/cdn
Plan data partitioning for scalable cloud solutions	https://learn.microsoft.com/en-us/azure/architecture/best-practices/data-partitioning
Apply data partitioning strategies in Azure services	https://learn.microsoft.com/en-us/azure/architecture/best-practices/data-partitioning-strategies

Anti-patterns

Topic	URL
Identify and remediate common Azure performance antipatterns	https://learn.microsoft.com/en-us/azure/architecture/antipatterns/
Avoid the Busy Database performance antipattern	https://learn.microsoft.com/en-us/azure/architecture/antipatterns/busy-database/
Detect and fix the Busy Front End antipattern	https://learn.microsoft.com/en-us/azure/architecture/antipatterns/busy-front-end/
Detect and remediate Chatty I/O antipattern	https://learn.microsoft.com/en-us/azure/architecture/antipatterns/chatty-io/
Mitigate the Extraneous Fetching antipattern in Azure	https://learn.microsoft.com/en-us/azure/architecture/antipatterns/extraneous-fetching/
Avoid Improper Instantiation performance antipattern	https://learn.microsoft.com/en-us/azure/architecture/antipatterns/improper-instantiation/
Address Monolithic Persistence data store antipattern	https://learn.microsoft.com/en-us/azure/architecture/antipatterns/monolithic-persistence/
Identify and remediate the No-Caching antipattern	https://learn.microsoft.com/en-us/azure/architecture/antipatterns/no-caching/
Mitigate Noisy Neighbor issues in multitenant systems	https://learn.microsoft.com/en-us/azure/architecture/antipatterns/noisy-neighbor/noisy-neighbor
Prevent Retry Storm antipattern in cloud services	https://learn.microsoft.com/en-us/azure/architecture/antipatterns/retry-storm/
Eliminate Synchronous I/O antipattern for scalability	https://learn.microsoft.com/en-us/azure/architecture/antipatterns/synchronous-io/

Example Workloads

Topic	URL
Automate video analysis with Azure ML and Vision	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/architecture/analyze-video-computer-vision-machine-learning
Automate document classification with Durable Functions	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/architecture/automate-document-classification-durable-functions
Implement automated PDF forms processing on Azure	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/architecture/automate-pdf-forms-processing
Build and deploy custom document models on Azure	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/architecture/build-deploy-custom-models
Index blob content and metadata with Azure AI Search	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/architecture/search-blob-metadata
Design secure research environments for regulated data on Azure	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/architecture/secure-compute-for-research
Analyze call center conversations with Azure OpenAI	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/openai/architecture/call-center-openai-analytics
Design a medallion lakehouse with Azure Data Factory	https://learn.microsoft.com/en-us/azure/architecture/databases/architecture/azure-data-factory-on-azure-landing-zones-index
Apply DataOps to a modern data warehouse in Azure	https://learn.microsoft.com/en-us/azure/architecture/databases/architecture/dataops-mdw

Migration Guides

Topic	URL
Plan Azure adoption for AWS professionals	https://learn.microsoft.com/en-us/azure/architecture/aws-professional/
Map AWS accounts and organizations to Azure subscriptions	https://learn.microsoft.com/en-us/azure/architecture/aws-professional/accounts
Map and compare AWS compute services to Azure	https://learn.microsoft.com/en-us/azure/architecture/aws-professional/compute
Map AWS data and AI services to Azure equivalents	https://learn.microsoft.com/en-us/azure/architecture/aws-professional/data-ai
Compare AWS and Azure database technologies for migration	https://learn.microsoft.com/en-us/azure/architecture/aws-professional/databases
Map Amazon EKS concepts and configs to Azure AKS	https://learn.microsoft.com/en-us/azure/architecture/aws-professional/eks-to-aks/
Manage and optimize AKS costs versus Amazon EKS	https://learn.microsoft.com/en-us/azure/architecture/aws-professional/eks-to-aks/cost-management
Apply governance to AKS clusters versus EKS	https://learn.microsoft.com/en-us/azure/architecture/aws-professional/eks-to-aks/governance
Migrate Kubernetes workloads from EKS to AKS	https://learn.microsoft.com/en-us/azure/architecture/aws-professional/eks-to-aks/migrate
Compare and configure AKS vs EKS monitoring and logging	https://learn.microsoft.com/en-us/azure/architecture/aws-professional/eks-to-aks/monitoring
Manage AKS nodes and node pools versus EKS	https://learn.microsoft.com/en-us/azure/architecture/aws-professional/eks-to-aks/node-pools