Tilläggstillägg för vm-skalningsuppsättningar för Service Fabric-hanterade klusternoder

Varje nodtyp i ett Service Fabric-hanterat kluster backas upp av en VM-skalningsuppsättning. På så sätt kan du lägga till tillägg för vm-skalningsuppsättningar i dina Service Fabric-hanterade klusternodtyper. Tillägg är små program som tillhandahåller konfiguration och automatisering efter distributionen på virtuella Azure-datorer. Azure-plattformen är värd för många tillägg som omfattar vm-konfiguration, övervakning, säkerhet och verktygsprogram. Utgivare tar ett program, omsluter det till ett tillägg och förenklar installationen. Allt du behöver göra är att ange obligatoriska parametrar.

Lägga till ett tillägg för vm-skalningsuppsättningar

Du kan lägga till ett tillägg för vm-skalningsuppsättningar i en Service Fabric-hanterad klusternodtyp med kommandot Add-AzServiceFabricManagedNodeTypeVMExtension PowerShell.

Alternativt kan du lägga till ett tillägg för vm-skalningsuppsättningar på en Service Fabric-hanterad klusternodtyp i din Azure Resource Manager-mall, till exempel:

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

Mer information om hur du konfigurerar service fabric-hanterade klusternodtyper finns i hanterad klusternodtyp.

Etablera före Service Fabric-körning

Om du vill etablera tillägg innan Service Fabric-körningen startar kan du använda parametern setupOrder med värdet BeforeSFRuntime i tilläggsegenskaperna för varje tillägg efter behov. På så sätt kan du konfigurera miljön och beroendena innan körningen och programmen börjar köras på noden. Se exemplet nedan för förtydligande:

Kommentar

Observera att om ett tillägg som markerats med BeforeSFRuntime misslyckas hindrar det Service Fabric-körningen från att starta. Därför kommer noden att vara nere från Service Fabric-perspektivet. Därför är det viktigt att behålla dessa tillägg med rätt konfigurationer och snabbt åtgärda eventuella problem som kan uppstå för att säkerställa hälsotillståndet för noder i klustret.

Krav

Använd Service Fabric API-versionen 2023-09-01-preview eller senare.

EXEMPEL på ARM-mall:

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

Kommentar

Särskild hantering för ADE-tillägget (AzureDiskEncryption): ADE måste köras före Service Fabric-körningen för att säkerställa att disken dekrypteras efter en omimering, så att Service Fabric-körningen kan börja använda den. Även om tillägget inte uttryckligen har markerats med BeforeSFRuntimekörs det före körningen. Observera dock att aktivering av kryptering på värden rekommenderas över användning av ADE-tillägget. Detaljerade anvisningar finns i Aktivera kryptering på värden.

Nästa steg

Mer information om Hanterade Service Fabric-kluster finns i:

Vanliga frågor och svar om hanterade Service Fabric-kluster