Microsoft.ServiceFabric-Cluster 2017-07-01-preview

Artikel
05/07/2024

Bicep-Ressourcendefinition

Der Clusterressourcentyp kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

Ressourcengruppen : Siehe Ressourcengruppenbereitstellungsbefehle

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ServiceFabric/clusters-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.ServiceFabric/clusters@2017-07-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    addOnFeatures: [
      'string'
    ]
    availableClusterVersions: [
      {
        codeVersion: 'string'
        environment: 'string'
        supportExpiryUtc: 'string'
      }
    ]
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
    }
    certificate: {
      thumbprint: 'string'
      thumbprintSecondary: 'string'
      x509StoreName: 'string'
    }
    clientCertificateCommonNames: [
      {
        certificateCommonName: 'string'
        certificateIssuerThumbprint: 'string'
        isAdmin: bool
      }
    ]
    clientCertificateThumbprints: [
      {
        certificateThumbprint: 'string'
        isAdmin: bool
      }
    ]
    clusterCodeVersion: 'string'
    clusterState: 'string'
    diagnosticsStorageAccountConfig: {
      blobEndpoint: 'string'
      protectedAccountKeyName: 'string'
      queueEndpoint: 'string'
      storageAccountName: 'string'
      tableEndpoint: 'string'
    }
    fabricSettings: [
      {
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
      }
    ]
    managementEndpoint: 'string'
    nodeTypes: [
      {
        applicationPorts: {
          endPort: int
          startPort: int
        }
        capacities: {
          {customized property}: 'string'
        }
        clientConnectionEndpointPort: int
        durabilityLevel: 'string'
        ephemeralPorts: {
          endPort: int
          startPort: int
        }
        httpGatewayEndpointPort: int
        isPrimary: bool
        name: 'string'
        placementProperties: {
          {customized property}: 'string'
        }
        reverseProxyEndpointPort: int
        vmInstanceCount: int
      }
    ]
    reliabilityLevel: 'string'
    reverseProxyCertificate: {
      thumbprint: 'string'
      thumbprintSecondary: 'string'
      x509StoreName: 'string'
    }
    upgradeDescription: {
      deltaHealthPolicy: {
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
      }
      forceRestart: bool
      healthCheckRetryTimeout: 'string'
      healthCheckStableDuration: 'string'
      healthCheckWaitDuration: 'string'
      healthPolicy: {
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
      }
      upgradeDomainTimeout: 'string'
      upgradeReplicaSetCheckTimeout: 'string'
      upgradeTimeout: 'string'
    }
    upgradeMode: 'string'
    vmImage: 'string'
  }
}

Eigenschaftswerte

clusters

Name	BESCHREIBUNG	Wert
name	Der Ressourcenname	Zeichenfolge (erforderlich) Zeichenlimit: 4-23 Gültige Zeichen: Kleinbuchstaben, Zahlen und Bindestriche. Beginnen Sie mit einem Kleinbuchstaben. Enden Sie mit einem Kleinbuchstaben oder einer Zahl.
location	Ressourcenspeicherort	Zeichenfolge (erforderlich)
tags	Ressourcentags.	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
properties	Die Clusterressourceneigenschaften	ClusterEigenschaften

ClusterEigenschaften

Name	BESCHREIBUNG	Wert
addOnFeatures	Die Liste der Add-On-Features, die im Cluster aktiviert werden sollen.	Zeichenfolgenarray, das folgendes enthält: "BackupRestoreService" "DnsService" 'RepairManager'
availableClusterVersions	Die für diesen Cluster verfügbaren Service Fabric-Laufzeitversionen.	ClusterVersionDetails[]
azureActiveDirectory	Die AAD-Authentifizierungseinstellungen des Clusters.	AzureActiveDirectory
Zertifikat	Das Zertifikat, das zum Sichern des Clusters verwendet werden soll. Das bereitgestellte Zertifikat wird für die Knotensicherheit innerhalb des Clusters, das SSL-Zertifikat für den Clusterverwaltungsendpunkt und den Standardadministratorclient verwendet.	CertificateDescription
clientCertificateCommonNames	Die Liste der Clientzertifikate, auf die durch allgemeinen Namen verwiesen wird, die zum Verwalten des Clusters zulässig sind.	ClientCertificateCommonName[]
clientCertificateThumbprints	Die Liste der Clientzertifikate, auf die durch Fingerabdruck verwiesen wird, auf die der Cluster verwaltet werden darf.	ClientCertificateThumbprint[]
clusterCodeVersion	Die Service Fabric-Runtimeversion des Clusters. Diese Eigenschaft kann nur durch Festlegen des Benutzers verwendet werden, wenn upgradeMode auf "Manuell" festgelegt ist. Verwenden Sie die ClusterVersion-API, um eine Liste der verfügbaren Service Fabric-Versionen für neue Cluster abzurufen. Verwenden Sie availableClusterVersions, um die Liste der verfügbaren Versionen für vorhandene Cluster abzurufen.	Zeichenfolge
clusterState	Der aktuelle Status des Clusters. – WaitingForNodes: Gibt an, dass die Clusterressource erstellt wird und der Ressourcenanbieter darauf wartet, dass die Service Fabric-VM-Erweiterung gestartet und gemeldet wird. - Bereitstellen: Gibt an, dass die Service Fabric-Runtime auf den VMs installiert wird. Die Clusterressource befindet sich in diesem Zustand, bis der Cluster gestartet wird und die Systemdienste ausgeführt werden. – BaselineUpgrade: Gibt an, dass der Cluster aktualisiert wird, um die Clusterversion zu erstellen. Dieses Upgrade wird automatisch initiiert, wenn der Cluster zum ersten Mal gestartet wird. - UpdatingUserConfiguration: Gibt an, dass der Cluster mit der vom Benutzer bereitgestellten Konfiguration aktualisiert wird. - UpdatingUserCertificate: Gibt an, dass der Cluster mit dem vom Benutzer bereitgestellten Zertifikat aktualisiert wird. - AktualisierenInfrastruktur: Gibt an, dass der Cluster mit der neuesten Service Fabric-Runtimeversion aktualisiert wird. Dies geschieht nur, wenn der upgradeMode auf "Automatisch" festgelegt ist. – ErzwingenClusterVersion: Gibt an, dass sich der Cluster in einer anderen Version als erwartet befindet und der Cluster auf die erwartete Version aktualisiert wird. - UpgradeServiceUnreachable: Gibt an, dass der Systemdienst im Cluster den Ressourcenanbieter nicht mehr abruft. Cluster in diesem Zustand können nicht vom Ressourcenanbieter verwaltet werden. – Autoskalierung: Gibt an, dass der ReliabilityLevel des Clusters angepasst wird. - Bereit: Gibt an, dass sich der Cluster in einem stabilen Zustand befindet.	"Autoskalierung" "BaselineUpgrade" "Bereitstellen" "ErzwingenClusterVersion" "Bereit" "AktualisierenInfrastruktur" "UpdatingUserCertificate" "UpdatingUserConfiguration" 'UpgradeServiceUnreachable' "WaitingForNodes"
diagnosticsStorageAccountConfig	Die Speicherkontoinformationen zum Speichern von Service Fabric-Diagnoseprotokollen.	DiagnosticsStorageAccountConfig
fabricSettings	Die Liste der benutzerdefinierten Fabriceinstellungen zum Konfigurieren des Clusters.	SettingsSectionDescription[]
managementEndpoint	Der HTTP-Verwaltungsendpunkt des Clusters.	Zeichenfolge (erforderlich)
nodeTypes	Die Liste der Knotentypen im Cluster.	NodeTypeDescription[] (erforderlich)
reliabilityLevel	Die Zuverlässigkeitsstufe legt die Größe der Replikatgruppen von Systemdiensten fest. Erfahren Sie mehr über ReliabilityLevel. – Keine: Führen Sie die Systemdienste mit der Anzahl der Zielreplikatesätze von 1 aus. Dies sollte nur für Testcluster verwendet werden. - Bronze: Führen Sie die Systemdienste mit der Anzahl der Zielreplikatesätze von 3 aus. Dies sollte nur für Testcluster verwendet werden. – Silber: Führen Sie die Systemdienste mit der Anzahl der Zielreplikatesätze von 5 aus. – Gold: Führen Sie die Systemdienste mit der Anzahl der Zielreplikatesätze von 7 aus. – Platinum: Führen Sie die Systemdienste mit der Anzahl der Zielreplikategruppen von 9 aus.	"Bronze" "Gold" "Keine" "Platinum" "Silber"
reverseProxyCertificate	Das vom Reverseproxy verwendete Serverzertifikat.	CertificateDescription
upgradeDescription	Die Richtlinie, die beim Upgraden des Clusters verwendet werden soll.	ClusterUpgradePolicy
upgradeMode	Der Upgrademodus des Clusters, wenn eine neue Service Fabric-Laufzeitversion verfügbar ist. – Automatisch: Der Cluster wird automatisch auf die neueste Service Fabric-Laufzeitversion aktualisiert, sobald sie verfügbar ist. – Manuell: Der Cluster wird nicht automatisch auf die neueste Service Fabric-Runtimeversion aktualisiert. Der Cluster wird aktualisiert, indem die clusterCodeVersion-Eigenschaft in der Clusterressource festgelegt wird.	"Automatisch" "Manuell"
vmImage	Das VM-Image VMSS wurde mit konfiguriert. Generische Namen wie Windows oder Linux können verwendet werden.	Zeichenfolge

