Microsoft.ServiceFabric-Cluster 2023-11-01-Preview
Bicep-Ressourcendefinition
Der Clusterressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.ServiceFabric/Cluster-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.
resource symbolicname 'Microsoft.ServiceFabric/clusters@2023-11-01-preview' = {
location: 'string'
name: 'string'
properties: {
addOnFeatures: [
'string'
]
applicationTypeVersionsCleanupPolicy: {
maxUnusedVersionsToKeep: int
}
azureActiveDirectory: {
clientApplication: 'string'
clusterApplication: 'string'
tenantId: 'string'
}
certificate: {
thumbprint: 'string'
thumbprintSecondary: 'string'
x509StoreName: 'string'
}
certificateCommonNames: {
commonNames: [
{
certificateCommonName: 'string'
certificateIssuerThumbprint: 'string'
}
]
x509StoreName: 'string'
}
clientCertificateCommonNames: [
{
certificateCommonName: 'string'
certificateIssuerThumbprint: 'string'
isAdmin: bool
}
]
clientCertificateThumbprints: [
{
certificateThumbprint: 'string'
isAdmin: bool
}
]
clusterCodeVersion: 'string'
diagnosticsStorageAccountConfig: {
blobEndpoint: 'string'
protectedAccountKeyName: 'string'
protectedAccountKeyName2: 'string'
queueEndpoint: 'string'
storageAccountName: 'string'
tableEndpoint: 'string'
}
enableHttpGatewayExclusiveAuthMode: bool
eventStoreServiceEnabled: bool
fabricSettings: [
{
name: 'string'
parameters: [
{
name: 'string'
value: 'string'
}
]
}
]
infrastructureServiceManager: bool
managementEndpoint: 'string'
nodeTypes: [
{
applicationPorts: {
endPort: int
startPort: int
}
capacities: {
{customized property}: 'string'
}
clientConnectionEndpointPort: int
durabilityLevel: 'string'
ephemeralPorts: {
endPort: int
startPort: int
}
httpGatewayEndpointPort: int
httpGatewayTokenAuthEndpointPort: int
isPrimary: bool
isStateless: bool
multipleAvailabilityZones: bool
name: 'string'
placementProperties: {
{customized property}: 'string'
}
reverseProxyEndpointPort: int
vmInstanceCount: int
}
]
notifications: [
{
isEnabled: bool
notificationCategory: 'string'
notificationLevel: 'string'
notificationTargets: [
{
notificationChannel: 'string'
receivers: [
'string'
]
}
]
}
]
reliabilityLevel: 'string'
reverseProxyCertificate: {
thumbprint: 'string'
thumbprintSecondary: 'string'
x509StoreName: 'string'
}
reverseProxyCertificateCommonNames: {
commonNames: [
{
certificateCommonName: 'string'
certificateIssuerThumbprint: 'string'
}
]
x509StoreName: 'string'
}
sfZonalUpgradeMode: 'string'
upgradeDescription: {
deltaHealthPolicy: {
applicationDeltaHealthPolicies: {
{customized property}: {
defaultServiceTypeDeltaHealthPolicy: {
maxPercentDeltaUnhealthyServices: int
}
serviceTypeDeltaHealthPolicies: {
{customized property}: {
maxPercentDeltaUnhealthyServices: int
}
}
}
}
maxPercentDeltaUnhealthyApplications: int
maxPercentDeltaUnhealthyNodes: int
maxPercentUpgradeDomainDeltaUnhealthyNodes: int
}
forceRestart: bool
healthCheckRetryTimeout: 'string'
healthCheckStableDuration: 'string'
healthCheckWaitDuration: 'string'
healthPolicy: {
applicationHealthPolicies: {
{customized property}: {
defaultServiceTypeHealthPolicy: {
maxPercentUnhealthyServices: int
}
serviceTypeHealthPolicies: {
{customized property}: {
maxPercentUnhealthyServices: int
}
}
}
}
maxPercentUnhealthyApplications: int
maxPercentUnhealthyNodes: int
}
upgradeDomainTimeout: 'string'
upgradeReplicaSetCheckTimeout: 'string'
upgradeTimeout: 'string'
}
upgradeMode: 'string'
upgradePauseEndTimestampUtc: 'string'
upgradePauseStartTimestampUtc: 'string'
upgradeWave: 'string'
vmImage: 'string'
vmssZonalUpgradeMode: 'string'
waveUpgradePaused: bool
}
tags: {
{customized property}: 'string'
}
}
Eigenschaftswerte
ApplicationDeltaHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| defaultServiceTypeDeltaHealthPolicy | Die Delta-Integritätsrichtlinie, die standardmäßig verwendet wird, um den Status eines Diensttyps beim Upgrade des Clusters auszuwerten. | ServiceTypeDeltaHealthPolicy |
| serviceTypeDeltaHealthPolicies | Die Zuordnung mit der Delta-Integritätsrichtlinie des Diensttyps pro Diensttypname. Die Karte ist standardmäßig leer. | ServiceTypeDeltaHealthPolicyMap- |
ApplicationDeltaHealthPolicyMap
| Name | Beschreibung | Wert |
|---|
ApplicationHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| defaultServiceTypeHealthPolicy | Die Standardmäßig zum Auswerten der Integrität eines Diensttyps verwendete Integritätsrichtlinie. | ServiceTypeHealthPolicy- |
| serviceTypeHealthPolicies | Die Zuordnung mit der Diensttypintegritätsrichtlinie pro Diensttypname. Die Karte ist standardmäßig leer. | ServiceTypeHealthPolicyMap- |
ApplicationHealthPolicyMap
| Name | Beschreibung | Wert |
|---|
ApplicationTypeVersionsCleanupPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| maxUnusedVersionsToKeep | Anzahl der nicht verwendeten Versionen pro Anwendungstyp, die beibehalten werden sollen. | Int Zwänge: Min.-Wert = 0 (erforderlich) |
AzureActiveDirectory
| Name | Beschreibung | Wert |
|---|---|---|
| clientApplication | Azure Active Directory-Clientanwendungs-ID. | Schnur |
| clusterApplication | Anwendungs-ID der Azure Active Directory-Clusteranwendung. | Schnur |
| tenantId | Azure Active Directory-Mandanten-ID. | Schnur |
CertificateDescription
| Name | Beschreibung | Wert |
|---|---|---|
| Fingerabdruck | Fingerabdruck des primären Zertifikats. | Zeichenfolge (erforderlich) |
| thumbprintSecondary | Fingerabdruck des sekundären Zertifikats. | Schnur |
| x509StoreName | Der lokale Zertifikatspeicherort. | 'AddressBook' 'AuthRoot' "CertificateAuthority" "Unzulässig" 'Mein' 'Root' "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 auf dem 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 auf dem Cluster ausführen. | bool (erforderlich) |
ClusterHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| applicationHealthPolicies | Definiert die Zuordnung der Anwendungsintegritätsrichtlinie, die verwendet wird, um den Status einer Anwendung oder einer seiner untergeordneten Entitäten auszuwerten. | ApplicationHealthPolicyMap- |
| maxPercentUnhealthyApplications | Der maximal zulässige Prozentsatz von fehlerhaften Anwendungen, bevor ein Fehler gemeldet wird. Damit beispielsweise 10% von Anwendungen nicht einwandfrei sein können, wäre dieser Wert 10. Der Prozentsatz stellt den maximalen tolerierten Prozentsatz der Anwendungen dar, die fehlerhaft sein können, bevor der Cluster als Fehler betrachtet wird. Wenn der Prozentsatz berücksichtigt wird, aber mindestens eine fehlerhafte Anwendung vorhanden ist, wird der Status als Warnung ausgewertet. Dies wird berechnet, indem die Anzahl der fehlerhaften Anwendungen über die Gesamtanzahl der Anwendungsinstanzen im Cluster dividiert wird, mit Ausnahme von Anwendungen von Anwendungstypen, die in applicationTypeHealthPolicyMap enthalten sind. Die Berechnung wird aufgerundet, um einen Fehler bei einer kleinen Anzahl von Anwendungen zu tolerieren. Der Standardprozentsatz ist Null. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 |
| maxPercentUnhealthyNodes | Der maximal zulässige Prozentsatz von fehlerhaften Knoten, bevor ein Fehler gemeldet wird. Damit beispielsweise 10% von Knoten nicht einwandfrei sein können, wäre dieser Wert 10. Der Prozentsatz stellt den maximalen tolerierten Prozentsatz der Knoten dar, die fehlerhaft sein können, bevor der Cluster als Fehler betrachtet wird. Wenn der Prozentsatz berücksichtigt wird, aber mindestens ein fehlerhafter Knoten vorhanden ist, wird die Integrität als Warnung ausgewertet. Der Prozentsatz wird berechnet, indem die Anzahl der fehlerhaften Knoten über die Gesamtanzahl der Knoten im Cluster dividiert wird. Die Berechnung wird aufgerundet, um einen Fehler bei einer kleinen Anzahl von Knoten zu tolerieren. Der Standardprozentsatz ist Null. In großen Clustern sind einige Knoten für Reparaturen immer nach unten oder außerhalb, sodass dieser Prozentsatz so konfiguriert werden sollte, dass dies toleriert wird. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 |
ClusterProperties
| Name | Beschreibung | Wert |
|---|---|---|
| addOnFeatures | Die Liste der Add-On-Features, die im Cluster aktiviert werden sollen. | Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'BackupRestoreService' 'DnsService' 'RepairManager' 'ResourceMonitorService' |
| applicationTypeVersionsCleanupPolicy | Die Richtlinie zum Bereinigen nicht verwendeter Versionen. | ApplicationTypeVersionsCleanupPolicy- |
| azureActiveDirectory | Die AAD-Authentifizierungseinstellungen des Clusters. | AzureActiveDirectory- |
| Zertifikat | Das Zertifikat, das zum Sichern des Clusters verwendet werden soll. Das bereitgestellte Zertifikat wird für Knotensicherheit innerhalb des Clusters, SSL-Zertifikats für Den Clusterverwaltungsendpunkt und Standardadministratorclient verwendet. | certificateDescription- |
| certificateCommonNames | Beschreibt eine Liste der Serverzertifikate, auf die mithilfe eines allgemeinen Namens verwiesen wird, die zum Sichern des Clusters verwendet werden. | ServerCertificateCommonNames- |
| clientCertificateCommonNames | Die Liste der Clientzertifikate, auf die mit allgemeinem Namen verwiesen wird, die zum Verwalten des Clusters berechtigt sind. | ClientCertificateCommonName[] |
| clientCertificateThumbprints | Die Liste der Clientzertifikate, auf die durch Fingerabdruck verwiesen wird, die zum Verwalten des Clusters berechtigt sind. | ClientCertificateThumbprint[] |
| clusterCodeVersion | Die Service Fabric-Laufzeitversion des Clusters. Diese Eigenschaft kann nur dann festgelegt werden, wenn upgradeMode- auf "Manuell" festgelegt ist. Um eine Liste der verfügbaren Service Fabric-Versionen für neue Cluster abzurufen, verwenden Sie ClusterVersion-API. Um die Liste der verfügbaren Versionen für vorhandene Cluster abzurufen, verwenden Sie availableClusterVersions. | Schnur |
| diagnosticsStorageAccountConfig | Die Speicherkontoinformationen zum Speichern von Service Fabric-Diagnoseprotokollen. | DiagnosticsStorageAccountConfig |
| enableHttpGatewayExclusiveAuthMode | Bei "true" ist die tokenbasierte Authentifizierung für httpGatewayEndpoint nicht zulässig. Dies ist erforderlich, um TLS-Versionen 1.3 und höher zu unterstützen. Wenn die tokenbasierte Authentifizierung verwendet wird, muss HttpGatewayTokenAuthEndpointPort definiert werden. | Bool |
| eventStoreServiceEnabled | Gibt an, ob der Ereignisspeicherdienst aktiviert ist. | Bool |
| fabricSettings | Die Liste der benutzerdefinierten Fabric-Einstellungen zum Konfigurieren des Clusters. | SettingsSectionDescription[] |
| infrastructureServiceManager | Gibt an, ob der Infrastrukturdienst-Manager aktiviert ist. | Bool |
| managementEndpoint | Der HTTP-Verwaltungsendpunkt des Clusters. | Zeichenfolge (erforderlich) |
| nodeTypes | Die Liste der Knotentypen im Cluster. | NodeTypeDescription[] (erforderlich) |
| Benachrichtigungen | Gibt eine Liste der Benachrichtigungskanäle für Clusterereignisse an. | Benachrichtigung[] |
| reliabilityLevel | Die Zuverlässigkeitsebene legt die Replikatgruppengröße von Systemdiensten fest. Erfahren Sie mehr über ReliabilityLevel-. - None – Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 1 aus. Dies sollte nur für Testcluster verwendet werden. - Bronze – Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 3 aus. Dies sollte nur für Testcluster verwendet werden. - Silber – Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 5 aus. - Gold – Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 7 aus. - Platinum - Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 9 aus. |
"Bronze" 'Gold' 'None' "Platin" 'Silber' |
| reverseProxyCertificate | Das vom Reverseproxy verwendete Serverzertifikat. | certificateDescription- |
| reverseProxyCertificateCommonNames | Beschreibt eine Liste der Serverzertifikate, auf die mithilfe eines allgemeinen Namens verwiesen wird, die zum Sichern des Clusters verwendet werden. | ServerCertificateCommonNames- |
| sfZonalUpgradeMode | Diese Eigenschaft steuert die logische Gruppierung von VMs in Upgradedomänen (UDs). Diese Eigenschaft kann nicht geändert werden, wenn ein Knotentyp mit mehreren Verfügbarkeitszonen bereits im Cluster vorhanden ist. | "Hierarchisch" "Parallel" |
| upgradeDescription | Die Richtlinie, die beim Aktualisieren des Clusters verwendet werden soll. | ClusterUpgradePolicy- |
| upgradeMode | Der Upgrademodus des Clusters, wenn eine neue Service Fabric-Laufzeitversion verfügbar ist. | "Automatisch" "Manuell" |
| upgradePauseEndTimestampUtc | Gibt das Enddatum und die Endzeit an, um automatische Laufzeitversionsupgrades auf dem Cluster für einen bestimmten Zeitraum im Cluster (UTC) anzuhalten. | Schnur |
| upgradePauseStartTimestampUtc | Gibt das Startdatum und die Startzeit an, um automatische Laufzeitversionsupgrades auf dem Cluster für einen bestimmten Zeitraum im Cluster (UTC) anzuhalten. | Schnur |
| upgradeWave | Gibt an, wann nach der Veröffentlichung neue Clusterlaufzeitversionsupgrades angewendet werden. Standardmäßig ist Wave0. Gilt nur, wenn upgradeMode- auf "Automatisch" festgelegt ist. | "Wave0" "Welle1" "Welle2" |
| vmImage | Das VM-Image VMSS wurde konfiguriert. Generische Namen wie Windows oder Linux können verwendet werden. | Schnur |
| vmssZonalUpgradeMode | Diese Eigenschaft definiert den Upgrademodus für den Skalierungssatz des virtuellen Computers, es ist obligatorisch, wenn ein Knotentyp mit mehreren Verfügbarkeitszonen hinzugefügt wird. | "Hierarchisch" "Parallel" |
| waveUpgradePaused | Boolescher Wert, um automatische Laufzeitversionsupgrades auf den Cluster anzuhalten. | Bool |
ClusterUpgradeDeltaHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| applicationDeltaHealthPolicies | Definiert die Zuordnung der Anwendungsdelta-Integritätsrichtlinie, die zum Auswerten der Integrität einer Anwendung oder einer seiner untergeordneten Entitäten beim Upgrade des Clusters verwendet wird. | ApplicationDeltaHealthPolicyMap- |
| maxPercentDeltaUnhealthyApplications | Der maximal zulässige Prozentsatz der Während von Clusterupgrades zulässigen Anwendungsintegritätsbeeinträchtigungen. Das Delta wird zwischen dem Status der Anwendungen am Anfang des Upgrades und dem Status der Anwendungen zum Zeitpunkt der Integritätsbewertung gemessen. Die Überprüfung wird nach abschluss des Upgrade-Domänenupgrades durchgeführt, um sicherzustellen, dass der globale Status des Clusters in tolerierten Grenzwerten liegt. Systemdienste sind in diesem Fall nicht enthalten. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 (erforderlich) |
| maxPercentDeltaUnhealthyNodes | Der maximal zulässige Prozentsatz der Während von Clusterupgrades zulässigen Knotenintegritätsbeeinträchtigung. Das Delta wird zwischen dem Zustand der Knoten am Anfang des Upgrades und dem Status der Knoten zum Zeitpunkt der Integritätsauswertung gemessen. Die Überprüfung wird nach abschluss des Upgrade-Domänenupgrades durchgeführt, um sicherzustellen, dass der globale Status des Clusters in tolerierten Grenzwerten liegt. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 (erforderlich) |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | Der maximal zulässige Prozentsatz der Integritätsbeeinträchtigung der Upgradedomänenknoten, die während Clusterupgrades zulässig sind. Das Delta wird zwischen dem Status der Upgradedomänenknoten am Anfang des Upgrades und dem Status der Upgradedomänenknoten zum Zeitpunkt der Integritätsauswertung gemessen. Die Überprüfung wird nach jedem Abschluss des Upgrade-Domänenupgrades für alle abgeschlossenen Upgradedomänen durchgeführt, um sicherzustellen, dass der Status der Upgradedomänen in tolerierten Grenzwerten liegt. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 (erforderlich) |
ClusterUpgradePolicy
| Name | Beschreibung | Wert |
|---|---|---|
| deltaHealthPolicy | Die Cluster-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 Daten). | Bool |
| healthCheckRetryTimeout | Die Zeitspanne zum Wiederholen der Integritätsauswertung, wenn die Anwendung oder der Cluster nicht korrekt ist, bevor das Upgrade zurückgesetzt wird. Das Timeout kann entweder im Format "hh:mm:ss" oder im Format "d.hh:mm:ss.ms" vorliegen. | Zeichenfolge (erforderlich) |
| healthCheckStableDuration | Die Zeitspanne, die die Anwendung oder der Cluster fehlerfrei bleiben muss, bevor das Upgrade zur 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 soll, 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 Upgrade des Clusters verwendet wird. | ClusterHealthPolicy- (erforderlich) |
| upgradeDomainTimeout | Der Zeitraum, in dem jede Upgradedomäne abgeschlossen sein muss, bevor das Upgrade zurückgesetzt wird. Das Timeout kann entweder im Format "hh:mm:ss" oder im Format "d.hh:mm:ss.ms" vorliegen. | Zeichenfolge (erforderlich) |
| upgradeReplicaSetCheckTimeout | Die maximale Zeit, um die Verarbeitung einer Upgradedomäne zu blockieren und den Verlust der Verfügbarkeit zu verhindern, wenn unerwartete Probleme auftreten. Wenn dieses Timeout abläuft, wird die Verarbeitung der Upgradedomäne unabhängig von Verfügbarkeitsverlustproblemen fortgesetzt. Das Timeout wird am Anfang 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 | Der Zeitraum, in dem das gesamte Upgrade abgeschlossen sein muss, bevor das Upgrade zurückgesetzt wird. Das Timeout kann entweder im Format "hh:mm:ss" oder im Format "d.hh:mm:ss.ms" vorliegen. | Zeichenfolge (erforderlich) |
DiagnosticsStorageAccountConfig
| Name | Beschreibung | Wert |
|---|---|---|
| blobEndpoint | Der BLOB-Endpunkt des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
| protectedAccountKeyName | Der Name des geschützten Diagnosespeicherschlüssels. | Zeichenfolge (erforderlich) |
| protectedAccountKeyName2 | Der Name des sekundären geschützten Diagnosespeicherschlüssels. Wenn einer der Speicherkontoschlüssel gedreht wird, wird der Cluster auf die Verwendung der anderen zurückgegriffen. | Schnur |
| queueEndpoint | Der Warteschlangenendpunkt des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
| storageAccountName | Der Name des Azure-Speicherkontos. | Zeichenfolge (erforderlich) |
| tableEndpoint | Der Tabellenendpunkt des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
EndpointRangeDescription
| Name | Beschreibung | Wert |
|---|---|---|
| endPort | Endport eines Bereichs von Ports | int (erforderlich) |
| startPort | Starten des Ports eines Portbereichs | int (erforderlich) |
Microsoft.ServiceFabric/Cluster
| Name | Beschreibung | Wert |
|---|---|---|
| Ort | Azure-Ressourcenspeicherort. | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| Eigenschaften | Die Clusterressourceneigenschaften | ClusterProperties- |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
NodeTypeDescription
| Name | Beschreibung | Wert |
|---|---|---|
| applicationPorts | Der Bereich der Ports, von denen der Cluster portieren zu Service Fabric-Anwendungen zugewiesen wurde. | EndpointRangeDescription- |
| Kapazitäten | 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 TCP-Clusterverwaltungsendpunktport. | int (erforderlich) |
| durabilityLevel | Die Haltbarkeitsebene des Knotentyps. Erfahren Sie mehr über DurabilityLevel. - Bronze - Keine Rechte. Dies ist die Standardeinstellung. - Silber – Die Infrastrukturaufträge können für eine Dauer von 10 Minuten pro UD angehalten werden. - Gold – Die Infrastrukturaufträge können für eine Dauer von 2 Stunden pro UD angehalten werden. Gold-Haltbarkeit kann nur auf vollständigen KNOTEN-VM-Skus 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 | Der HTTP-Clusterverwaltungsendpunktport. | int (erforderlich) |
| httpGatewayTokenAuthEndpointPort | Der Port, der für tokenauthentifizierungsbasierte HTTPS-Verbindungen mit dem Cluster verwendet wird. Kann nicht auf denselben Port wie HttpGatewayEndpoint festgelegt werden. | Int |
| isPrimary | Der Knotentyp, auf dem Systemdienste ausgeführt werden. Nur ein Knotentyp sollte als primär markiert werden. Der primäre Knotentyp kann für vorhandene Cluster nicht gelöscht oder geändert werden. | bool (erforderlich) |
| isStateless | Gibt an, ob der Knotentyp nur zustandslose Workloads hosten kann. | Bool |
| multipleAvailabilityZones | Gibt an, ob der Knotentyp aktiviert ist, um mehrere Zonen zu unterstützen. | Bool |
| Name | Der Name des Knotentyps. | Zeichenfolge (erforderlich) |
| placementProperties | Die Platzierungstags, die auf Knoten im Knotentyp angewendet werden, die verwendet werden können, um anzugeben, wo bestimmte Dienste (Workload) ausgeführt werden sollen. | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | Der vom Reverseproxy verwendete Endpunkt. | Int |
| vmInstanceCount | VMInstanceCount sollte 1 bis n sein, wobei n die Anzahl der VM-Instanzen angibt, die diesem nodeType entsprechen. VMInstanceCount = 0 kann nur in diesen Szenarien ausgeführt werden: NodeType ist ein sekundärer NodeType. Haltbarkeit = Bronze oder Haltbarkeit >= Bronze und InfrastructureServiceManager = true. Wenn VMInstanceCount = 0, impliziert, dass die virtuellen Computer für diesen nodeType nicht für die anfängliche Berechnung der Clustergröße verwendet werden. | Int Zwänge: Min.-Wert = 0 Max. Wert = 2147483647 (erforderlich) |
NodeTypeDescriptionCapacities
| Name | Beschreibung | Wert |
|---|
NodeTypeDescriptionPlacementProperties
| Name | Beschreibung | Wert |
|---|
Benachrichtigung
| Name | Beschreibung | Wert |
|---|---|---|
| isEnabled | Gibt an, ob die Benachrichtigung aktiviert ist. | bool (erforderlich) |
| notificationCategory | Die Kategorie der Benachrichtigung. | "WaveProgress" (erforderlich) |
| notificationLevel | Die Ebene der Benachrichtigung. | "Alle" "Kritisch" (erforderlich) |
| notificationTargets | Liste der Ziele, die die Benachrichtigung abonnieren. | NotificationTarget-[] (erforderlich) |
NotificationTarget
| Name | Beschreibung | Wert |
|---|---|---|
| notificationChannel | Der Benachrichtigungskanal gibt den Typ der Empfänger an, die die Benachrichtigung abonniert haben, entweder Benutzer oder Abonnement. | "EmailSubscription" "EmailUser" (erforderlich) |
| Empfänger | Liste der Ziele, die die Benachrichtigung abonnieren. | string[] (erforderlich) |
ResourceTags
| Name | Beschreibung | Wert |
|---|
ServerCertificateCommonName
| Name | Beschreibung | Wert |
|---|---|---|
| certificateCommonName | Der allgemeine Name des Serverzertifikats. | Zeichenfolge (erforderlich) |
| certificateIssuerThumbprint | Der Ausstellerfingerabdruck des Serverzertifikats. | Zeichenfolge (erforderlich) |
ServerCertificateCommonNames
| Name | Beschreibung | Wert |
|---|---|---|
| commonNames | Die Liste der Serverzertifikate, auf die mit allgemeinem Namen verwiesen wird, die zum Sichern des Clusters verwendet werden. | ServerCertificateCommonName[] |
| x509StoreName | Der lokale Zertifikatspeicherort. | 'AddressBook' 'AuthRoot' "CertificateAuthority" "Unzulässig" 'Mein' 'Root' "TrustedPeople" 'TrustedPublisher' |
ServiceTypeDeltaHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| maxPercentDeltaUnhealthyServices | Der maximal zulässige Prozentsatz der Dienstintegritätsverschlechterung, die während Clusterupgrades zulässig ist. Das Delta wird zwischen dem Status der Dienste am Anfang des Upgrades und dem Status der Dienste zum Zeitpunkt der Integritätsbewertung gemessen. Die Überprüfung wird nach abschluss des Upgrade-Domänenupgrades durchgeführt, um sicherzustellen, dass der globale Status des Clusters in tolerierten Grenzwerten liegt. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 |
ServiceTypeDeltaHealthPolicyMap
| Name | Beschreibung | Wert |
|---|
ServiceTypeHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| maxPercentUnhealthyServices | Der maximale Prozentsatz der Dienste, die nicht fehlerfrei sein dürfen, bevor Ihre Anwendung als Fehler betrachtet wird. | Int Zwänge: Min.-Wert = 0 Max. Wert = 100 |
ServiceTypeHealthPolicyMap
| Name | Beschreibung | Wert |
|---|
SettingsParameterDescription
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Parametername der Fabric-Einstellung. | Zeichenfolge (erforderlich) |
| Wert | Der Parameterwert der Fabric-Einstellung. | Zeichenfolge (erforderlich) |
SettingsSectionDescription
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Abschnittsname der Fabric-Einstellungen. | Zeichenfolge (erforderlich) |
| Parameter | Die Sammlung von Parametern im Abschnitt. | SettingsParameterDescription[] (erforderlich) |
Schnellstartbeispiele
Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.
| Bicep-Datei | Beschreibung |
|---|---|
| Bereitstellen eines sicheren Cluster mit 5 Knoten | Mit dieser Vorlage können Sie einen sicheren 5-Knoten-Service Fabric-Cluster unter Windows Server 2019 Datacenter auf einem Standard_D2_v2 Size VMSS bereitstellen. |
ARM-Vorlagenressourcendefinition
Der Clusterressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.ServiceFabric/Cluster-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.
{
"type": "Microsoft.ServiceFabric/clusters",
"apiVersion": "2023-11-01-preview",
"name": "string",
"location": "string",
"properties": {
"addOnFeatures": [ "string" ],
"applicationTypeVersionsCleanupPolicy": {
"maxUnusedVersionsToKeep": "int"
},
"azureActiveDirectory": {
"clientApplication": "string",
"clusterApplication": "string",
"tenantId": "string"
},
"certificate": {
"thumbprint": "string",
"thumbprintSecondary": "string",
"x509StoreName": "string"
},
"certificateCommonNames": {
"commonNames": [
{
"certificateCommonName": "string",
"certificateIssuerThumbprint": "string"
}
],
"x509StoreName": "string"
},
"clientCertificateCommonNames": [
{
"certificateCommonName": "string",
"certificateIssuerThumbprint": "string",
"isAdmin": "bool"
}
],
"clientCertificateThumbprints": [
{
"certificateThumbprint": "string",
"isAdmin": "bool"
}
],
"clusterCodeVersion": "string",
"diagnosticsStorageAccountConfig": {
"blobEndpoint": "string",
"protectedAccountKeyName": "string",
"protectedAccountKeyName2": "string",
"queueEndpoint": "string",
"storageAccountName": "string",
"tableEndpoint": "string"
},
"enableHttpGatewayExclusiveAuthMode": "bool",
"eventStoreServiceEnabled": "bool",
"fabricSettings": [
{
"name": "string",
"parameters": [
{
"name": "string",
"value": "string"
}
]
}
],
"infrastructureServiceManager": "bool",
"managementEndpoint": "string",
"nodeTypes": [
{
"applicationPorts": {
"endPort": "int",
"startPort": "int"
},
"capacities": {
"{customized property}": "string"
},
"clientConnectionEndpointPort": "int",
"durabilityLevel": "string",
"ephemeralPorts": {
"endPort": "int",
"startPort": "int"
},
"httpGatewayEndpointPort": "int",
"httpGatewayTokenAuthEndpointPort": "int",
"isPrimary": "bool",
"isStateless": "bool",
"multipleAvailabilityZones": "bool",
"name": "string",
"placementProperties": {
"{customized property}": "string"
},
"reverseProxyEndpointPort": "int",
"vmInstanceCount": "int"
}
],
"notifications": [
{
"isEnabled": "bool",
"notificationCategory": "string",
"notificationLevel": "string",
"notificationTargets": [
{
"notificationChannel": "string",
"receivers": [ "string" ]
}
]
}
],
"reliabilityLevel": "string",
"reverseProxyCertificate": {
"thumbprint": "string",
"thumbprintSecondary": "string",
"x509StoreName": "string"
},
"reverseProxyCertificateCommonNames": {
"commonNames": [
{
"certificateCommonName": "string",
"certificateIssuerThumbprint": "string"
}
],
"x509StoreName": "string"
},
"sfZonalUpgradeMode": "string",
"upgradeDescription": {
"deltaHealthPolicy": {
"applicationDeltaHealthPolicies": {
"{customized property}": {
"defaultServiceTypeDeltaHealthPolicy": {
"maxPercentDeltaUnhealthyServices": "int"
},
"serviceTypeDeltaHealthPolicies": {
"{customized property}": {
"maxPercentDeltaUnhealthyServices": "int"
}
}
}
},
"maxPercentDeltaUnhealthyApplications": "int",
"maxPercentDeltaUnhealthyNodes": "int",
"maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
},
"forceRestart": "bool",
"healthCheckRetryTimeout": "string",
"healthCheckStableDuration": "string",
"healthCheckWaitDuration": "string",
"healthPolicy": {
"applicationHealthPolicies": {
"{customized property}": {
"defaultServiceTypeHealthPolicy": {
"maxPercentUnhealthyServices": "int"
},
"serviceTypeHealthPolicies": {
"{customized property}": {
"maxPercentUnhealthyServices": "int"
}
}
}
},
"maxPercentUnhealthyApplications": "int",
"maxPercentUnhealthyNodes": "int"
},
"upgradeDomainTimeout": "string",
"upgradeReplicaSetCheckTimeout": "string",
"upgradeTimeout": "string"
},
"upgradeMode": "string",
"upgradePauseEndTimestampUtc": "string",
"upgradePauseStartTimestampUtc": "string",
"upgradeWave": "string",
"vmImage": "string",
"vmssZonalUpgradeMode": "string",
"waveUpgradePaused": "bool"
},
"tags": {
"{customized property}": "string"
}
}
Eigenschaftswerte
ApplicationDeltaHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| defaultServiceTypeDeltaHealthPolicy | Die Delta-Integritätsrichtlinie, die standardmäßig verwendet wird, um den Status eines Diensttyps beim Upgrade des Clusters auszuwerten. | ServiceTypeDeltaHealthPolicy |
| serviceTypeDeltaHealthPolicies | Die Zuordnung mit der Delta-Integritätsrichtlinie des Diensttyps pro Diensttypname. Die Karte ist standardmäßig leer. | ServiceTypeDeltaHealthPolicyMap- |
ApplicationDeltaHealthPolicyMap
| Name | Beschreibung | Wert |
|---|
ApplicationHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| defaultServiceTypeHealthPolicy | Die Standardmäßig zum Auswerten der Integrität eines Diensttyps verwendete Integritätsrichtlinie. | ServiceTypeHealthPolicy- |
| serviceTypeHealthPolicies | Die Zuordnung mit der Diensttypintegritätsrichtlinie pro Diensttypname. Die Karte ist standardmäßig leer. | ServiceTypeHealthPolicyMap- |
ApplicationHealthPolicyMap
| Name | Beschreibung | Wert |
|---|
ApplicationTypeVersionsCleanupPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| maxUnusedVersionsToKeep | Anzahl der nicht verwendeten Versionen pro Anwendungstyp, die beibehalten werden sollen. | Int Zwänge: Min.-Wert = 0 (erforderlich) |
AzureActiveDirectory
| Name | Beschreibung | Wert |
|---|---|---|
| clientApplication | Azure Active Directory-Clientanwendungs-ID. | Schnur |
| clusterApplication | Anwendungs-ID der Azure Active Directory-Clusteranwendung. | Schnur |
| tenantId | Azure Active Directory-Mandanten-ID. | Schnur |
CertificateDescription
| Name | Beschreibung | Wert |
|---|---|---|
| Fingerabdruck | Fingerabdruck des primären Zertifikats. | Zeichenfolge (erforderlich) |
| thumbprintSecondary | Fingerabdruck des sekundären Zertifikats. | Schnur |
| x509StoreName | Der lokale Zertifikatspeicherort. | 'AddressBook' 'AuthRoot' "CertificateAuthority" "Unzulässig" 'Mein' 'Root' "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 auf dem 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 auf dem Cluster ausführen. | bool (erforderlich) |
ClusterHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| applicationHealthPolicies | Definiert die Zuordnung der Anwendungsintegritätsrichtlinie, die verwendet wird, um den Status einer Anwendung oder einer seiner untergeordneten Entitäten auszuwerten. | ApplicationHealthPolicyMap- |
| maxPercentUnhealthyApplications | Der maximal zulässige Prozentsatz von fehlerhaften Anwendungen, bevor ein Fehler gemeldet wird. Damit beispielsweise 10% von Anwendungen nicht einwandfrei sein können, wäre dieser Wert 10. Der Prozentsatz stellt den maximalen tolerierten Prozentsatz der Anwendungen dar, die fehlerhaft sein können, bevor der Cluster als Fehler betrachtet wird. Wenn der Prozentsatz berücksichtigt wird, aber mindestens eine fehlerhafte Anwendung vorhanden ist, wird der Status als Warnung ausgewertet. Dies wird berechnet, indem die Anzahl der fehlerhaften Anwendungen über die Gesamtanzahl der Anwendungsinstanzen im Cluster dividiert wird, mit Ausnahme von Anwendungen von Anwendungstypen, die in applicationTypeHealthPolicyMap enthalten sind. Die Berechnung wird aufgerundet, um einen Fehler bei einer kleinen Anzahl von Anwendungen zu tolerieren. Der Standardprozentsatz ist Null. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 |
| maxPercentUnhealthyNodes | Der maximal zulässige Prozentsatz von fehlerhaften Knoten, bevor ein Fehler gemeldet wird. Damit beispielsweise 10% von Knoten nicht einwandfrei sein können, wäre dieser Wert 10. Der Prozentsatz stellt den maximalen tolerierten Prozentsatz der Knoten dar, die fehlerhaft sein können, bevor der Cluster als Fehler betrachtet wird. Wenn der Prozentsatz berücksichtigt wird, aber mindestens ein fehlerhafter Knoten vorhanden ist, wird die Integrität als Warnung ausgewertet. Der Prozentsatz wird berechnet, indem die Anzahl der fehlerhaften Knoten über die Gesamtanzahl der Knoten im Cluster dividiert wird. Die Berechnung wird aufgerundet, um einen Fehler bei einer kleinen Anzahl von Knoten zu tolerieren. Der Standardprozentsatz ist Null. In großen Clustern sind einige Knoten für Reparaturen immer nach unten oder außerhalb, sodass dieser Prozentsatz so konfiguriert werden sollte, dass dies toleriert wird. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 |
ClusterProperties
| Name | Beschreibung | Wert |
|---|---|---|
| addOnFeatures | Die Liste der Add-On-Features, die im Cluster aktiviert werden sollen. | Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'BackupRestoreService' 'DnsService' 'RepairManager' 'ResourceMonitorService' |
| applicationTypeVersionsCleanupPolicy | Die Richtlinie zum Bereinigen nicht verwendeter Versionen. | ApplicationTypeVersionsCleanupPolicy- |
| azureActiveDirectory | Die AAD-Authentifizierungseinstellungen des Clusters. | AzureActiveDirectory- |
| Zertifikat | Das Zertifikat, das zum Sichern des Clusters verwendet werden soll. Das bereitgestellte Zertifikat wird für Knotensicherheit innerhalb des Clusters, SSL-Zertifikats für Den Clusterverwaltungsendpunkt und Standardadministratorclient verwendet. | certificateDescription- |
| certificateCommonNames | Beschreibt eine Liste der Serverzertifikate, auf die mithilfe eines allgemeinen Namens verwiesen wird, die zum Sichern des Clusters verwendet werden. | ServerCertificateCommonNames- |
| clientCertificateCommonNames | Die Liste der Clientzertifikate, auf die mit allgemeinem Namen verwiesen wird, die zum Verwalten des Clusters berechtigt sind. | ClientCertificateCommonName[] |
| clientCertificateThumbprints | Die Liste der Clientzertifikate, auf die durch Fingerabdruck verwiesen wird, die zum Verwalten des Clusters berechtigt sind. | ClientCertificateThumbprint[] |
| clusterCodeVersion | Die Service Fabric-Laufzeitversion des Clusters. Diese Eigenschaft kann nur dann festgelegt werden, wenn upgradeMode- auf "Manuell" festgelegt ist. Um eine Liste der verfügbaren Service Fabric-Versionen für neue Cluster abzurufen, verwenden Sie ClusterVersion-API. Um die Liste der verfügbaren Versionen für vorhandene Cluster abzurufen, verwenden Sie availableClusterVersions. | Schnur |
| diagnosticsStorageAccountConfig | Die Speicherkontoinformationen zum Speichern von Service Fabric-Diagnoseprotokollen. | DiagnosticsStorageAccountConfig |
| enableHttpGatewayExclusiveAuthMode | Bei "true" ist die tokenbasierte Authentifizierung für httpGatewayEndpoint nicht zulässig. Dies ist erforderlich, um TLS-Versionen 1.3 und höher zu unterstützen. Wenn die tokenbasierte Authentifizierung verwendet wird, muss HttpGatewayTokenAuthEndpointPort definiert werden. | Bool |
| eventStoreServiceEnabled | Gibt an, ob der Ereignisspeicherdienst aktiviert ist. | Bool |
| fabricSettings | Die Liste der benutzerdefinierten Fabric-Einstellungen zum Konfigurieren des Clusters. | SettingsSectionDescription[] |
| infrastructureServiceManager | Gibt an, ob der Infrastrukturdienst-Manager aktiviert ist. | Bool |
| managementEndpoint | Der HTTP-Verwaltungsendpunkt des Clusters. | Zeichenfolge (erforderlich) |
| nodeTypes | Die Liste der Knotentypen im Cluster. | NodeTypeDescription[] (erforderlich) |
| Benachrichtigungen | Gibt eine Liste der Benachrichtigungskanäle für Clusterereignisse an. | Benachrichtigung[] |
| reliabilityLevel | Die Zuverlässigkeitsebene legt die Replikatgruppengröße von Systemdiensten fest. Erfahren Sie mehr über ReliabilityLevel-. - None – Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 1 aus. Dies sollte nur für Testcluster verwendet werden. - Bronze – Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 3 aus. Dies sollte nur für Testcluster verwendet werden. - Silber – Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 5 aus. - Gold – Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 7 aus. - Platinum - Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 9 aus. |
"Bronze" 'Gold' 'None' "Platin" 'Silber' |
| reverseProxyCertificate | Das vom Reverseproxy verwendete Serverzertifikat. | certificateDescription- |
| reverseProxyCertificateCommonNames | Beschreibt eine Liste der Serverzertifikate, auf die mithilfe eines allgemeinen Namens verwiesen wird, die zum Sichern des Clusters verwendet werden. | ServerCertificateCommonNames- |
| sfZonalUpgradeMode | Diese Eigenschaft steuert die logische Gruppierung von VMs in Upgradedomänen (UDs). Diese Eigenschaft kann nicht geändert werden, wenn ein Knotentyp mit mehreren Verfügbarkeitszonen bereits im Cluster vorhanden ist. | "Hierarchisch" "Parallel" |
| upgradeDescription | Die Richtlinie, die beim Aktualisieren des Clusters verwendet werden soll. | ClusterUpgradePolicy- |
| upgradeMode | Der Upgrademodus des Clusters, wenn eine neue Service Fabric-Laufzeitversion verfügbar ist. | "Automatisch" "Manuell" |
| upgradePauseEndTimestampUtc | Gibt das Enddatum und die Endzeit an, um automatische Laufzeitversionsupgrades auf dem Cluster für einen bestimmten Zeitraum im Cluster (UTC) anzuhalten. | Schnur |
| upgradePauseStartTimestampUtc | Gibt das Startdatum und die Startzeit an, um automatische Laufzeitversionsupgrades auf dem Cluster für einen bestimmten Zeitraum im Cluster (UTC) anzuhalten. | Schnur |
| upgradeWave | Gibt an, wann nach der Veröffentlichung neue Clusterlaufzeitversionsupgrades angewendet werden. Standardmäßig ist Wave0. Gilt nur, wenn upgradeMode- auf "Automatisch" festgelegt ist. | "Wave0" "Welle1" "Welle2" |
| vmImage | Das VM-Image VMSS wurde konfiguriert. Generische Namen wie Windows oder Linux können verwendet werden. | Schnur |
| vmssZonalUpgradeMode | Diese Eigenschaft definiert den Upgrademodus für den Skalierungssatz des virtuellen Computers, es ist obligatorisch, wenn ein Knotentyp mit mehreren Verfügbarkeitszonen hinzugefügt wird. | "Hierarchisch" "Parallel" |
| waveUpgradePaused | Boolescher Wert, um automatische Laufzeitversionsupgrades auf den Cluster anzuhalten. | Bool |
ClusterUpgradeDeltaHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| applicationDeltaHealthPolicies | Definiert die Zuordnung der Anwendungsdelta-Integritätsrichtlinie, die zum Auswerten der Integrität einer Anwendung oder einer seiner untergeordneten Entitäten beim Upgrade des Clusters verwendet wird. | ApplicationDeltaHealthPolicyMap- |
| maxPercentDeltaUnhealthyApplications | Der maximal zulässige Prozentsatz der Während von Clusterupgrades zulässigen Anwendungsintegritätsbeeinträchtigungen. Das Delta wird zwischen dem Status der Anwendungen am Anfang des Upgrades und dem Status der Anwendungen zum Zeitpunkt der Integritätsbewertung gemessen. Die Überprüfung wird nach abschluss des Upgrade-Domänenupgrades durchgeführt, um sicherzustellen, dass der globale Status des Clusters in tolerierten Grenzwerten liegt. Systemdienste sind in diesem Fall nicht enthalten. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 (erforderlich) |
| maxPercentDeltaUnhealthyNodes | Der maximal zulässige Prozentsatz der Während von Clusterupgrades zulässigen Knotenintegritätsbeeinträchtigung. Das Delta wird zwischen dem Zustand der Knoten am Anfang des Upgrades und dem Status der Knoten zum Zeitpunkt der Integritätsauswertung gemessen. Die Überprüfung wird nach abschluss des Upgrade-Domänenupgrades durchgeführt, um sicherzustellen, dass der globale Status des Clusters in tolerierten Grenzwerten liegt. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 (erforderlich) |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | Der maximal zulässige Prozentsatz der Integritätsbeeinträchtigung der Upgradedomänenknoten, die während Clusterupgrades zulässig sind. Das Delta wird zwischen dem Status der Upgradedomänenknoten am Anfang des Upgrades und dem Status der Upgradedomänenknoten zum Zeitpunkt der Integritätsauswertung gemessen. Die Überprüfung wird nach jedem Abschluss des Upgrade-Domänenupgrades für alle abgeschlossenen Upgradedomänen durchgeführt, um sicherzustellen, dass der Status der Upgradedomänen in tolerierten Grenzwerten liegt. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 (erforderlich) |
ClusterUpgradePolicy
| Name | Beschreibung | Wert |
|---|---|---|
| deltaHealthPolicy | Die Cluster-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 Daten). | Bool |
| healthCheckRetryTimeout | Die Zeitspanne zum Wiederholen der Integritätsauswertung, wenn die Anwendung oder der Cluster nicht korrekt ist, bevor das Upgrade zurückgesetzt wird. Das Timeout kann entweder im Format "hh:mm:ss" oder im Format "d.hh:mm:ss.ms" vorliegen. | Zeichenfolge (erforderlich) |
| healthCheckStableDuration | Die Zeitspanne, die die Anwendung oder der Cluster fehlerfrei bleiben muss, bevor das Upgrade zur 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 soll, 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 Upgrade des Clusters verwendet wird. | ClusterHealthPolicy- (erforderlich) |
| upgradeDomainTimeout | Der Zeitraum, in dem jede Upgradedomäne abgeschlossen sein muss, bevor das Upgrade zurückgesetzt wird. Das Timeout kann entweder im Format "hh:mm:ss" oder im Format "d.hh:mm:ss.ms" vorliegen. | Zeichenfolge (erforderlich) |
| upgradeReplicaSetCheckTimeout | Die maximale Zeit, um die Verarbeitung einer Upgradedomäne zu blockieren und den Verlust der Verfügbarkeit zu verhindern, wenn unerwartete Probleme auftreten. Wenn dieses Timeout abläuft, wird die Verarbeitung der Upgradedomäne unabhängig von Verfügbarkeitsverlustproblemen fortgesetzt. Das Timeout wird am Anfang 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 | Der Zeitraum, in dem das gesamte Upgrade abgeschlossen sein muss, bevor das Upgrade zurückgesetzt wird. Das Timeout kann entweder im Format "hh:mm:ss" oder im Format "d.hh:mm:ss.ms" vorliegen. | Zeichenfolge (erforderlich) |
DiagnosticsStorageAccountConfig
| Name | Beschreibung | Wert |
|---|---|---|
| blobEndpoint | Der BLOB-Endpunkt des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
| protectedAccountKeyName | Der Name des geschützten Diagnosespeicherschlüssels. | Zeichenfolge (erforderlich) |
| protectedAccountKeyName2 | Der Name des sekundären geschützten Diagnosespeicherschlüssels. Wenn einer der Speicherkontoschlüssel gedreht wird, wird der Cluster auf die Verwendung der anderen zurückgegriffen. | Schnur |
| queueEndpoint | Der Warteschlangenendpunkt des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
| storageAccountName | Der Name des Azure-Speicherkontos. | Zeichenfolge (erforderlich) |
| tableEndpoint | Der Tabellenendpunkt des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
EndpointRangeDescription
| Name | Beschreibung | Wert |
|---|---|---|
| endPort | Endport eines Bereichs von Ports | int (erforderlich) |
| startPort | Starten des Ports eines Portbereichs | int (erforderlich) |
Microsoft.ServiceFabric/Cluster
| Name | Beschreibung | Wert |
|---|---|---|
| apiVersion | Die API-Version | "2023-11-01-preview" |
| Ort | Azure-Ressourcenspeicherort. | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| Eigenschaften | Die Clusterressourceneigenschaften | ClusterProperties- |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
| Art | Der Ressourcentyp | "Microsoft.ServiceFabric/Cluster" |
NodeTypeDescription
| Name | Beschreibung | Wert |
|---|---|---|
| applicationPorts | Der Bereich der Ports, von denen der Cluster portieren zu Service Fabric-Anwendungen zugewiesen wurde. | EndpointRangeDescription- |
| Kapazitäten | 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 TCP-Clusterverwaltungsendpunktport. | int (erforderlich) |
| durabilityLevel | Die Haltbarkeitsebene des Knotentyps. Erfahren Sie mehr über DurabilityLevel. - Bronze - Keine Rechte. Dies ist die Standardeinstellung. - Silber – Die Infrastrukturaufträge können für eine Dauer von 10 Minuten pro UD angehalten werden. - Gold – Die Infrastrukturaufträge können für eine Dauer von 2 Stunden pro UD angehalten werden. Gold-Haltbarkeit kann nur auf vollständigen KNOTEN-VM-Skus 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 | Der HTTP-Clusterverwaltungsendpunktport. | int (erforderlich) |
| httpGatewayTokenAuthEndpointPort | Der Port, der für tokenauthentifizierungsbasierte HTTPS-Verbindungen mit dem Cluster verwendet wird. Kann nicht auf denselben Port wie HttpGatewayEndpoint festgelegt werden. | Int |
| isPrimary | Der Knotentyp, auf dem Systemdienste ausgeführt werden. Nur ein Knotentyp sollte als primär markiert werden. Der primäre Knotentyp kann für vorhandene Cluster nicht gelöscht oder geändert werden. | bool (erforderlich) |
| isStateless | Gibt an, ob der Knotentyp nur zustandslose Workloads hosten kann. | Bool |
| multipleAvailabilityZones | Gibt an, ob der Knotentyp aktiviert ist, um mehrere Zonen zu unterstützen. | Bool |
| Name | Der Name des Knotentyps. | Zeichenfolge (erforderlich) |
| placementProperties | Die Platzierungstags, die auf Knoten im Knotentyp angewendet werden, die verwendet werden können, um anzugeben, wo bestimmte Dienste (Workload) ausgeführt werden sollen. | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | Der vom Reverseproxy verwendete Endpunkt. | Int |
| vmInstanceCount | VMInstanceCount sollte 1 bis n sein, wobei n die Anzahl der VM-Instanzen angibt, die diesem nodeType entsprechen. VMInstanceCount = 0 kann nur in diesen Szenarien ausgeführt werden: NodeType ist ein sekundärer NodeType. Haltbarkeit = Bronze oder Haltbarkeit >= Bronze und InfrastructureServiceManager = true. Wenn VMInstanceCount = 0, impliziert, dass die virtuellen Computer für diesen nodeType nicht für die anfängliche Berechnung der Clustergröße verwendet werden. | Int Zwänge: Min.-Wert = 0 Max. Wert = 2147483647 (erforderlich) |
NodeTypeDescriptionCapacities
| Name | Beschreibung | Wert |
|---|
NodeTypeDescriptionPlacementProperties
| Name | Beschreibung | Wert |
|---|
Benachrichtigung
| Name | Beschreibung | Wert |
|---|---|---|
| isEnabled | Gibt an, ob die Benachrichtigung aktiviert ist. | bool (erforderlich) |
| notificationCategory | Die Kategorie der Benachrichtigung. | "WaveProgress" (erforderlich) |
| notificationLevel | Die Ebene der Benachrichtigung. | "Alle" "Kritisch" (erforderlich) |
| notificationTargets | Liste der Ziele, die die Benachrichtigung abonnieren. | NotificationTarget-[] (erforderlich) |
NotificationTarget
| Name | Beschreibung | Wert |
|---|---|---|
| notificationChannel | Der Benachrichtigungskanal gibt den Typ der Empfänger an, die die Benachrichtigung abonniert haben, entweder Benutzer oder Abonnement. | "EmailSubscription" "EmailUser" (erforderlich) |
| Empfänger | Liste der Ziele, die die Benachrichtigung abonnieren. | string[] (erforderlich) |
ResourceTags
| Name | Beschreibung | Wert |
|---|
ServerCertificateCommonName
| Name | Beschreibung | Wert |
|---|---|---|
| certificateCommonName | Der allgemeine Name des Serverzertifikats. | Zeichenfolge (erforderlich) |
| certificateIssuerThumbprint | Der Ausstellerfingerabdruck des Serverzertifikats. | Zeichenfolge (erforderlich) |
ServerCertificateCommonNames
| Name | Beschreibung | Wert |
|---|---|---|
| commonNames | Die Liste der Serverzertifikate, auf die mit allgemeinem Namen verwiesen wird, die zum Sichern des Clusters verwendet werden. | ServerCertificateCommonName[] |
| x509StoreName | Der lokale Zertifikatspeicherort. | 'AddressBook' 'AuthRoot' "CertificateAuthority" "Unzulässig" 'Mein' 'Root' "TrustedPeople" 'TrustedPublisher' |
ServiceTypeDeltaHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| maxPercentDeltaUnhealthyServices | Der maximal zulässige Prozentsatz der Dienstintegritätsverschlechterung, die während Clusterupgrades zulässig ist. Das Delta wird zwischen dem Status der Dienste am Anfang des Upgrades und dem Status der Dienste zum Zeitpunkt der Integritätsbewertung gemessen. Die Überprüfung wird nach abschluss des Upgrade-Domänenupgrades durchgeführt, um sicherzustellen, dass der globale Status des Clusters in tolerierten Grenzwerten liegt. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 |
ServiceTypeDeltaHealthPolicyMap
| Name | Beschreibung | Wert |
|---|
ServiceTypeHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| maxPercentUnhealthyServices | Der maximale Prozentsatz der Dienste, die nicht fehlerfrei sein dürfen, bevor Ihre Anwendung als Fehler betrachtet wird. | Int Zwänge: Min.-Wert = 0 Max. Wert = 100 |
ServiceTypeHealthPolicyMap
| Name | Beschreibung | Wert |
|---|
SettingsParameterDescription
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Parametername der Fabric-Einstellung. | Zeichenfolge (erforderlich) |
| Wert | Der Parameterwert der Fabric-Einstellung. | Zeichenfolge (erforderlich) |
SettingsSectionDescription
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Abschnittsname der Fabric-Einstellungen. | Zeichenfolge (erforderlich) |
| Parameter | Die Sammlung von Parametern im Abschnitt. | SettingsParameterDescription[] (erforderlich) |
Schnellstartvorlagen
Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.
| Schablone | Beschreibung |
|---|---|
Bereitstellen eines sicheren 3 Nodetype-Clusters mit aktivierten NSGs
|
Mit dieser Vorlage können Sie einen sicheren 3 Nodetype Service Fabric Cluster unter Windows Server 2016 Data Center auf einem Standard_D2 Größen-VMs bereitstellen. Mithilfe dieser Vorlage können Sie den eingehenden und ausgehenden Netzwerkdatenverkehr mithilfe von Netzwerksicherheitsgruppen steuern. |
|
Bereitstellen eines sicheren Cluster mit 5 Knoten
|
Mit dieser Vorlage können Sie einen sicheren 5-Knoten-Service Fabric-Cluster unter Windows Server 2019 Datacenter auf einem Standard_D2_v2 Size VMSS bereitstellen. |
|
Bereitstellen eines 5 Node Ubuntu Service Fabric Cluster-
|
Mit dieser Vorlage können Sie einen sicheren 5-Knoten-Service Fabric-Cluster bereitstellen, der Ubuntu auf einer Standard_D2_V2 Größe VMSS ausführt. |
Terraform -Ressourcendefinition (AzAPI-Anbieter)
Der Clusterressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.ServiceFabric/Cluster-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceFabric/clusters@2023-11-01-preview"
name = "string"
location = "string"
body = jsonencode({
properties = {
addOnFeatures = [
"string"
]
applicationTypeVersionsCleanupPolicy = {
maxUnusedVersionsToKeep = int
}
azureActiveDirectory = {
clientApplication = "string"
clusterApplication = "string"
tenantId = "string"
}
certificate = {
thumbprint = "string"
thumbprintSecondary = "string"
x509StoreName = "string"
}
certificateCommonNames = {
commonNames = [
{
certificateCommonName = "string"
certificateIssuerThumbprint = "string"
}
]
x509StoreName = "string"
}
clientCertificateCommonNames = [
{
certificateCommonName = "string"
certificateIssuerThumbprint = "string"
isAdmin = bool
}
]
clientCertificateThumbprints = [
{
certificateThumbprint = "string"
isAdmin = bool
}
]
clusterCodeVersion = "string"
diagnosticsStorageAccountConfig = {
blobEndpoint = "string"
protectedAccountKeyName = "string"
protectedAccountKeyName2 = "string"
queueEndpoint = "string"
storageAccountName = "string"
tableEndpoint = "string"
}
enableHttpGatewayExclusiveAuthMode = bool
eventStoreServiceEnabled = bool
fabricSettings = [
{
name = "string"
parameters = [
{
name = "string"
value = "string"
}
]
}
]
infrastructureServiceManager = bool
managementEndpoint = "string"
nodeTypes = [
{
applicationPorts = {
endPort = int
startPort = int
}
capacities = {
{customized property} = "string"
}
clientConnectionEndpointPort = int
durabilityLevel = "string"
ephemeralPorts = {
endPort = int
startPort = int
}
httpGatewayEndpointPort = int
httpGatewayTokenAuthEndpointPort = int
isPrimary = bool
isStateless = bool
multipleAvailabilityZones = bool
name = "string"
placementProperties = {
{customized property} = "string"
}
reverseProxyEndpointPort = int
vmInstanceCount = int
}
]
notifications = [
{
isEnabled = bool
notificationCategory = "string"
notificationLevel = "string"
notificationTargets = [
{
notificationChannel = "string"
receivers = [
"string"
]
}
]
}
]
reliabilityLevel = "string"
reverseProxyCertificate = {
thumbprint = "string"
thumbprintSecondary = "string"
x509StoreName = "string"
}
reverseProxyCertificateCommonNames = {
commonNames = [
{
certificateCommonName = "string"
certificateIssuerThumbprint = "string"
}
]
x509StoreName = "string"
}
sfZonalUpgradeMode = "string"
upgradeDescription = {
deltaHealthPolicy = {
applicationDeltaHealthPolicies = {
{customized property} = {
defaultServiceTypeDeltaHealthPolicy = {
maxPercentDeltaUnhealthyServices = int
}
serviceTypeDeltaHealthPolicies = {
{customized property} = {
maxPercentDeltaUnhealthyServices = int
}
}
}
}
maxPercentDeltaUnhealthyApplications = int
maxPercentDeltaUnhealthyNodes = int
maxPercentUpgradeDomainDeltaUnhealthyNodes = int
}
forceRestart = bool
healthCheckRetryTimeout = "string"
healthCheckStableDuration = "string"
healthCheckWaitDuration = "string"
healthPolicy = {
applicationHealthPolicies = {
{customized property} = {
defaultServiceTypeHealthPolicy = {
maxPercentUnhealthyServices = int
}
serviceTypeHealthPolicies = {
{customized property} = {
maxPercentUnhealthyServices = int
}
}
}
}
maxPercentUnhealthyApplications = int
maxPercentUnhealthyNodes = int
}
upgradeDomainTimeout = "string"
upgradeReplicaSetCheckTimeout = "string"
upgradeTimeout = "string"
}
upgradeMode = "string"
upgradePauseEndTimestampUtc = "string"
upgradePauseStartTimestampUtc = "string"
upgradeWave = "string"
vmImage = "string"
vmssZonalUpgradeMode = "string"
waveUpgradePaused = bool
}
})
tags = {
{customized property} = "string"
}
}
Eigenschaftswerte
ApplicationDeltaHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| defaultServiceTypeDeltaHealthPolicy | Die Delta-Integritätsrichtlinie, die standardmäßig verwendet wird, um den Status eines Diensttyps beim Upgrade des Clusters auszuwerten. | ServiceTypeDeltaHealthPolicy |
| serviceTypeDeltaHealthPolicies | Die Zuordnung mit der Delta-Integritätsrichtlinie des Diensttyps pro Diensttypname. Die Karte ist standardmäßig leer. | ServiceTypeDeltaHealthPolicyMap- |
ApplicationDeltaHealthPolicyMap
| Name | Beschreibung | Wert |
|---|
ApplicationHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| defaultServiceTypeHealthPolicy | Die Standardmäßig zum Auswerten der Integrität eines Diensttyps verwendete Integritätsrichtlinie. | ServiceTypeHealthPolicy- |
| serviceTypeHealthPolicies | Die Zuordnung mit der Diensttypintegritätsrichtlinie pro Diensttypname. Die Karte ist standardmäßig leer. | ServiceTypeHealthPolicyMap- |
ApplicationHealthPolicyMap
| Name | Beschreibung | Wert |
|---|
ApplicationTypeVersionsCleanupPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| maxUnusedVersionsToKeep | Anzahl der nicht verwendeten Versionen pro Anwendungstyp, die beibehalten werden sollen. | Int Zwänge: Min.-Wert = 0 (erforderlich) |
AzureActiveDirectory
| Name | Beschreibung | Wert |
|---|---|---|
| clientApplication | Azure Active Directory-Clientanwendungs-ID. | Schnur |
| clusterApplication | Anwendungs-ID der Azure Active Directory-Clusteranwendung. | Schnur |
| tenantId | Azure Active Directory-Mandanten-ID. | Schnur |
CertificateDescription
| Name | Beschreibung | Wert |
|---|---|---|
| Fingerabdruck | Fingerabdruck des primären Zertifikats. | Zeichenfolge (erforderlich) |
| thumbprintSecondary | Fingerabdruck des sekundären Zertifikats. | Schnur |
| x509StoreName | Der lokale Zertifikatspeicherort. | 'AddressBook' 'AuthRoot' "CertificateAuthority" "Unzulässig" 'Mein' 'Root' "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 auf dem 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 auf dem Cluster ausführen. | bool (erforderlich) |
ClusterHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| applicationHealthPolicies | Definiert die Zuordnung der Anwendungsintegritätsrichtlinie, die verwendet wird, um den Status einer Anwendung oder einer seiner untergeordneten Entitäten auszuwerten. | ApplicationHealthPolicyMap- |
| maxPercentUnhealthyApplications | Der maximal zulässige Prozentsatz von fehlerhaften Anwendungen, bevor ein Fehler gemeldet wird. Damit beispielsweise 10% von Anwendungen nicht einwandfrei sein können, wäre dieser Wert 10. Der Prozentsatz stellt den maximalen tolerierten Prozentsatz der Anwendungen dar, die fehlerhaft sein können, bevor der Cluster als Fehler betrachtet wird. Wenn der Prozentsatz berücksichtigt wird, aber mindestens eine fehlerhafte Anwendung vorhanden ist, wird der Status als Warnung ausgewertet. Dies wird berechnet, indem die Anzahl der fehlerhaften Anwendungen über die Gesamtanzahl der Anwendungsinstanzen im Cluster dividiert wird, mit Ausnahme von Anwendungen von Anwendungstypen, die in applicationTypeHealthPolicyMap enthalten sind. Die Berechnung wird aufgerundet, um einen Fehler bei einer kleinen Anzahl von Anwendungen zu tolerieren. Der Standardprozentsatz ist Null. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 |
| maxPercentUnhealthyNodes | Der maximal zulässige Prozentsatz von fehlerhaften Knoten, bevor ein Fehler gemeldet wird. Damit beispielsweise 10% von Knoten nicht einwandfrei sein können, wäre dieser Wert 10. Der Prozentsatz stellt den maximalen tolerierten Prozentsatz der Knoten dar, die fehlerhaft sein können, bevor der Cluster als Fehler betrachtet wird. Wenn der Prozentsatz berücksichtigt wird, aber mindestens ein fehlerhafter Knoten vorhanden ist, wird die Integrität als Warnung ausgewertet. Der Prozentsatz wird berechnet, indem die Anzahl der fehlerhaften Knoten über die Gesamtanzahl der Knoten im Cluster dividiert wird. Die Berechnung wird aufgerundet, um einen Fehler bei einer kleinen Anzahl von Knoten zu tolerieren. Der Standardprozentsatz ist Null. In großen Clustern sind einige Knoten für Reparaturen immer nach unten oder außerhalb, sodass dieser Prozentsatz so konfiguriert werden sollte, dass dies toleriert wird. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 |
ClusterProperties
| Name | Beschreibung | Wert |
|---|---|---|
| addOnFeatures | Die Liste der Add-On-Features, die im Cluster aktiviert werden sollen. | Zeichenfolgenarray, das eine der folgenden Elemente enthält: 'BackupRestoreService' 'DnsService' 'RepairManager' 'ResourceMonitorService' |
| applicationTypeVersionsCleanupPolicy | Die Richtlinie zum Bereinigen nicht verwendeter Versionen. | ApplicationTypeVersionsCleanupPolicy- |
| azureActiveDirectory | Die AAD-Authentifizierungseinstellungen des Clusters. | AzureActiveDirectory- |
| Zertifikat | Das Zertifikat, das zum Sichern des Clusters verwendet werden soll. Das bereitgestellte Zertifikat wird für Knotensicherheit innerhalb des Clusters, SSL-Zertifikats für Den Clusterverwaltungsendpunkt und Standardadministratorclient verwendet. | certificateDescription- |
| certificateCommonNames | Beschreibt eine Liste der Serverzertifikate, auf die mithilfe eines allgemeinen Namens verwiesen wird, die zum Sichern des Clusters verwendet werden. | ServerCertificateCommonNames- |
| clientCertificateCommonNames | Die Liste der Clientzertifikate, auf die mit allgemeinem Namen verwiesen wird, die zum Verwalten des Clusters berechtigt sind. | ClientCertificateCommonName[] |
| clientCertificateThumbprints | Die Liste der Clientzertifikate, auf die durch Fingerabdruck verwiesen wird, die zum Verwalten des Clusters berechtigt sind. | ClientCertificateThumbprint[] |
| clusterCodeVersion | Die Service Fabric-Laufzeitversion des Clusters. Diese Eigenschaft kann nur dann festgelegt werden, wenn upgradeMode- auf "Manuell" festgelegt ist. Um eine Liste der verfügbaren Service Fabric-Versionen für neue Cluster abzurufen, verwenden Sie ClusterVersion-API. Um die Liste der verfügbaren Versionen für vorhandene Cluster abzurufen, verwenden Sie availableClusterVersions. | Schnur |
| diagnosticsStorageAccountConfig | Die Speicherkontoinformationen zum Speichern von Service Fabric-Diagnoseprotokollen. | DiagnosticsStorageAccountConfig |
| enableHttpGatewayExclusiveAuthMode | Bei "true" ist die tokenbasierte Authentifizierung für httpGatewayEndpoint nicht zulässig. Dies ist erforderlich, um TLS-Versionen 1.3 und höher zu unterstützen. Wenn die tokenbasierte Authentifizierung verwendet wird, muss HttpGatewayTokenAuthEndpointPort definiert werden. | Bool |
| eventStoreServiceEnabled | Gibt an, ob der Ereignisspeicherdienst aktiviert ist. | Bool |
| fabricSettings | Die Liste der benutzerdefinierten Fabric-Einstellungen zum Konfigurieren des Clusters. | SettingsSectionDescription[] |
| infrastructureServiceManager | Gibt an, ob der Infrastrukturdienst-Manager aktiviert ist. | Bool |
| managementEndpoint | Der HTTP-Verwaltungsendpunkt des Clusters. | Zeichenfolge (erforderlich) |
| nodeTypes | Die Liste der Knotentypen im Cluster. | NodeTypeDescription[] (erforderlich) |
| Benachrichtigungen | Gibt eine Liste der Benachrichtigungskanäle für Clusterereignisse an. | Benachrichtigung[] |
| reliabilityLevel | Die Zuverlässigkeitsebene legt die Replikatgruppengröße von Systemdiensten fest. Erfahren Sie mehr über ReliabilityLevel-. - None – Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 1 aus. Dies sollte nur für Testcluster verwendet werden. - Bronze – Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 3 aus. Dies sollte nur für Testcluster verwendet werden. - Silber – Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 5 aus. - Gold – Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 7 aus. - Platinum - Führen Sie die Systemdienste mit einer Zielreplikatgruppenanzahl von 9 aus. |
"Bronze" 'Gold' 'None' "Platin" 'Silber' |
| reverseProxyCertificate | Das vom Reverseproxy verwendete Serverzertifikat. | certificateDescription- |
| reverseProxyCertificateCommonNames | Beschreibt eine Liste der Serverzertifikate, auf die mithilfe eines allgemeinen Namens verwiesen wird, die zum Sichern des Clusters verwendet werden. | ServerCertificateCommonNames- |
| sfZonalUpgradeMode | Diese Eigenschaft steuert die logische Gruppierung von VMs in Upgradedomänen (UDs). Diese Eigenschaft kann nicht geändert werden, wenn ein Knotentyp mit mehreren Verfügbarkeitszonen bereits im Cluster vorhanden ist. | "Hierarchisch" "Parallel" |
| upgradeDescription | Die Richtlinie, die beim Aktualisieren des Clusters verwendet werden soll. | ClusterUpgradePolicy- |
| upgradeMode | Der Upgrademodus des Clusters, wenn eine neue Service Fabric-Laufzeitversion verfügbar ist. | "Automatisch" "Manuell" |
| upgradePauseEndTimestampUtc | Gibt das Enddatum und die Endzeit an, um automatische Laufzeitversionsupgrades auf dem Cluster für einen bestimmten Zeitraum im Cluster (UTC) anzuhalten. | Schnur |
| upgradePauseStartTimestampUtc | Gibt das Startdatum und die Startzeit an, um automatische Laufzeitversionsupgrades auf dem Cluster für einen bestimmten Zeitraum im Cluster (UTC) anzuhalten. | Schnur |
| upgradeWave | Gibt an, wann nach der Veröffentlichung neue Clusterlaufzeitversionsupgrades angewendet werden. Standardmäßig ist Wave0. Gilt nur, wenn upgradeMode- auf "Automatisch" festgelegt ist. | "Wave0" "Welle1" "Welle2" |
| vmImage | Das VM-Image VMSS wurde konfiguriert. Generische Namen wie Windows oder Linux können verwendet werden. | Schnur |
| vmssZonalUpgradeMode | Diese Eigenschaft definiert den Upgrademodus für den Skalierungssatz des virtuellen Computers, es ist obligatorisch, wenn ein Knotentyp mit mehreren Verfügbarkeitszonen hinzugefügt wird. | "Hierarchisch" "Parallel" |
| waveUpgradePaused | Boolescher Wert, um automatische Laufzeitversionsupgrades auf den Cluster anzuhalten. | Bool |
ClusterUpgradeDeltaHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| applicationDeltaHealthPolicies | Definiert die Zuordnung der Anwendungsdelta-Integritätsrichtlinie, die zum Auswerten der Integrität einer Anwendung oder einer seiner untergeordneten Entitäten beim Upgrade des Clusters verwendet wird. | ApplicationDeltaHealthPolicyMap- |
| maxPercentDeltaUnhealthyApplications | Der maximal zulässige Prozentsatz der Während von Clusterupgrades zulässigen Anwendungsintegritätsbeeinträchtigungen. Das Delta wird zwischen dem Status der Anwendungen am Anfang des Upgrades und dem Status der Anwendungen zum Zeitpunkt der Integritätsbewertung gemessen. Die Überprüfung wird nach abschluss des Upgrade-Domänenupgrades durchgeführt, um sicherzustellen, dass der globale Status des Clusters in tolerierten Grenzwerten liegt. Systemdienste sind in diesem Fall nicht enthalten. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 (erforderlich) |
| maxPercentDeltaUnhealthyNodes | Der maximal zulässige Prozentsatz der Während von Clusterupgrades zulässigen Knotenintegritätsbeeinträchtigung. Das Delta wird zwischen dem Zustand der Knoten am Anfang des Upgrades und dem Status der Knoten zum Zeitpunkt der Integritätsauswertung gemessen. Die Überprüfung wird nach abschluss des Upgrade-Domänenupgrades durchgeführt, um sicherzustellen, dass der globale Status des Clusters in tolerierten Grenzwerten liegt. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 (erforderlich) |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | Der maximal zulässige Prozentsatz der Integritätsbeeinträchtigung der Upgradedomänenknoten, die während Clusterupgrades zulässig sind. Das Delta wird zwischen dem Status der Upgradedomänenknoten am Anfang des Upgrades und dem Status der Upgradedomänenknoten zum Zeitpunkt der Integritätsauswertung gemessen. Die Überprüfung wird nach jedem Abschluss des Upgrade-Domänenupgrades für alle abgeschlossenen Upgradedomänen durchgeführt, um sicherzustellen, dass der Status der Upgradedomänen in tolerierten Grenzwerten liegt. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 (erforderlich) |
ClusterUpgradePolicy
| Name | Beschreibung | Wert |
|---|---|---|
| deltaHealthPolicy | Die Cluster-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 Daten). | Bool |
| healthCheckRetryTimeout | Die Zeitspanne zum Wiederholen der Integritätsauswertung, wenn die Anwendung oder der Cluster nicht korrekt ist, bevor das Upgrade zurückgesetzt wird. Das Timeout kann entweder im Format "hh:mm:ss" oder im Format "d.hh:mm:ss.ms" vorliegen. | Zeichenfolge (erforderlich) |
| healthCheckStableDuration | Die Zeitspanne, die die Anwendung oder der Cluster fehlerfrei bleiben muss, bevor das Upgrade zur 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 soll, 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 Upgrade des Clusters verwendet wird. | ClusterHealthPolicy- (erforderlich) |
| upgradeDomainTimeout | Der Zeitraum, in dem jede Upgradedomäne abgeschlossen sein muss, bevor das Upgrade zurückgesetzt wird. Das Timeout kann entweder im Format "hh:mm:ss" oder im Format "d.hh:mm:ss.ms" vorliegen. | Zeichenfolge (erforderlich) |
| upgradeReplicaSetCheckTimeout | Die maximale Zeit, um die Verarbeitung einer Upgradedomäne zu blockieren und den Verlust der Verfügbarkeit zu verhindern, wenn unerwartete Probleme auftreten. Wenn dieses Timeout abläuft, wird die Verarbeitung der Upgradedomäne unabhängig von Verfügbarkeitsverlustproblemen fortgesetzt. Das Timeout wird am Anfang 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 | Der Zeitraum, in dem das gesamte Upgrade abgeschlossen sein muss, bevor das Upgrade zurückgesetzt wird. Das Timeout kann entweder im Format "hh:mm:ss" oder im Format "d.hh:mm:ss.ms" vorliegen. | Zeichenfolge (erforderlich) |
DiagnosticsStorageAccountConfig
| Name | Beschreibung | Wert |
|---|---|---|
| blobEndpoint | Der BLOB-Endpunkt des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
| protectedAccountKeyName | Der Name des geschützten Diagnosespeicherschlüssels. | Zeichenfolge (erforderlich) |
| protectedAccountKeyName2 | Der Name des sekundären geschützten Diagnosespeicherschlüssels. Wenn einer der Speicherkontoschlüssel gedreht wird, wird der Cluster auf die Verwendung der anderen zurückgegriffen. | Schnur |
| queueEndpoint | Der Warteschlangenendpunkt des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
| storageAccountName | Der Name des Azure-Speicherkontos. | Zeichenfolge (erforderlich) |
| tableEndpoint | Der Tabellenendpunkt des Azure Storage-Kontos. | Zeichenfolge (erforderlich) |
EndpointRangeDescription
| Name | Beschreibung | Wert |
|---|---|---|
| endPort | Endport eines Bereichs von Ports | int (erforderlich) |
| startPort | Starten des Ports eines Portbereichs | int (erforderlich) |
Microsoft.ServiceFabric/Cluster
| Name | Beschreibung | Wert |
|---|---|---|
| Ort | Azure-Ressourcenspeicherort. | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| Eigenschaften | Die Clusterressourceneigenschaften | ClusterProperties- |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. |
| Art | Der Ressourcentyp | "Microsoft.ServiceFabric/clusters@2023-11-01-preview" |
NodeTypeDescription
| Name | Beschreibung | Wert |
|---|---|---|
| applicationPorts | Der Bereich der Ports, von denen der Cluster portieren zu Service Fabric-Anwendungen zugewiesen wurde. | EndpointRangeDescription- |
| Kapazitäten | 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 TCP-Clusterverwaltungsendpunktport. | int (erforderlich) |
| durabilityLevel | Die Haltbarkeitsebene des Knotentyps. Erfahren Sie mehr über DurabilityLevel. - Bronze - Keine Rechte. Dies ist die Standardeinstellung. - Silber – Die Infrastrukturaufträge können für eine Dauer von 10 Minuten pro UD angehalten werden. - Gold – Die Infrastrukturaufträge können für eine Dauer von 2 Stunden pro UD angehalten werden. Gold-Haltbarkeit kann nur auf vollständigen KNOTEN-VM-Skus 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 | Der HTTP-Clusterverwaltungsendpunktport. | int (erforderlich) |
| httpGatewayTokenAuthEndpointPort | Der Port, der für tokenauthentifizierungsbasierte HTTPS-Verbindungen mit dem Cluster verwendet wird. Kann nicht auf denselben Port wie HttpGatewayEndpoint festgelegt werden. | Int |
| isPrimary | Der Knotentyp, auf dem Systemdienste ausgeführt werden. Nur ein Knotentyp sollte als primär markiert werden. Der primäre Knotentyp kann für vorhandene Cluster nicht gelöscht oder geändert werden. | bool (erforderlich) |
| isStateless | Gibt an, ob der Knotentyp nur zustandslose Workloads hosten kann. | Bool |
| multipleAvailabilityZones | Gibt an, ob der Knotentyp aktiviert ist, um mehrere Zonen zu unterstützen. | Bool |
| Name | Der Name des Knotentyps. | Zeichenfolge (erforderlich) |
| placementProperties | Die Platzierungstags, die auf Knoten im Knotentyp angewendet werden, die verwendet werden können, um anzugeben, wo bestimmte Dienste (Workload) ausgeführt werden sollen. | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | Der vom Reverseproxy verwendete Endpunkt. | Int |
| vmInstanceCount | VMInstanceCount sollte 1 bis n sein, wobei n die Anzahl der VM-Instanzen angibt, die diesem nodeType entsprechen. VMInstanceCount = 0 kann nur in diesen Szenarien ausgeführt werden: NodeType ist ein sekundärer NodeType. Haltbarkeit = Bronze oder Haltbarkeit >= Bronze und InfrastructureServiceManager = true. Wenn VMInstanceCount = 0, impliziert, dass die virtuellen Computer für diesen nodeType nicht für die anfängliche Berechnung der Clustergröße verwendet werden. | Int Zwänge: Min.-Wert = 0 Max. Wert = 2147483647 (erforderlich) |
NodeTypeDescriptionCapacities
| Name | Beschreibung | Wert |
|---|
NodeTypeDescriptionPlacementProperties
| Name | Beschreibung | Wert |
|---|
Benachrichtigung
| Name | Beschreibung | Wert |
|---|---|---|
| isEnabled | Gibt an, ob die Benachrichtigung aktiviert ist. | bool (erforderlich) |
| notificationCategory | Die Kategorie der Benachrichtigung. | "WaveProgress" (erforderlich) |
| notificationLevel | Die Ebene der Benachrichtigung. | "Alle" "Kritisch" (erforderlich) |
| notificationTargets | Liste der Ziele, die die Benachrichtigung abonnieren. | NotificationTarget-[] (erforderlich) |
NotificationTarget
| Name | Beschreibung | Wert |
|---|---|---|
| notificationChannel | Der Benachrichtigungskanal gibt den Typ der Empfänger an, die die Benachrichtigung abonniert haben, entweder Benutzer oder Abonnement. | "EmailSubscription" "EmailUser" (erforderlich) |
| Empfänger | Liste der Ziele, die die Benachrichtigung abonnieren. | string[] (erforderlich) |
ResourceTags
| Name | Beschreibung | Wert |
|---|
ServerCertificateCommonName
| Name | Beschreibung | Wert |
|---|---|---|
| certificateCommonName | Der allgemeine Name des Serverzertifikats. | Zeichenfolge (erforderlich) |
| certificateIssuerThumbprint | Der Ausstellerfingerabdruck des Serverzertifikats. | Zeichenfolge (erforderlich) |
ServerCertificateCommonNames
| Name | Beschreibung | Wert |
|---|---|---|
| commonNames | Die Liste der Serverzertifikate, auf die mit allgemeinem Namen verwiesen wird, die zum Sichern des Clusters verwendet werden. | ServerCertificateCommonName[] |
| x509StoreName | Der lokale Zertifikatspeicherort. | 'AddressBook' 'AuthRoot' "CertificateAuthority" "Unzulässig" 'Mein' 'Root' "TrustedPeople" 'TrustedPublisher' |
ServiceTypeDeltaHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| maxPercentDeltaUnhealthyServices | Der maximal zulässige Prozentsatz der Dienstintegritätsverschlechterung, die während Clusterupgrades zulässig ist. Das Delta wird zwischen dem Status der Dienste am Anfang des Upgrades und dem Status der Dienste zum Zeitpunkt der Integritätsbewertung gemessen. Die Überprüfung wird nach abschluss des Upgrade-Domänenupgrades durchgeführt, um sicherzustellen, dass der globale Status des Clusters in tolerierten Grenzwerten liegt. |
Int Zwänge: Min.-Wert = 0 Max. Wert = 100 |
ServiceTypeDeltaHealthPolicyMap
| Name | Beschreibung | Wert |
|---|
ServiceTypeHealthPolicy
| Name | Beschreibung | Wert |
|---|---|---|
| maxPercentUnhealthyServices | Der maximale Prozentsatz der Dienste, die nicht fehlerfrei sein dürfen, bevor Ihre Anwendung als Fehler betrachtet wird. | Int Zwänge: Min.-Wert = 0 Max. Wert = 100 |
ServiceTypeHealthPolicyMap
| Name | Beschreibung | Wert |
|---|
SettingsParameterDescription
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Parametername der Fabric-Einstellung. | Zeichenfolge (erforderlich) |
| Wert | Der Parameterwert der Fabric-Einstellung. | Zeichenfolge (erforderlich) |
SettingsSectionDescription
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Abschnittsname der Fabric-Einstellungen. | Zeichenfolge (erforderlich) |
| Parameter | Die Sammlung von Parametern im Abschnitt. | SettingsParameterDescription[] (erforderlich) |