Create Azure Service Fabric target command

Last updated 2023-03-30T20:05:29.4308064+00:00

Azure Service Fabric

Command: New-OctopusAzureServiceFabricTarget

Parameter	Value
`-name`	Name for the Octopus deployment target
`-azureConnectionEndpoint`	Connection endpoint for the Service Fabric Cluster
`-azureSecurityMode`	Security mode, use one of the aliases in the table below
`-azureCertificateThumbprint`	Certificate thumbprint of the Azure Certificate
`-azureActiveDirectoryUsername`	Username for accessing the Service Fabric Cluster
`-azureActiveDirectoryPassword`	Password for accessing the Service Fabric Cluster
`-certificateStoreLocation`	(Optional) Override the default certificate store location
`-certificateStoreName`	(Optional) Override the default certificate store name
`-octopusCertificateIdOrName`	Name or Id of the Certificate Resource in Octopus
`-octopusRoles`	Comma separated list of Roles to assign
`-updateIfExisting`	Will update an existing Service Fabric target with the same name, create if it doesn't exist
`-octopusDefaultWorkerPoolIdOrName`	Name or Id of the Worker Pool for the deployment target to use. (Optional). Added in 2020.6.0.

Security Mode Options

Mode	Aliases
Unsecure	`unsecure`
Secure Client Certificate	`certificate` `clientcertificate` `secureclientcertificate`
Secure Azure Active Directory	`aad` `azureactivedirectory`

Examples:

# Unsecure
New-OctopusAzureServiceFabricTarget -name "My Service Fabric Target 1" `
                                    -azureConnectionEndpoint "connectionEndpoint" `
                                    -azureSecurityMode "unsecure" `
                                    -octopusRoles "ServiceFabricRole" `
                                    -updateIfExisting

# Client Certificate
New-OctopusAzureServiceFabricTarget -name "My Service Fabric Target 2" `
                                    -azureConnectionEndpoint "connectionEndpoint" `
                                    -azureSecurityMode "certificate" `
                                    -azureCertificateThumbprint "1234567890" `
                                    -octopusCertificateIdOrName "My Service Fabric Certificate" `
                                    -octopusRoles "Service Fabric Role"

# Client Certificate overriding certificate store
New-OctopusAzureServiceFabricTarget -name "My Service Fabric Target 3" `
                                    -azureConnectionEndpoint "https://localhost" `
                                    -azureSecurityMode "certificate" `
                                    -azureCertificateThumbprint "1234" `
                                    -certificateStoreLocation "Custom Store Location" `
                                    -certificateStoreName "My Store Name" `
                                    -octopusCertificateIdOrName "cert" `
                                    -octopusRoles "sfrole"

# Azure Active Directory
New-OctopusAzureServiceFabricTarget -name "My Service Fabric Target 4" `
                                   -azureConnectionEndpoint "connectionEndpoint" `
                                   -azureSecurityMode  "azureactivedirectory" `
                                   -azureCertificateThumbprint "1234567890" `
                                   -octopusCertificateIdOrName "cert" `
                                   -octopusRoles "Service Fabric Role"

If your process creates dynamic deployment targets from a script, and then deploys to those targets in a subsequent step, make sure you add a full health check step for the role of the newly created targets after the step that creates and registers the targets.

This allows Octopus to ensure the new targets are ready for deployment by staging packages required by subsequent steps that perform the deployment.

Need support? We're here to help.