ClusterVersionDetails

Name	BESCHREIBUNG	Wert
codeVersion	Die Service Fabric-Laufzeitversion des Clusters.	Zeichenfolge
Environment	Gibt an, ob diese Version für das Windows- oder Linux-Betriebssystem gilt.	"Linux" "Windows"
supportExpiryUtc	Das Datum des Ablaufs der Unterstützung der Version.	Zeichenfolge

AzureActiveDirectory

Name	BESCHREIBUNG	Wert
clientApplication	Anwendungs-ID der Azure Active Directory-Clientanwendung.	Zeichenfolge
clusterApplication	Anwendungs-ID des Azure Active Directory-Clusters.	Zeichenfolge
tenantId	Azure Active Directory-Mandanten-ID.	Zeichenfolge

CertificateDescription

Name	BESCHREIBUNG	Wert
thumbprint	Fingerabdruck des primären Zertifikats.	Zeichenfolge (erforderlich)
FingerabdruckSecondary	Fingerabdruck des sekundären Zertifikats.	Zeichenfolge
x509StoreName	Der lokale Zertifikatspeicherort.	"AddressBook" "AuthRoot" "CertificateAuthority" "Unzulässig" "My" 'Stamm' "TrustedPeople" "TrustedPublisher"

ClientCertificateCommonName

Name	BESCHREIBUNG	Wert
certificateCommonName	Der allgemeine Name des Clientzertifikats.	Zeichenfolge (erforderlich)
certificateIssuerThumbprint	Der Ausstellerfingerabdruck des Clientzertifikats.	Zeichenfolge (erforderlich)
isAdmin	Gibt an, ob das Clientzertifikat Administratorzugriff auf den Cluster hat. Nicht-Administratorclients können nur schreibgeschützte Vorgänge im Cluster ausführen.	bool (erforderlich)

ClientCertificateThumbprint

Name	BESCHREIBUNG	Wert
certificateThumbprint	Der Fingerabdruck des Clientzertifikats.	Zeichenfolge (erforderlich)
isAdmin	Gibt an, ob das Clientzertifikat Administratorzugriff auf den Cluster hat. Nicht-Administratorclients können nur schreibgeschützte Vorgänge im Cluster ausführen.	bool (erforderlich)

DiagnosticsStorageAccountConfig

Name	BESCHREIBUNG	Wert
blobEndpoint	Der Blobendpunkt des Azure-Speicherkontos.	Zeichenfolge (erforderlich)
protectedAccountKeyName	Der name des geschützten Diagnose Speicherschlüssels.	Zeichenfolge (erforderlich)
queueEndpoint	Der Warteschlangenendpunkt des Azure-Speicherkontos.	Zeichenfolge (erforderlich)
storageAccountName	Azure-Speicherkontoname	Zeichenfolge (erforderlich)
tableEndpoint	Der Tabellenendpunkt des Azure-Speicherkontos.	Zeichenfolge (erforderlich)

EinstellungenSectionDescription

Name	BESCHREIBUNG	Wert
name	Der Abschnittsname der Fabriceinstellungen.	Zeichenfolge (erforderlich)
parameters	Die Auflistung von Parametern im Abschnitt.	SettingsParameterDescription[] (erforderlich)

SettingsParameterDescription

Name	BESCHREIBUNG	Wert
name	Der Parametername der Fabriceinstellung.	Zeichenfolge (erforderlich)
value	Der Parameterwert der Fabriceinstellung.	Zeichenfolge (erforderlich)

NodeTypeDescription

Name	BESCHREIBUNG	Wert
applicationPorts	Der Bereich der Ports, von dem aus der Cluster Service Fabric-Anwendungen Port zugewiesen hat.	EndpointRangeDescription
capacities	Die Kapazitätstags, die auf die Knoten im Knotentyp angewendet werden, verwendet der Clusterressourcen-Manager diese Tags, um zu verstehen, wie viel Ressource ein Knoten hat.	NodeTypeDescriptionCapacities
clientConnectionEndpointPort	Der Endpunktport für die TCP-Clusterverwaltung.	int (erforderlich)
durabilityLevel	Die Dauerhaftigkeitsebene des Knotentyps. Erfahren Sie mehr über DurabilityLevel. - Bronze – Keine Berechtigungen. Dies ist die Standardoption. – Silber: Die Infrastrukturaufträge können für einen Zeitraum von 30 Minuten pro UD angehalten werden. - Gold: Die Infrastrukturaufträge können für eine Dauer von 2 Stunden pro UD angehalten werden. Die Dauerhaftigkeit „Gold“ kann nur für VM-SKUs mit vollständigen Knoten wie D15_V2, G5 usw. aktiviert werden.	"Bronze" "Gold" "Silber"
ephemeralPorts	Der Bereich der kurzlebigen Ports, mit denen Knoten in diesem Knotentyp konfiguriert werden sollten.	EndpointRangeDescription
httpGatewayEndpointPort	Der Endpunktport für die HTTP-Clusterverwaltung.	int (erforderlich)
IsPrimary	Der Knotentyp, auf dem die Systemdienste ausgeführt werden. Es sollte nur ein Knotentyp als primär markiert werden. Der primäre Knotentyp kann für vorhandene Cluster nicht gelöscht oder geändert werden.	bool (erforderlich)
name	Der Name des Knotentyps.	Zeichenfolge (erforderlich)
placementEigenschaften	Die Platzierungstags, die auf Knoten im Knotentyp angewendet werden, können verwendet werden, um anzugeben, wo bestimmte Dienste (Workload) ausgeführt werden sollen.	NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort	Der vom Reverseproxy verwendete Endpunkt.	INT
vmInstanceCount	Die Anzahl der Knoten im Knotentyp. Diese Anzahl sollte mit der Kapazitätseigenschaft in der entsprechenden VirtualMachineScaleSet-Ressource übereinstimmen.	int (erforderlich) Einschränkungen: Min-Wert = 1 Maximaler Wert = 2147483647

EndpointRangeDescription

Name	BESCHREIBUNG	Wert
endPort	Endport eines Portbereichs	int (erforderlich)
startPort	Startport eines Portbereichs	int (erforderlich)

NodeTypeDescriptionCapacities

Name	BESCHREIBUNG	Wert
{angepasste Eigenschaft}		Zeichenfolge

NodeTypeDescriptionPlacementProperties

Name	BESCHREIBUNG	Wert
{angepasste Eigenschaft}		Zeichenfolge

ClusterUpgradePolicy

