Typy węzłów usługi Service Fabric w zarządzanym klastrze

Zestaw skalowania maszyn wirtualnych obsługuje każdy typ węzła w klastrze zarządzanym przez Service Fabric. W przypadku klastrów zarządzanych wprowadzasz wszelkie wymagane zmiany za pośrednictwem dostawcy zasobów klastra zarządzanego usługi Service Fabric. Dostawca klastra zarządzanego tworzy i abstrahuje wszystkie bazowe zasoby klastra w Twoim imieniu. Zlecenie zarządzania zasobami dostawcy ułatwia wdrażanie i zarządzanie typem węzła klastra. Zarządzanie zapobiega błędom operacyjnym, takim jak usuwanie węzła początkowego, i pomaga stosować najlepsze praktyki, takie jak weryfikowanie, czy SKU maszyny wirtualnej jest bezpieczne do użycia.

W pozostałej części tego dokumentu opisano sposób dostosowywania różnych ustawień, w tym:

• Tworzenie typu węzła
• Dostosowywanie liczby wystąpień typu węzła
• Włączanie automatycznych uaktualnień obrazów systemu operacyjnego
• Zmienianie obrazu systemu operacyjnego
• Konfigurowanie właściwości umieszczania
• Ustawianie prefiksu nazwy komputera

Ten dokument koncentruje się na używaniu witryny Azure Portal i szablonów usługi Azure Resource Manager do wprowadzania zmian.

Dodawanie typu węzła

Typ węzła można dodać do klastra zarządzanego usługi Service Fabric za pomocą portalu, szablonu usługi Azure Resource Manager lub programu PowerShell.

Dodawanie za pomocą portalu

1. Zaloguj się w witrynie Azure Portal

2. Przejdź do strony Przegląd zasobu klastra.

3. Wybierz Node types w Settings sekcji

4. Wybierz Add u góry, wypełnij wymagane informacje, a następnie wybierz pozycję Dodaj u dołu.

5. Poczekaj na ukończenie dodawania nowego typu węzła

Dodaj przy użyciu szablonu ARM

Dodaj inny typ Microsoft.ServiceFabric/managedclusters/nodetypes zasobu z wymaganymi wartościami i wykonaj wdrożenie klastra, aby ustawienie miało zastosowanie.

• Wersja interfejsu API dla zasobów klastra zarządzanego przez Service Fabric powinna być 2021-05-01 lub nowsza.
• Upewnij się, że ustawisz isPrimary na true, jeśli zamierzasz zastąpić istniejący podstawowy typ węzła.

{
    "apiVersion": "[variables('sfApiVersion')]",
    "type": "Microsoft.ServiceFabric/managedclusters/nodetypes",
    "name": "[concat(parameters('clusterName'), '/', parameters('nodeType2Name'))]",
    "location": "[resourcegroup().location]",
    "dependsOn": [
        "[concat('Microsoft.ServiceFabric/managedclusters/', parameters('clusterName'))]"
    ],
    "properties": {
        "isPrimary": false,
        "vmImagePublisher": "[parameters('vmImagePublisher')]",
        "vmImageOffer": "[parameters('vmImageOffer')]",
        "vmImageSku": "[parameters('vmImageSku')]",
        "vmImageVersion": "[parameters('vmImageVersion')]",
        "vmSize": "[parameters('nodeType2VmSize')]",
        "vmInstanceCount": "[parameters('nodeType2VmInstanceCount')]",
        "dataDiskSizeGB": "[parameters('nodeType2DataDiskSizeGB')]",
        "dataDiskType": "[parameters('nodeType2managedDataDiskType')]"
    }
}

Aby zapoznać się z przykładową konfiguracją dwóch typów węzłów, zobacz nasz przykładowy szablon ARM dwóch typów węzłów.

Dodawanie za pomocą programu PowerShell

Aby utworzyć nowy typ węzła, należy zdefiniować następujące właściwości:

