|
| 1 | +--- |
| 2 | +title: Connect to a Service Fabric managed cluster |
| 3 | +description: Learn how to connect to a Service Fabric managed cluster |
| 4 | +ms.topic: how-to |
| 5 | +ms.date: 10/25/2021 |
| 6 | +--- |
| 7 | +# Connect to a Service Fabric managed cluster |
| 8 | + |
| 9 | +Once you have deployed a cluster via [Portal, Azure Resource Managed template](quickstart-managed-cluster-template.md), or [PowerShell](tutorial-managed-cluster-deploy.md) there are various ways to connect to and view your managed cluster. |
| 10 | + |
| 11 | +## Use Azure portal |
| 12 | + |
| 13 | +Navigate to your managed cluster resource by |
| 14 | + |
| 15 | + 1) Going to https://portal.azure.com/ |
| 16 | + |
| 17 | + 2) Navigate to your cluster resource by searching for Service Fabric and selecting "Service Fabric managed clusters" |
| 18 | + |
| 19 | + 3) Select your cluster |
| 20 | + |
| 21 | + 4) In this experience you can view and modify certain parameters. For more information see the [cluster configuration options](how-to-managed-cluster-configuration.md) available. |
| 22 | + |
| 23 | +## Use Service Fabric Explorer |
| 24 | + |
| 25 | +[Service Fabric Explorer](https://github.com/Microsoft/service-fabric-explorer) (SFX) is an application for inspecting and managing application and cluster health of a Microsoft Azure Service Fabric cluster. |
| 26 | + |
| 27 | +To navigate to SFX for your managed cluster |
| 28 | + |
| 29 | + 1) Going to https://portal.azure.com/ |
| 30 | + |
| 31 | + 2) Navigate to your cluster resource by searching for Service Fabric and selecting "Service Fabric managed clusters" |
| 32 | + |
| 33 | + 3) Select your cluster |
| 34 | + |
| 35 | + 4) Locate the `SF Explorer` located in the upper right, example: https://mycluster.region.cloudapp.azure.com:19080/Explorer |
| 36 | + |
| 37 | +## Use PowerShell Modules |
| 38 | + |
| 39 | +There following PowerShell Modules are available to connect, view, and modify configurations for your cluster. |
| 40 | + |
| 41 | +* Install the [Service Fabric SDK and PowerShell module](service-fabric-get-started.md). |
| 42 | + |
| 43 | +* Install [Azure PowerShell 4.7.0](/powershell/azure/release-notes-azureps#azservicefabric) (or later). |
| 44 | + |
| 45 | +### Using the Service Fabric PowerShell Module |
| 46 | +To use this module you'll need the cluster certificate thumbprint. You can find this value in the cluster properties output of your resource deployment or by querying the cluster properties on an existing resource. |
| 47 | + |
| 48 | +The following command can be used to query your cluster resource for the cluster certificate thumbprint. |
| 49 | + |
| 50 | +```powershell |
| 51 | +$serverThumbprint = (Get-AzResource -ResourceId /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ServiceFabric/managedclusters/mysfcluster).Properties.clusterCertificateThumbprints |
| 52 | +``` |
| 53 | + |
| 54 | +With the cluster certificate thumbprint, you're ready to connect to your cluster. |
| 55 | + |
| 56 | +```powershell |
| 57 | +$connectionEndpoint = "mysfcluster.eastus2.cloudapp.azure.com:19000" |
| 58 | +Connect-ServiceFabricCluster -ConnectionEndpoint $connectionEndpoint -KeepAliveIntervalInSec 10 ` |
| 59 | + -X509Credential ` |
| 60 | + -ServerCertThumbprint $serverThumbprint ` |
| 61 | + -FindType FindByThumbprint ` |
| 62 | + -FindValue $clientThumbprint ` |
| 63 | + -StoreLocation CurrentUser ` |
| 64 | + -StoreName My |
| 65 | +
|
| 66 | +``` |
| 67 | + |
| 68 | +### Using the Azure Service Fabric PowerShell Module |
| 69 | + |
| 70 | +Azure Service Fabric Module enables you to do operations like creating a managed cluster, scaling a node type, and viewing managed cluster resource information. The specific cmdlets supported for managed clusters are named `AzServiceFabricManagedCluster*` that you can reference on the [Az.ServiceFabric PowerShell Module](/powershell/module/az.servicefabric/) documentation. |
| 71 | + |
| 72 | + |
| 73 | +The following example uses one of the cmdlets to view the details of a managed cluster. |
| 74 | + |
| 75 | +```powershell |
| 76 | +$rgName = "testResourceGroup" |
| 77 | +$clusterName = "mycluster" |
| 78 | +Get-AzServiceFabricManagedCluster -ResourceGroupName $rgName -Name $clusterName |
| 79 | +``` |
| 80 | + |
| 81 | +## Next steps |
| 82 | + |
| 83 | +* [Deploy an application to a managed cluster using Azure Resource Manager](how-to-managed-cluster-app-deployment-template.md) |
| 84 | +* [Configure managed cluster options](how-to-managed-cluster-configuration.md) |
| 85 | + |
| 86 | + |
| 87 | + |
0 commit comments