Name	BESCHREIBUNG	Wert
deltaHealthPolicy	Die Delta-Integritätsrichtlinie, die beim Upgrade des Clusters verwendet wird.	ClusterUpgradeDeltaHealthPolicy
forceRestart	Wenn true, werden Prozesse während des Upgrades erzwungen neu gestartet, auch wenn sich die Codeversion nicht geändert hat (das Upgrade ändert nur die Konfiguration oder die Daten).	bool
healthCheckRetryTimeout	Die Zeitspanne für die Erneute Überprüfung der Integritätsauswertung, wenn die Anwendung oder der Cluster fehlerhaft ist, bevor das Upgrade ein Rollback ausgeführt wird. Das Timeout kann entweder im Format hh:mm:ss oder im d.hh:mm:ss.ms-Format vorliegen.	Zeichenfolge (erforderlich)
healthCheckStableDuration	Die Zeitspanne, während der die Anwendung oder der Cluster fehlerfrei bleiben muss, bevor das Upgrade mit der nächsten Upgradedomäne fortgesetzt wird. Die Dauer kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms erfolgen.	Zeichenfolge (erforderlich)
healthCheckWaitDuration	Die Zeitspanne, die nach Abschluss einer Upgradedomäne gewartet werden muss, bevor Integritätsprüfungen durchgeführt werden. Die Dauer kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms erfolgen.	Zeichenfolge (erforderlich)
healthPolicy	Die Clusterintegritätsrichtlinie, die beim Upgrade des Clusters verwendet wird.	ClusterHealthPolicy (erforderlich)
upgradeDomainTimeout	Die Zeitspanne, die jede Upgradedomäne abschließen muss, bevor das Upgrade ein Rollback ausgeführt wird. Das Timeout kann entweder im Format hh:mm:ss oder im d.hh:mm:ss.ms-Format vorliegen.	Zeichenfolge (erforderlich)
upgradeReplicaSetCheckTimeout	Die maximale Zeitspanne, während der die Verarbeitung einer Upgradedomäne blockiert und Verfügbarkeitsverlust verhindert wird, wenn es unerwartete Probleme gibt. Wenn dieses Timeout abläuft, wird die Verarbeitung der Upgradedomäne unabhängig von Verfügbarkeitsverlustproblemen fortgesetzt. Das Timeout wird beim Start jeder Upgradedomäne zurückgesetzt. Das Timeout kann entweder im Format hh:mm:ss oder im d.hh:mm:ss.ms-Format vorliegen.	Zeichenfolge (erforderlich)
upgradeTimeout	Die Zeitspanne, die das gesamte Upgrade abschließen muss, bevor ein Rollback für das Upgrade durchgeführt wird. Das Timeout kann entweder im Format hh:mm:ss oder im d.hh:mm:ss.ms-Format vorliegen.	Zeichenfolge (erforderlich)

ClusterUpgradeDeltaHealthPolicy

Name	BESCHREIBUNG	Wert
maxPercentDeltaUnhealthyApplications	Der maximal zulässige Prozentsatz der während Clusterupgrades zulässigen Anwendungsintegritätsbeeinträchtigungen. Das Delta wird zwischen dem Status der Anwendungen zu Beginn des Upgrades und dem Status der Anwendungen zum Zeitpunkt der Integritätsbewertung gemessen. Diese Überprüfung wird nach jedem erfolgreichen Upgrade einer Upgradedomäne durchgeführt, um sicherzustellen, dass sich der globale Clusterstatus innerhalb eines zulässigen Rahmens befindet. Systemdienste sind nicht enthalten.	int (erforderlich) Einschränkungen: Min-Wert = 0 Maximaler Wert = 100
maxPercentDeltaUnhealthyNodes	Der während eines Clusterupgrades zulässige Höchstprozentsatz der Integritätsminderung von Knoten. Das Delta wird zwischen den Status der Knoten am Anfang des Upgrades und den Status der Knoten zum Zeitpunkt der Integritätsbewertung gemessen. Diese Überprüfung wird nach jedem erfolgreichen Upgrade einer Upgradedomäne durchgeführt, um sicherzustellen, dass sich der globale Clusterstatus innerhalb eines zulässigen Rahmens befindet.	int (erforderlich) Einschränkungen: Min-Wert = 0 Maximaler Wert = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes	Der während eines Clusterupgrades zulässige Höchstprozentsatz der Integritätsminderung von Upgradedomänenknoten. Das Delta wird zwischen den Status der Upgradedomänenknoten am Anfang des Upgrades und den Status der Upgradedomänenknoten zum Zeitpunkt der Integritätsbewertung gemessen. Diese Überprüfung wird nach jedem erfolgreichen Upgrade einer Upgradedomäne für alle abgeschlossenen Upgradedomänen durchgeführt, um sicherzustellen, dass sich der globale Clusterstatus innerhalb eines zulässigen Rahmens befindet.	int (erforderlich) Einschränkungen: Min-Wert = 0 Maximaler Wert = 100

ClusterHealthPolicy

Name	BESCHREIBUNG	Wert
maxPercentUnhealthyApplications	Der maximal zulässige Prozentsatz fehlerhafter Anwendungen, bevor ein Fehler gemeldet wird. Soll es z. B.zulässig sein, dass 10 % der Anwendungen fehlerhaft sind, muss dieser Wert gleich „10“ sein.	INT Einschränkungen: Min-Wert = 0 Maximaler Wert = 100
maxPercentUnhealthyNodes	Der maximal zulässige Prozentsatz fehlerhafter Knoten, bevor ein Fehler gemeldet wird. Soll es z. B.zulässig sein, dass 10 % der Knoten fehlerhaft sind, muss dieser Wert gleich „10“ sein.	INT Einschränkungen: Min-Wert = 0 Maximaler Wert = 100

Schnellstartvorlagen

Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.

Vorlage	BESCHREIBUNG
Bereitstellen eines Ubuntu Service Fabric-Clusters mit 5 Knoten	Mit dieser Vorlage können Sie einen sicheren Service Fabric-Cluster mit 5 Knoten bereitstellen, der Ubuntu auf einer vmSS mit Standard_D2_V2 Größe ausführt.
Bereitstellen eines sicheren Clusters mit 5 Knoten	Mit dieser Vorlage können Sie einen sicheren Service Fabric-Cluster mit 5 Knoten unter Windows Server 2019 Datacenter auf einer VMSS mit Standard_D2_v2 Größe bereitstellen.
Bereitstellen eines sicheren Clusters mit 3 Knotentypen mit aktivierten NSGs	Mit dieser Vorlage können Sie einen sicheren 3-Knotentyp Service Fabric-Cluster mit Windows Server 2016 Data Center auf VMs mit Standard_D2 Größe bereitstellen. Mit dieser Vorlage können Sie den eingehenden und ausgehenden Netzwerkdatenverkehr mithilfe von Netzwerksicherheitsgruppen steuern.

Ressourcendefinition mit einer ARM-Vorlage

Der Clusterressourcentyp kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

Ressourcengruppen : Siehe Ressourcengruppenbereitstellungsbefehle

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ServiceFabric/clusters-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.ServiceFabric/clusters",
  "apiVersion": "2017-07-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "addOnFeatures": [ "string" ],
    "availableClusterVersions": [
      {
        "codeVersion": "string",
        "environment": "string",
        "supportExpiryUtc": "string"
      }
    ],
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string"
    },
    "certificate": {
      "thumbprint": "string",
      "thumbprintSecondary": "string",
      "x509StoreName": "string"
    },
    "clientCertificateCommonNames": [
      {
        "certificateCommonName": "string",
        "certificateIssuerThumbprint": "string",
        "isAdmin": "bool"
      }
    ],
    "clientCertificateThumbprints": [
      {
        "certificateThumbprint": "string",
        "isAdmin": "bool"
      }
    ],
    "clusterCodeVersion": "string",
    "clusterState": "string",
    "diagnosticsStorageAccountConfig": {
      "blobEndpoint": "string",
      "protectedAccountKeyName": "string",
      "queueEndpoint": "string",
      "storageAccountName": "string",
      "tableEndpoint": "string"
    },
    "fabricSettings": [
      {
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ]
      }
    ],
    "managementEndpoint": "string",
    "nodeTypes": [
      {
        "applicationPorts": {
          "endPort": "int",
          "startPort": "int"
        },
        "capacities": {
          "{customized property}": "string"
        },
        "clientConnectionEndpointPort": "int",
        "durabilityLevel": "string",
        "ephemeralPorts": {
          "endPort": "int",
          "startPort": "int"
        },
        "httpGatewayEndpointPort": "int",
        "isPrimary": "bool",
        "name": "string",
        "placementProperties": {
          "{customized property}": "string"
        },
        "reverseProxyEndpointPort": "int",
        "vmInstanceCount": "int"
      }
    ],
    "reliabilityLevel": "string",
    "reverseProxyCertificate": {
      "thumbprint": "string",
      "thumbprintSecondary": "string",
      "x509StoreName": "string"
    },
    "upgradeDescription": {
      "deltaHealthPolicy": {
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
      },
      "forceRestart": "bool",
      "healthCheckRetryTimeout": "string",
      "healthCheckStableDuration": "string",
      "healthCheckWaitDuration": "string",
      "healthPolicy": {
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int"
      },
      "upgradeDomainTimeout": "string",
      "upgradeReplicaSetCheckTimeout": "string",
      "upgradeTimeout": "string"
    },
    "upgradeMode": "string",
    "vmImage": "string"
  }
}

Eigenschaftswerte

clusters

Name	BESCHREIBUNG	Wert
type	Ressourcentyp	"Microsoft.ServiceFabric/clusters"
apiVersion	Die Ressourcen-API-Version	'2017-07-01-preview'
name	Der Ressourcenname	Zeichenfolge (erforderlich) Zeichenlimit: 4-23 Gültige Zeichen: Kleinbuchstaben, Zahlen und Bindestriche. Beginnen Sie mit einem Kleinbuchstaben. Enden Sie mit einem Kleinbuchstaben oder einer Zahl.
location	Ressourcenspeicherort	Zeichenfolge (erforderlich)
tags	Ressourcentags.	Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
properties	Die Clusterressourceneigenschaften	ClusterEigenschaften

