Obsługa rozszerzenia zestawu skalowania maszyn wirtualnych w typach węzłów klastra zarządzanego usługi Service Fabric

Każdy typ węzła w klastrze zarządzanym usługi Service Fabric jest wspierany przez zestaw skalowania maszyn wirtualnych. Dzięki temu można dodawać rozszerzenia zestawu skalowania maszyn wirtualnych do typów węzłów klastra zarządzanego usługi Service Fabric. Rozszerzenia to małe aplikacje, które zapewniają konfigurację po wdrożeniu i automatyzację na maszynach wirtualnych platformy Azure. Platforma Azure hostuje wiele rozszerzeń obejmujących konfigurację maszyny wirtualnej, monitorowanie, zabezpieczenia i aplikacje narzędziowe. Wydawcy przyjmują aplikację, opakowuje ją w rozszerzenie i upraszczają instalację. Wystarczy podać obowiązkowe parametry.

Dodawanie rozszerzenia zestawu skalowania maszyn wirtualnych

Rozszerzenie zestawu skalowania maszyn wirtualnych można dodać do typu węzła klastra zarządzanego usługi Service Fabric przy użyciu polecenia Add-AzServiceFabricManagedNodeTypeVMExtension programu PowerShell.

Alternatywnie można dodać rozszerzenie zestawu skalowania maszyn wirtualnych w węźle klastra zarządzanego usługi Service Fabric w szablonie usługi Azure Resource Manager, na przykład:

{
  "type": "Microsoft.ServiceFabric/managedclusters/nodetypes",
  "apiVersion": "[variables('sfApiVersion')]",
  "name": "[concat(parameters('clusterName'), '/', parameters('nodeTypeName'))]",
  "dependsOn": [
    "[concat('Microsoft.ServiceFabric/managedclusters/', parameters('clusterName'))]"
  ],
  "location": "[resourceGroup().location]",
  "properties": {
    "isPrimary": true,
    ...
    "vmExtensions": [
      {
        "name": "KvExtension",
        "properties": {
          "publisher": "Microsoft.Azure.KeyVault",
          "type": "KeyVaultForWindows",
          "typeHandlerVersion": "3.0",
          "autoUpgradeMinorVersion": true,
          "settings": {
            "secretsManagementSettings": {
              "observedCertificates": [
                ...
              ]
            }
          }
        }
      }
    ]
  }
}

Aby uzyskać więcej informacji na temat konfigurowania typów węzłów klastra zarządzanego usługi Service Fabric, zobacz Typ węzła klastra zarządzanego.

Jak aprowizować przed środowiskiem uruchomieniowym usługi Service Fabric

Aby aprowizować rozszerzenia przed uruchomieniem środowiska uruchomieniowego usługi Service Fabric, możesz użyć parametru setupOrder z wartością BeforeSFRuntime we właściwościach rozszerzenia dla każdego rozszerzenia zgodnie z potrzebami. Dzięki temu można skonfigurować środowisko i zależności przed rozpoczęciem działania środowiska uruchomieniowego i aplikacji w węźle. Aby uzyskać wyjaśnienie, zobacz poniższy przykład:

Uwaga

Należy pamiętać, że jeśli rozszerzenie oznaczone BeforeSFRuntime niepowodzeniem zakończy się niepowodzeniem, uniemożliwi uruchomienie środowiska uruchomieniowego usługi Service Fabric. W związku z tym węzeł zostanie wyłączony z perspektywy usługi Service Fabric. Dlatego ważne jest, aby zachować te rozszerzenia przy użyciu poprawnych konfiguracji i szybko rozwiązać wszelkie problemy, które mogą wystąpić w celu zapewnienia kondycji węzłów w klastrze.

Wymagania

Użyj wersji 2023-09-01-preview interfejsu API usługi Service Fabric lub nowszej.

Przykład szablonu usługi ARM:

{
  "type": "Microsoft.ServiceFabric/managedclusters/nodetypes",
  "apiVersion": "2023-09-01-preview",
  "name": "[concat(parameters('clusterName'), '/', parameters('nodeTypeName'))]",
  "properties": {
    "isPrimary": true,
    ...
    "vmExtensions": [
        {
            "name": "KvExtension",
            "properties": {
                "setupOrder": [
                    "BeforeSFRuntime"
                ],
                "provisionAfterExtensions" [ "GenevaMonitoringExtension" ],
                "publisher": "Microsoft.Azure.KeyVault",
                "type": "KeyVaultForWindows",
                "typeHandlerVersion": "3.0",
                "autoUpgradeMinorVersion": true,
                "settings": {
                "secretsManagementSettings": {
                  "observedCertificates": [
                    ...
                  ]
                }
              }
            }
        },
        {
          "name": "GenevaMonitoringExtension",
          "properties": {
              "setupOrder": [
                    "BeforeSFRuntime"
                ],
              "autoUpgradeMinorVersion": true,
              "enableAutomaticUpgrade": true,
              "publisher": "Microsoft.Azure.Geneva",
              "type": "GenevaMonitoring",
              "typeHandlerVersion": "2.40",
              "settings": {
                "configurations": [
                  {
                    "ServiceArguments": {
                      ...
                    },
                    "UserArguments": {
                      ...
                    }
                  }
                ]
              }
          }
      }
    ]
  }
}

Uwaga

Specjalna obsługa rozszerzenia AzureDiskEncryption (ADE): usługa ADE musi zostać uruchomiona przed środowiskiem uruchomieniowym usługi Service Fabric, aby zagwarantować, że dysk zostanie odszyfrowany po operacjach z obrazem, co umożliwi środowisko uruchomieniowe usługi Service Fabric rozpoczęcie korzystania z niego. Nawet jeśli rozszerzenie nie jest jawnie oznaczone za pomocą BeforeSFRuntimepolecenia , zostanie ono uruchomione przed środowiskiem uruchomieniowym. Należy jednak pamiętać, że włączenie szyfrowania na hoście jest zalecane za pomocą rozszerzenia ADE. Aby uzyskać szczegółowe instrukcje, zobacz Włączanie szyfrowania na hoście.

Następne kroki

Aby dowiedzieć się więcej o klastrach zarządzanych usługi Service Fabric, zobacz:

Klastry zarządzane usługi Service Fabric — często zadawane pytania