• Grupa zasobów: grupa zasobów, w ramach których znajduje się klaster
• Nazwa klastra: nazwa klastra zarządzanego
• Nazwa typu węzła: nazwa unikatowa od wszystkich istniejących typów węzłów w klastrze.
• Liczba wystąpień: początkowa liczba węzłów nowego typu węzła.
• Rozmiar maszyny wirtualnej: jednostka SKU maszyny wirtualnej dla węzłów. Jeśli nie zostanie określony, zostanie użyta wartość domyślna Standard_D2 .

$resourceGroup = "myResourceGroup"
$clusterName = "mysfcluster"
$nodeTypeName = "nt2"
$vmSize = "Standard_D2_v2"

New-AzServiceFabricManagedNodeType -ResourceGroupName $resourceGroup -ClusterName $clusterName -Name $nodeTypeName -InstanceCount 3 -vmSize $vmSize

Usuń typ węzła

Typ węzła klastra zarządzanego usługi Service Fabric można usunąć przy użyciu portalu lub programu PowerShell.

Usuwanie za pomocą portalu

1. Zaloguj się w witrynie Azure Portal

2. Przejdź do strony Przegląd zasobu klastra. ! [Przykładowa strona przeglądu][omówienie]

3. Wybierz Node types w Settings sekcji

4. Wybierz element Node Type , który chcesz usunąć, a następnie wybierz Delete u góry.

Usuwanie za pomocą programu PowerShell

Aby usunąć typ węzła, należy zdefiniować następujące właściwości:

• Grupa zasobów: grupa zasobów, w ramach których znajduje się klaster
• Nazwa klastra: nazwa klastra zarządzanego
• Nazwa typu węzła: nazwa unikatowa od wszystkich istniejących typów węzłów w klastrze.

$resourceGroup = "myResourceGroup"
$clusterName = "myCluster"
$nodeTypeName = "nt2"

Remove-AzServiceFabricManagedNodeType -ResourceGroupName $resourceGroup -ClusterName $clusterName  -Name $nodeTypeName

Skalowanie typu węzła

Typ węzła klastra zarządzanego usługi Service Fabric można skalować za pomocą portalu, szablonu usługi ARM lub programu PowerShell. Możesz również skonfigurować automatyczne skalowanie dla typu węzła pomocniczego, jeśli chcesz w pełni zautomatyzowane rozwiązanie.

Skalowanie przy użyciu portalu

Z tego przewodnika dowiesz się, jak zmodyfikować liczbę węzłów dla typu węzła przy użyciu portalu.

1. Zaloguj się w witrynie Azure Portal

2. Przejdź do strony Przegląd zasobu klastra. ! [Przykładowa strona przeglądu][omówienie]

3. Wybierz Node Types w Settings sekcji

4. Wybierz element Node type name , który chcesz zmodyfikować

5. W razie potrzeby przejrzyj i zaktualizuj właściwości typu węzła.

6. Wybierz Manage node type scaling , aby skonfigurować ustawienia skalowania i wybrać między niestandardowymi opcjami skalowania automatycznego i ręcznego skalowania. Autoskalowanie to wbudowana funkcja, która pomaga aplikacjom działać najlepiej, gdy zmienia się zapotrzebowanie. Możesz ręcznie skalować zasób do określonej liczby wystąpień lub za pomocą niestandardowych zasad skalowania automatycznego, które skaluje się na podstawie progów metryk. Można również zaplanować liczbę wystąpień w celu skalowania w wyznaczonych oknach czasu. Dowiedz się więcej o autoskalowania platformy Azure lub wyświetl film wideo z instrukcjami.

   • Niestandardowe autoskalowania: wybierz odpowiednie scale mode ustawienie, aby zdefiniować niestandardowe zasady autoskalowania — Scale to a specific instance countlub Scale based on a metric. Ten ostatni jest oparty na regułach wyzwalania metryk, na przykład zwiększ liczbę instancji o 1, gdy użycie procesora CPU przekracza 70%. Po zdefiniowaniu zasad wybierz Save u góry.

     

   • Skalowanie ręczne: dopasuj Node count wartość do nowej wartości, którą chcesz wybrać, i wybierz Save u góry. Na tym zrzucie ekranu wartość była 3 i została zmieniona na 5.

     

   Wybierz Apply u dołu, aby skonfigurować te zapisane ustawienia w typie węzła.

