Menambahkan atau menghilangkan node ke kluster Service Fabric mandiri yang berjalan di Windows Server

Artikel
08/25/2024

Setelah Anda membuat kluster Service Fabric standalone pada komputer Windows Server, kebutuhan (bisnis) Anda dapat berubah dan Anda harus menambahkan atau menghapus node ke kluster Anda, seperti yang dijelaskan dalam artikel ini.

Catatan

Fungsionalitas penambahan dan penghapusan node tidak didukung dalam kluster pengembangan lokal.

Menambahkan node ke kluster Anda

Siapkan VM/komputer yang ingin Anda tambahkan ke kluster Anda dengan mengikuti langkah-langkah yang diuraikan dalam Merencanakan dan menyiapkan penyebaran kluster Service Fabric Anda.
Identifikasikan domain kesalahan mana dan tingkatkan domain untuk menambahkan VM/komputer ini.

Jika Anda menggunakan sertifikat untuk mengamankan kluster, sertifikat diharapkan akan diinstal di penyimpanan sertifikat lokal sebagai persiapan untuk node untuk bergabung dengan kluster. Analog ini berlaku saat menggunakan bentuk keamanan lain.
Desktop jarak jauh (RDP) ke dalam VM/komputer yang ingin Anda tambahkan ke kluster.
Salin atau unduh paket standalone untuk Service Fabric untuk Windows Server ke VM/komputer dan unzip paket.
Jalankan PowerShell dengan hak istimewa yang ditinggikan dan buka lokasi paket yang belum di-zip.
Jalankan skrip AddNode.ps1 dengan parameter yang menjelaskan node baru yang akan ditambahkan. Contoh berikut menambahkan node baru yang disebut VM5, dengan jenis NodeType0 dan alamat IP 182.17.34.52, ke dalam UD1 dan fd:/dc1/r0. ExistingClusterConnectionEndPoint adalah titik akhir koneksi untuk node yang sudah ada di kluster yang ada, yang dapat berupa alamat IP dari node apa pun di dalam kluster.

Tidak aman (prototyping):
```
.\AddNode.ps1 -NodeName VM5 -NodeType NodeType0 -NodeIPAddressorFQDN 182.17.34.52 -ExistingClientConnectionEndpoint 182.17.34.50:19000 -UpgradeDomain UD1 -FaultDomain fd:/dc1/r0 -AcceptEULA
```
Aman (berbasis sertifikat):
```
$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
```
Ketika skrip selesai berjalan, Anda dapat memeriksa apakah node baru telah ditambahkan dengan menjalankan cmdlet Get-ServiceFabricNode.
Untuk memastikan konsistensi di berbagai node dalam kluster, Anda harus memulai peningkatan konfigurasi. Jalankan Get-ServiceFabricClusterConfiguration untuk mendapatkan file konfigurasi terbaru dan tambahkan node yang baru ditambahkan ke bagian "Node". Disarankan juga untuk selalu memiliki konfigurasi kluster terbaru yang tersedia jika Anda perlu melakukan penyebaran ulang kluster yang memiliki konfigurasi yang sama.
```
{
    "nodeName": "vm5",
    "iPAddress": "182.17.34.52",
    "nodeTypeRef": "NodeType0",
    "faultDomain": "fd:/dc1/r0",
    "upgradeDomain": "UD1"
}
```
Jalankan Start-ServiceFabricClusterConfigurationUpgrade untuk memulai peningkatan.
```
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
```
Anda dapat memantau kemajuan peningkatan pada Service Fabric Explorer. Atau, Anda dapat menjalankan Get-ServiceFabricClusterUpgrade.

Menambahkan node ke kluster yang dikonfigurasi dengan Windows Security menggunakan gMSA

Untuk kluster yang dikonfigurasi dengan Akun Layanan Terkelola Grup (gMSA)(https://technet.microsoft.com/library/hh831782.aspx), node baru dapat ditambahkan menggunakan peningkatan konfigurasi:

Jalankan Get-ServiceFabricClusterConfiguration pada salah satu node yang ada untuk mendapatkan file konfigurasi terbaru dan tambahkan detail tentang node baru yang ingin Anda tambahkan di bagian "Node". Pastikan node baru tersebut merupakan bagian dari akun yang dikelola grup yang sama. Akun ini harus merupakan Administrator pada semua komputer.
```
{
    "nodeName": "vm5",
     "iPAddress": "182.17.34.52",
     "nodeTypeRef": "NodeType0",
     "faultDomain": "fd:/dc1/r0",
     "upgradeDomain": "UD1"
}
```
Jalankan Start-ServiceFabricClusterConfigurationUpgrade untuk memulai peningkatan.
```
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
```
Anda dapat memantau kemajuan peningkatan pada Service Fabric Explorer. Atau, Anda dapat menjalankan Get-ServiceFabricClusterUpgrade

Menambahkan jenis node ke kluster Anda

Untuk menambahkan jenis node baru, modifikasi konfigurasi Anda untuk menyertakan jenis node baru di bagian "NodeTypes" pada "Properties" dan mulai peningkatan konfigurasi menggunakan Start-ServiceFabricClusterConfigurationUpgrade. Setelah peningkatan selesai, Anda dapat menambahkan node baru ke kluster Anda dengan jenis node ini.

Menghapus node dari kluster Anda

Node dapat dihapus dari kluster menggunakan peningkatan konfigurasi, dengan cara berikut:

Jalankan Get-ServiceFabricClusterConfiguration untuk mendapatkan file konfigurasi terbaru dan hapus node tersebut dari bagian "Node". Tambahkan parameter "NodesToBeRemoved" ke bagian "Penyiapan" di bagian "FabricSettings". "Nilai" harus berupa daftar nama node dari node yang dipisahkan koma yang perlu dihapus.

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

Jalankan Start-ServiceFabricClusterConfigurationUpgrade untuk memulai peningkatan.
```
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
```
Anda dapat memantau kemajuan peningkatan pada Service Fabric Explorer. Atau, Anda dapat menjalankan Get-ServiceFabricClusterUpgrade.

Catatan

Penghapusan node dapat memulai beberapa pembaruan. Beberapa node ditandai dengan tag IsSeedNode=”true” dan dapat ditentukan dengan mengkueri manifes kluster menggunakan Get-ServiceFabricClusterManifest. Penghapusan node tersebut mungkin memakan waktu lebih lama daripada yang lain karena node awal harus dipindahkan dalam skenario seperti itu. Kluster harus mempertahankan minimal 3 node primer jenis node.

Menghapus tipe node dari kluster Anda

Sebelum menghapus jenis node, periksa apakah ada node yang mereferensikan jenis node. Hapus node ini sebelum menghapus tipe node yang sesuai. Setelah semua node yang sesuai dihapus, Anda dapat menghapus NodeType dari konfigurasi kluster dan memulai pembaruan konfigurasi menggunakan Start-ServiceFabricClusterConfigurationUpgrade.

Mengganti node utama kluster Anda

Penggantian node primer harus dilakukan satu demi satu node, alih-alih menghapus lalu menambahkan dalam batch.

Bagikan melalui