Knooppunten toevoegen aan of verwijderen uit een zelfstandig Service Fabric-cluster dat wordt uitgevoerd op Windows Server

Artikel
10/15/2024

Nadat u uw zelfstandige Service Fabric-cluster op Windows Server-computers hebt gemaakt, kunnen uw (zakelijke) behoeften veranderen en moet u knooppunten toevoegen aan of verwijderen uit uw cluster, zoals beschreven in dit artikel.

Notitie

De functionaliteit voor het toevoegen en verwijderen van knooppunten wordt niet ondersteund in lokale ontwikkelclusters.

Knooppunten toevoegen aan uw cluster

Bereid de VM/machine voor die u aan uw cluster wilt toevoegen door de stappen te volgen die worden beschreven in Plan en bereid uw Service Fabric-clusterimplementatie voor.
Bepaal aan welk foutdomein en upgradedomein u deze VM/machine gaat toevoegen.

Als u certificaten gebruikt om het cluster te beveiligen, worden certificaten naar verwachting geïnstalleerd in de lokale certificaatarchieven ter voorbereiding op het knooppunt om lid te worden van het cluster. Het analoge is van toepassing bij het gebruik van andere vormen van beveiliging.
Extern bureaublad (RDP) in de VM/machine die u wilt toevoegen aan het cluster.
Kopieer of download het zelfstandige pakket voor Service Fabric voor Windows Server naar de VM/machine en pak het pakket uit.
Voer PowerShell uit met verhoogde bevoegdheden en ga naar de locatie van het uitgepakte pakket.
Voer het addNode.ps1-script uit met de parameters die het nieuwe knooppunt beschrijven dat moet worden toegevoegd. In het volgende voorbeeld wordt een nieuw knooppunt met de naam VM5 toegevoegd, met het type NodeType0 en IP-adres 182.17.34.52, in UD1 en fd:/dc1/r0. ExistingClusterConnectionEndPoint is een verbindingseindpunt voor een knooppunt dat zich al in het bestaande cluster bevindt. Dit kan het IP-adres zijn van elk knooppunt in het cluster.

Onbeveiligd (prototypen):
```
.\AddNode.ps1 -NodeName VM5 -NodeType NodeType0 -NodeIPAddressorFQDN 182.17.34.52 -ExistingClientConnectionEndpoint 182.17.34.50:19000 -UpgradeDomain UD1 -FaultDomain fd:/dc1/r0 -AcceptEULA
```
Beveiligd (op basis van certificaten):
```
$CertThumbprint= "***********************"

.\AddNode.ps1 -NodeName VM5 -NodeType NodeType0 -NodeIPAddressorFQDN 182.17.34.52 -ExistingClientConnectionEndpoint 182.17.34.50:19000 -UpgradeDomain UD1 -FaultDomain fd:/dc1/r0 -X509Credential -ServerCertThumbprint $CertThumbprint  -AcceptEULA
```
Wanneer het script is uitgevoerd, kunt u controleren of het nieuwe knooppunt is toegevoegd door de cmdlet Get-ServiceFabricNode uit te voeren.
Als u consistentie tussen verschillende knooppunten in het cluster wilt garanderen, moet u een configuratie-upgrade starten. Voer Get-ServiceFabricClusterConfiguration uit om het meest recente configuratiebestand op te halen en voeg het zojuist toegevoegde knooppunt toe aan de sectie Knooppunten. Het wordt ook aanbevolen om altijd de meest recente clusterconfiguratie beschikbaar te hebben voor het geval u een cluster met dezelfde configuratie opnieuw moet implementeren.
```
{
    "nodeName": "vm5",
    "iPAddress": "182.17.34.52",
    "nodeTypeRef": "NodeType0",
    "faultDomain": "fd:/dc1/r0",
    "upgradeDomain": "UD1"
}
```
Voer Start-ServiceFabricClusterConfigurationUpgrade uit om de upgrade te starten.
```
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
```
U kunt de voortgang van de upgrade in Service Fabric Explorer controleren. U kunt ook Get-ServiceFabricClusterUpgrade uitvoeren.

Knooppunten toevoegen aan clusters die zijn geconfigureerd met Windows-beveiliging met gMSA