7. Provisioning state pokazuje status Updating do ukończenia. Po zakończeniu zostanie ponownie wyświetlony Succeeded.

Skalowanie typu węzła przy użyciu szablonu

Aby dostosować liczbę węzłów dla typu węzła przy użyciu szablonu ARM, zmień wartość właściwości vmInstanceCount na nową wartość i wykonaj wdrożenie klastra, aby ustawienie miało zastosowanie. Klaster zaczyna automatyczną aktualizację. Po zakończeniu zobaczysz dodatkowe węzły.

• Wersja interfejsu API zasobów klastra zarządzanego usługi Service Fabric powinna mieć wartość 2021-05-01 lub nowszą.

{
  "apiVersion": "[variables('sfApiVersion')]",
  "type": "Microsoft.ServiceFabric/managedclusters/nodetypes",
  "name": "[concat(parameters('clusterName'), '/', parameters('nodeTypeName'))]",
  "location": "[resourcegroup().location]",
  "properties": {
    ...
    "vmInstanceCount": "[parameters('nodeTypeVmInstanceCount')]",
    ...
  }
}

Skalowanie typu węzła przy użyciu programu PowerShell

Zmień liczbę wystąpień, aby zwiększyć lub zmniejszyć liczbę węzłów w typie węzła, który chcesz skalować. Nazwy typów węzłów można znaleźć w szablonie usługi Azure Resource Manager (szablon ARM) z wdrożenia klastra lub w narzędziu Service Fabric Explorer.

$resourceGroup = "myResourceGroup"
$clusterName = "mysfcluster"
$nodeTypeName = "FE"
$instanceCount = "7"

Set-AzServiceFabricManagedNodeType -ResourceGroupName $resourceGroup -ClusterName $clusterName -name $nodeTypeName -InstanceCount $instanceCount -Verbose

Klaster automatycznie rozpoczyna aktualizację. Po zakończeniu zobaczysz dodatkowe węzły.

Włączanie automatycznych uaktualnień obrazów systemu operacyjnego

Możesz włączyć automatyczne uaktualnienia obrazów systemu operacyjnego dla maszyn wirtualnych, które obsługują węzły klastra zarządzanego. Mimo że zasoby zestawu skalowania maszyn wirtualnych są zarządzane w Twoim imieniu przez klastry zarządzane przez Service Fabric, możesz zdecydować się na włączenie automatycznych aktualizacji obrazów systemu operacyjnego dla węzłów klastra. Podobnie jak w przypadku klasycznych klastrów usługi Service Fabric węzły klastra zarządzanego nie są domyślnie uaktualniane, aby zapobiec niezamierzonym przerwom w działaniu klastra.

Aby włączyć automatyczne uaktualnienia systemu operacyjnego:

• Używanie interfejsu apiVersion 2021-05-01 lub nowszej wersji zasobów Microsoft.ServiceFabric/managedclusters i Microsoft.ServiceFabric/managedclusters/nodetypes
• Ustaw właściwość enableAutoOSUpgrade klastra na true
• Ustaw właściwość vmImageVersion zasobu nodeTypes klastra na wartość latest

Na przykład:

    {
      "apiVersion": "[variables('sfApiVersion')]",
      "type": "Microsoft.ServiceFabric/managedclusters",
      ...
      "properties": {
        ...
        "enableAutoOSUpgrade": true
      },
    },
    {
      "apiVersion": "[variables('sfApiVersion')]",
      "type": "Microsoft.ServiceFabric/managedclusters/nodetypes",
       ...
      "properties": {
        ...
        "vmImageVersion": "latest",
        ...
      }
    }
}

