Creare il primo cluster autonomo di Service Fabric

È possibile creare un cluster autonomo di Service Fabric su qualsiasi macchina virtuale o computer che esegua Windows Server 2012 R2 o Windows Server 2016, locale o nel cloud. Questa guida introduttiva consente di creare un cluster di sviluppo autonomo in pochi minuti. Al termine si ottiene un cluster di tre nodi in esecuzione in un singolo computer nel quale è possibile distribuire app.

Prima di iniziare

Service Fabric offre un pacchetto di installazione per la creazione di cluster di Service Fabric autonomi. Scaricare il pacchetto di installazione. Decomprimere il pacchetto di installazione in una cartella nel computer o nella macchina virtuale in cui si configura il cluster di sviluppo. Il contenuto del pacchetto di installazione è descritto nei dettagli qui.

L'amministratore del cluster che distribuisce e configura il cluster deve avere privilegi di amministratore nel computer. Non è possibile installare Service Fabric in un controller di dominio.

Convalidare l'ambiente

Lo script TestConfiguration.ps1 nel pacchetto autonomo viene usato come Best Practices Analyzer per verificare se un cluster possa essere distribuito in un determinato ambiente. La preparazione della distribuzione elenca i prerequisiti e i requisiti dell'ambiente. Eseguire lo script per verificare se è possibile creare il cluster di sviluppo:

.\TestConfiguration.ps1 -ClusterConfigFilePath .\ClusterConfig.Unsecure.DevCluster.json

Creare il cluster

Con il pacchetto di installazione vengono installati diversi file di esempio per la configurazione del cluster. ClusterConfig.Unsecure.DevCluster.json è la configurazione del cluster più semplice: un cluster non sicuro, con tre nodi in esecuzione in un singolo computer. Altri file di configurazione descrivono cluster con una o più macchine virtuali protetti con la sicurezza di Windows o certificati X.509. Non è necessario modificare le impostazioni di configurazione predefinite per questa esercitazione, ma è consigliabile esaminare il file di configurazione per acquisire familiarità con le impostazioni. La sezione nodes descrive i tre nodi nel cluster, indicando nome, indirizzo IP, tipo di nodo, dominio di errore e dominio di aggiornamento. La sezione properties definisce le impostazioni per sicurezza, livello di affidabilità, raccolta di dati di diagnostica e tipi di nodi del cluster.

Questo cluster è senza protezione. Chiunque si può connettere in modo anonimo ed eseguire operazioni di gestione. È quindi necessario proteggere sempre i cluster di produzione usando certificati X.509 o la sicurezza di Windows. La sicurezza viene configurata solo in fase di creazione del cluster e non è possibile abilitare la sicurezza dopo la creazione del cluster. Vedere Proteggere un cluster per altre informazioni sulla sicurezza dei cluster di Service Fabric.

Per creare il cluster di sviluppo con tre nodi, eseguire lo script CreateServiceFabricCluster.ps1 da una sessione amministratore di PowerShell:

.\CreateServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.Unsecure.DevCluster.json -AcceptEULA

Il pacchetto di runtime di Service Fabric viene scaricato e installato automaticamente al momento della creazione del cluster.

Connettersi al cluster

Il cluster di sviluppo di tre nodi è ora in esecuzione. Il modulo ServiceFabric di PowerShell viene installato con il runtime. È possibile verificare che il cluster sia in esecuzione dallo stesso computer o da un computer remoto con il runtime di Service Fabric. Il cmdlet Connect-ServiceFabricCluster stabilisce una connessione al cluster.

Connect-ServiceFabricCluster -ConnectionEndpoint localhost:19000

Per altri esempi di connessione a un cluster, vedere Connettersi a un cluster sicuro. Dopo la connessione al cluster, usare il cmdlet Get-ServiceFabricNode per visualizzare un elenco dei nodi presenti nel cluster e informazioni di stato per ogni nodo. HealthState deve essere OK per ogni nodo.

PS C:\temp\Microsoft.Azure.ServiceFabric.WindowsServer> Get-ServiceFabricNode |Format-Table

NodeDeactivationInfo NodeName IpAddressOrFQDN NodeType  CodeVersion  ConfigVersion NodeStatus NodeUpTime NodeDownTime HealthState
-------------------- -------- --------------- --------  -----------  ------------- ---------- ---------- ------------ -----------
                     vm2      localhost       NodeType2 5.6.220.9494 0                     Up 00:03:38   00:00:00              OK
                     vm1      localhost       NodeType1 5.6.220.9494 0                     Up 00:03:38   00:00:00              OK
                     vm0      localhost       NodeType0 5.6.220.9494 0                     Up 00:02:43   00:00:00              OK

Visualizzare il cluster con Service Fabric Explorer

Service Fabric Explorer rappresenta un ottimo strumento per la visualizzazione del cluster e la gestione delle applicazioni. Service Fabric Explorer è un servizio in esecuzione nel cluster, cui si accede tramite un browser passando a http://localhost:19080/Explorer.

Il dashboard del cluster offre una panoramica del cluster, incluso un riepilogo dell'integrità delle applicazioni e dei nodi. La visualizzazione dei nodi mostra il layout fisico del cluster. Per un determinato nodo, è possibile esaminare le applicazioni con il codice distribuito in quel nodo.

Service Fabric Explorer

Rimuovere il cluster

Per rimuovere un cluster, eseguire lo script RemoveServiceFabricCluster.ps1 di Powershell dalla cartella del pacchetto e passare il percorso del file di configurazione JSON. Se necessario, è anche possibile specificare un percorso per il log del processo di eliminazione.

# Removes Service Fabric cluster nodes from each computer in the configuration file.
.\RemoveServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.Unsecure.DevCluster.json -Force

Per rimuovere il runtime di Service Fabric dal computer, eseguire lo script di PowerShell seguente dalla cartella del pacchetto.

# Removes Service Fabric from the current computer.
.\CleanFabric.ps1

Passaggi successivi

Ora che è stato configurato un cluster di sviluppo autonomo, vedere gli articoli seguenti: