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

Makale
08/25/2024

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şlevi 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'ye/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ı ö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'da izleyebilirsiniz. Alternatif olarak, Get-ServiceFabricClusterUpgrade komutunu çalıştırabilirsiniz.

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

Grup Yönetilen Hizmet Hesabı (gMSA)()https://technet.microsoft.com/library/hh831782.aspx ile yapılandırılan 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'da 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 kümenize bu düğüm türüyle 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. "FabricSettings" bölümünün içindeki "Setup" bölümüne "NodesToBeRemoved" parametresini 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'da 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ümenin en az 3 birincil düğüm türü düğüm tutması gerekir.

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

Bir 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 komutunu 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 toplu olarak eklemek yerine bir düğümden sonra gerçekleştirilmelidir.

Aracılığıyla paylaş