Po włączeniu usługi Service Fabric rozpoczyna wykonywanie zapytań i śledzenie wersji obrazów systemu operacyjnego w klastrze zarządzanym. Jeśli jest dostępna nowa wersja systemu operacyjnego, typy węzłów klastra (zestawy skalowania maszyn wirtualnych) są uaktualniane pojedynczo. Uaktualnienia środowiska uruchomieniowego usługi Service Fabric są wykonywane tylko po potwierdzeniu, że żadne uaktualnienia obrazu systemu operacyjnego węzła klastra nie są w toku.

Jeśli uaktualnienie zakończy się niepowodzeniem, usługa Service Fabric ponowi próbę po upływie 24 godzin przez maksymalnie trzy próby. Podobnie jak w przypadku klasycznych (niezarządzanych) uaktualnień usługi Service Fabric, aplikacje lub węzły w złej kondycji mogą blokować uaktualnienie obrazu systemu operacyjnego.

Aby uzyskać więcej informacji na temat uaktualnień obrazów, zobacz Automatyczne uaktualnienia obrazów systemu operacyjnego za pomocą zestawów skalowania maszyn wirtualnych platformy Azure.

Modyfikowanie wariantu SKU systemu operacyjnego dla rodzaju węzła

Klastry zarządzane usługi Service Fabric umożliwiają modyfikowanie jednostki SKU systemu operacyjnego dla typu węzła. Ten proces jest przydatny w scenariuszach, takich jak migracja z systemu Windows 2019 do systemu Windows 2022 lub jeśli chcesz przełączyć się do jednostki SKU server (Core) w porównaniu z serwerem ze środowiskiem pulpitu SKU.

Modyfikowanie SKU systemu operacyjnego za pomocą portalu

Z tego przewodnika dowiesz się, jak zmodyfikować obraz systemu operacyjnego dla typu węzła przy użyciu portalu.

1. Zaloguj się w witrynie Azure Portal

2. Przejdź do strony Przegląd zasobu klastra. ! [Przykładowa strona przeglądu][omówienie]

3. Wybierz Node Types w Settings sekcji

4. Wybierz element Node type name , który chcesz zmodyfikować

5. Dopasuj OS Image wartość do nowej wartości, którą chcesz wybrać, i wybierz Apply u dołu. ! [Przykład przedstawiający zmianę obrazu systemu operacyjnego][change-os-image]

6. Provisioning state wyświetla stan Updating i wykonuje jedną domenę uaktualnienia naraz. Po zakończeniu zostanie on wyświetlony Succeeded ponownie.

Modyfikowanie jednostki SKU systemu operacyjnego przy użyciu szablonu

Aby zmodyfikować obraz systemu operacyjnego używany dla typu węzła przy użyciu szablonu usługi ARM, dostosuj vmImageSku właściwość przy użyciu nowej wartości i wykonaj wdrożenie klastra, aby ustawienie zostało zastosowane. Dostawca klastra zarządzanego odtwarza obraz każdego wystąpienia przez domenę uaktualnienia.

• Wersja interfejsu API zasobów klastra zarządzanego usługi Service Fabric powinna mieć wartość 2021-05-01 lub nowszą.

{
  "apiVersion": "[variables('sfApiVersion')]",
  "type": "Microsoft.ServiceFabric/managedclusters/nodetypes",
  "name": "[concat(parameters('clusterName'), '/', parameters('nodeTypeName'))]",
  "location": "[resourcegroup().location]",
  "properties": {
    ...
    "vmImagePublisher": "[parameters('vmImagePublisher')]",
    "vmImageOffer": "[parameters('vmImageOffer')]",
    "vmImageSku": "[parameters('vmImageSku')]",
    "vmImageVersion": "[parameters('vmImageVersion')]",
    ...
  }
}

Konfiguruj właściwości rozmieszczania dla typu węzła

