Creare un cluster autonomo in esecuzione su Windows Server

Azure Service Fabric consente di creare cluster Service Fabric su qualsiasi macchina virtuale o computer che esegue Windows Server. In questo modo è possibile distribuire ed eseguire applicazioni di Service Fabric in qualsiasi ambiente che contenga un set di computer Windows Server interconnessi, in locale o con qualsiasi provider di cloud. Service Fabric offre un pacchetto di installazione per la creazione di cluster di Service Fabric, denominato pacchetto autonomo per Windows Server.

Questo articolo illustra la procedura di creazione di un cluster autonomo di Service Fabric.

Nota

Questo pacchetto autonomo di Windows Server è disponibile in commercio e può essere usato per distribuzioni di produzione. Il pacchetto può contenere nuove funzionalità di Service Fabric in "Anteprima". Scorrere verso il basso fino alla sezione "Funzionalità di anteprima incluse in questo pacchetto". per visualizzare l'elenco delle funzionalità in anteprima. È possibile scaricare una copia del contratto di licenza ora.

Ottenere supporto per il pacchetto Service Fabric per Windows Server

Scaricare il pacchetto Service Fabric per Windows Server

Per creare il cluster usare il pacchetto Service Fabric per Windows Server (Windows Server 2012 R2 e versioni successive) disponibile qui:
Collegamento per il download - Pacchetto autonomo di Service Fabric - Windows Server

Informazioni dettagliate sul contenuto del pacchetto sono disponibili qui.

Il pacchetto di runtime di Service Fabric viene scaricato automaticamente al momento della creazione del cluster. Se si esegue la distribuzione da un computer non connesso a Internet, scaricare il pacchetto di runtime fuori banda da qui:
Collegamento per il download - Runtime di Service Fabric - Windows Server

Trovare esempi di configurazione di cluster autonomi in:
Esempi di configurazione di cluster autonomi

Creare il cluster

Service Fabric può essere distribuito in un cluster di sviluppo macchine usando il file ClusterConfig.Unsecure.DevCluster.json file incluso negli esempi.

Decomprimere il pacchetto autonomo nella macchina, copiare il file di configurazione di esempio nella macchina locale, quindi eseguire lo script CreateServiceFabricCluster.ps1 tramite una sessione di PowerShell come amministratore, dalla cartella del pacchetto autonomo:

Passaggio 1A: creare un cluster di sviluppo locale non protetto

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

Per informazioni dettagliate sulla risoluzione dei problemi, vedere la sezione Configurazione dell'ambiente in Pianificare e preparare la distribuzione del cluster.

Al termine dell'esecuzione degli scenari di sviluppo è possibile rimuovere il cluster Service Fabric dalla macchina facendo riferimento alla procedura della sezione "Rimuovere un cluster".

Passaggio 1B: creare un cluster con più macchine

Dopo avere eseguito i passaggi di pianificazione e preparazione illustrati nel collegamento seguente, si è pronti per creare il cluster di produzione usando il file di configurazione del cluster.
Pianificare e preparare la distribuzione del cluster

  1. Convalidare il file di configurazione scritto eseguendo lo script TestConfiguration.ps1 nella cartella del pacchetto autonomo:

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

    Verrà visualizzato un output simile al seguente: Se nel campo in basso "Passed" viene restituito un valore "True", sono stati superati i controlli di integrità ed è possibile distribuire il cluster in base alla configurazione di input.

    Trace folder already exists. Traces will be written to existing trace folder: C:\temp\Microsoft.Azure.ServiceFabric.WindowsServer\DeploymentTraces
    Running Best Practices Analyzer...
    Best Practices Analyzer completed successfully.
    
    LocalAdminPrivilege        : True
    IsJsonValid                : True
    IsCabValid                 : True
    RequiredPortsOpen          : True
    RemoteRegistryAvailable    : True
    FirewallAvailable          : True
    RpcCheckPassed             : True
    NoConflictingInstallations : True
    FabricInstallable          : True
    Passed                     : True
    
  2. Creare il cluster: eseguire lo script CreateServiceFabricCluster.ps1 per la distribuzione del cluster Service Fabric in ogni computer nella configurazione.

    .\CreateServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.json -AcceptEULA
    
Nota

Le tracce di distribuzione vengono scritte nella VM o nel computer in cui è stato eseguito lo script PowerShell CreateServiceFabricCluster.ps1. Sono disponibili nella sottocartella DeploymentTraces all'interno della directory da cui è stato eseguito lo script. Per verificare se Service Fabric è stato distribuito correttamente in un computer, individuare i file installati nella directory FabricDataRoot, come descritto in dettaglio nella sezione FabricSetting del file di configurazione del cluster. Per impostazione predefinita la directory è c:\ProgramData\SF. I processi FabricHost.exe e Fabric.exe possono essere visualizzati in esecuzione in Gestione attività.