ClusterEigenschaften

Name	BESCHREIBUNG	Wert
addOnFeatures	Die Liste der Add-On-Features, die im Cluster aktiviert werden sollen.	Zeichenfolgenarray, das folgendes enthält: "BackupRestoreService" "DnsService" 'RepairManager'
availableClusterVersions	Die für diesen Cluster verfügbaren Service Fabric-Laufzeitversionen.	ClusterVersionDetails[]
azureActiveDirectory	Die AAD-Authentifizierungseinstellungen des Clusters.	AzureActiveDirectory
Zertifikat	Das Zertifikat, das zum Sichern des Clusters verwendet werden soll. Das bereitgestellte Zertifikat wird für die Knotensicherheit innerhalb des Clusters, das SSL-Zertifikat für den Clusterverwaltungsendpunkt und den Standardadministratorclient verwendet.	CertificateDescription
clientCertificateCommonNames	Die Liste der Clientzertifikate, auf die durch allgemeinen Namen verwiesen wird, die zum Verwalten des Clusters zulässig sind.	ClientCertificateCommonName[]
clientCertificateThumbprints	Die Liste der Clientzertifikate, auf die durch Fingerabdruck verwiesen wird, auf die der Cluster verwaltet werden darf.	ClientCertificateThumbprint[]
clusterCodeVersion	Die Service Fabric-Runtimeversion des Clusters. Diese Eigenschaft kann nur durch Festlegen des Benutzers verwendet werden, wenn upgradeMode auf "Manuell" festgelegt ist. Verwenden Sie die ClusterVersion-API, um eine Liste der verfügbaren Service Fabric-Versionen für neue Cluster abzurufen. Verwenden Sie availableClusterVersions, um die Liste der verfügbaren Versionen für vorhandene Cluster abzurufen.	Zeichenfolge
clusterState	Der aktuelle Status des Clusters. – WaitingForNodes: Gibt an, dass die Clusterressource erstellt wird und der Ressourcenanbieter darauf wartet, dass die Service Fabric-VM-Erweiterung gestartet und gemeldet wird. – Bereitstellen: Gibt an, dass die Service Fabric-Runtime auf den VMs installiert wird. Die Clusterressource befindet sich in diesem Zustand, bis der Cluster gestartet wird und die Systemdienste betriebsbereit sind. – BaselineUpgrade: Gibt an, dass der Cluster aktualisiert wird, um die Clusterversion zu erstellen. Dieses Upgrade wird automatisch initiiert, wenn der Cluster zum ersten Mal gestartet wird. - UpdatingUserConfiguration: Gibt an, dass der Cluster mit der vom Benutzer bereitgestellten Konfiguration aktualisiert wird. - UpdatingUserCertificate: Gibt an, dass der Cluster mit dem vom Benutzer bereitgestellten Zertifikat aktualisiert wird. - UpdatingInfrastructure: Gibt an, dass der Cluster mit der neuesten Service Fabric-Runtimeversion aktualisiert wird. Dies geschieht nur, wenn upgradeMode auf "Automatisch" festgelegt ist. – ErzwingenClusterVersion: Gibt an, dass der Cluster eine andere Version als erwartet verwendet und der Cluster auf die erwartete Version aktualisiert wird. - UpgradeServiceUnreachable: Gibt an, dass der Systemdienst im Cluster den Ressourcenanbieter nicht mehr abruft. Cluster in diesem Zustand können nicht vom Ressourcenanbieter verwaltet werden. – AutoScale: Gibt an, dass der ReliabilityLevel des Clusters angepasst wird. – Bereit: Gibt an, dass sich der Cluster in einem stabilen Zustand befindet.	"AutoScale" "BaselineUpgrade" "Bereitstellen" "EnforcingClusterVersion" "Bereit" "UpdatingInfrastructure" "UpdatingUserCertificate" "UpdatingUserConfiguration" 'UpgradeServiceUnreachable' "WaitingForNodes"
diagnosticsStorageAccountConfig	Die Speicherkontoinformationen zum Speichern von Service Fabric-Diagnoseprotokollen.	DiagnosticsStorageAccountConfig
fabricSettings	Die Liste der benutzerdefinierten Fabriceinstellungen zum Konfigurieren des Clusters.	SettingsSectionDescription[]
managementEndpoint	Der HTTP-Verwaltungsendpunkt des Clusters.	Zeichenfolge (erforderlich)
nodeTypes	Die Liste der Knotentypen im Cluster.	NodeTypeDescription[] (erforderlich)
reliabilityLevel	Die Zuverlässigkeitsstufe legt die Größe der Replikatgruppen von Systemdiensten fest. Erfahren Sie mehr über ReliabilityLevel. – Keine: Führen Sie die Systemdienste mit der Anzahl der Zielreplikatesätze von 1 aus. Dies sollte nur für Testcluster verwendet werden. - Bronze: Führen Sie die Systemdienste mit der Anzahl der Zielreplikatesätze von 3 aus. Dies sollte nur für Testcluster verwendet werden. – Silber: Führen Sie die Systemdienste mit der Anzahl der Zielreplikatesätze von 5 aus. – Gold: Führen Sie die Systemdienste mit der Anzahl der Zielreplikatesätze von 7 aus. – Platinum: Führen Sie die Systemdienste mit der Anzahl der Zielreplikategruppen von 9 aus.	"Bronze" "Gold" "Keine" "Platinum" "Silber"
reverseProxyCertificate	Das vom Reverseproxy verwendete Serverzertifikat.	CertificateDescription
upgradeDescription	Die Richtlinie, die beim Upgraden des Clusters verwendet werden soll.	ClusterUpgradePolicy
upgradeMode	Der Upgrademodus des Clusters, wenn eine neue Service Fabric-Laufzeitversion verfügbar ist. – Automatisch: Der Cluster wird automatisch auf die neueste Service Fabric-Laufzeitversion aktualisiert, sobald sie verfügbar ist. – Manuell: Der Cluster wird nicht automatisch auf die neueste Service Fabric-Runtimeversion aktualisiert. Der Cluster wird aktualisiert, indem die clusterCodeVersion-Eigenschaft in der Clusterressource festgelegt wird.	"Automatisch" "Manuell"
vmImage	Das VM-Image VMSS wurde mit konfiguriert. Generische Namen wie Windows oder Linux können verwendet werden.	Zeichenfolge

ClusterVersionDetails

Name	BESCHREIBUNG	Wert
codeVersion	Die Service Fabric-Laufzeitversion des Clusters.	Zeichenfolge
Environment	Gibt an, ob diese Version für das Windows- oder Linux-Betriebssystem gilt.	"Linux" "Windows"
supportExpiryUtc	Das Datum des Ablaufs der Unterstützung der Version.	Zeichenfolge

AzureActiveDirectory

Name	BESCHREIBUNG	Wert
clientApplication	Anwendungs-ID der Azure Active Directory-Clientanwendung.	Zeichenfolge
clusterApplication	Anwendungs-ID des Azure Active Directory-Clusters.	Zeichenfolge
tenantId	Azure Active Directory-Mandanten-ID.	Zeichenfolge

CertificateDescription

Name	BESCHREIBUNG	Wert
thumbprint	Fingerabdruck des primären Zertifikats.	Zeichenfolge (erforderlich)
FingerabdruckSecondary	Fingerabdruck des sekundären Zertifikats.	Zeichenfolge
x509StoreName	Der speicherort des lokalen Zertifikatspeichers.	"AddressBook" "AuthRoot" "CertificateAuthority" "Unzulässig" "Meine" 'Stamm' "TrustedPeople" "TrustedPublisher"

ClientCertificateCommonName

Name	BESCHREIBUNG	Wert
certificateCommonName	Der allgemeine Name des Clientzertifikats.	Zeichenfolge (erforderlich)
certificateIssuerThumbprint	Der Ausstellerfingerabdruck des Clientzertifikats.	Zeichenfolge (erforderlich)
isAdmin	Gibt an, ob das Clientzertifikat Administratorzugriff auf den Cluster hat. Nicht-Administratorclients können nur schreibgeschützte Vorgänge im Cluster ausführen.	bool (erforderlich)

ClientCertificateThumbprint

Name	BESCHREIBUNG	Wert
certificateThumbprint	Der Fingerabdruck des Clientzertifikats.	Zeichenfolge (erforderlich)
isAdmin	Gibt an, ob das Clientzertifikat Administratorzugriff auf den Cluster hat. Nicht-Administratorclients können nur schreibgeschützte Vorgänge im Cluster ausführen.	bool (erforderlich)

