azure-app-service

name	azure-app-service
description	Expert knowledge for Azure App Service development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when choosing App Service plans, VNet/ASE networking, Entra auth, deployment slots/CI/CD, or Azure OpenAI chatbots, and other Azure App Service related development tasks. Not for Azure Functions (use azure-functions), Azure Container Apps (use azure-container-apps), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Static Web Apps (use azure-static-web-apps).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-31","generator":"docs2skills/1.0.0"}

Azure App Service Skill

This skill provides expert guidance for Azure App Service. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. 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
Troubleshooting	L37-L45	Diagnosing and fixing App Service issues using built-in diagnostics, logs, Azure Monitor, site status, and guidance for common WordPress-specific problems.
Best Practices	L46-L56	Best practices for deploying and securing App Service apps, handling inbound/outbound and TLS IP changes, and using Traffic Manager for resilient, highly available endpoints
Decision Making	L57-L74	Guidance for planning and choosing App Service tiers, hosting plans, networking, auth, secure connectivity, domains, and migration paths (Windows→Linux, .NET, Docker, VNet, ASE vs multitenant).
Architecture & Design Patterns	L75-L80	Patterns for scaling App Service apps: geo-distributed deployments with App Service Environments and designing RAG chatbots using Foundry on App Service.
Limits & Quotas	L81-L85	App Service resource limits (CPU, memory, connections), quota types, how they’re measured/monitored, and how to use metrics to detect and avoid hitting plan or app quotas.
Security	L86-L133	Securing App Service apps: auth (Entra, social, OIDC, MCP), certificates/TLS, IP/VNet/firewall, managed identities, Key Vault, storage/SQL/Graph access, and end‑to‑end network isolation.
Configuration	L134-L187	Configuring App Service apps: runtime and language settings, containers/sidecars, networking (VNet, NAT, private endpoints, DNS), auth, SSL/domains, storage, backups, and environment variables.
Integrations & Coding Patterns	L188-L197	Patterns for integrating App Service apps with APM tools, TLS/SSL certs, Application Gateway, MCP, Azure OpenAI chatbots (Node/Flask), and event-driven jobs via WebJobs bindings.
Deployment	L198-L221	Deploying and managing App Service apps: CI/CD (GitHub Actions, Azure Pipelines), ZIP/FTP/local Git deploy, deployment slots, ASE setup/scale, DNS migration, and maintenance/patch automation.

Troubleshooting

Topic	URL
Use App Service diagnostics to troubleshoot apps	https://learn.microsoft.com/en-us/azure/app-service/overview-diagnostics
Enable and access Azure App Service diagnostic logs	https://learn.microsoft.com/en-us/azure/app-service/troubleshoot-diagnostic-logs
Troubleshoot App Service apps with Azure Monitor	https://learn.microsoft.com/en-us/azure/app-service/tutorial-troubleshoot-monitor
Use App Service site status page for runtime issues	https://learn.microsoft.com/en-us/azure/app-service/use-app-service-site-status-page
Resolve common WordPress on Azure App Service issues	https://learn.microsoft.com/en-us/azure/app-service/wordpress-faq

Best Practices

Topic	URL
Apply best practices and troubleshooting for Azure App Service	https://learn.microsoft.com/en-us/azure/app-service/app-service-best-practices
Apply deployment best practices for App Service	https://learn.microsoft.com/en-us/azure/app-service/deploy-best-practices
Prepare App Service apps for inbound IP address changes	https://learn.microsoft.com/en-us/azure/app-service/ip-address-change-inbound
Prepare App Service apps for outbound IP address changes	https://learn.microsoft.com/en-us/azure/app-service/ip-address-change-outbound
Handle TLS/SSL IP address changes for App Service bindings	https://learn.microsoft.com/en-us/azure/app-service/ip-address-change-ssl
Apply security best practices to Azure App Service deployments	https://learn.microsoft.com/en-us/azure/app-service/overview-security
Configure Azure Traffic Manager with App Service endpoints	https://learn.microsoft.com/en-us/azure/app-service/web-sites-traffic-manager

Decision Making

Topic	URL
Choose and use .NET migration tools for App Service	https://learn.microsoft.com/en-us/azure/app-service/app-service-asp-net-migration
Configure and evaluate App Service Premium v3 tier	https://learn.microsoft.com/en-us/azure/app-service/app-service-configure-premium-v3-tier
Assess .NET web apps before App Service migration	https://learn.microsoft.com/en-us/azure/app-service/app-service-migration-assess-net
Plan migration of App Service apps from Windows to Linux	https://learn.microsoft.com/en-us/azure/app-service/app-service-migration-windows-linux
Choose between App Service Environment v3 and multitenant	https://learn.microsoft.com/en-us/azure/app-service/environment/ase-multi-tenant-comparison
Choose the right authentication option for App Service	https://learn.microsoft.com/en-us/azure/app-service/identity-scenarios
Migrate App Service VNet integration from gateway to regional	https://learn.microsoft.com/en-us/azure/app-service/migrate-gateway-based-vnet-integration
Decide and plan migration from Docker Compose to sidecars	https://learn.microsoft.com/en-us/azure/app-service/migrate-sidecar-multi-container-apps
Choose App Service networking features for security and access	https://learn.microsoft.com/en-us/azure/app-service/networking-features
Choose and configure App Gateway with App Service	https://learn.microsoft.com/en-us/azure/app-service/overview-app-gateway-integration
Plan and manage custom domains for App Service

Architecture & Design Patterns

Topic	URL
Design geo-distributed scale with App Service Environments	https://learn.microsoft.com/en-us/azure/app-service/environment/app-service-app-service-environment-geo-distributed-scale
Design RAG chatbots with Foundry on App Service	https://learn.microsoft.com/en-us/azure/app-service/scenario-ai-chatbot-retrieval-augmented-generation

