azure-service-fabric

name	azure-service-fabric
description	Expert knowledge for Azure Service Fabric development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when designing Service Fabric clusters, Reliable Services/Actors, reverse proxy/API gateways, backup/restore, or CI/CD, and other Azure Service Fabric related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Container Apps (use azure-container-apps), Azure App Service (use azure-app-service), Azure Cloud Services (use azure-cloud-services).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-02","generator":"docs2skills/1.0.0"}

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

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 for planning and sizing Service Fabric clusters: OS/disk choices, stateless node types, capacity/durability/reliability planning, version selection, and migration targets.
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/apps: cert and Entra auth, managed identities and secrets, disk encryption, network/DDoS/IP policies, remoting/endpoint security, and security best practices.
Configuration	L183-L302	Configuring and operating Service Fabric clusters and apps: networking, scaling, backup/restore, manifests, actors, containers, monitoring/telemetry, resource governance, and test/fault tools.
Integrations & Coding Patterns	L303-L339	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	L340-L401	Deploying and upgrading Service Fabric clusters and apps (managed, classic, standalone), scaling and AZ/region migration, CI/CD pipelines, security, images, and maintenance/upgrade control.

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

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

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

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
Deploy Service Fabric applications with system-assigned managed identity	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-deploy-service-fabric-application-system-assigned-managed-identity
Grant Service Fabric app managed identity access to Azure resources	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-grant-access-other-resources
Configure Service Fabric applications with managed identity on managed clusters	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-application-managed-identity
Manage and deploy application secrets in Service Fabric managed clusters	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-application-secrets

Configuration

Topic	URL
Use Service Fabric Backup Explorer on local backups	https://learn.microsoft.com/en-us/azure/service-fabric/backup-explorer
Configure container registry credentials in Service Fabric	https://learn.microsoft.com/en-us/azure/service-fabric/configure-container-repository-credentials
Configure container image management in Service Fabric	https://learn.microsoft.com/en-us/azure/service-fabric/container-image-management
Configure Azure Load Balancer rules for Service Fabric clusters	https://learn.microsoft.com/en-us/azure/service-fabric/create-load-balancer-rule
Disable and enable Service Fabric services (scale to zero)	https://learn.microsoft.com/en-us/azure/service-fabric/disable-enable-service
Configure ARM-based app deployment to Service Fabric managed clusters	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-app-deployment-template
Integrate Azure Application Gateway with Service Fabric managed clusters	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-application-gateway
Configure autoscaling policies for Service Fabric managed clusters	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-autoscale
Configure Azure Service Fabric managed cluster settings	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-configuration
Deploy Service Fabric managed clusters with a subnet per node type	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-deploy-with-subnet-per-nodetype

Integrations & Coding Patterns

Topic	URL
Use managed identity in Service Fabric application code to access Azure services	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-managed-identity-service-fabric-app-code
Use managed identity in Service Fabric application code	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-identity-service-fabric-app-code
Manage Service Fabric with Azure CLI and sfctl	https://learn.microsoft.com/en-us/azure/service-fabric/samples-cli
Connect and communicate with Service Fabric services	https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-connect-and-communicate-with-services
Query Service Fabric EventStore APIs for cluster events	https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-diagnostics-eventstore-query
Containerize and deploy .NET apps to Service Fabric with Azure SQL	https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-host-app-in-a-container
Generate and use Service Fabric Java client APIs from REST spec	https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-java-rest-api-usage
Migrate Service Fabric Java apps from SDK to Maven dependencies	https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-migrate-old-javaapp-to-use-maven
Use PowerShell to manage Service Fabric clusters	https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-powershell-samples
Enumerate Reliable Actors and metadata in Service Fabric	https://learn.microsoft.com/en-us/azure/service-fabric/service-fabric-reliable-actors-enumerate

Deployment

Topic	URL
Deploy custom Windows images to Service Fabric managed clusters	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-deploy-custom-image
Deploy Service Fabric apps with user-assigned managed identity	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-deploy-service-fabric-application-user-assigned-managed-identity
Deploy Service Fabric managed clusters across Availability Zones	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-availability-zones
Add Azure Dedicated Hosts to Service Fabric managed clusters	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-dedicated-hosts
Enable coordinated Safe Deployment Process on Service Fabric managed clusters	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-enable-safe-deployment-process
Configure maintenance control windows for Service Fabric managed clusters	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-maintenance-control
Manage runtime upgrades for Service Fabric managed clusters	https://learn.microsoft.com/en-us/azure/service-fabric/how-to-managed-cluster-upgrades
Migrate Service Fabric clusters to availability zone support	https://learn.microsoft.com/en-us/azure/service-fabric/migrate-service-fabric-availability-zones
Deploy a classic Service Fabric cluster via portal	https://learn.microsoft.com/en-us/azure/service-fabric/quickstart-classic-cluster-portal
Create a Service Fabric cluster using Bicep