Azure Service Fabric

This section contains resources for using Octopus to deploy your Azure Service Fabric applications. We assume you already have a Service Fabric cluster set up in Azure. If you don’t yet, check out Microsoft’s documentation on getting started with Azure Service Fabric

Service Fabric Deployment Targets in Octopus

Octopus provides a built in Deployment Target for Azure Service Fabric clusters. Check out this page for help setting up and configuring your target.


Learn how to package a Service Fabric application for use with Octopus Deploy.

Step Templates

Octopus comes with two built-in step templates facilitating deployment and management of Azure Service Fabric apps.

Security modes

Both step template types above require an authorized connection to a cluster.

Octopus provides two options for connecting to Service Fabric clusters securely:

  1. Using Client Certificates.
  2. Using Azure Active Directory.


Individual applications in a Service Fabric cluster have their own version numbers while the entire clustered app has a separate version number independent of its constituent parts. Octopus does not enforce a particular process for managing application/service versions. Learn more about using Octopus Deploy to automate updates to the application/service versions.

Overwrite vs rolling upgrades

The default behavior of the Service Fabric deployments is to overwrite an existing application. What this means is that if the application already exists in the cluster it will be removed first and the redeployed (you’ll see it using RegisterAndCreate in the logs).

The alternative approach is to use rolling deployments. To use this, add the following line to your publish profile in the source

<UpgradeDeployment Enabled="true" />

It will then update each node in turn with the new version (you’ll see it using RegisterAndUpgrade in the logs).

Help us continuously improve

Please let us know if you have any feedback about this page.

Send feedback

Page updated on Sunday, January 1, 2023