Windows Server’da çalışan tek başına Service Fabric kümesine düğüm ekleme veya kaldırma

Makale
06/01/2023

Tek başına Service Fabric kümenizi Windows Server makinelerinde oluşturduktan sonra, (iş) gereksinimleriniz değişebilir ve bu makalede açıklandığı gibi kümenize düğüm eklemeniz veya kaldırmanız gerekir.

Not

Düğüm ekleme ve kaldırma işlevselliği yerel geliştirme kümelerinde desteklenmez.

Kümenize düğüm ekleme

Service Fabric küme dağıtımınızı planlama ve hazırlama bölümünde açıklanan adımları izleyerek kümenize eklemek istediğiniz VM'yi/makineyi hazırlayın.
Bu VM/makineyi ekleyeceğiniz hata etki alanını ve yükseltme etki alanını belirleyin.

Kümenin güvenliğini sağlamak için sertifikalar kullanırsanız, düğümün kümeye katılmasına hazırlık olarak sertifikaların yerel sertifika depolarına yüklenmesi beklenir. Analog, diğer güvenlik biçimleri kullanılırken geçerlidir.
Kümeye eklemek istediğiniz VM/makineye uzak masaüstü (RDP).
Windows Server için Service Fabric'in tek başına paketini VM'ye/makineye kopyalayın veya indirin ve paketin sıkıştırmasını açın.
PowerShell'i yükseltilmiş ayrıcalıklarla çalıştırın ve sıkıştırması açılmış paketin konumuna gidin.
Eklenecek yeni düğümü açıklayan parametrelerle AddNode.ps1 betiğini çalıştırın. Aşağıdaki örnek, NodeType0 türü ve IP adresi 182.17.34.52 olan VM5 adlı yeni bir düğümü UD1 ve fd:/dc1/r0 içine ekler. ExistingClusterConnectionEndPoint mevcut kümede bulunan bir düğümün bağlantı uç noktasıdır ve bu, kümedeki herhangi bir düğümün IP adresi olabilir.

Güvenli olmayan (prototip oluşturma):
```
.\AddNode.ps1 -NodeName VM5 -NodeType NodeType0 -NodeIPAddressorFQDN 182.17.34.52 -ExistingClientConnectionEndpoint 182.17.34.50:19000 -UpgradeDomain UD1 -FaultDomain fd:/dc1/r0 -AcceptEULA
```
Güvenli (sertifika tabanlı):
```
$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
```
Betiğin çalışması tamamlandığında Get-ServiceFabricNode cmdlet'ini çalıştırarak yeni düğümün eklenip eklenmediğini de kontrol edebilirsiniz.
Kümedeki farklı düğümler arasında tutarlılık sağlamak için bir yapılandırma yükseltmesi başlatmanız gerekir. En son yapılandırma dosyasını almak ve yeni eklenen düğümü "Düğümler" bölümüne eklemek için Get-ServiceFabricClusterConfiguration komutunu çalıştırın. Aynı yapılandırmaya sahip bir kümeyi yeniden dağıtmanız gerektiğinde her zaman en son küme yapılandırmasının kullanılabilir olması da önerilir.
```
{
    "nodeName": "vm5",
    "iPAddress": "182.17.34.52",
    "nodeTypeRef": "NodeType0",
    "faultDomain": "fd:/dc1/r0",
    "upgradeDomain": "UD1"
}
```
Yükseltmeyi başlatmak için Start-ServiceFabricClusterConfigurationUpgrade komutunu çalıştırın.
```
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
```
Yükseltmenin ilerleme durumunu Service Fabric Explorer izleyebilirsiniz. Alternatif olarak Get-ServiceFabricClusterUpgrade komutunu çalıştırabilirsiniz.

gMSA kullanarak Windows Güvenliği ile yapılandırılmış kümelere düğüm ekleme

