Esercitazione: Installare e creare cluster di Service Fabric

2024-08-24

I cluster autonomi di Service Fabric offrono la possibilità di scegliere il proprio ambiente e creare un cluster come parte dell'approccio "qualsiasi sistema operativo, qualsiasi cloud" adottato da Service Fabric. In questa serie di esercitazioni viene creato un cluster autonomo ospitato in AWS o Azure e viene installata un'applicazione al suo interno.

Questa è la seconda di una serie di esercitazioni. Questa esercitazione illustra la procedura di creazione di un cluster autonomo di Service Fabric.

In questo articolo si apprenderà come:

Scaricare e installare il pacchetto autonomo di Service Fabric
Creare il cluster di Service Fabric
Connettersi al cluster di Service Fabric

Scaricare il pacchetto Service Fabric per Windows Server

Service Fabric offre un pacchetto di installazione per la creazione di cluster di Service Fabric autonomi. Scaricare il pacchetto di installazione nel computer locale. Dopo che è stato scaricato correttamente, copiarlo al posto della connessione RDP alla macchina virtuale e incollarlo nel desktop.

Selezionare il file con estensione zip e aprire il menu di scelta rapida, quindi selezionare Estrai tutto>Estrai. Mentre si estraggono i file, viene generata una cartella sul desktop che corrisponde al nome del file con estensione zip.

È possibile trovare altri dettagli sui contenuti del pacchetto di installazione.

Definire il file di configurazione

Si sta compilando un cluster Windows a tre nodi, pertanto è necessario modificare il file ClusterConfig.Unsecure.MultiMachine.json.

Successivamente, aggiornare le tre righe ipAddress 8, 15 e 22 nel file, impostandole sugli indirizzi IP di ogni istanza.

Dopo l'aggiornamento, i nodi vengono visualizzati come segue:

{
  "nodeName": "vm0",
  "ipAddress": "172.31.27.1",
  "nodeTypeRef": "NodeType0",
  "faultDomain": "fd:/dc1/r0",
  "upgradeDomain": "UD0"
}

È quindi necessario aggiornare un paio delle proprietà. Alla riga 34 è necessario modificare la stringa di connessione per l'archivio di diagnostica, che dovrebbe avere l'aspetto seguente "connectionstring": "C:\\ProgramData\\SF\\DiagnosticsStore"

Infine, nella sezione nodeTypes della configurazione aggiungere una nuova sezione per eseguire il mapping delle porte temporanee che verranno usate da Windows. Il file di configurazione deve avere un aspetto simile al seguente:

"applicationPorts": {
    "startPort": "20001",
    "endPort": "20031"
},
"ephemeralPorts": {
    "startPort": "20606",
    "endPort": "20861"
},
"isPrimary": true

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:

cd .\Desktop\Microsoft.Azure.ServiceFabric.WindowsServer.6.2.274.9494\
.\TestConfiguration.ps1 -ClusterConfigFilePath .\ClusterConfig.Unsecure.MultiMachine.json

Verrà visualizzato un output simile all'esempio seguente. Se per il 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:\Users\Administrator\Desktop\Microsoft.Azure.ServiceFabric.WindowsServer.6.2.274.9494\DeploymentTraces
Running Best Practices Analyzer...
Best Practices Analyzer completed successfully.


LocalAdminPrivilege        : True
IsJsonValid                : True
IsCabValid                 :
RequiredPortsOpen          : True
RemoteRegistryAvailable    : True
FirewallAvailable          : True
RpcCheckPassed             : True
NoConflictingInstallations : True
FabricInstallable          : True
DataDrivesAvailable        : True
NoDomainController         : True
Passed                     : True

Creare il cluster

Dopo aver convalidato correttamente la configurazione del cluster, eseguire lo script CreateServiceFabricCluster.ps1 per distribuire il cluster di Service Fabric nelle macchine virtuali nel file di configurazione.

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

Se tutto funziona correttamente, si riceverà un output simile al seguente:

Your cluster is successfully created! You can connect and manage your cluster using Microsoft Azure Service Fabric Explorer or PowerShell. To connect through PowerShell, run 'Connect-ServiceFabricCluster [ClusterConnectionEndpoint]'.

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à.

Aprire 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.

Passaggi successivi

In questo articolo si è appreso come caricare grandi quantità di dati casuali in parallelo in un account di archiviazione, ad esempio come:

Configurare la stringa di connessione
Compilare l'applicazione
Eseguire l'applicazione
Convalidare il numero di connessioni

Passare alla terza parte della serie per installare un'applicazione nel cluster che è stato creato.

Installare l'applicazione nel cluster di Service Fabric