Właściwości rozmieszczenia są używane w celu zapewnienia, że niektóre obciążenia działają tylko na niektórych typach węzłów w klastrze. Klastry zarządzane usługi Service Fabric obsługują konfigurowanie tych właściwości za pośrednictwem portalu, szablonu usługi ARM lub programu PowerShell.

Konfigurowanie właściwości umieszczania za pomocą portalu

W tym przewodniku nauczysz się, jak zmodyfikować właściwość pozycji dla typu węzła za pomocą portalu.

1. Zaloguj się w witrynie Azure Portal

2. Przejdź do strony Przegląd zasobu klastra. ! [Przykładowa strona przeglądu][omówienie]

3. Wybierz Node Types w Settings sekcji

4. Wybierz element Node type name , który chcesz zmodyfikować

5. Placement properties W sekcji dodaj nazwę i wartość, którą chcesz, a następnie wybierz Apply na dole. Na tym zrzucie ekranu użyto NameSSD_Premium z Valuetrue.

6. Oprogramowanie Provisioning state wyświetla stan Updating do momentu ukończenia. Po zakończeniu Succeeded zostanie wyświetlony ponownie.

Konfigurowanie właściwości umieszczania przy użyciu szablonu

Aby zmienić właściwości rozmieszczania dla typu węzła za pomocą szablonu ARM, dostosuj placementProperties właściwość za pomocą jednej lub więcej nowych wartości i wykonaj wdrożenie klastra, aby ustawienie zaczęło obowiązywać. W poniższym przykładzie przedstawiono trzy wartości ustawiane dla typu węzła.

• Wersja interfejsu API zasobów klastra zarządzanego usługi Service Fabric powinna mieć wartość 2021-05-01 lub nowszą.

{
  "apiVersion": "[variables('sfApiVersion')]",
  "type": "Microsoft.ServiceFabric/managedclusters/nodetypes",
  "name": "[concat(parameters('clusterName'), '/', parameters('nodeTypeName'))]",
  "location": "[resourcegroup().location]",
  "properties": {
    "placementProperties": {
      "PremiumSSD": "true",
      "NodeColor": "green",
      "SomeProperty": "5"
    }
  }
}

Konfigurowanie właściwości umieszczania za pomocą programu PowerShell

Poniższy przykład aktualizuje i nadpisuje wszelkie istniejące właściwości położenia dla danego typu węzła.

$rgName = "testRG"
$clusterName = "testCluster"
$NodeTypeName = "nt1"
Set-AzServiceFabricManagedNodeType -ResourceGroupName $rgName -ClusterName $clusterName -name $NodeTypeName -PlacementProperty @{NodeColor="Red";SomeProperty="6";} -Verbose

Modyfikacja SKU maszyny wirtualnej dla typu węzła

Aby zmodyfikować rozmiar SKU maszyny wirtualnej używany dla typu węzła przy użyciu szablonu ARM, dostosuj właściwość vmSize do nowej wartości i przeprowadź wdrożenie klastra, aby ustawienie zostało zastosowane. Dostawca klastra zarządzanego odtwarza obraz każdego wystąpienia dla każdej domeny uaktualnień. Aby uzyskać listę opcji SKU, odwołaj się do Rozmiary maszyn wirtualnych — Azure Virtual Machines | Microsoft Learn.

{
  "apiVersion": "[variables('sfApiVersion')]",
  "type": "Microsoft.ServiceFabric/managedclusters/nodetypes",
  "name": "[concat(parameters('clusterName'), '/', parameters('nodeTypeName'))]",
  "location": "[resourcegroup().location]",
  "properties": {
    ...
    "vmSize": "[parameters('vmImageVersion')]",
    ...
  }
}

Konfigurowanie wielu dysków zarządzanych

Klastry zarządzane usługi Service Fabric domyślnie konfigurują jeden dysk zarządzany. Konfigurując następującą opcjonalną właściwość i wartości, można dodać więcej dysków zarządzanych do typów węzłów w klastrze. Możesz określić literę dysku, typ dysku i rozmiar dysku na dysk.

