azure-spring-apps

# Azure Spring Apps Skill This skill provides expert guidance for Azure Spring Apps. 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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md) 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-L54 | Diagnosing and fixing Azure Spring Apps issues: memory/OOM, dumps/JFR, remote debugging, VNet connectivity, logs/diagnostics, exit codes, build failures, and Spring Cloud Gateway. | | Best Practices | L55-L60 | Guidance on production-ready monitoring and diagnostics in Azure Spring Apps, including observability setup, metrics/logs/traces, and configuring JVM diagnostic and debugging options. | | Decision Making | L61-L81 | Guidance on choosing Azure Spring Apps plans and migrating Spring workloads, configs, gateways, and networking from ASA to Enterprise, AKS, or Container Apps, including logging and Tanzu replacements | | Architecture & Design Patterns | L82-L89 | Deployment and resiliency patterns for Azure Spring Apps: zero-downtime and blue-green releases, load balancer integration, zone redundancy, and disaster recovery design. | | Limits & Quotas | L90-L100 | Version/Java support, service-specific limits/quotas, storage caps, VNet requirements, and guidance for scaling Azure Spring Apps Enterprise (instances, large CPU/memory apps). | | Security | L101-L127 | Securing Azure Spring Apps: TLS/SSL, custom domains, App Gateway, Entra ID SSO/RBAC, managed identities (Key Vault, SQL, Functions), and Azure Policy/regulatory controls. | | Configuration | L128-L167 | Configuring Azure Spring Apps runtime: networking, ingress/egress, DNS, storage, logging/metrics, APM, health probes, scaling, gateways, Tanzu tools, and enterprise job/lifecycle settings. | | Integrations & Coding Patterns | L168-L192 | Integrating Azure Spring Apps with databases, Redis, Key Vault, gRPC, Tanzu tools, and APM/monitoring (App Insights, AppDynamics, Dynatrace, Elastic, New Relic) and collecting metrics/logs. | | Deployment | L193-L212 | Deploying Azure Spring Apps: CI/CD with GitHub/Azure Pipelines/Maven/CLI, container & polyglot deployments, VNet/ARM/Bicep/Terraform setup, blue‑green staging, and region moves. | ### Troubleshooting | Topic | URL | |-------|-----| | Capture heap and thread dumps and use JFR in Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-capture-dumps | | Connect to Azure Spring Apps instances for advanced troubleshooting | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-connect-to-app-instance-for-troubleshooting | | Resolve app restarts caused by out-of-memory in Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-fix-app-restart-issues-caused-by-out-of-memory | | Enable and use remote debugging for Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-remote-debugging-app-instance | | Self-diagnose Azure Spring Apps issues in virtual networks | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-self-diagnose-running-in-vnet | | Use Azure Spring Apps diagnostics to self-diagnose issues | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-self-diagnose-solve | | Use tools to troubleshoot Java memory issues in Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/tools-to-troubleshoot-memory-issues | | General troubleshooting guide for Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/troubleshoot | | Troubleshoot application exit codes in Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/troubleshoot-exit-code | | Troubleshoot Azure Spring Apps in virtual networks | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/troubleshooting-vnet | | Stream Azure Spring Apps job logs for troubleshooting | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/how-to-job-log-streaming | | Stream managed component logs in Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/how-to-managed-component-log-streaming | | Troubleshoot VMware Spring Cloud Gateway on Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/how-to-troubleshoot-enterprise-spring-cloud-gateway | | Troubleshoot Azure Spring Apps build failures | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/troubleshoot-build-exit-code | ### Best Practices | Topic | URL | |-------|-----| | Optimize observability for production Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/application-observability | | Configure JVM diagnostic options for Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-dump-jvm-options | ### Decision Making | Topic | URL | |-------|-----| | Migrate Azure Spring Apps Basic/Standard to Enterprise plan | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-migrate-standard-tier-to-enterprise-tier | | Choose the right Azure Spring Apps plan | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/plan-comparison | | Understand Azure Spring Apps Enterprise marketplace offer | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/how-to-enterprise-marketplace-offer | | Migrate Application Live View to Spring Boot Admin | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-application-live-view | | Migrate from Application Configuration Service to Spring Cloud Config Server | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-enterprise-application-configuration-service | | Plan migration off deprecated Tanzu components | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-off-deprecated-tanzu-components | | Plan migration from Azure Spring Apps to Azure Kubernetes Service | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-to-aks-overview | | Migrate Azure Spring Apps API Portal to Azure API Management | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-to-azure-container-apps-components-api-portal | | Migrate Azure Spring Apps ACS to Config Server for Spring | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-to-azure-container-apps-components-application-configuration-service | | Migrate Spring Cloud Config Server to Config Server for Spring | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-to-azure-container-apps-components-config-server | | Migrate Eureka Server to Eureka Server for Spring on Container Apps | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-to-azure-container-apps-components-eureka | | Migrate Spring Cloud Gateway Tanzu to Gateway for Spring on Container Apps | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-to-azure-container-apps-components-gateway | | Migrate Application Live View to Managed Admin for Spring | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-to-azure-container-apps-components-live-view | | Map logs and metrics from Azure Spring Apps to Container Apps | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-to-azure-container-apps-monitoring | | Migrate Azure Spring Apps custom virtual network to Container Apps | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-to-azure-container-apps-network | | Decide when to migrate from Azure Spring Apps to Container Apps | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-to-azure-container-apps-overview | | Plan Azure Container Apps environment for Spring Apps migration | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-to-azure-container-apps-provision | ### Architecture & Design Patterns | Topic | URL | |-------|-----| | Design zero-downtime deployments on Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/concept-zero-downtime-deployment | | Apply blue-green deployment patterns in Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/concepts-blue-green-deployment-strategies | | Integrate Azure Spring Apps with Azure load balancer options | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-integrate-azure-load-balancers | | Design resilient Azure Spring Apps with zones and DR | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/reliability-spring-apps | ### Limits & Quotas | Topic | URL | |-------|-----| | Version support policy for Java and Spring on Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/concept-app-customer-responsibilities | | Azure Spring Apps FAQ with service-specific behaviors | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/faq | | Use built-in persistent storage limits in Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-built-in-persistent-storage | | Service plans and quotas for Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/quotas | | VNet requirements and dependencies for Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/vnet-customer-responsibilities | | Scale Azure Spring Apps Enterprise to 1000 instances | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/how-to-enterprise-deploy-app-at-scale | | Deploy large CPU and memory apps on Azure Spring Apps Enterprise | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/how-to-enterprise-large-cpu-memory-applications | ### Security | Topic | URL | |-------|-----| | Understand built-in security controls in Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/concept-security-controls | | Use managed identity from Azure Spring Apps to access Azure SQL | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/connect-managed-identity-to-azure-sql | | Expose Azure Spring Apps via Application Gateway with end-to-end TLS | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/expose-apps-gateway-end-to-end-tls | | Authenticate Azure Spring Apps CI/CD with Key Vault in GitHub Actions | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/github-actions-key-vault | | Secure Config Server and Service Registry with Entra RBAC | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-access-data-plane-azure-ad-rbac | | Map and secure custom domains for Azure Spring Apps with TLS | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-custom-domain | | Enable ingress-to-app TLS for Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-enable-ingress-to-app-tls | | Enable system-assigned managed identity in Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-enable-system-assigned-managed-identity | | Manage user-assigned managed identities for Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-manage-user-assigned-managed-identities | | Create custom RBAC roles for Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-permissions | | Use managed identities with Azure Spring Apps applications | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-use-managed-identities | | Use TLS/SSL certificates in Azure Spring Apps applications | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/how-to-use-tls-certificate | | Use built-in Azure Policy definitions for Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/policy-reference | | Apply Azure Policy regulatory compliance controls to Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/security-controls-policy | | Invoke Azure Functions from Azure Spring Apps using managed identity | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/tutorial-managed-identities-functions | | Use managed identities to access Key Vault from Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/tutorial-managed-identities-key-vault | | Expose Azure Spring Apps via Application Gateway TLS termination | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/expose-apps-gateway-tls-termination | | Expose Azure Spring Apps to internet with TLS options | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/how-to-access-app-from-internet-virtual-network | | Configure Entra ID SSO for Spring Cloud Gateway and API Portal | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/how-to-set-up-sso-with-azure-ad | | Configure single sign-on for Azure Spring Apps Enterprise apps | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/quickstart-configure-single-sign-on-enterprise | | Deploy Entra ID–protected REST API to Azure Spring Apps | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/quickstart-deploy-restful-api-app | | Secure Spring Boot communications end-to-end on Azure | https://learn.microsoft.com/en-us/azure/spring-apps/enterprise/secure-communications-end-to-end | | Migrate custom domain TLS/SSL from Spring Apps to Container Apps | https://learn.microsoft.com/en-us/azure/spring-apps/migration/migrate-to-azure-container-apps-custom-domain | ### Configuration | Topic | URL | |-------|-----| | Configure private endpoints to access Azure Spring Apps in a VNet | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/access-app-virtual-network | | Understand Azure Spring Apps API breaking changes | https://learn.microsoft.com/en-us/azure/spring-apps/basic-standard/breaking-changes |