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

  • Artikel

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

Knooppunten toevoegen aan uw cluster

  1. Bereid de VM/machine voor die u aan uw cluster wilt toevoegen door de stappen te volgen die worden beschreven in De implementatie van uw Service Fabric-cluster plannen en voorbereiden.

  2. Bepaal aan welk foutdomein en welk 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 toevoegen van het knooppunt aan het cluster. De analoge is van toepassing bij het gebruik van andere vormen van beveiliging.

  3. Extern bureaublad (RDP) op de VM/machine die u aan het cluster wilt toevoegen.

  4. Kopieer of download het zelfstandige pakket voor Service Fabric voor Windows Server naar de VM/machine en pak het pakket uit.

  5. Voer PowerShell uit met verhoogde bevoegdheden en ga naar de locatie van het uitgepakte pakket.

  6. Voer het AddNode.ps1-script uit met de parameters die het nieuwe knooppunt beschrijven dat u wilt toevoegen. In het volgende voorbeeld wordt een nieuw knooppunt met de naam VM5, met het type NodeType0 en IP-adres 182.17.34.52, toegevoegd aan 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 (prototype):

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

  7. Om consistentie tussen verschillende knooppunten in het cluster te 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 wilt implementeren.

    {
    "nodeName": "vm5",
    "iPAddress": "182.17.34.52",
    "nodeTypeRef": "NodeType0",
    "faultDomain": "fd:/dc1/r0",
    "upgradeDomain": "UD1"
}

  8. Voer Start-ServiceFabricClusterConfigurationUpgrade uit om de upgrade te starten.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

    U kunt de voortgang van de upgrade controleren op Service Fabric Explorer. U kunt ook Get-ServiceFabricClusterUpgrade uitvoeren.

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

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

  1. Voer Get-ServiceFabricClusterConfiguration uit op een van de bestaande knooppunten om het meest recente configuratiebestand op te halen en details toe te voegen 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"
}

  2. Voer Start-ServiceFabricClusterConfigurationUpgrade uit om de upgrade te starten.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

    U kunt de voortgang van de upgrade controleren op Service Fabric Explorer. U kunt ook Get-ServiceFabricClusterUpgrade uitvoeren

Knooppunttypen toevoegen aan uw cluster

Als u een nieuw knooppunttype wilt toevoegen, wijzigt u de configuratie door het nieuwe knooppunttype op te nemen in de sectie 'NodeTypes' onder 'Properties' en start u een configuratie-upgrade met start-ServiceFabricClusterConfigurationUpgrade. Zodra de upgrade is voltooid, kunt u nieuwe knooppunten toevoegen aan uw cluster met dit knooppunttype.

Knooppunten uit uw cluster verwijderen

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

  1. Voer Get-ServiceFabricClusterConfiguration uit om het meest recente configuratiebestand op te halen en het knooppunt te verwijderen 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"
         }
     ]
     }
 ]

  2. Voer Start-ServiceFabricClusterConfigurationUpgrade uit om de upgrade te starten.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

    U kunt de voortgang van de upgrade controleren op Service Fabric Explorer. U kunt ook Get-ServiceFabricClusterUpgrade uitvoeren.

Notitie

Het verwijderen van knooppunten kan leiden tot meerdere upgrades. 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 knooppunten van het primaire knooppunttype onderhouden.

Knooppunttypen verwijderen uit uw cluster

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

Primaire knooppunten van uw cluster vervangen

De vervanging van primaire knooppunten moet het ene knooppunt na het andere worden uitgevoerd, in plaats van te verwijderen en vervolgens toe te voegen in batches.

Volgende stappen