Voor clusters die zijn geconfigureerd met een groep beheerd serviceaccount (gMSA)(https://technet.microsoft.com/library/hh831782.aspx), kan een nieuw knooppunt worden toegevoegd met behulp van een configuratie-upgrade:

Voer Get-ServiceFabricClusterConfiguration uit op een van de bestaande knooppunten om het meest recente configuratiebestand op te halen en voeg details toe over het nieuwe knooppunt dat u wilt toevoegen in de sectie Knooppunten. Zorg ervoor dat het nieuwe knooppunt deel uitmaakt van hetzelfde door de groep beheerde account. Dit account moet een beheerder zijn op alle computers.
```
{
    "nodeName": "vm5",
     "iPAddress": "182.17.34.52",
     "nodeTypeRef": "NodeType0",
     "faultDomain": "fd:/dc1/r0",
     "upgradeDomain": "UD1"
}
```
Voer Start-ServiceFabricClusterConfigurationUpgrade uit om de upgrade te starten.
```
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
```
U kunt de voortgang van de upgrade in Service Fabric Explorer controleren. U kunt ook Get-ServiceFabricClusterUpgrade uitvoeren

Knooppunttypen toevoegen aan uw cluster

Als u een nieuw knooppunttype wilt toevoegen, wijzigt u de configuratie zodat het nieuwe knooppunttype wordt opgenomen in de sectie 'NodeTypes' onder 'Eigenschappen' en begint u een configuratie-upgrade met start-ServiceFabricClusterConfigurationUpgrade. Zodra de upgrade is voltooid, kunt u nieuwe knooppunten toevoegen aan uw cluster met dit knooppunttype.

Knooppunten verwijderen uit uw cluster

Een knooppunt kan op de volgende manier worden verwijderd uit een cluster met behulp van een configuratie-upgrade:

Voer Get-ServiceFabricClusterConfiguration uit om het meest recente configuratiebestand op te halen en verwijder het knooppunt uit de sectie Knooppunten. Voeg de parameter NodesToBeRemoved toe aan de sectie Setup in de sectie FabricSettings. De 'waarde' moet een door komma's gescheiden lijst zijn met knooppuntnamen van knooppunten die moeten worden verwijderd.

 "fabricSettings": [
     {
     "name": "Setup",
     "parameters": [
         {
         "name": "FabricDataRoot",
         "value": "C:\\ProgramData\\SF"
         },
         {
         "name": "FabricLogRoot",
         "value": "C:\\ProgramData\\SF\\Log"
         },
         {
         "name": "NodesToBeRemoved",
         "value": "vm0, vm1"
         }
     ]
     }
 ]

Voer Start-ServiceFabricClusterConfigurationUpgrade uit om de upgrade te starten.
```
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
```
U kunt de voortgang van de upgrade in Service Fabric Explorer controleren. U kunt ook Get-ServiceFabricClusterUpgrade uitvoeren.

Notitie

Het verwijderen van knooppunten kan meerdere upgrades initiëren. Sommige knooppunten zijn gemarkeerd met IsSeedNode=”true” tag en kunnen worden geïdentificeerd door een query uit te voeren op het clustermanifest met behulp van Get-ServiceFabricClusterManifest. Het verwijderen van dergelijke knooppunten kan langer duren dan andere, omdat de seed-knooppunten in dergelijke scenario's moeten worden verplaatst. Het cluster moet minimaal 3 primaire knooppuntknooppunten onderhouden.

Knooppunttypen verwijderen uit uw cluster

Controleer voordat u een knooppunttype verwijdert of er knooppunten zijn die naar het knooppunttype verwijzen. Verwijder deze knooppunten voordat u het bijbehorende knooppunttype verwijdert. Zodra alle bijbehorende knooppunten zijn verwijderd, kunt u het NodeType uit de clusterconfiguratie verwijderen en een configuratie-upgrade starten met start-ServiceFabricClusterConfigurationUpgrade.

Primaire knooppunten van uw cluster vervangen

De vervanging van primaire knooppunten moet na een ander knooppunt worden uitgevoerd, in plaats van te verwijderen en vervolgens toe te voegen aan batches.

Share via