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/SAP/App Service solutions, hybrid networking, secure APIs/RAG, or AWS/GCP/on-prem migrations, 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-08-09","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-L90	End-to-end Azure solution blueprints: mission-critical, secure, and compliant architectures for data platforms, AKS, SAP, App Service, hybrid networking, and enterprise integration.
Solution Ideas	L91-L128	End-to-end solution patterns for AI, data, analytics, security, DevOps, and migration on Azure—how to design, integrate, and operate complex workloads using multiple Azure services.
Design Patterns	L129-L177	Patterns for resilient, scalable cloud apps: messaging, transactions, routing, caching, security, identity, data partitioning, and migration using Azure services.
Technology Choices	L178-L212	Guidance on choosing the right Azure/Fabric services and architectures for AI/ML, data, analytics, storage, compute, networking, containers, and messaging based on workload needs.
Architecture Styles	L213-L224	Guidance on choosing and designing Azure app architectures (big compute, big data, event-driven, microservices, N-tier, web-queue-worker) with patterns, components, and best practices.
Best Practices	L225-L281	Best-practice patterns for Azure architectures: secure APIs/RAG/ML, AKS ops and CI/CD, networking/DNS/DR, caching/CDN/IoT, SAP, VM patching, monitoring, scaling, and reliability.
Anti-patterns	L282-L296	Diagnosing and fixing common Azure performance and scalability anti-patterns (busy DB/front end, chatty I/O, no caching, noisy neighbors, retry storms, sync I/O, monolithic persistence).
Example Workloads	L297-L396	End-to-end Azure solution blueprints: real workloads for data/AI, APIs, AKS, hybrid, security, mainframe/ERP, IoT/OPC UA, VDI, backup, and BI/Fabric architectures and operations.
Migration Guides	L397-L426	Guides for migrating from AWS, GCP, on-prem Oracle, and Kafka to Azure, mapping services (compute, data, identity, networking, Kubernetes) and comparing architectures, costs, and security.

Reference Architectures

Topic	URL
Deploy a baseline enterprise Foundry chat reference architecture	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/architecture/baseline-microsoft-foundry-chat
Implement baseline Foundry chat in an Azure landing zone	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
Implement DR-ready Azure enterprise data platform architecture	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
Design image classification apps using Azure services	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 a conversation analytics solution with Foundry tools	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/idea/unlock-insights-from-conversational-data
Design polyglot persistence with Cosmos DB and SQL	https://learn.microsoft.com/en-us/azure/architecture/databases/idea/combine-relational-nosql
Use Cosmos DB change feed for minimal storage replication	https://learn.microsoft.com/en-us/azure/architecture/databases/idea/minimal-storage-change-feed-replicate-data

Design Patterns

Topic	URL
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
Apply the Anti-Corruption Layer integration pattern	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
Apply the Bulkhead pattern to isolate failures	https://learn.microsoft.com/en-us/azure/architecture/patterns/bulkhead
Use the Cache-Aside pattern for on-demand caching	https://learn.microsoft.com/en-us/azure/architecture/patterns/cache-aside
Apply the choreography pattern for distributed workflows	https://learn.microsoft.com/en-us/azure/architecture/patterns/choreography
Use the Circuit Breaker pattern for resilient calls	https://learn.microsoft.com/en-us/azure/architecture/patterns/circuit-breaker
Apply the Claim-Check pattern for large messages

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
Design and implement microservices architecture on Azure	https://learn.microsoft.com/en-us/azure/architecture/microservices/design/

Best Practices

Topic	URL
Use a gateway to securely expose Foundry models	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/azure-openai-gateway-guide
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
Implement agentic RAG architectures with Azure AI	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/rag/rag-agentic
Configure and optimize RAG information retrieval on Azure	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/rag/rag-information-retrieval
Engineer effective prompts for Azure RAG solutions	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/rag/rag-prompt-engineering
Design and evaluate Azure RAG solutions rigorously	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/guide/rag/rag-solution-design-and-evaluation-guide
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

Anti-patterns

Topic	URL
Identify and remediate common Azure performance antipatterns	https://learn.microsoft.com/en-us/azure/architecture/antipatterns/
Identify and remediate the Busy Database 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/
Avoid synchronous I/O to improve scalability in Azure apps	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 Azure 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
Index blob content and metadata with Azure AI Search	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/architecture/search-blob-metadata
Implement a secure Azure research environment for regulated data	https://learn.microsoft.com/en-us/azure/architecture/ai-ml/architecture/secure-compute-for-research
Implement batch analytics for 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
Implement DataOps for a modern Azure data warehouse	https://learn.microsoft.com/en-us/azure/architecture/databases/architecture/dataops-mdw
Implement write-through caching with Azure SQL and Redis	https://learn.microsoft.com/en-us/azure/architecture/databases/architecture/write-through-caching-azure-sql-managed-redis

Migration Guides

Topic	URL
Map AWS services and concepts to Azure for migration	https://learn.microsoft.com/en-us/azure/architecture/aws-professional/
Map AWS accounts and organizations to Azure structures	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
Map AWS database services to Azure offerings	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
Compare and govern EKS vs AKS Kubernetes clusters	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