Поддержка расширения масштабируемого набора виртуальных машин в типах узлов управляемого кластера Service Fabric

Статья
2025-04-02

Каждому типу узла в кластере Service Fabric в Azure соответствует масштабируемый набор виртуальных машин. Это позволяет вам добавлять расширения масштабируемых наборов виртуальных машин к типам узлов управляемого кластера Service Fabric. Расширения — это небольшие приложения, которые обеспечивают настройку и автоматизацию на виртуальных машинах Azure после развертывания. На платформе Azure доступно множество расширений, в число которых входят приложения для конфигурации, мониторинга, безопасности виртуальных машин, а также служебные приложения. Издатели переносят приложение в расширение, чтобы упростить установку. Все, что вам нужно, — предоставить обязательные параметры.

Добавьте расширение для масштабируемого набора виртуальных машин

Для добавления расширения масштабируемого набора виртуальных машин в тип управляемого узла кластера Service Fabric можно использовать команду PowerShell Add-AzServiceFabricManagedNodeTypeVMExtension.

Кроме того, в шаблоне Azure Resource Manager можно добавить расширение масштабируемого набора виртуальных машин для типа узла управляемого кластера Service Fabric, например:

{
  "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": [
                ...
              ]
            }
          }
        }
      }
    ]
  }
}

Подробнее о настройке типов узлов управляемого кластера Service Fabric см. в разделе о типе узла управляемого кластера.

Как настроить перед запуском среды выполнения Service Fabric

Чтобы подготовить расширения перед запуском среды выполнения Service Fabric, можно использовать setupOrder параметр со значением BeforeSFRuntime в свойствах расширения для каждого расширения по мере необходимости. Это позволяет настроить среду и зависимости перед запуском среды выполнения и приложений на узле. Дополнительные сведения см. в следующем примере:

Примечание.

Важно отметить, что если расширение, помеченное BeforeSFRuntime, не удается, это предотвратит запуск среды выполнения Service Fabric. Следовательно, узел будет недоступен с точки зрения Service Fabric. Поэтому важно поддерживать эти расширения с правильными конфигурациями и быстро устранять любые проблемы, которые могут возникнуть, чтобы обеспечить работоспособность узлов в кластере.

Требования

Используйте версию 2023-09-01-preview или более позднюю версию API Service Fabric.

Пример шаблона 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": {
                      ...
                    }
                  }
                ]
              }
          }
      }
    ]
  }
}

Примечание.

Специальная обработка расширения AzureDiskEncryption (ADE): ADE необходимо запустить перед средой выполнения Service Fabric, чтобы убедиться, что диск расшифровывается после операций повторного создания образа, позволяя среде выполнения Service Fabric начать использовать его. Даже если расширение не отмечено BeforeSFRuntimeявным образом, оно будет выполняться перед средой выполнения. Но обратите внимание, что рекомендуется включать шифрование на узле, а не использовать расширение ADE. Подробные инструкции см. в разделе "Включение шифрования на узле".

Следующие шаги

Дополнительные сведения об управляемых кластерах Service Fabric см. в статье:

Распространенные вопросы об управляемых кластерах Service Fabric