azure-service-fabric

# Azure Service Fabric Skill This skill provides expert guidance for Azure Service Fabric. 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-L59 | Diagnosing and fixing Service Fabric issues: connectivity, upgrades, health, logging/monitoring, container and Java logs, reverse proxy, Reliable Services/Actors, and local cluster setup. | | Best Practices | L60-L94 | Best practices for designing, deploying, upgrading, testing, monitoring, and operating Azure Service Fabric apps and clusters, including Reliable Collections/Actors, backup/restore, networking, capacity, and DR. | | Decision Making | L95-L106 | Guidance on planning Service Fabric clusters: choosing OS and versions, disk and node types, capacity and reliability sizing, and migration targets for Cloud Services workloads. | | Architecture & Design Patterns | L107-L120 | Designing Service Fabric cluster architecture: cross-AZ replica rings, CRP/CRM internals, service affinity, movement cost, defragmentation, metrics balancing, networking, and API gateway patterns. | | Limits & Quotas | L121-L125 | Configuring Service Fabric app upgrade settings: health policies, rolling upgrade behavior, monitoring, and timeout parameters to control safe, reliable deployments. | | Security | L126-L182 | Securing Service Fabric clusters and apps: certificates, Microsoft Entra auth, managed identities, secrets, disk encryption, policies, remoting/WCF/HTTPS security, and production best practices. | | Configuration | L183-L304 | Configuring Service Fabric clusters, apps, and networking: backups, scaling, manifests, actors, containers, monitoring/telemetry, reverse proxy, ARM/managed clusters, and Cluster Resource Manager settings. | | Integrations & Coding Patterns | L305-L341 | Patterns and tools for integrating Service Fabric apps with Azure services, APIs, containers, remoting stacks, and managing clusters/apps via sfctl, PowerShell, and EventStore APIs | | Deployment | L342-L402 | Deploying, upgrading, scaling, and migrating Service Fabric clusters and applications (managed, classic, standalone), including CI/CD, identities, networking, zones, and maintenance controls. | ### Troubleshooting | Topic | URL | |-------|-----| | Connect to Service Fabric managed clusters and handle SFX cert errors | https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-connect | | Troubleshoot SNAT port exhaustion in Service Fabric managed clusters | https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-troubleshoot-snat-port-exhaustion-issues | | Troubleshoot Azure Service Fabric application upgrade issues | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-application-upgrade-troubleshooting | | View and use Service Fabric container logs for diagnosis | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-containers-view-logs | | Troubleshoot common Service Fabric code package errors | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-diagnostics-code-package-errors | | Diagnose common monitoring and diagnostics scenarios in Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-diagnostics-common-scenarios | | Analyze Service Fabric events with Azure Monitor logs queries | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-diagnostics-event-analysis-oms | | Monitor and diagnose Service Fabric apps locally on Windows | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-diagnostics-how-to-monitor-and-diagnose-services-locally | | Monitor and diagnose Service Fabric apps locally on Linux | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-diagnostics-how-to-monitor-and-diagnose-services-locally-linux | | Report and inspect Service Fabric health from code | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-diagnostics-how-to-report-and-check-service-health | | Resolve common FabricClient exceptions in Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions | | Monitor Service Fabric Reliable Actors runtime diagnostics | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-actors-diagnostics | | Monitor Service Fabric ServiceRemoting with performance counters | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-serviceremoting-diagnostics | | Diagnose Stateful Reliable Services using Service Fabric diagnostics | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-services-diagnostics | | Diagnose Service Fabric reverse proxy request failures | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reverse-proxy-diagnostics | | Fix common local Service Fabric cluster setup issues | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-troubleshoot-local-cluster-setup | | Debug and collect logs for Java apps on local Service Fabric clusters | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-tutorial-debug-log-local-cluster | | Use Service Fabric system health reports to troubleshoot | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-understand-and-troubleshoot-with-system-health-reports | | Query and evaluate aggregated health in Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-view-entities-aggregated-health | ### Best Practices | Topic | URL | |-------|-----| | Best practices to migrate Cloud Services to Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/cloud-services-to-service-fabric-migration-guide | | Patch Windows OS on Azure Service Fabric clusters | https://learn.microsoft.com/en-us/azure/service-fabric/how-to-patch-cluster-nodes-windows | | Apply data serialization best practices for Service Fabric upgrades | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-application-upgrade-data-serialization | | Avoid invalid Service Fabric ARM cluster configurations | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-azure-resource-manager-guardrails | | Design Azure Service Fabric applications effectively | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-best-practices-applications | | Plan and scale Azure Service Fabric cluster capacity | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-best-practices-capacity-scaling | | Manage Service Fabric as code with ARM templates | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-best-practices-infrastructure-as-code | | Apply monitoring best practices for Azure Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-best-practices-monitoring | | Apply networking best practices for Azure Service Fabric clusters | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-best-practices-networking | | Configure stateful replica set size in Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-best-practices-replica-set-size-configuration | | Convert Cloud Services roles to Service Fabric stateless services | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-cloud-services-migration-worker-role-stateless-service | | Use automatic node repair in Service Fabric managed clusters | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-node-auto-repair | | Unit test stateful Service Fabric services effectively | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-concepts-unit-testing | | Design disaster recovery strategies for Azure Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-disaster-recovery | | Implement logging for .NET Service Fabric applications | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-how-to-diagnostics-log | | Unit test Service Fabric stateful services effectively | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-how-to-unit-test-stateful-services | | Use Service Fabric production readiness checklist | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-production-readiness-checklist | | Design and manage Reliable Actor state in Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-actors-access-save-remove-state | | Implement backup and restore for Service Fabric actors | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-actors-backup-and-restore | | Manually delete Reliable Actors and their state in Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-actors-delete-actors | | Define serializable types for Service Fabric actors | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-actors-notes-on-actor-type-serialization | | Choose and use timers vs reminders in Reliable Actors | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-actors-timers-reminders | | Plan and use Service Fabric Backup and Restore | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-services-backup-restore | | Apply best practices for Service Fabric Reliable Collections | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-services-reliable-collections-guidelines | | Avoid and handle throttling in Service Fabric Reliable Collections | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-services-reliable-collections-throttling-guidelines | | Configure transactions and locks in Reliable Collections | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-services-reliable-collections-transactions-locks | | Use ReliableConcurrentQueue for high-throughput messaging | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-services-reliable-concurrent-queue | | Use replica soft delete for Service Fabric data protection | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-replica-soft-delete | | Design and emit custom Service Fabric health reports | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-report-health | | Design and test Service Fabric service-to-service communication | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-testability-scenarios-service-communication | | Use Reliable Collections effectively in Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-work-with-reliable-collections | ### Decision Making | Topic | URL | |-------|-----| | Choose Azure migration targets for Cloud Services workloads | https://learn.microsoft.com/en-us/azure/service-fabric/cloud-services-migration-decision-matrix | | Use Ephemeral OS disks with Service Fabric managed clusters | https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-ephemeral-os-disks | | Choose and configure managed disk types for Service Fabric clusters | https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-managed-disk | | Deploy stateless node types in Service Fabric managed clusters | https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-stateless-node-type | | Estimate resource capacity for Service Fabric applications | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-capacity-planning | | Plan Service Fabric cluster capacity, durability, and reliability | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-capacity | | Choose between Service Fabric on Linux or Windows | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-linux-windows-differences | | Select supported Azure Service Fabric cluster versions | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-versions | ### Architecture & Design Patterns | Topic | URL | |-------|-----| | Design Service Fabric cross-AZ auxiliary replica rings | https://learn.microsoft.com/en-us/azure/service-fabric/advanced-fault-tolerance-availability-zone-rings | | Handle subclustered metrics balancing in Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/cluster-resource-manager-subclustering | | Use Azure API Management as gateway for Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-api-management-overview | | Configure service affinity patterns in Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-resource-manager-advanced-placement-rules-affinity | | Service Fabric Cluster Resource Manager architecture details | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-resource-manager-architecture | | Use defragmentation metrics strategy in Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-resource-manager-defragmentation-metrics | | Understand Service Fabric Cluster Resource Manager | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-resource-manager-introduction | | Integrate Cluster Resource Manager with Service Fabric management | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-resource-manager-management-integration | | Tune movement cost for Service Fabric services | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-resource-manager-movement-cost | | Apply networking patterns for Azure Service Fabric clusters | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-patterns-networking | ### Limits & Quotas | Topic | URL | |-------|-----| | Configure Service Fabric application upgrade parameters and timeouts | https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-application-upgrade-parameters | ### Security | Topic | URL | |-------|-----| | Manage X.509 certificates for Service Fabric clusters | https://learn.microsoft.com/en-us/azure/service-fabric/cluster-security-certificate-management | | Configure X.509 certificate authentication in Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/cluster-security-certificates | | Use managed identities with Azure Service Fabric | https://learn.microsoft.com/en-us/azure/service-fabric/concepts-managed-identity | | Enable managed identity token service on existing Service Fabric clusters | https://learn.microsoft.com/en-us/azure/service-fabric/configure-existing-cluster-enable-managed-identity-token-service | | Configure managed identity support for new Service Fabric clusters | https://learn.microsoft.com/en-us/azure/service-fabric/configure-new-azure-service-fabric-enable-managed-identity |