DiagnosticsStorageAccountConfig

Name	BESCHREIBUNG	Wert
blobEndpoint	Der Blobendpunkt des Azure-Speicherkontos.	Zeichenfolge (erforderlich)
protectedAccountKeyName	Der name des geschützten Diagnose Speicherschlüssels.	Zeichenfolge (erforderlich)
queueEndpoint	Der Warteschlangenendpunkt des Azure-Speicherkontos.	Zeichenfolge (erforderlich)
storageAccountName	Azure-Speicherkontoname	Zeichenfolge (erforderlich)
tableEndpoint	Der Tabellenendpunkt des Azure-Speicherkontos.	Zeichenfolge (erforderlich)

EinstellungenSectionDescription

Name	BESCHREIBUNG	Wert
name	Der Abschnittsname der Fabriceinstellungen.	Zeichenfolge (erforderlich)
parameters	Die Auflistung von Parametern im Abschnitt.	SettingsParameterDescription[] (erforderlich)

SettingsParameterDescription

Name	BESCHREIBUNG	Wert
name	Der Parametername der Fabriceinstellung.	Zeichenfolge (erforderlich)
value	Der Parameterwert der Fabriceinstellung.	Zeichenfolge (erforderlich)

NodeTypeDescription

Name	BESCHREIBUNG	Wert
applicationPorts	Der Bereich der Ports, von dem aus der Cluster Service Fabric-Anwendungen Port zugewiesen hat.	EndpointRangeDescription
capacities	Die Kapazitätstags, die auf die Knoten im Knotentyp angewendet werden, verwendet der Clusterressourcen-Manager diese Tags, um zu verstehen, wie viel Ressource ein Knoten hat.	NodeTypeDescriptionCapacities
clientConnectionEndpointPort	Der Endpunktport für die TCP-Clusterverwaltung.	int (erforderlich)
durabilityLevel	Die Dauerhaftigkeitsebene des Knotentyps. Erfahren Sie mehr über DurabilityLevel. - Bronze – Keine Berechtigungen. Dies ist die Standardoption. – Silber: Die Infrastrukturaufträge können für einen Zeitraum von 30 Minuten pro UD angehalten werden. - Gold: Die Infrastrukturaufträge können für eine Dauer von 2 Stunden pro UD angehalten werden. Die Dauerhaftigkeit „Gold“ kann nur für VM-SKUs mit vollständigen Knoten wie D15_V2, G5 usw. aktiviert werden.	"Bronze" "Gold" "Silber"
ephemeralPorts	Der Bereich der kurzlebigen Ports, mit denen Knoten in diesem Knotentyp konfiguriert werden sollen.	EndpointRangeDescription
httpGatewayEndpointPort	Port des HTTP-Clusterverwaltungsendpunkts.	int (erforderlich)
IsPrimary	Der Knotentyp, auf dem die Systemdienste ausgeführt werden. Es sollte nur ein Knotentyp als primär markiert werden. Der primäre Knotentyp kann für vorhandene Cluster nicht gelöscht oder geändert werden.	bool (erforderlich)
name	Der Name des Knotentyps.	Zeichenfolge (erforderlich)
placementProperties	Die Auf Knoten im Knotentyp angewendeten Platzierungstags, die verwendet werden können, um anzugeben, wo bestimmte Dienste (Workload) ausgeführt werden sollen.	NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort	Der vom Reverseproxy verwendete Endpunkt.	INT
vmInstanceCount	Die Anzahl der Knoten im Knotentyp. Diese Anzahl sollte mit der Kapazitätseigenschaft in der entsprechenden VirtualMachineScaleSet-Ressource übereinstimmen.	int (erforderlich) Einschränkungen: Minimaler Wert = 1 Max. Wert = 2147483647

EndpointRangeDescription

Name	BESCHREIBUNG	Wert
endPort	Endport eines Portbereichs	int (erforderlich)
startPort	Starten des Ports eines Portbereichs	int (erforderlich)

NodeTypeDescriptionCapacities

Name	BESCHREIBUNG	Wert
{angepasste Eigenschaft}		Zeichenfolge

NodeTypeDescriptionPlacementProperties

Name	BESCHREIBUNG	Wert
{angepasste Eigenschaft}		Zeichenfolge

ClusterUpgradePolicy

Name	BESCHREIBUNG	Wert
deltaHealthPolicy	Die Delta-Integritätsrichtlinie, die beim Upgraden des Clusters verwendet wird.	ClusterUpgradeDeltaHealthPolicy
forceRestart	Wenn true, werden Prozesse während des Upgrades erzwungen neu gestartet, auch wenn sich die Codeversion nicht geändert hat (das Upgrade ändert nur Konfiguration oder Daten).	bool
healthCheckRetryTimeout	Die Zeitspanne, in der die Integritätsauswertung wiederholt wird, wenn die Anwendung oder der Cluster fehlerhaft ist, bevor das Upgrade ein Rollback ausgeführt wird. Das Timeout kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms vorliegen.	Zeichenfolge (erforderlich)
healthCheckStableDuration	Die Zeitspanne, während der die Anwendung oder der Cluster fehlerfrei bleiben muss, bevor das Upgrade mit der nächsten Upgradedomäne fortgesetzt wird. Die Dauer kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms vorliegen.	Zeichenfolge (erforderlich)
healthCheckWaitDuration	Die Zeitspanne, die nach Abschluss einer Upgradedomäne gewartet werden muss, bevor Integritätsprüfungen durchgeführt werden. Die Dauer kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms vorliegen.	Zeichenfolge (erforderlich)
healthPolicy	Die Clusterintegritätsrichtlinie, die beim Upgraden des Clusters verwendet wird.	ClusterHealthPolicy (erforderlich)
upgradeDomainTimeout	Die Zeitspanne, die jede Upgradedomäne abschließen muss, bevor ein Rollback für das Upgrade durchgeführt wird. Das Timeout kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms vorliegen.	Zeichenfolge (erforderlich)
upgradeReplicaSetCheckTimeout	Die maximale Zeitspanne, während der die Verarbeitung einer Upgradedomäne blockiert und Verfügbarkeitsverlust verhindert wird, wenn es unerwartete Probleme gibt. Wenn dieses Timeout abläuft, wird die Verarbeitung der Upgradedomäne unabhängig von Verfügbarkeitsverlustproblemen fortgesetzt. Das Timeout wird beim Start jeder Upgradedomäne zurückgesetzt. Das Timeout kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms vorliegen.	Zeichenfolge (erforderlich)
upgradeTimeout	Die Zeitspanne, die das Upgrade insgesamt durchführen muss, bevor ein Rollback für das Upgrade durchgeführt wird. Das Timeout kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms vorliegen.	Zeichenfolge (erforderlich)

ClusterUpgradeDeltaHealthPolicy

Name	BESCHREIBUNG	Wert
maxPercentDeltaUnhealthyApplications	Der maximal zulässige Prozentsatz der während Clusterupgrades zulässigen Beeinträchtigung der Anwendungsintegrität. Das Delta wird zwischen dem Status der Anwendungen zu Beginn des Upgrades und dem Zustand der Anwendungen zum Zeitpunkt der Integritätsauswertung gemessen. Diese Überprüfung wird nach jedem erfolgreichen Upgrade einer Upgradedomäne durchgeführt, um sicherzustellen, dass sich der globale Clusterstatus innerhalb eines zulässigen Rahmens befindet. Systemdienste sind darin nicht enthalten.	int (erforderlich) Einschränkungen: Min-Wert = 0 Maximaler Wert = 100
maxPercentDeltaUnhealthyNodes	Der während eines Clusterupgrades zulässige Höchstprozentsatz der Integritätsminderung von Knoten. Das Delta wird zwischen den Status der Knoten am Anfang des Upgrades und den Status der Knoten zum Zeitpunkt der Integritätsbewertung gemessen. Diese Überprüfung wird nach jedem erfolgreichen Upgrade einer Upgradedomäne durchgeführt, um sicherzustellen, dass sich der globale Clusterstatus innerhalb eines zulässigen Rahmens befindet.	int (erforderlich) Einschränkungen: Min-Wert = 0 Maximaler Wert = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes	Der während eines Clusterupgrades zulässige Höchstprozentsatz der Integritätsminderung von Upgradedomänenknoten. Das Delta wird zwischen den Status der Upgradedomänenknoten am Anfang des Upgrades und den Status der Upgradedomänenknoten zum Zeitpunkt der Integritätsbewertung gemessen. Diese Überprüfung wird nach jedem erfolgreichen Upgrade einer Upgradedomäne für alle abgeschlossenen Upgradedomänen durchgeführt, um sicherzustellen, dass sich der globale Clusterstatus innerhalb eines zulässigen Rahmens befindet.	int (erforderlich) Einschränkungen: Min-Wert = 0 Maximaler Wert = 100