Skonfiguruj więcej dysków zarządzanych, deklarując additionalDataDisks właściwość i wymagane parametry w szablonie usługi Resource Manager w następujący sposób:

Wymagania dotyczące funkcji

• Jednostka LUN musi być unikatowa dla każdego dysku i nie może wykorzystywać zarezerwowanej jednostki LUN 0 lub LUN 1.
• Litera dysku nie może używać liter zarezerwowanych C lub D i nie można jej modyfikować po utworzeniu. S jest używany domyślnie, jeśli nie zostanie określony.
• Musi określać obsługiwany typ dysku
• Wersja interfejsu API zasobów klastra zarządzanego usługi Service Fabric powinna mieć wartość 2022-01-01 lub nowszą.

{
  "apiVersion": "[variables('sfApiVersion')]",
  "type": "Microsoft.ServiceFabric/managedclusters/nodetypes",
  "name": "[concat(parameters('clusterName'), '/', parameters('nodeTypeName'))]",
  "location": "[resourcegroup().location]",
  "properties": {
    "additionalDataDisks": {
      "lun": "2",
      "diskSizeGB": "50",
      "diskType": "Standard_LRS",
      "diskLetter": "S" 
    }
  }
}

Zobacz pełną listę dostępnych parametrów.

Konfigurowanie litery dysku danych usługi Service Fabric

Klastry zarządzane przez Service Fabric domyślnie konfigurują dysk danych Service Fabric i automatycznie przypisują literę dysku na wszystkich węzłach danego typu węzła. Konfigurując tę opcjonalną właściwość i wartość, można określić i pobrać literę dysku danych usługi Service Fabric, jeśli masz określone wymagania dotyczące mapowania liter dysku.

Wymagania dotyczące funkcji

• Litera dysku nie może używać liter zarezerwowanych C lub D i nie można jej modyfikować po utworzeniu. S jest używany jako domyślny, jeśli nie zostanie określony.
• Wersja interfejsu API zasobów klastra zarządzanego usługi Service Fabric powinna mieć wartość 2022-01-01 lub nowszą.

{
  {
    "apiVersion": "[variables('sfApiVersion')]",
    "type": "Microsoft.ServiceFabric/managedclusters/nodetypes",
    "name": "[concat(parameters('clusterName'), '/', parameters('nodeTypeName'))]",
    "location": "[resourcegroup().location]",
    "properties": {
      "dataDiskLetter": "S"
    }
  }
}

Ustawianie prefiksu nazwy komputera

Klienci, którzy wymagają dłuższych nazw dla typu węzła w celu uzyskania bardziej szczegółowego opisu, korzystają z prefiksu nazwy komputera.

Zaimplementuj następujące zmiany szablonu usługi ARM, aby ustawić prefiks nazwy komputera:

{
  "apiVersion": "2024-04-01",
  "type": "Microsoft.ServiceFabric/managedclusters/nodetypes",
  "name": "[concat(parameters('clusterName'), '/', 'BE-testResourceGroup-testRegion-test')]",
  "location": "[parameters('clusterLocation')]",
  "dependsOn": [
      "[concat('Microsoft.ServiceFabric/managedclusters/', parameters('clusterName'))]"
  ],
  "properties": {
    "isPrimary": false,
    "dataDiskSizeGB": "[parameters('dataDiskSizeGB')]",
    "vmImagePublisher": "[parameters('vmImagePublisher')]",
    "vmImageOffer": "[parameters('vmImageOffer')]",
    "vmImageSku": "[parameters('vmImageSku')]",
    "vmImageVersion": "[parameters('vmImageVersion')]",
    "vmSize": "[parameters('vmSize')]",
    "vmInstanceCount": "[parameters('vmInstanceCount')]",
    "computerNamePrefix": "computerNamePrefix"
  }
} 

Następne kroki