azure-container-apps

راهنمای تخصصی طراحی، استقرار و عیب‌یابی Azure Container Apps

این Skill برای کار با Azure Container Apps، از انتخاب معماری و تنظیمات runtime تا deployment، scaling، امنیت و اتصال به سرویس‌های دیگر راهنمایی تخصصی ارائه می‌دهد. همچنین در عیب‌یابی image pull، health probe، پورت‌ها، storage mount، خطاهای runtime و startup کمک می‌کند.

با استفاده از quick reference محلی و دریافت مستندات به‌روز Microsoft، می‌توانید تصمیم‌های معماری دقیق‌تری بگیرید، CI/CD با GitHub Actions یا Azure Pipelines بسازید و محدودیت‌ها و quotaهای پلتفرم را بهتر مدیریت کنید.

چه چیزی می‌گیرید

  • راهنمای عیب‌یابی خطاهای image، startup، health probe، networking و storage
  • پیشنهادهای معماری برای microservices، Java، Dapr و workloadهای event-driven
  • راهنمای تنظیم scaling، revisions، traffic splitting، ingress و workload profiles
  • الگوهای امنیتی برای Entra، OIDC، mTLS، secrets، managed identity و private endpoints
  • راهنمای deployment و CI/CD با GitHub Actions، Azure Pipelines و Docker Compose

برای چه کاری خوب است

  • تیم‌هایی که می‌خواهند سرویس‌های containerized را روی Azure اجرا یا مهاجرت دهند
  • توسعه‌دهندگانی که با مشکل deployment، scaling، networking یا health check مواجه‌اند
  • معماران و DevOps engineerهایی که به طراحی microservices و rolloutهای امن نیاز دارند

برای چه کاری نیست

  • پروژه‌هایی که به اجرای کامل Kubernetes و کنترل مستقیم روی control plane نیاز دارند
  • سؤال‌های عمومی خارج از Azure Container Apps و سرویس‌های مرتبط با آن
  • محیط‌های بدون دسترسی شبکه، در صورت نیاز به دریافت مستندات به‌روز

دربارهٔ این اسکیل

 npx skills add MicrosoftDocs/Agent-Skills

SKILL.md

Azure Container Apps Skill

This skill provides expert guidance for Azure Container 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

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

CategoryLinesDescription
TroubleshootingL37-L51Diagnosing and fixing Container Apps issues: image pulls, startup/exit failures, health probes, ports, storage mounts, runtime/OCI errors, debug console use, and Java log-level troubleshooting.
Best PracticesL52-L58Deployment, cold-start, and runtime tuning guidance: blue-green rollouts, reducing scale-out latency, and optimizing Java memory usage in Azure Container Apps.
Decision MakingL59-L79Guidance on choosing Container Apps hosting/compute options, cost models, GPUs, and workload profiles, plus migration paths from Functions, Heroku, Java/Spring/Tomcat, and other Azure container services
Architecture & Design PatternsL80-L86Architectures and patterns for Java microservices on Azure Container Apps, including Eureka HA clusters, AI-enabled PetClinic, and end-to-end microservice design best practices.
Limits & QuotasL87-L94Limits, quotas, and default behaviors for Container Apps (including express preview), plus how to review current limits and request quota increases.
SecurityL95-L133Securing Container Apps: auth (Entra, social, OIDC, mTLS, certs), secrets/managed identity, private endpoints, firewalls/WAF, DNS/ingress controls, and security best practices.
ConfigurationL134-L176Configuring Container Apps runtime: networking/ingress, scaling, revisions/traffic, Dapr, Functions, Java, logging/monitoring, storage mounts, workload profiles, and maintenance.
Integrations & Coding PatternsL177-L199Patterns for connecting Container Apps to each other and to services (Dapr, Spring, Front Door, Service Connector) plus dynamic/shell/code-interpreter sessions and event-driven jobs.
DeploymentL200-L208Deploying and automating Container Apps: CI/CD with GitHub Actions/Azure Pipelines, Docker Compose migration, self-hosted runners, and Arc-enabled Kubernetes integration.

Troubleshooting

Best Practices

TopicURL
Implement blue-green deployments in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/blue-green-deployment
Apply cold-start reduction best practices in Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/cold-start
Optimize Java memory usage in Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-memory-fit

Decision Making

Architecture & Design Patterns

TopicURL
Design a highly available Eureka cluster on Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-eureka-server-highly-available
Understand AI-enabled PetClinic architecture on Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/java-petclinic-ai-overview
Design microservices architecture on Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/microservices

Limits & Quotas

TopicURL
Azure Container Apps express preview feature limitshttps://learn.microsoft.com/en-us/azure/container-apps/express-faq
Azure Container Apps platform limits and behaviorshttps://learn.microsoft.com/en-us/azure/container-apps/faq
Request quota increases for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/quota-requests
Review quotas and limits for Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/quotas

Security

Configuration

Integrations & Coding Patterns

Deployment

TopicURL
Enable Azure Container Apps on Arc-enabled Kubernetes clustershttps://learn.microsoft.com/en-us/azure/container-apps/azure-arc-enable-cluster
Automate Container Apps revisions with Azure Pipelineshttps://learn.microsoft.com/en-us/azure/container-apps/azure-pipelines
Deploy Docker Compose agents to Azure Container Appshttps://learn.microsoft.com/en-us/azure/container-apps/compose-agent
Automate Container Apps revisions with GitHub Actionshttps://learn.microsoft.com/en-us/azure/container-apps/github-actions
Generate Container Apps GitHub Actions via Azure CLIhttps://learn.microsoft.com/en-us/azure/container-apps/github-actions-cli
Run self-hosted CI/CD runners with Container Apps jobshttps://learn.microsoft.com/en-us/azure/container-apps/tutorial-ci-cd-runners-jobs

دانلود ZIP