ClusterHealthPolicy

Name	BESCHREIBUNG	Wert
maxPercentUnhealthyApplications	Der maximal zulässige Prozentsatz fehlerhafter Anwendungen, bevor ein Fehler gemeldet wird. Soll es z. B.zulässig sein, dass 10 % der Anwendungen fehlerhaft sind, muss dieser Wert gleich „10“ sein.	INT Einschränkungen: Min-Wert = 0 Maximaler Wert = 100
maxPercentUnhealthyNodes	Der maximal zulässige Prozentsatz fehlerhafter Knoten, bevor ein Fehler gemeldet wird. Soll es z. B.zulässig sein, dass 10 % der Knoten fehlerhaft sind, muss dieser Wert gleich „10“ sein.	INT Einschränkungen: Min-Wert = 0 Maximaler Wert = 100

Schnellstartvorlagen

Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.

Vorlage	BESCHREIBUNG
Bereitstellen eines Ubuntu Service Fabric-Clusters mit 5 Knoten	Mit dieser Vorlage können Sie einen sicheren Service Fabric-Cluster mit 5 Knoten bereitstellen, der Ubuntu auf einer vmSS mit Standard_D2_V2 Größe ausführt.
Bereitstellen eines sicheren Clusters mit 5 Knoten	Mit dieser Vorlage können Sie einen sicheren Service Fabric-Cluster mit 5 Knoten unter Windows Server 2019 Datacenter auf einer VMSS mit Standard_D2_v2 Größe bereitstellen.
Bereitstellen eines sicheren Clusters mit 3 Knotentypen mit aktivierten NSGs	Mit dieser Vorlage können Sie einen sicheren 3-Knotentyp Service Fabric-Cluster mit Windows Server 2016 Data Center auf VMs mit Standard_D2 Größe bereitstellen. Mit dieser Vorlage können Sie den eingehenden und ausgehenden Netzwerkdatenverkehr mithilfe von Netzwerksicherheitsgruppen steuern.

Terraform (AzAPI-Anbieter) Ressourcendefinition

Der Clusterressourcentyp kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ServiceFabric/clusters-Ressource zu erstellen, fügen Sie Der Vorlage die folgende Terraform-Ressource hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/clusters@2017-07-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      addOnFeatures = [
        "string"
      ]
      availableClusterVersions = [
        {
          codeVersion = "string"
          environment = "string"
          supportExpiryUtc = "string"
        }
      ]
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
      }
      certificate = {
        thumbprint = "string"
        thumbprintSecondary = "string"
        x509StoreName = "string"
      }
      clientCertificateCommonNames = [
        {
          certificateCommonName = "string"
          certificateIssuerThumbprint = "string"
          isAdmin = bool
        }
      ]
      clientCertificateThumbprints = [
        {
          certificateThumbprint = "string"
          isAdmin = bool
        }
      ]
      clusterCodeVersion = "string"
      clusterState = "string"
      diagnosticsStorageAccountConfig = {
        blobEndpoint = "string"
        protectedAccountKeyName = "string"
        queueEndpoint = "string"
        storageAccountName = "string"
        tableEndpoint = "string"
      }
      fabricSettings = [
        {
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
        }
      ]
      managementEndpoint = "string"
      nodeTypes = [
        {
          applicationPorts = {
            endPort = int
            startPort = int
          }
          capacities = {
            {customized property} = "string"
          }
          clientConnectionEndpointPort = int
          durabilityLevel = "string"
          ephemeralPorts = {
            endPort = int
            startPort = int
          }
          httpGatewayEndpointPort = int
          isPrimary = bool
          name = "string"
          placementProperties = {
            {customized property} = "string"
          }
          reverseProxyEndpointPort = int
          vmInstanceCount = int
        }
      ]
      reliabilityLevel = "string"
      reverseProxyCertificate = {
        thumbprint = "string"
        thumbprintSecondary = "string"
        x509StoreName = "string"
      }
      upgradeDescription = {
        deltaHealthPolicy = {
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
        }
        forceRestart = bool
        healthCheckRetryTimeout = "string"
        healthCheckStableDuration = "string"
        healthCheckWaitDuration = "string"
        healthPolicy = {
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
        }
        upgradeDomainTimeout = "string"
        upgradeReplicaSetCheckTimeout = "string"
        upgradeTimeout = "string"
      }
      upgradeMode = "string"
      vmImage = "string"
    }
  })
}

Eigenschaftswerte

clusters

Name	BESCHREIBUNG	Wert
type	Ressourcentyp	"Microsoft.ServiceFabric/clusters@2017-07-01-preview"
name	Der Ressourcenname	Zeichenfolge (erforderlich) Zeichenlimit: 4-23 Gültige Zeichen: Kleinbuchstaben, Zahlen und Bindestriche. Beginnen Sie mit einem Kleinbuchstaben. Enden Sie mit einem Kleinbuchstaben oder einer Zahl.
location	Ressourcenspeicherort	Zeichenfolge (erforderlich)
parent_id	Verwenden Sie zum Bereitstellen in einer Ressourcengruppe die ID dieser Ressourcengruppe.	Zeichenfolge (erforderlich)
tags	Ressourcentags.	Wörterbuch der Tagnamen und -werte.
properties	Die Clusterressourceneigenschaften	ClusterEigenschaften

ClusterEigenschaften

Name	BESCHREIBUNG	Wert
addOnFeatures	Die Liste der Add-On-Features, die im Cluster aktiviert werden sollen.	Zeichenfolgenarray, das folgendes enthält: "BackupRestoreService" "DnsService" "RepairManager"
availableClusterVersions	Die für diesen Cluster verfügbaren Service Fabric-Laufzeitversionen.	ClusterVersionDetails[]
azureActiveDirectory	Die AAD-Authentifizierungseinstellungen des Clusters.	AzureActiveDirectory
Zertifikat	Das Zertifikat, das zum Sichern des Clusters verwendet werden soll. Das bereitgestellte Zertifikat wird für die Knotensicherheit innerhalb des Clusters, das SSL-Zertifikat für den Clusterverwaltungsendpunkt und den Standardadministratorclient verwendet.	CertificateDescription
clientCertificateCommonNames	Die Liste der Clientzertifikate, auf die mit einem allgemeinen Namen verwiesen wird, die zum Verwalten des Clusters zulässig sind.	ClientCertificateCommonName[]
clientCertificateThumbprints	Die Liste der Clientzertifikate, auf die durch Fingerabdruck verwiesen wird, die zum Verwalten des Clusters zulässig sind.	ClientCertificateThumbprint[]
clusterCodeVersion	Die Service Fabric-Laufzeitversion des Clusters. Diese Eigenschaft kann nur durch Festlegen des Benutzers festgelegt werden, wenn upgradeMode auf "Manuell" festgelegt ist. Verwenden Sie die ClusterVersion-API, um eine Liste der verfügbaren Service Fabric-Versionen für neue Cluster abzurufen. Verwenden Sie availableClusterVersions, um die Liste der verfügbaren Versionen für vorhandene Cluster abzurufen.	Zeichenfolge
clusterState	Der aktuelle Status des Clusters. – WaitingForNodes: Gibt an, dass die Clusterressource erstellt wird und der Ressourcenanbieter darauf wartet, dass die Service Fabric-VM-Erweiterung gestartet und gemeldet wird. – Bereitstellen: Gibt an, dass die Service Fabric-Runtime auf den VMs installiert wird. Die Clusterressource befindet sich in diesem Zustand, bis der Cluster gestartet wird und die Systemdienste betriebsbereit sind. – BaselineUpgrade: Gibt an, dass der Cluster aktualisiert wird, um die Clusterversion zu erstellen. Dieses Upgrade wird automatisch initiiert, wenn der Cluster zum ersten Mal gestartet wird. - UpdatingUserConfiguration: Gibt an, dass der Cluster mit der vom Benutzer bereitgestellten Konfiguration aktualisiert wird. - UpdatingUserCertificate: Gibt an, dass der Cluster mit dem vom Benutzer bereitgestellten Zertifikat aktualisiert wird. - UpdatingInfrastructure: Gibt an, dass der Cluster mit der neuesten Service Fabric-Runtimeversion aktualisiert wird. Dies geschieht nur, wenn upgradeMode auf "Automatisch" festgelegt ist. – ErzwingenClusterVersion: Gibt an, dass der Cluster eine andere Version als erwartet verwendet und der Cluster auf die erwartete Version aktualisiert wird. - UpgradeServiceUnreachable: Gibt an, dass der Systemdienst im Cluster den Ressourcenanbieter nicht mehr abruft. Cluster in diesem Zustand können nicht vom Ressourcenanbieter verwaltet werden. – AutoScale: Gibt an, dass der ReliabilityLevel des Clusters angepasst wird. – Bereit: Gibt an, dass sich der Cluster in einem stabilen Zustand befindet.	"AutoScale" "BaselineUpgrade" "Bereitstellen" "ErzwingClusterVersion" „Ready“ "UpdatingInfrastructure" "UpdatingUserCertificate" "UpdatingUserConfiguration" "UpgradeServiceUnreachable" "WaitingForNodes"
diagnosticsStorageAccountConfig	Die Speicherkontoinformationen zum Speichern von Service Fabric-Diagnoseprotokollen.	DiagnosticsStorageAccountConfig
fabricSettings	Die Liste der benutzerdefinierten Fabriceinstellungen zum Konfigurieren des Clusters.	SettingsSectionDescription[]
managementEndpoint	Der HTTP-Verwaltungsendpunkt des Clusters.	Zeichenfolge (erforderlich)
nodeTypes	Die Liste der Knotentypen im Cluster.	NodeTypeDescription[] (erforderlich)
reliabilityLevel	Die Zuverlässigkeitsstufe legt die Größe der Replikatgruppen von Systemdiensten fest. Erfahren Sie mehr über ReliabilityLevel. – Keine: Führen Sie die Systemdienste mit der Anzahl der Zielreplikatesätze von 1 aus. Dies sollte nur für Testcluster verwendet werden. - Bronze: Führen Sie die Systemdienste mit der Anzahl der Zielreplikatesätze von 3 aus. Dies sollte nur für Testcluster verwendet werden. – Silber: Führen Sie die Systemdienste mit der Anzahl der Zielreplikatesätze von 5 aus. – Gold: Führen Sie die Systemdienste mit der Anzahl der Zielreplikatesätze von 7 aus. – Platinum: Führen Sie die Systemdienste mit der Anzahl der Zielreplikategruppen von 9 aus.	"Bronze" "Gold" "None" "Platinum" „Silber“
reverseProxyCertificate	Das vom Reverseproxy verwendete Serverzertifikat.	CertificateDescription
upgradeDescription	Die Richtlinie, die beim Upgraden des Clusters verwendet werden soll.	ClusterUpgradePolicy
upgradeMode	Der Upgrademodus des Clusters, wenn eine neue Service Fabric-Laufzeitversion verfügbar ist. – Automatisch: Der Cluster wird automatisch auf die neueste Service Fabric-Laufzeitversion aktualisiert, sobald sie verfügbar ist. – Manuell: Der Cluster wird nicht automatisch auf die neueste Service Fabric-Runtimeversion aktualisiert. Der Cluster wird aktualisiert, indem die clusterCodeVersion-Eigenschaft in der Clusterressource festgelegt wird.	"Automatisch" "Manuell"
vmImage	Das VM-Image VMSS wurde mit konfiguriert. Generische Namen wie Windows oder Linux können verwendet werden.	Zeichenfolge

ClusterVersionDetails

Name	BESCHREIBUNG	Wert
codeVersion	Die Service Fabric-Laufzeitversion des Clusters.	Zeichenfolge
Environment	Gibt an, ob diese Version für das Windows- oder Linux-Betriebssystem gilt.	"Linux" "Windows"
supportExpiryUtc	Das Datum des Ablaufs der Unterstützung der Version.	Zeichenfolge

AzureActiveDirectory

Name	BESCHREIBUNG	Wert
clientApplication	Anwendungs-ID der Azure Active Directory-Clientanwendung.	Zeichenfolge
clusterApplication	Anwendungs-ID des Azure Active Directory-Clusters.	Zeichenfolge
tenantId	Azure Active Directory-Mandanten-ID.	Zeichenfolge

CertificateDescription

Name	BESCHREIBUNG	Wert
thumbprint	Fingerabdruck des primären Zertifikats.	Zeichenfolge (erforderlich)
FingerabdruckSecondary	Fingerabdruck des sekundären Zertifikats.	Zeichenfolge
x509StoreName	Der lokale Zertifikatspeicherort.	"AddressBook" "AuthRoot" "CertificateAuthority" "Unzulässig" "My" "Stamm" "TrustedPeople" "TrustedPublisher"

ClientCertificateCommonName

Name	BESCHREIBUNG	Wert
certificateCommonName	Der allgemeine Name des Clientzertifikats.	Zeichenfolge (erforderlich)
certificateIssuerThumbprint	Der Ausstellerfingerabdruck des Clientzertifikats.	Zeichenfolge (erforderlich)
isAdmin	Gibt an, ob das Clientzertifikat über Administratorzugriff auf den Cluster verfügt. Nicht-Administratorclients können nur schreibgeschützte Vorgänge im Cluster ausführen.	bool (erforderlich)

ClientCertificateThumbprint

Name	BESCHREIBUNG	Wert
certificateThumbprint	Der Fingerabdruck des Clientzertifikats.	Zeichenfolge (erforderlich)
isAdmin	Gibt an, ob das Clientzertifikat über Administratorzugriff auf den Cluster verfügt. Nicht-Administratorclients können nur schreibgeschützte Vorgänge im Cluster ausführen.	bool (erforderlich)

DiagnosticsStorageAccountConfig

Name	BESCHREIBUNG	Wert
blobEndpoint	Der Blobendpunkt des Azure-Speicherkontos.	Zeichenfolge (erforderlich)
protectedAccountKeyName	Der name des geschützten Diagnose Speicherschlüssels.	Zeichenfolge (erforderlich)
queueEndpoint	Der Warteschlangenendpunkt des Azure-Speicherkontos.	Zeichenfolge (erforderlich)
storageAccountName	Azure-Speicherkontoname	Zeichenfolge (erforderlich)
tableEndpoint	Der Tabellenendpunkt des Azure-Speicherkontos.	Zeichenfolge (erforderlich)

SettingsSectionDescription

Name	BESCHREIBUNG	Wert
name	Der Abschnittsname der Fabriceinstellungen.	Zeichenfolge (erforderlich)
parameters	Die Auflistung der Parameter im Abschnitt.	SettingsParameterDescription[] (erforderlich)

SettingsParameterDescription

Name	BESCHREIBUNG	Wert
name	Der Parametername der Fabriceinstellung.	Zeichenfolge (erforderlich)
value	Der Parameterwert der Fabriceinstellung.	Zeichenfolge (erforderlich)

NodeTypeDescription

Name	BESCHREIBUNG	Wert
applicationPorts	Der Portbereich, von dem aus der Cluster Service Fabric-Anwendungen Port zugewiesen hat.	EndpointRangeDescription
capacities	Die Kapazitätstags, die auf die Knoten im Knotentyp angewendet werden, verwendet der Clusterressourcen-Manager diese Tags, um zu verstehen, wie viel Ressource ein Knoten hat.	NodeTypeDescriptionCapacities
clientConnectionEndpointPort	Port des TCP-Clusterverwaltungsendpunkts.	int (erforderlich)
durabilityLevel	Die Dauerhaftigkeitsebene des Knotentyps. Erfahren Sie mehr über DurabilityLevel. - Bronze : Keine Berechtigungen. Dies ist die Standardoption. – Silber: Die Infrastrukturaufträge können für eine Dauer von 30 Minuten pro UD angehalten werden. - Gold: Die Infrastrukturaufträge können für eine Dauer von 2 Stunden pro UD angehalten werden. Die Dauerhaftigkeit „Gold“ kann nur für VM-SKUs mit vollständigen Knoten wie D15_V2, G5 usw. aktiviert werden.	"Bronze" "Gold" „Silber“
ephemeralPorts	Der Bereich der kurzlebigen Ports, mit denen Knoten in diesem Knotentyp konfiguriert werden sollen.	EndpointRangeDescription
httpGatewayEndpointPort	Port des HTTP-Clusterverwaltungsendpunkts.	int (erforderlich)
IsPrimary	Der Knotentyp, auf dem die Systemdienste ausgeführt werden. Es sollte nur ein Knotentyp als primär markiert werden. Der primäre Knotentyp kann für vorhandene Cluster nicht gelöscht oder geändert werden.	bool (erforderlich)
name	Der Name des Knotentyps.	Zeichenfolge (erforderlich)
placementProperties	Die Auf Knoten im Knotentyp angewendeten Platzierungstags, die verwendet werden können, um anzugeben, wo bestimmte Dienste (Workload) ausgeführt werden sollen.	NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort	Der vom Reverseproxy verwendete Endpunkt.	INT
vmInstanceCount	Die Anzahl der Knoten im Knotentyp. Diese Anzahl sollte mit der Kapazitätseigenschaft in der entsprechenden VirtualMachineScaleSet-Ressource übereinstimmen.	int (erforderlich) Einschränkungen: Minimaler Wert = 1 Max. Wert = 2147483647

EndpointRangeDescription

Name	BESCHREIBUNG	Wert
endPort	Endport eines Portbereichs	int (erforderlich)
startPort	Starten des Ports eines Portbereichs	int (erforderlich)

NodeTypeDescriptionCapacities

Name	BESCHREIBUNG	Wert
{angepasste Eigenschaft}		Zeichenfolge

NodeTypeDescriptionPlacementProperties

Name	BESCHREIBUNG	Wert
{angepasste Eigenschaft}		Zeichenfolge

ClusterUpgradePolicy

Name	BESCHREIBUNG	Wert
deltaHealthPolicy	Die Delta-Integritätsrichtlinie, die beim Upgraden des Clusters verwendet wird.	ClusterUpgradeDeltaHealthPolicy
forceRestart	Wenn true, werden Prozesse während des Upgrades erzwungen neu gestartet, auch wenn sich die Codeversion nicht geändert hat (das Upgrade ändert nur Konfiguration oder Daten).	bool
healthCheckRetryTimeout	Die Zeitspanne, in der die Integritätsauswertung wiederholt wird, wenn die Anwendung oder der Cluster fehlerhaft ist, bevor das Upgrade ein Rollback ausgeführt wird. Das Timeout kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms vorliegen.	Zeichenfolge (erforderlich)
healthCheckStableDuration	Die Zeitspanne, während der die Anwendung oder der Cluster fehlerfrei bleiben muss, bevor das Upgrade mit der nächsten Upgradedomäne fortgesetzt wird. Die Dauer kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms vorliegen.	Zeichenfolge (erforderlich)
healthCheckWaitDuration	Die Zeitspanne, die nach Abschluss einer Upgradedomäne gewartet werden muss, bevor Integritätsprüfungen durchgeführt werden. Die Dauer kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms vorliegen.	Zeichenfolge (erforderlich)
healthPolicy	Die Clusterintegritätsrichtlinie, die beim Upgraden des Clusters verwendet wird.	ClusterHealthPolicy (erforderlich)
upgradeDomainTimeout	Die Zeitspanne, die jede Upgradedomäne abschließen muss, bevor ein Rollback für das Upgrade durchgeführt wird. Das Timeout kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms vorliegen.	Zeichenfolge (erforderlich)
upgradeReplicaSetCheckTimeout	Die maximale Zeitspanne, während der die Verarbeitung einer Upgradedomäne blockiert und Verfügbarkeitsverlust verhindert wird, wenn es unerwartete Probleme gibt. Wenn dieses Timeout abläuft, wird die Verarbeitung der Upgradedomäne unabhängig von Verfügbarkeitsverlustproblemen fortgesetzt. Das Timeout wird beim Start jeder Upgradedomäne zurückgesetzt. Das Timeout kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms vorliegen.	Zeichenfolge (erforderlich)
upgradeTimeout	Die Zeitspanne, die das Upgrade insgesamt durchführen muss, bevor ein Rollback für das Upgrade durchgeführt wird. Das Timeout kann entweder im Format hh:mm:ss oder im Format d.hh:mm:ss.ms vorliegen.	Zeichenfolge (erforderlich)

ClusterUpgradeDeltaHealthPolicy

Name	BESCHREIBUNG	Wert
maxPercentDeltaUnhealthyApplications	Der maximal zulässige Prozentsatz der während Clusterupgrades zulässigen Beeinträchtigung der Anwendungsintegrität. Das Delta wird zwischen dem Status der Anwendungen zu Beginn des Upgrades und dem Zustand der Anwendungen zum Zeitpunkt der Integritätsauswertung gemessen. Diese Überprüfung wird nach jedem erfolgreichen Upgrade einer Upgradedomäne durchgeführt, um sicherzustellen, dass sich der globale Clusterstatus innerhalb eines zulässigen Rahmens befindet. Systemdienste sind darin nicht enthalten.	int (erforderlich) Einschränkungen: Minimaler Wert = 0 Maximaler Wert = 100
maxPercentDeltaUnhealthyNodes	Der während eines Clusterupgrades zulässige Höchstprozentsatz der Integritätsminderung von Knoten. Das Delta wird zwischen den Status der Knoten am Anfang des Upgrades und den Status der Knoten zum Zeitpunkt der Integritätsbewertung gemessen. Diese Überprüfung wird nach jedem erfolgreichen Upgrade einer Upgradedomäne durchgeführt, um sicherzustellen, dass sich der globale Clusterstatus innerhalb eines zulässigen Rahmens befindet.	int (erforderlich) Einschränkungen: Minimaler Wert = 0 Maximaler Wert = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes	Der während eines Clusterupgrades zulässige Höchstprozentsatz der Integritätsminderung von Upgradedomänenknoten. Das Delta wird zwischen den Status der Upgradedomänenknoten am Anfang des Upgrades und den Status der Upgradedomänenknoten zum Zeitpunkt der Integritätsbewertung gemessen. Diese Überprüfung wird nach jedem erfolgreichen Upgrade einer Upgradedomäne für alle abgeschlossenen Upgradedomänen durchgeführt, um sicherzustellen, dass sich der globale Clusterstatus innerhalb eines zulässigen Rahmens befindet.	int (erforderlich) Einschränkungen: Minimaler Wert = 0 Maximaler Wert = 100

ClusterHealthPolicy

Name	BESCHREIBUNG	Wert
maxPercentUnhealthyApplications	Der maximal zulässige Prozentsatz fehlerhafter Anwendungen, bevor ein Fehler gemeldet wird. Soll es z. B.zulässig sein, dass 10 % der Anwendungen fehlerhaft sind, muss dieser Wert gleich „10“ sein.	INT Einschränkungen: Minimaler Wert = 0 Maximaler Wert = 100
maxPercentUnhealthyNodes	Der maximal zulässige Prozentsatz fehlerhafter Knoten, bevor ein Fehler gemeldet wird. Soll es z. B.zulässig sein, dass 10 % der Knoten fehlerhaft sind, muss dieser Wert gleich „10“ sein.	INT Einschränkungen: Minimaler Wert = 0 Maximaler Wert = 100

Share via

Microsoft.ServiceFabric-Cluster 2017-07-01-preview

Bicep-Ressourcendefinition

Ressourcenformat

Eigenschaftswerte

clusters

ClusterEigenschaften

ClusterVersionDetails

AzureActiveDirectory

CertificateDescription

ClientCertificateCommonName

ClientCertificateThumbprint

DiagnosticsStorageAccountConfig

EinstellungenSectionDescription

SettingsParameterDescription

NodeTypeDescription

EndpointRangeDescription

NodeTypeDescriptionCapacities

NodeTypeDescriptionPlacementProperties

ClusterUpgradePolicy

ClusterUpgradeDeltaHealthPolicy

ClusterHealthPolicy

Schnellstartvorlagen

Ressourcendefinition mit einer ARM-Vorlage

Ressourcenformat

Eigenschaftswerte

clusters

ClusterEigenschaften

ClusterVersionDetails

AzureActiveDirectory

CertificateDescription

ClientCertificateCommonName

ClientCertificateThumbprint

DiagnosticsStorageAccountConfig

EinstellungenSectionDescription

SettingsParameterDescription

NodeTypeDescription

EndpointRangeDescription

NodeTypeDescriptionCapacities

NodeTypeDescriptionPlacementProperties

ClusterUpgradePolicy

ClusterUpgradeDeltaHealthPolicy

ClusterHealthPolicy

Schnellstartvorlagen

Terraform (AzAPI-Anbieter) Ressourcendefinition

Ressourcenformat

Eigenschaftswerte

clusters

ClusterEigenschaften

ClusterVersionDetails

AzureActiveDirectory

CertificateDescription

ClientCertificateCommonName

ClientCertificateThumbprint

DiagnosticsStorageAccountConfig

SettingsSectionDescription

SettingsParameterDescription

NodeTypeDescription

EndpointRangeDescription

NodeTypeDescriptionCapacities

NodeTypeDescriptionPlacementProperties

ClusterUpgradePolicy

ClusterUpgradeDeltaHealthPolicy

ClusterHealthPolicy

Feedback

Feedback

Zusätzliche Ressourcen