Grup Yönetilen Hizmet Hesabı (gMSA)()https://technet.microsoft.com/library/hh831782.aspx ile yapılandırılmış kümeler için, yapılandırma yükseltmesi kullanılarak yeni bir düğüm eklenebilir:

Mevcut düğümlerden herhangi birinde Get-ServiceFabricClusterConfiguration komutunu çalıştırarak en son yapılandırma dosyasını alın ve "Düğümler" bölümüne eklemek istediğiniz yeni düğümle ilgili ayrıntıları ekleyin. Yeni düğümün aynı grup tarafından yönetilen hesabın parçası olduğundan emin olun. Bu hesap tüm makinelerde Yönetici olmalıdır.
```
{
    "nodeName": "vm5",
     "iPAddress": "182.17.34.52",
     "nodeTypeRef": "NodeType0",
     "faultDomain": "fd:/dc1/r0",
     "upgradeDomain": "UD1"
}
```
Yükseltmeyi başlatmak için Start-ServiceFabricClusterConfigurationUpgrade komutunu çalıştırın.
```
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
```
Yükseltmenin ilerleme durumunu Service Fabric Explorer izleyebilirsiniz. Alternatif olarak Get-ServiceFabricClusterUpgrade komutunu çalıştırabilirsiniz

Kümenize düğüm türleri ekleme

Yeni bir düğüm türü eklemek için, yapılandırmanızı "Özellikler" altındaki "NodeTypes" bölümüne yeni düğüm türünü içerecek şekilde değiştirin ve Start-ServiceFabricClusterConfigurationUpgrade komutunu kullanarak bir yapılandırma yükseltmesi başlatın. Yükseltme tamamlandıktan sonra bu düğüm türüyle kümenize yeni düğümler ekleyebilirsiniz.

Kümenizden düğümleri kaldırma

Bir düğüm, yapılandırma yükseltmesi kullanılarak bir kümeden aşağıdaki şekilde kaldırılabilir:

En son yapılandırma dosyasını almak ve düğümü "Düğümler" bölümünden kaldırmak için Get-ServiceFabricClusterConfiguration komutunu çalıştırın. "NodeToBeRemoved" parametresini "FabricSettings" bölümünün içindeki "Setup" bölümüne ekleyin. "Değer", kaldırılması gereken düğümlerin düğüm adlarının virgülle ayrılmış bir listesi olmalıdır.

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

Yükseltmeyi başlatmak için Start-ServiceFabricClusterConfigurationUpgrade komutunu çalıştırın.
```
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
```
Yükseltmenin ilerleme durumunu Service Fabric Explorer izleyebilirsiniz. Alternatif olarak Get-ServiceFabricClusterUpgrade komutunu çalıştırabilirsiniz.

Not

Düğümlerin kaldırılması birden çok yükseltme başlatabilir. Bazı düğümler etiketle IsSeedNode=”true” işaretlenir ve kullanılarak Get-ServiceFabricClusterManifestküme bildirimi sorgulanarak tanımlanabilir. Bu tür senaryolarda çekirdek düğümlerinin taşınması gerekeceğinden, bu tür düğümlerin kaldırılması diğerlerinden daha uzun sürebilir. Küme en az 3 birincil düğüm türü düğümü tutmalıdır.

Kümenizden düğüm türlerini kaldırma

Düğüm türünü kaldırmadan önce düğüm türüne başvuran düğüm olup olmadığını denetleyin. İlgili düğüm türünü kaldırmadan önce bu düğümleri kaldırın. Karşılık gelen tüm düğümler kaldırıldıktan sonra NodeType'ı küme yapılandırmasından kaldırabilir ve Start-ServiceFabricClusterConfigurationUpgrade kullanarak bir yapılandırma yükseltmesi başlatabilirsiniz.

Kümenizin birincil düğümlerini değiştirme

Birincil düğümlerin değiştirilmesi, kaldırılıp sonra toplu olarak eklemek yerine bir düğümden sonra gerçekleştirilmelidir.