Limits & Quotas

Topic	URL
Understand quotas and metrics for Azure App Service	https://learn.microsoft.com/en-us/azure/app-service/web-sites-monitor

Security

Topic	URL
Set up IP and VNet access restrictions for App Service	https://learn.microsoft.com/en-us/azure/app-service/app-service-ip-restrictions
Configure Key Vault references in App Service settings	https://learn.microsoft.com/en-us/azure/app-service/app-service-key-vault-references
Handle App Service Managed Certificate changes and validation	https://learn.microsoft.com/en-us/azure/app-service/app-service-managed-certificate-changes-july-2025
Configure TLS mutual authentication in Azure App Service	https://learn.microsoft.com/en-us/azure/app-service/app-service-web-configure-tls-mutual-auth
Configure Entra auth for Foundry OpenAPI tools on App Service	https://learn.microsoft.com/en-us/azure/app-service/configure-authentication-ai-foundry-openapi-tool
Customize sign-in and sign-out behavior in App Service auth	https://learn.microsoft.com/en-us/azure/app-service/configure-authentication-customize-sign-in-out
Configure MCP server authorization in Azure App Service	https://learn.microsoft.com/en-us/azure/app-service/configure-authentication-mcp
Secure MCP servers on App Service with Entra authentication	https://learn.microsoft.com/en-us/azure/app-service/configure-authentication-mcp-server-vscode
Manage OAuth tokens with App Service authentication	https://learn.microsoft.com/en-us/azure/app-service/configure-authentication-oauth-tokens
Configure Microsoft Entra authentication for App Service	https://learn.microsoft.com/en-us/azure/app-service/configure-authentication-provider-aad

Configuration

Topic	URL
Configure Azure App Service App Configuration references	https://learn.microsoft.com/en-us/azure/app-service/app-service-configuration-references
Configure Hybrid Connections for Azure App Service apps	https://learn.microsoft.com/en-us/azure/app-service/app-service-hybrid-connections
Manage App Service authentication API and runtime versions	https://learn.microsoft.com/en-us/azure/app-service/configure-authentication-api-version
Configure App Service authentication using file-based settings	https://learn.microsoft.com/en-us/azure/app-service/configure-authentication-file-based
Configure core settings for Azure App Service apps	https://learn.microsoft.com/en-us/azure/app-service/configure-common
Mount Azure Storage file shares in App Service	https://learn.microsoft.com/en-us/azure/app-service/configure-connect-to-azure-storage
Configure custom containers for Azure App Service	https://learn.microsoft.com/en-us/azure/app-service/configure-custom-container
Configure Traffic Manager with App Service custom domains	https://learn.microsoft.com/en-us/azure/app-service/configure-domain-traffic-manager
Configure custom error pages in Azure App Service	https://learn.microsoft.com/en-us/azure/app-service/configure-error-pages
Configure gateway-required VNet integration for App Service	https://learn.microsoft.com/en-us/azure/app-service/configure-gateway-required-vnet-integration
Configure gRPC applications on Azure App Service for Linux

Integrations & Coding Patterns

Topic	URL
Integrate Java apps on App Service with APM platforms	https://learn.microsoft.com/en-us/azure/app-service/configure-language-java-apm
Use App Service TLS/SSL certificates in application code	https://learn.microsoft.com/en-us/azure/app-service/configure-ssl-certificate-in-code
Integrate App Service Environment with Azure Application Gateway	https://learn.microsoft.com/en-us/azure/app-service/environment/integrate-with-application-gateway
Integrate Node.js Express chatbot with Azure OpenAI via App Service	https://learn.microsoft.com/en-us/azure/app-service/tutorial-ai-openai-chatbot-node
Integrate Python Flask chatbot with Azure OpenAI via App Service	https://learn.microsoft.com/en-us/azure/app-service/tutorial-ai-openai-chatbot-python
Implement event-driven jobs with Azure WebJobs SDK bindings	https://learn.microsoft.com/en-us/azure/app-service/webjobs-sdk-how-to

Deployment

Topic	URL
Clone Azure App Service apps using PowerShell	https://learn.microsoft.com/en-us/azure/app-service/app-service-web-app-cloning
Set up Azure Pipelines CI/CD for App Service	https://learn.microsoft.com/en-us/azure/app-service/deploy-azure-pipelines
Set up CI/CD to App Service custom containers	https://learn.microsoft.com/en-us/azure/app-service/deploy-ci-cd-custom-container
Manage deployment credentials for Azure App Service	https://learn.microsoft.com/en-us/azure/app-service/deploy-configure-credentials
Deploy App Service custom containers using GitHub Actions	https://learn.microsoft.com/en-us/azure/app-service/deploy-container-github-action
Configure continuous deployment to Azure App Service	https://learn.microsoft.com/en-us/azure/app-service/deploy-continuous-deployment
Deploy to Azure App Service using FTP/FTPS	https://learn.microsoft.com/en-us/azure/app-service/deploy-ftp
Deploy to Azure App Service using GitHub Actions	https://learn.microsoft.com/en-us/azure/app-service/deploy-github-actions
Deploy from a local Git repository to App Service	https://learn.microsoft.com/en-us/azure/app-service/deploy-local-git
Run Azure App Service apps directly from ZIP packages	https://learn.microsoft.com/en-us/azure/app-service/deploy-run-package
Configure deployment slots and staging for App Service	https://learn.microsoft.com/en-us/azure/app-service/deploy-staging-slots
Deploy ZIP and file packages to Azure App Service