Passaggio 1C: Creare un cluster offline (non connesso a Internet)

Il pacchetto di runtime di Service Fabric viene scaricato automaticamente al momento della creazione del cluster. Quando si distribuisce un cluster a computer non connessi a Internet è necessario scaricare il pacchetto di runtime di Service Fabric separatamente e specificare il percorso del pacchetto al momento della creazione del cluster. Il pacchetto di runtime può essere scaricato separatamente da un altro computer connesso a Internet in Collegamento per il download - Service Fabric Runtime (Runtime di Service Fabric) - Windows Server. Copiare il pacchetto di runtime nella posizione da cui si intende distribuire il cluster offline eseguendo CreateServiceFabricCluster.ps1 con il parametro -FabricRuntimePackagePath incluso, come illustrato di seguito:

.\CreateServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.json -FabricRuntimePackagePath .\MicrosoftAzureServiceFabric.cab

dove .\ClusterConfig.json e .\MicrosoftAzureServiceFabric.cab sono rispettivamente i percorsi per la configurazione del cluster e per il file di runtime con estensione cab.

Passaggio 2: connettersi al cluster

Per connettersi a un cluster protetto, vedere la sezione relativa alla connessione di Service Fabric a un cluster protetto.

Per connettersi a un cluster non protetto, eseguire il seguente comando di PowerShell:

Connect-ServiceFabricCluster -ConnectionEndpoint <*IPAddressofaMachine*>:<Client connection end point port>

Esempio:

Connect-ServiceFabricCluster -ConnectionEndpoint 192.13.123.2345:19000

Passaggio 3: Visualizzare Service Fabric Explorer

È ora possibile connettersi al cluster con Service Fabric Explorer direttamente da uno dei computer con http://localhost:19080/Explorer/index.html o in modalità remota con http://<IPAddressofaMachine>:19080/Explorer/index.html.

Aggiungere e rimuovere ruoli

È possibile aggiungere o rimuovere nodi nel cluster di Service Fabric autonomo al variare delle esigenze aziendali. Per i passaggi dettagliati, leggere le informazioni su aggiunta e rimozione di nodi in un cluster Service Fabric autonomo.

Rimuovere un 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.

Questo script può essere eseguito su qualsiasi macchina con accesso amministrativo a tutte le macchine elencate come nodi nel file di configurazione del cluster. La macchina in cui viene eseguito lo script non deve necessariamente far parte del cluster.

# Removes Service Fabric from each machine in the configuration
.\RemoveServiceFabricCluster.ps1 -ClusterConfigFilePath .\ClusterConfig.json -Force
# Removes Service Fabric from the current machine
.\CleanFabric.ps1

Dati di telemetria raccolti e come rifiutarli esplicitamente

Per impostazione predefinita, il prodotto raccoglie i dati di telemetria sull'utilizzo di Service Fabric per migliorarlo. Best Practice Analyzer, che viene eseguito durante la configurazione, controlla la connettività a https://vortex.data.microsoft.com/collect/v1. Se non è raggiungibile, la configurazione non riesce, a meno che non si rifiutino esplicitamente i dati di telemetria.

  1. La pipeline di telemetria cerca di caricare i dati seguenti in https://vortex.data.microsoft.com/collect/v1 una volta al giorno. Si tratta di un tentativo di caricamento che non influisce sulla funzionalità del cluster. I dati di telemetria vengono inviati solo dal nodo che esegue la gestione failover primaria. Nessun altro nodo invia dati di telemetria.
  2. La telemetria è costituita dagli elementi seguenti:
  • Numero di servizi
  • Numero di elementi ServiceTypes
  • Numero di elementi Applications
  • Numero di elementi ApplicationUpgrades
  • Numero di elementi FailoverUnits
  • Numero di elementi InBuildFailoverUnits
  • Numero di elementi UnhealthyFailoverUnits
  • Numero di elementi Replicas
  • Numero di elementi InBuildReplicas
  • Numero di elementi StandByReplicas
  • Numero di elementi OfflineReplicas
  • CommonQueueLength
  • QueryQueueLength
  • FailoverUnitQueueLength
  • CommitQueueLength
  • Numero di elementi Nodes
  • IsContextComplete: True/False
  • ClusterId: GUID generato casualmente per ogni cluster
  • ServiceFabricVersion
  • Indirizzo IP della macchina virtuale o del computer da cui vengono caricati i dati di telemetria

Per disabilitare la telemetria, aggiungere quanto segue all'elemento properties nel file di configurazione del cluster enableTelemetry: false.

Funzionalità di anteprima incluse in questo pacchetto

Nessuna.

Nota

A partire dalla nuova versione GA del cluster autonomo per Windows Server (versione 5.3.204.x) è possibile aggiornare il cluster per le versioni future, manualmente o automaticamente. Per informazioni dettagliate, vedere Aggiornare il cluster autonomo di Service Fabric in Windows Server.

Passaggi successivi