Udostępnij za pośrednictwem

Klastry Microsoft.ServiceFabric

  • Artykuł

Definicja zasobu Bicep

Typ zasobu klastrów można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.ServiceFabric/clusters, dodaj następujący kod Bicep do szablonu.

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'
  }
}

Wartości właściwości

ApplicationDeltaHealthPolicy

Nazwa Opis Wartość
defaultServiceTypeDeltaHealthPolicy Zasady kondycji różnicowej używane domyślnie do oceny kondycji typu usługi podczas uaktualniania klastra. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies Mapa z zasadami kondycji różnicowej typu usługi na nazwę typu usługi. Mapa jest domyślnie pusta. ServiceTypeDeltaHealthPolicyMap

ApplicationDeltaHealthPolicyMap

Nazwa Opis Wartość

ApplicationHealthPolicy

Nazwa Opis Wartość
defaultServiceTypeHealthPolicy Zasady kondycji używane domyślnie do oceny kondycji typu usługi. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Mapa z zasadami kondycji typu usługi na nazwę typu usługi. Mapa jest domyślnie pusta. ServiceTypeHealthPolicyMap

ApplicationHealthPolicyMap

Nazwa Opis Wartość

ApplicationTypeVersionsCleanupPolicy

Nazwa Opis Wartość
maxUnusedVersionsToKeep Liczba nieużywanych wersji na typ aplikacji do zachowania. Int

Ograniczenia:
Minimalna wartość = 0 (wymagane)

AzureActiveDirectory

Nazwa Opis Wartość
clientApplication Identyfikator aplikacji klienckiej usługi Azure Active Directory. struna
clusterApplication Identyfikator aplikacji klastra usługi Azure Active Directory. struna
tenantId Identyfikator dzierżawy usługi Azure Active Directory. struna

Opis certyfikatu

Nazwa Opis Wartość
Odcisk palca Odcisk palca certyfikatu podstawowego. ciąg (wymagany)
odcisk palcaSecondary Odcisk palca certyfikatu pomocniczego. struna
x509StoreName Lokalizacja lokalnego magazynu certyfikatów. "Adresbook"
"AuthRoot"
"CertificateAuthority"
"Niedozwolone"
"Mój"
"Katalog główny"
"Zaufani ludzie"
"TrustedPublisher"

ClientCertificateCommonName

Nazwa Opis Wartość
certificateCommonName Nazwa pospolita certyfikatu klienta. ciąg (wymagany)
certificateIssuerThumbprint Odcisk palca wystawcy certyfikatu klienta. ciąg (wymagany)
isAdmin Wskazuje, czy certyfikat klienta ma dostęp administratora do klastra. Klienci niebędący administratorami mogą wykonywać tylko operacje tylko do odczytu w klastrze. bool (wymagane)

ClientCertificateThumbprint

Nazwa Opis Wartość
certificateThumbprint Odcisk palca certyfikatu klienta. ciąg (wymagany)
isAdmin Wskazuje, czy certyfikat klienta ma dostęp administratora do klastra. Klienci niebędący administratorami mogą wykonywać tylko operacje tylko do odczytu w klastrze. bool (wymagane)

ClusterHealthPolicy

Nazwa Opis Wartość
applicationHealthPolicies Definiuje mapę zasad kondycji aplikacji używaną do oceny kondycji aplikacji lub jednej z jej jednostek podrzędnych. ApplicationHealthPolicyMap
maxPercentUnhealthyApplications Maksymalny dozwolony procent aplikacji w złej kondycji przed zgłoszeniem błędu. Na przykład aby umożliwić 10% aplikacji w złej kondycji, ta wartość będzie wynosić 10.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową aplikacji, które mogą być w złej kondycji, zanim klaster zostanie uznany za błąd.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jedna aplikacja w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Jest to obliczane przez podzielenie liczby aplikacji w złej kondycji na łączną liczbę wystąpień aplikacji w klastrze, z wyłączeniem aplikacji typów aplikacji uwzględnionych w metryce ApplicationTypeHealthPolicyMap.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na małej liczbie aplikacji. Wartość procentowa domyślna to zero.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100
maxPercentUnhealthyNodes Maksymalny dozwolony procent węzłów w złej kondycji przed zgłoszeniem błędu. Na przykład aby umożliwić 10% węzłów w złej kondycji, ta wartość będzie wynosić 10.

Wartość procentowa reprezentuje maksymalny tolerowany procent węzłów, które mogą być w złej kondycji, zanim klaster zostanie uwzględniony w błędzie.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jeden węzeł w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Wartość procentowa jest obliczana przez podzielenie liczby węzłów w złej kondycji na łączną liczbę węzłów w klastrze.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na małej liczbie węzłów. Wartość procentowa domyślna to zero.

W dużych klastrach niektóre węzły będą zawsze wyłączone lub wyłączone w celu naprawy, więc ta wartość procentowa powinna być skonfigurowana tak, aby to tolerowała.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100

Właściwości klastra

Nazwa Opis Wartość
addOnFeatures Lista funkcji dodatków do włączenia w klastrze. Tablica ciągów zawierająca dowolną z:
"BackupRestoreService"
"DnsService"
"RepairManager"
"ResourceMonitorService"
applicationTypeVersionsCleanupPolicy Zasady używane do czyszczenia nieużywanych wersji. ApplicationTypeVersionsCleanupPolicy
azureActiveDirectory Ustawienia uwierzytelniania usługi AAD klastra. AzureActiveDirectory
certyfikat Certyfikat używany do zabezpieczania klastra. Podany certyfikat będzie używany do zabezpieczeń węzła w ramach klastra, certyfikatu SSL dla punktu końcowego zarządzania klastrem i domyślnego klienta administracyjnego. CertificateDescription
certificateCommonNames Opisuje listę certyfikatów serwera, do których odwołuje się nazwa pospolita używana do zabezpieczania klastra. ServerCertificateCommonNames
clientCertificateCommonNames Lista certyfikatów klienta, do których odwołuje się nazwa pospolita, które mogą zarządzać klastrem. ClientCertificateCommonName[]
clientCertificateThumbprints Lista certyfikatów klienta, do których odwołuje się odcisk palca, które mogą zarządzać klastrem. ClientCertificateThumbprint[]
clusterCodeVersion Wersja środowiska uruchomieniowego usługi Service Fabric klastra. Ta właściwość może być ustawiana tylko przez ustawienie użytkownika, gdy upgradeMode jest ustawiona na wartość "Manual". Aby uzyskać listę dostępnych wersji usługi Service Fabric dla nowych klastrów, użyj interfejsu API ClusterVersion. Aby uzyskać listę dostępnych wersji dla istniejących klastrów, użyj availableClusterVersions. struna
diagnosticsStorageAccountConfig Informacje o koncie magazynu do przechowywania dzienników diagnostycznych usługi Service Fabric. DiagnosticsStorageAccountConfig
enableHttpGatewayExclusiveAuthMode Jeśli wartość true, uwierzytelnianie oparte na tokenach nie jest dozwolone w punkcie HttpGatewayEndpoint. Jest to wymagane do obsługi protokołu TLS w wersji 1.3 lub nowszej. Jeśli jest używane uwierzytelnianie oparte na tokenach, należy zdefiniować parametr HttpGatewayTokenAuthEndpointPort. Bool
eventStoreServiceEnabled Wskazuje, czy usługa magazynu zdarzeń jest włączona. Bool
fabricSettings Lista niestandardowych ustawień sieci szkieletowej do skonfigurowania klastra. SettingsSectionDescription[]
infrastructureServiceManager Wskazuje, czy menedżer usług infrastruktury jest włączony. Bool
managementEndpoint Punkt końcowy zarządzania http klastra. ciąg (wymagany)
nodeTypes Lista typów węzłów w klastrze. NodeTypeDescription[] (wymagane)
Powiadomienia Wskazuje listę kanałów powiadomień dla zdarzeń klastra. powiadomienia[]
reliabilityLevel Poziom niezawodności ustawia rozmiar zestawu replik usług systemowych. Dowiedz się więcej o ReliabilityLevel.

- Brak — uruchom usługi systemowe z docelową liczbą zestawów replik 1. Powinno to być używane tylko w przypadku klastrów testowych.
- Brąz — uruchom usługi systemowe z docelową liczbą zestawów replik 3. Powinno to być używane tylko w przypadku klastrów testowych.
- Silver — uruchom usługi systemowe z docelową liczbą zestawów replik 5.
- Gold - Uruchom usługi systemowe z docelową liczbą zestawów replik 7.
- Platinum — uruchom usługi systemowe z docelową liczbą zestawów replik 9.		 "Brązowy"
"Złoto"
"Brak"
"Platyna"
"Silver"
reverseProxyCertificate Certyfikat serwera używany przez zwrotny serwer proxy. CertificateDescription
reverseProxyCertificateCommonNames Opisuje listę certyfikatów serwera, do których odwołuje się nazwa pospolita używana do zabezpieczania klastra. ServerCertificateCommonNames
sfZonalUpgradeMode Ta właściwość steruje logicznym grupowaniem maszyn wirtualnych w domenach uaktualniania (UD). Tej właściwości nie można zmodyfikować, jeśli typ węzła z wieloma strefami dostępności jest już obecny w klastrze. "Hierarchiczny"
"Równoległe"
upgradeDescription Zasady do użycia podczas uaktualniania klastra. ClusterUpgradePolicy
upgradeMode Tryb uaktualniania klastra, gdy jest dostępna nowa wersja środowiska uruchomieniowego usługi Service Fabric. "Automatyczny"
"Ręczne"
upgradePauseEndTimestampUtc Wskazuje datę i godzinę zakończenia wstrzymania automatycznych uaktualnień wersji środowiska uruchomieniowego w klastrze przez określony okres czasu w klastrze (UTC). struna
upgradePauseStartTimestampUtc Wskazuje datę i godzinę rozpoczęcia wstrzymania automatycznych uaktualnień wersji środowiska uruchomieniowego w klastrze przez określony okres czasu w klastrze (UTC). struna
upgradeWave Wskazuje, kiedy nowe uaktualnienia wersji środowiska uruchomieniowego klastra zostaną zastosowane po ich wydaniu. Domyślnie to Wave0. Ma zastosowanie tylko wtedy, gdy upgradeMode jest ustawiona na wartość "Automatyczna". "Wave0"
"Wave1"
"Wave2"
vmImage Skonfigurowano zestaw skalowania maszyn wirtualnych z obrazem maszyny wirtualnej. Można używać nazw ogólnych, takich jak Windows lub Linux. struna
vmssZonalUpgradeMode Ta właściwość definiuje tryb uaktualniania zestawu skalowania maszyn wirtualnych, jest obowiązkowy, jeśli dodano typ węzła z wieloma strefami dostępności. "Hierarchiczny"
"Równoległe"
waveUpgradePaused Wartość logiczna w celu wstrzymania automatycznych uaktualnień wersji środowiska uruchomieniowego do klastra. Bool

ClusterUpgradeDeltaHealthPolicy

Nazwa Opis Wartość
applicationDeltaHealthPolicies Definiuje mapę zasad kondycji różnicowej aplikacji używaną do oceny kondycji aplikacji lub jednej z jej jednostek podrzędnych podczas uaktualniania klastra. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications Maksymalny dozwolony procent pogorszenia kondycji aplikacji dozwolony podczas uaktualniania klastra.
Różnica jest mierzona między stanem aplikacji na początku uaktualniania a stanem aplikacji w momencie oceny kondycji.
Sprawdzanie jest wykonywane po każdym zakończeniu uaktualniania domeny, aby upewnić się, że stan globalny klastra mieści się w granicach tolerowanych. Usługi systemowe nie są w tym uwzględnione.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100 (wymagane)
maxPercentDeltaUnhealthyNodes Maksymalny dozwolony procent obniżenia kondycji węzłów dozwolony podczas uaktualniania klastra.
Delta jest mierzona między stanem węzłów na początku uaktualniania a stanem węzłów w czasie oceny kondycji.
Sprawdzanie jest wykonywane po każdym zakończeniu uaktualniania domeny, aby upewnić się, że stan globalny klastra mieści się w granicach tolerowanych.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100 (wymagane)
maxPercentUpgradeDomainDeltaUnhealthyNodes Maksymalny dozwolony procent obniżenia kondycji węzłów domeny uaktualnienia dozwolony podczas uaktualniania klastra.
Różnica jest mierzona między stanem węzłów domeny uaktualnienia na początku uaktualnienia a stanem węzłów domeny uaktualnienia w momencie oceny kondycji.
Sprawdzanie jest wykonywane po każdym ukończeniu uaktualniania domeny dla wszystkich ukończonych domen uaktualniania, aby upewnić się, że stan domen uaktualnienia mieści się w granicach tolerowanych.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100 (wymagane)

ClusterUpgradePolicy

Nazwa Opis Wartość
deltaHealthPolicy Zasady kondycji różnicowej klastra używane podczas uaktualniania klastra. ClusterUpgradeDeltaHealthPolicy
forceRestart Jeśli to prawda, procesy są wymuszane podczas uaktualniania, nawet jeśli wersja kodu nie uległa zmianie (uaktualnienie zmienia tylko konfigurację lub dane). Bool
healthCheckRetryTimeout Czas ponawiania próby oceny kondycji, gdy aplikacja lub klaster jest w złej kondycji przed wycofaniem uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
healthCheckStableDuration Czas, przez jaki aplikacja lub klaster musi pozostać w dobrej kondycji, zanim uaktualnienie przejdzie do następnej domeny uaktualnienia. Czas trwania może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
healthCheckWaitDuration Czas oczekiwania po ukończeniu domeny uaktualnienia przed przeprowadzeniem kontroli kondycji. Czas trwania może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
healthPolicy Zasady kondycji klastra używane podczas uaktualniania klastra. ClusterHealthPolicy (wymagane)
upgradeDomainTimeout Czas ukończenia każdej domeny uaktualnienia przed wycofaniem uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
upgradeReplicaSetCheckTimeout Maksymalny czas blokowania przetwarzania domeny uaktualnienia i zapobiegania utracie dostępności, gdy występują nieoczekiwane problemy. Po wygaśnięciu tego limitu czasu przetwarzanie domeny uaktualnienia będzie kontynuowane niezależnie od problemów z utratą dostępności. Limit czasu jest resetowany na początku każdej domeny uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
upgradeTimeout Czas ukończenia uaktualnienia ogólnego przed wycofaniem uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)

DiagnosticsStorageAccountConfig

Nazwa Opis Wartość
blobEndpoint Punkt końcowy obiektu blob konta usługi Azure Storage. ciąg (wymagany)
protectedAccountKeyName Nazwa chronionego klucza magazynu diagnostyki. ciąg (wymagany)
protectedAccountKeyName2 Nazwa pomocniczego chronionego klucza magazynu diagnostyki. Jeśli jeden z kluczy konta magazynu zostanie obrócony, klaster wróci do używania drugiego. struna
queueEndpoint Punkt końcowy kolejki konta usługi Azure Storage. ciąg (wymagany)
storageAccountName Nazwa konta usługi Azure Storage. ciąg (wymagany)
tableEndpoint Punkt końcowy tabeli konta usługi Azure Storage. ciąg (wymagany)

EndpointRangeDescription

Nazwa Opis Wartość
endPort Końcowy port zakresu portów int (wymagane)
startPort Początkowy port zakresu portów int (wymagane)

Microsoft.ServiceFabric/clusters

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobów platformy Azure. ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości zasobu klastra ClusterProperties
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

NodeTypeDescription

Nazwa Opis Wartość
applicationPorts Zakres portów, z których klaster przypisał port do aplikacji usługi Service Fabric. endpointRangeDescription
Pojemności Tagi pojemności zastosowane do węzłów w typie węzła, menedżer zasobów klastra używa tych tagów, aby zrozumieć, ile zasobów ma węzeł. NodeTypeDescriptionCapacities
clientConnectionEndpointPort Port punktu końcowego zarządzania klastrem TCP. int (wymagane)
trwałośćPoszczel Poziom trwałości typu węzła. Dowiedz się więcej o TrwałośćLevel.

- Brąz - Brak uprawnień. Jest to wartość domyślna.
- Silver — zadania infrastruktury można wstrzymać przez czas 10 minut na użytkownika.
- Złoto — zadania infrastruktury mogą być wstrzymane przez czas trwania 2 godzin na użytkownika. Trwałość złota może być włączona tylko w przypadku jednostek SKU maszyn wirtualnych z pełnym węzłem, takich jak D15_V2, G5 itp.		 "Brązowy"
"Złoto"
"Silver"
efemerycznePorts Zakres efemerycznych portów, z którymi należy skonfigurować węzły tego typu węzłów. endpointRangeDescription
httpGatewayEndpointPort Port punktu końcowego zarządzania klastrem HTTP. int (wymagane)
httpGatewayTokenAuthEndpointPort Port używany na potrzeby połączeń HTTPS opartych na tokenach z klastrem. Nie można ustawić tego samego portu co HttpGatewayEndpoint. Int
isPrimary Typ węzła, w którym będą uruchamiane usługi systemowe. Jako podstawowy powinien być oznaczony tylko jeden typ węzła. Nie można usunąć ani zmienić typu węzła podstawowego dla istniejących klastrów. bool (wymagane)
isStateless Wskazuje, czy typ węzła może hostować tylko obciążenia bezstanowe. Bool
multipleAvailabilityZones Wskazuje, czy typ węzła jest włączony do obsługi wielu stref. Bool
nazwa Nazwa typu węzła. ciąg (wymagany)
placementProperties Tagi umieszczania stosowane do węzłów w typie węzła, których można użyć do wskazania, gdzie powinny być uruchomione określone usługi (obciążenie). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Punkt końcowy używany przez zwrotny serwer proxy. Int
vmInstanceCount Wartość VMInstanceCount powinna być od 1 do n, gdzie n wskazuje liczbę wystąpień maszyn wirtualnych odpowiadających temu nodeType. Wartość VMInstanceCount = 0 można wykonać tylko w następujących scenariuszach: NodeType jest węzłem pomocniczymType. Trwałość = brąz lub trwałość >= brąz i infrastrukturaServiceManager = true. Jeśli wartość VMInstanceCount = 0, oznacza to, że maszyny wirtualne dla tego typu węzła nie będą używane do obliczania początkowego rozmiaru klastra. Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 2147483647 (wymagane)

NodeTypeDescriptionCapacities

Nazwa Opis Wartość

NodeTypeDescriptionPlacementProperties

Nazwa Opis Wartość

Powiadomienie

Nazwa Opis Wartość
isEnabled Wskazuje, czy powiadomienie jest włączone. bool (wymagane)
notificationCategory Kategoria powiadomienia. "WaveProgress" (wymagane)
notificationLevel Poziom powiadomień. "Wszystko"
"Krytyczne" (wymagane)
notificationTargets Lista obiektów docelowych, które subskrybują powiadomienie. NotificationTarget[] (wymagane)

NotificationTarget

Nazwa Opis Wartość
notificationChannel Kanał powiadomień wskazuje typ odbiorników subskrybowanych do powiadomienia— użytkownika lub subskrypcji. "EmailSubscription"
"EmailUser" (wymagany)
Odbiorniki Lista obiektów docelowych, które subskrybują powiadomienie. string[] (wymagane)

Tagi zasobów

Nazwa Opis Wartość

ServerCertificateCommonName

Nazwa Opis Wartość
certificateCommonName Nazwa pospolita certyfikatu serwera. ciąg (wymagany)
certificateIssuerThumbprint Odcisk palca wystawcy certyfikatu serwera. ciąg (wymagany)

ServerCertificateCommonNames

Nazwa Opis Wartość
commonNames Lista certyfikatów serwera, do których odwołuje się nazwa pospolita, która jest używana do zabezpieczania klastra. ServerCertificateCommonName[]
x509StoreName Lokalizacja lokalnego magazynu certyfikatów. "Adresbook"
"AuthRoot"
"CertificateAuthority"
"Niedozwolone"
"Mój"
"Katalog główny"
"Zaufani ludzie"
"TrustedPublisher"

ServiceTypeDeltaHealthPolicy

Nazwa Opis Wartość
maxPercentDeltaUnhealthyServices Maksymalny dozwolony procent obniżenia kondycji usług dozwolony podczas uaktualniania klastra.
Różnica jest mierzona między stanem usług na początku uaktualniania a stanem usług w momencie oceny kondycji.
Sprawdzanie jest wykonywane po każdym zakończeniu uaktualniania domeny, aby upewnić się, że stan globalny klastra mieści się w granicach tolerowanych.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100

ServiceTypeDeltaHealthPolicyMap

Nazwa Opis Wartość

ServiceTypeHealthPolicy

Nazwa Opis Wartość
maxPercentUnhealthyServices Maksymalny procent usług, które mogą być w złej kondycji, zanim aplikacja zostanie uznana za błędną. Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100

ServiceTypeHealthPolicyMap

Nazwa Opis Wartość

SettingsParameterDescription

Nazwa Opis Wartość
nazwa Nazwa parametru ustawienia sieci szkieletowej. ciąg (wymagany)
wartość Wartość parametru ustawienia sieci szkieletowej. ciąg (wymagany)

UstawieniaSectionDescription

Nazwa Opis Wartość
nazwa Nazwa sekcji ustawień sieci szkieletowej. ciąg (wymagany)
Parametry Kolekcja parametrów w sekcji . SettingsParameterDescription[] (wymagane)

Przykłady z przewodnika Szybki start

W poniższych przykładach szybkiego startu wdrożono ten typ zasobu.

Plik Bicep Opis
wdrażanie bezpiecznego klastra z 5 węzłami Ten szablon umożliwia wdrożenie bezpiecznego klastra usługi Service Fabric z systemem Windows Server 2019 Datacenter z systemem Standard_D2_v2 Size VMSS.

Definicja zasobu szablonu usługi ARM

Typ zasobu klastrów można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.ServiceFabric/clusters, dodaj następujący kod JSON do szablonu.

{
  "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"
  }
}

Wartości właściwości

ApplicationDeltaHealthPolicy

Nazwa Opis Wartość
defaultServiceTypeDeltaHealthPolicy Zasady kondycji różnicowej używane domyślnie do oceny kondycji typu usługi podczas uaktualniania klastra. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies Mapa z zasadami kondycji różnicowej typu usługi na nazwę typu usługi. Mapa jest domyślnie pusta. ServiceTypeDeltaHealthPolicyMap

ApplicationDeltaHealthPolicyMap

Nazwa Opis Wartość

ApplicationHealthPolicy

Nazwa Opis Wartość
defaultServiceTypeHealthPolicy Zasady kondycji używane domyślnie do oceny kondycji typu usługi. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Mapa z zasadami kondycji typu usługi na nazwę typu usługi. Mapa jest domyślnie pusta. ServiceTypeHealthPolicyMap

ApplicationHealthPolicyMap

Nazwa Opis Wartość

ApplicationTypeVersionsCleanupPolicy

Nazwa Opis Wartość
maxUnusedVersionsToKeep Liczba nieużywanych wersji na typ aplikacji do zachowania. Int

Ograniczenia:
Minimalna wartość = 0 (wymagane)

AzureActiveDirectory

Nazwa Opis Wartość
clientApplication Identyfikator aplikacji klienckiej usługi Azure Active Directory. struna
clusterApplication Identyfikator aplikacji klastra usługi Azure Active Directory. struna
tenantId Identyfikator dzierżawy usługi Azure Active Directory. struna

Opis certyfikatu

Nazwa Opis Wartość
Odcisk palca Odcisk palca certyfikatu podstawowego. ciąg (wymagany)
odcisk palcaSecondary Odcisk palca certyfikatu pomocniczego. struna
x509StoreName Lokalizacja lokalnego magazynu certyfikatów. "Adresbook"
"AuthRoot"
"CertificateAuthority"
"Niedozwolone"
"Mój"
"Katalog główny"
"Zaufani ludzie"
"TrustedPublisher"

ClientCertificateCommonName

Nazwa Opis Wartość
certificateCommonName Nazwa pospolita certyfikatu klienta. ciąg (wymagany)
certificateIssuerThumbprint Odcisk palca wystawcy certyfikatu klienta. ciąg (wymagany)
isAdmin Wskazuje, czy certyfikat klienta ma dostęp administratora do klastra. Klienci niebędący administratorami mogą wykonywać tylko operacje tylko do odczytu w klastrze. bool (wymagane)

ClientCertificateThumbprint

Nazwa Opis Wartość
certificateThumbprint Odcisk palca certyfikatu klienta. ciąg (wymagany)
isAdmin Wskazuje, czy certyfikat klienta ma dostęp administratora do klastra. Klienci niebędący administratorami mogą wykonywać tylko operacje tylko do odczytu w klastrze. bool (wymagane)

ClusterHealthPolicy

Nazwa Opis Wartość
applicationHealthPolicies Definiuje mapę zasad kondycji aplikacji używaną do oceny kondycji aplikacji lub jednej z jej jednostek podrzędnych. ApplicationHealthPolicyMap
maxPercentUnhealthyApplications Maksymalny dozwolony procent aplikacji w złej kondycji przed zgłoszeniem błędu. Na przykład aby umożliwić 10% aplikacji w złej kondycji, ta wartość będzie wynosić 10.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową aplikacji, które mogą być w złej kondycji, zanim klaster zostanie uznany za błąd.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jedna aplikacja w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Jest to obliczane przez podzielenie liczby aplikacji w złej kondycji na łączną liczbę wystąpień aplikacji w klastrze, z wyłączeniem aplikacji typów aplikacji uwzględnionych w metryce ApplicationTypeHealthPolicyMap.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na małej liczbie aplikacji. Wartość procentowa domyślna to zero.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100
maxPercentUnhealthyNodes Maksymalny dozwolony procent węzłów w złej kondycji przed zgłoszeniem błędu. Na przykład aby umożliwić 10% węzłów w złej kondycji, ta wartość będzie wynosić 10.

Wartość procentowa reprezentuje maksymalny tolerowany procent węzłów, które mogą być w złej kondycji, zanim klaster zostanie uwzględniony w błędzie.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jeden węzeł w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Wartość procentowa jest obliczana przez podzielenie liczby węzłów w złej kondycji na łączną liczbę węzłów w klastrze.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na małej liczbie węzłów. Wartość procentowa domyślna to zero.

W dużych klastrach niektóre węzły będą zawsze wyłączone lub wyłączone w celu naprawy, więc ta wartość procentowa powinna być skonfigurowana tak, aby to tolerowała.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100

Właściwości klastra

Nazwa Opis Wartość
addOnFeatures Lista funkcji dodatków do włączenia w klastrze. Tablica ciągów zawierająca dowolną z:
"BackupRestoreService"
"DnsService"
"RepairManager"
"ResourceMonitorService"
applicationTypeVersionsCleanupPolicy Zasady używane do czyszczenia nieużywanych wersji. ApplicationTypeVersionsCleanupPolicy
azureActiveDirectory Ustawienia uwierzytelniania usługi AAD klastra. AzureActiveDirectory
certyfikat Certyfikat używany do zabezpieczania klastra. Podany certyfikat będzie używany do zabezpieczeń węzła w ramach klastra, certyfikatu SSL dla punktu końcowego zarządzania klastrem i domyślnego klienta administracyjnego. CertificateDescription
certificateCommonNames Opisuje listę certyfikatów serwera, do których odwołuje się nazwa pospolita używana do zabezpieczania klastra. ServerCertificateCommonNames
clientCertificateCommonNames Lista certyfikatów klienta, do których odwołuje się nazwa pospolita, które mogą zarządzać klastrem. ClientCertificateCommonName[]
clientCertificateThumbprints Lista certyfikatów klienta, do których odwołuje się odcisk palca, które mogą zarządzać klastrem. ClientCertificateThumbprint[]
clusterCodeVersion Wersja środowiska uruchomieniowego usługi Service Fabric klastra. Ta właściwość może być ustawiana tylko przez ustawienie użytkownika, gdy upgradeMode jest ustawiona na wartość "Manual". Aby uzyskać listę dostępnych wersji usługi Service Fabric dla nowych klastrów, użyj interfejsu API ClusterVersion. Aby uzyskać listę dostępnych wersji dla istniejących klastrów, użyj availableClusterVersions. struna
diagnosticsStorageAccountConfig Informacje o koncie magazynu do przechowywania dzienników diagnostycznych usługi Service Fabric. DiagnosticsStorageAccountConfig
enableHttpGatewayExclusiveAuthMode Jeśli wartość true, uwierzytelnianie oparte na tokenach nie jest dozwolone w punkcie HttpGatewayEndpoint. Jest to wymagane do obsługi protokołu TLS w wersji 1.3 lub nowszej. Jeśli jest używane uwierzytelnianie oparte na tokenach, należy zdefiniować parametr HttpGatewayTokenAuthEndpointPort. Bool
eventStoreServiceEnabled Wskazuje, czy usługa magazynu zdarzeń jest włączona. Bool
fabricSettings Lista niestandardowych ustawień sieci szkieletowej do skonfigurowania klastra. SettingsSectionDescription[]
infrastructureServiceManager Wskazuje, czy menedżer usług infrastruktury jest włączony. Bool
managementEndpoint Punkt końcowy zarządzania http klastra. ciąg (wymagany)
nodeTypes Lista typów węzłów w klastrze. NodeTypeDescription[] (wymagane)
Powiadomienia Wskazuje listę kanałów powiadomień dla zdarzeń klastra. powiadomienia[]
reliabilityLevel Poziom niezawodności ustawia rozmiar zestawu replik usług systemowych. Dowiedz się więcej o ReliabilityLevel.

- Brak — uruchom usługi systemowe z docelową liczbą zestawów replik 1. Powinno to być używane tylko w przypadku klastrów testowych.
- Brąz — uruchom usługi systemowe z docelową liczbą zestawów replik 3. Powinno to być używane tylko w przypadku klastrów testowych.
- Silver — uruchom usługi systemowe z docelową liczbą zestawów replik 5.
- Gold - Uruchom usługi systemowe z docelową liczbą zestawów replik 7.
- Platinum — uruchom usługi systemowe z docelową liczbą zestawów replik 9.		 "Brązowy"
"Złoto"
"Brak"
"Platyna"
"Silver"
reverseProxyCertificate Certyfikat serwera używany przez zwrotny serwer proxy. CertificateDescription
reverseProxyCertificateCommonNames Opisuje listę certyfikatów serwera, do których odwołuje się nazwa pospolita używana do zabezpieczania klastra. ServerCertificateCommonNames
sfZonalUpgradeMode Ta właściwość steruje logicznym grupowaniem maszyn wirtualnych w domenach uaktualniania (UD). Tej właściwości nie można zmodyfikować, jeśli typ węzła z wieloma strefami dostępności jest już obecny w klastrze. "Hierarchiczny"
"Równoległe"
upgradeDescription Zasady do użycia podczas uaktualniania klastra. ClusterUpgradePolicy
upgradeMode Tryb uaktualniania klastra, gdy jest dostępna nowa wersja środowiska uruchomieniowego usługi Service Fabric. "Automatyczny"
"Ręczne"
upgradePauseEndTimestampUtc Wskazuje datę i godzinę zakończenia wstrzymania automatycznych uaktualnień wersji środowiska uruchomieniowego w klastrze przez określony okres czasu w klastrze (UTC). struna
upgradePauseStartTimestampUtc Wskazuje datę i godzinę rozpoczęcia wstrzymania automatycznych uaktualnień wersji środowiska uruchomieniowego w klastrze przez określony okres czasu w klastrze (UTC). struna
upgradeWave Wskazuje, kiedy nowe uaktualnienia wersji środowiska uruchomieniowego klastra zostaną zastosowane po ich wydaniu. Domyślnie to Wave0. Ma zastosowanie tylko wtedy, gdy upgradeMode jest ustawiona na wartość "Automatyczna". "Wave0"
"Wave1"
"Wave2"
vmImage Skonfigurowano zestaw skalowania maszyn wirtualnych z obrazem maszyny wirtualnej. Można używać nazw ogólnych, takich jak Windows lub Linux. struna
vmssZonalUpgradeMode Ta właściwość definiuje tryb uaktualniania zestawu skalowania maszyn wirtualnych, jest obowiązkowy, jeśli dodano typ węzła z wieloma strefami dostępności. "Hierarchiczny"
"Równoległe"
waveUpgradePaused Wartość logiczna w celu wstrzymania automatycznych uaktualnień wersji środowiska uruchomieniowego do klastra. Bool

ClusterUpgradeDeltaHealthPolicy

Nazwa Opis Wartość
applicationDeltaHealthPolicies Definiuje mapę zasad kondycji różnicowej aplikacji używaną do oceny kondycji aplikacji lub jednej z jej jednostek podrzędnych podczas uaktualniania klastra. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications Maksymalny dozwolony procent pogorszenia kondycji aplikacji dozwolony podczas uaktualniania klastra.
Różnica jest mierzona między stanem aplikacji na początku uaktualniania a stanem aplikacji w momencie oceny kondycji.
Sprawdzanie jest wykonywane po każdym zakończeniu uaktualniania domeny, aby upewnić się, że stan globalny klastra mieści się w granicach tolerowanych. Usługi systemowe nie są w tym uwzględnione.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100 (wymagane)
maxPercentDeltaUnhealthyNodes Maksymalny dozwolony procent obniżenia kondycji węzłów dozwolony podczas uaktualniania klastra.
Delta jest mierzona między stanem węzłów na początku uaktualniania a stanem węzłów w czasie oceny kondycji.
Sprawdzanie jest wykonywane po każdym zakończeniu uaktualniania domeny, aby upewnić się, że stan globalny klastra mieści się w granicach tolerowanych.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100 (wymagane)
maxPercentUpgradeDomainDeltaUnhealthyNodes Maksymalny dozwolony procent obniżenia kondycji węzłów domeny uaktualnienia dozwolony podczas uaktualniania klastra.
Różnica jest mierzona między stanem węzłów domeny uaktualnienia na początku uaktualnienia a stanem węzłów domeny uaktualnienia w momencie oceny kondycji.
Sprawdzanie jest wykonywane po każdym ukończeniu uaktualniania domeny dla wszystkich ukończonych domen uaktualniania, aby upewnić się, że stan domen uaktualnienia mieści się w granicach tolerowanych.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100 (wymagane)

ClusterUpgradePolicy

Nazwa Opis Wartość
deltaHealthPolicy Zasady kondycji różnicowej klastra używane podczas uaktualniania klastra. ClusterUpgradeDeltaHealthPolicy
forceRestart Jeśli to prawda, procesy są wymuszane podczas uaktualniania, nawet jeśli wersja kodu nie uległa zmianie (uaktualnienie zmienia tylko konfigurację lub dane). Bool
healthCheckRetryTimeout Czas ponawiania próby oceny kondycji, gdy aplikacja lub klaster jest w złej kondycji przed wycofaniem uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
healthCheckStableDuration Czas, przez jaki aplikacja lub klaster musi pozostać w dobrej kondycji, zanim uaktualnienie przejdzie do następnej domeny uaktualnienia. Czas trwania może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
healthCheckWaitDuration Czas oczekiwania po ukończeniu domeny uaktualnienia przed przeprowadzeniem kontroli kondycji. Czas trwania może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
healthPolicy Zasady kondycji klastra używane podczas uaktualniania klastra. ClusterHealthPolicy (wymagane)
upgradeDomainTimeout Czas ukończenia każdej domeny uaktualnienia przed wycofaniem uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
upgradeReplicaSetCheckTimeout Maksymalny czas blokowania przetwarzania domeny uaktualnienia i zapobiegania utracie dostępności, gdy występują nieoczekiwane problemy. Po wygaśnięciu tego limitu czasu przetwarzanie domeny uaktualnienia będzie kontynuowane niezależnie od problemów z utratą dostępności. Limit czasu jest resetowany na początku każdej domeny uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
upgradeTimeout Czas ukończenia uaktualnienia ogólnego przed wycofaniem uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)

DiagnosticsStorageAccountConfig

Nazwa Opis Wartość
blobEndpoint Punkt końcowy obiektu blob konta usługi Azure Storage. ciąg (wymagany)
protectedAccountKeyName Nazwa chronionego klucza magazynu diagnostyki. ciąg (wymagany)
protectedAccountKeyName2 Nazwa pomocniczego chronionego klucza magazynu diagnostyki. Jeśli jeden z kluczy konta magazynu zostanie obrócony, klaster wróci do używania drugiego. struna
queueEndpoint Punkt końcowy kolejki konta usługi Azure Storage. ciąg (wymagany)
storageAccountName Nazwa konta usługi Azure Storage. ciąg (wymagany)
tableEndpoint Punkt końcowy tabeli konta usługi Azure Storage. ciąg (wymagany)

EndpointRangeDescription

Nazwa Opis Wartość
endPort Końcowy port zakresu portów int (wymagane)
startPort Początkowy port zakresu portów int (wymagane)

Microsoft.ServiceFabric/clusters

Nazwa Opis Wartość
apiVersion Wersja interfejsu API "2023-11-01-preview"
lokalizacja Lokalizacja zasobów platformy Azure. ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości zasobu klastra ClusterProperties
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.ServiceFabric/clusters"

NodeTypeDescription

Nazwa Opis Wartość
applicationPorts Zakres portów, z których klaster przypisał port do aplikacji usługi Service Fabric. endpointRangeDescription
Pojemności Tagi pojemności zastosowane do węzłów w typie węzła, menedżer zasobów klastra używa tych tagów, aby zrozumieć, ile zasobów ma węzeł. NodeTypeDescriptionCapacities
clientConnectionEndpointPort Port punktu końcowego zarządzania klastrem TCP. int (wymagane)
trwałośćPoszczel Poziom trwałości typu węzła. Dowiedz się więcej o TrwałośćLevel.

- Brąz - Brak uprawnień. Jest to wartość domyślna.
- Silver — zadania infrastruktury można wstrzymać przez czas 10 minut na użytkownika.
- Złoto — zadania infrastruktury mogą być wstrzymane przez czas trwania 2 godzin na użytkownika. Trwałość złota może być włączona tylko w przypadku jednostek SKU maszyn wirtualnych z pełnym węzłem, takich jak D15_V2, G5 itp.		 "Brązowy"
"Złoto"
"Silver"
efemerycznePorts Zakres efemerycznych portów, z którymi należy skonfigurować węzły tego typu węzłów. endpointRangeDescription
httpGatewayEndpointPort Port punktu końcowego zarządzania klastrem HTTP. int (wymagane)
httpGatewayTokenAuthEndpointPort Port używany na potrzeby połączeń HTTPS opartych na tokenach z klastrem. Nie można ustawić tego samego portu co HttpGatewayEndpoint. Int
isPrimary Typ węzła, w którym będą uruchamiane usługi systemowe. Jako podstawowy powinien być oznaczony tylko jeden typ węzła. Nie można usunąć ani zmienić typu węzła podstawowego dla istniejących klastrów. bool (wymagane)
isStateless Wskazuje, czy typ węzła może hostować tylko obciążenia bezstanowe. Bool
multipleAvailabilityZones Wskazuje, czy typ węzła jest włączony do obsługi wielu stref. Bool
nazwa Nazwa typu węzła. ciąg (wymagany)
placementProperties Tagi umieszczania stosowane do węzłów w typie węzła, których można użyć do wskazania, gdzie powinny być uruchomione określone usługi (obciążenie). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Punkt końcowy używany przez zwrotny serwer proxy. Int
vmInstanceCount Wartość VMInstanceCount powinna być od 1 do n, gdzie n wskazuje liczbę wystąpień maszyn wirtualnych odpowiadających temu nodeType. Wartość VMInstanceCount = 0 można wykonać tylko w następujących scenariuszach: NodeType jest węzłem pomocniczymType. Trwałość = brąz lub trwałość >= brąz i infrastrukturaServiceManager = true. Jeśli wartość VMInstanceCount = 0, oznacza to, że maszyny wirtualne dla tego typu węzła nie będą używane do obliczania początkowego rozmiaru klastra. Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 2147483647 (wymagane)

NodeTypeDescriptionCapacities

Nazwa Opis Wartość

NodeTypeDescriptionPlacementProperties

Nazwa Opis Wartość

Powiadomienie

Nazwa Opis Wartość
isEnabled Wskazuje, czy powiadomienie jest włączone. bool (wymagane)
notificationCategory Kategoria powiadomienia. "WaveProgress" (wymagane)
notificationLevel Poziom powiadomień. "Wszystko"
"Krytyczne" (wymagane)
notificationTargets Lista obiektów docelowych, które subskrybują powiadomienie. NotificationTarget[] (wymagane)

NotificationTarget

Nazwa Opis Wartość
notificationChannel Kanał powiadomień wskazuje typ odbiorników subskrybowanych do powiadomienia— użytkownika lub subskrypcji. "EmailSubscription"
"EmailUser" (wymagany)
Odbiorniki Lista obiektów docelowych, które subskrybują powiadomienie. string[] (wymagane)

Tagi zasobów

Nazwa Opis Wartość

ServerCertificateCommonName

Nazwa Opis Wartość
certificateCommonName Nazwa pospolita certyfikatu serwera. ciąg (wymagany)
certificateIssuerThumbprint Odcisk palca wystawcy certyfikatu serwera. ciąg (wymagany)

ServerCertificateCommonNames

Nazwa Opis Wartość
commonNames Lista certyfikatów serwera, do których odwołuje się nazwa pospolita, która jest używana do zabezpieczania klastra. ServerCertificateCommonName[]
x509StoreName Lokalizacja lokalnego magazynu certyfikatów. "Adresbook"
"AuthRoot"
"CertificateAuthority"
"Niedozwolone"
"Mój"
"Katalog główny"
"Zaufani ludzie"
"TrustedPublisher"

ServiceTypeDeltaHealthPolicy

Nazwa Opis Wartość
maxPercentDeltaUnhealthyServices Maksymalny dozwolony procent obniżenia kondycji usług dozwolony podczas uaktualniania klastra.
Różnica jest mierzona między stanem usług na początku uaktualniania a stanem usług w momencie oceny kondycji.
Sprawdzanie jest wykonywane po każdym zakończeniu uaktualniania domeny, aby upewnić się, że stan globalny klastra mieści się w granicach tolerowanych.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100

ServiceTypeDeltaHealthPolicyMap

Nazwa Opis Wartość

ServiceTypeHealthPolicy

Nazwa Opis Wartość
maxPercentUnhealthyServices Maksymalny procent usług, które mogą być w złej kondycji, zanim aplikacja zostanie uznana za błędną. Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100

ServiceTypeHealthPolicyMap

Nazwa Opis Wartość

SettingsParameterDescription

Nazwa Opis Wartość
nazwa Nazwa parametru ustawienia sieci szkieletowej. ciąg (wymagany)
wartość Wartość parametru ustawienia sieci szkieletowej. ciąg (wymagany)

UstawieniaSectionDescription

Nazwa Opis Wartość
nazwa Nazwa sekcji ustawień sieci szkieletowej. ciąg (wymagany)
Parametry Kolekcja parametrów w sekcji . SettingsParameterDescription[] (wymagane)

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają ten typ zasobu.

Szablon Opis
wdrażanie bezpiecznego klastra z 3 węzłami z włączoną sieciową grupą zabezpieczeń

wdrażanie w usłudze Azure		 Ten szablon umożliwia wdrożenie bezpiecznego klastra usługi Service Fabric typu 3 z systemem Windows Server 2016 Data center na maszynach wirtualnych o rozmiarze Standard_D2. Użyj tego szablonu, aby sterować przychodzącym i wychodzącym ruchem sieciowym przy użyciu sieciowych grup zabezpieczeń.
wdrażanie bezpiecznego klastra z 5 węzłami

wdrażanie w usłudze Azure		 Ten szablon umożliwia wdrożenie bezpiecznego klastra usługi Service Fabric z systemem Windows Server 2019 Datacenter z systemem Standard_D2_v2 Size VMSS.
wdrażanie klastra usługi Ubuntu Service Fabric z 5 węzłami

wdrażanie w usłudze Azure		 Ten szablon umożliwia wdrożenie bezpiecznego klastra usługi Service Fabric 5 węzła z systemem Ubuntu na maszynie wirtualnej o rozmiarze Standard_D2_V2.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu klastrów można wdrożyć przy użyciu operacji docelowych:

  • grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.ServiceFabric/clusters, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/clusters@2023-11-01-preview"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "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
    }
  })
}

Wartości właściwości

ApplicationDeltaHealthPolicy

Nazwa Opis Wartość
defaultServiceTypeDeltaHealthPolicy Zasady kondycji różnicowej używane domyślnie do oceny kondycji typu usługi podczas uaktualniania klastra. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies Mapa z zasadami kondycji różnicowej typu usługi na nazwę typu usługi. Mapa jest domyślnie pusta. ServiceTypeDeltaHealthPolicyMap

ApplicationDeltaHealthPolicyMap

Nazwa Opis Wartość

ApplicationHealthPolicy

Nazwa Opis Wartość
defaultServiceTypeHealthPolicy Zasady kondycji używane domyślnie do oceny kondycji typu usługi. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Mapa z zasadami kondycji typu usługi na nazwę typu usługi. Mapa jest domyślnie pusta. ServiceTypeHealthPolicyMap

ApplicationHealthPolicyMap

Nazwa Opis Wartość

ApplicationTypeVersionsCleanupPolicy

Nazwa Opis Wartość
maxUnusedVersionsToKeep Liczba nieużywanych wersji na typ aplikacji do zachowania. Int

Ograniczenia:
Minimalna wartość = 0 (wymagane)

AzureActiveDirectory

Nazwa Opis Wartość
clientApplication Identyfikator aplikacji klienckiej usługi Azure Active Directory. struna
clusterApplication Identyfikator aplikacji klastra usługi Azure Active Directory. struna
tenantId Identyfikator dzierżawy usługi Azure Active Directory. struna

Opis certyfikatu

Nazwa Opis Wartość
Odcisk palca Odcisk palca certyfikatu podstawowego. ciąg (wymagany)
odcisk palcaSecondary Odcisk palca certyfikatu pomocniczego. struna
x509StoreName Lokalizacja lokalnego magazynu certyfikatów. "Adresbook"
"AuthRoot"
"CertificateAuthority"
"Niedozwolone"
"Mój"
"Katalog główny"
"Zaufani ludzie"
"TrustedPublisher"

ClientCertificateCommonName

Nazwa Opis Wartość
certificateCommonName Nazwa pospolita certyfikatu klienta. ciąg (wymagany)
certificateIssuerThumbprint Odcisk palca wystawcy certyfikatu klienta. ciąg (wymagany)
isAdmin Wskazuje, czy certyfikat klienta ma dostęp administratora do klastra. Klienci niebędący administratorami mogą wykonywać tylko operacje tylko do odczytu w klastrze. bool (wymagane)

ClientCertificateThumbprint

Nazwa Opis Wartość
certificateThumbprint Odcisk palca certyfikatu klienta. ciąg (wymagany)
isAdmin Wskazuje, czy certyfikat klienta ma dostęp administratora do klastra. Klienci niebędący administratorami mogą wykonywać tylko operacje tylko do odczytu w klastrze. bool (wymagane)

ClusterHealthPolicy

Nazwa Opis Wartość
applicationHealthPolicies Definiuje mapę zasad kondycji aplikacji używaną do oceny kondycji aplikacji lub jednej z jej jednostek podrzędnych. ApplicationHealthPolicyMap
maxPercentUnhealthyApplications Maksymalny dozwolony procent aplikacji w złej kondycji przed zgłoszeniem błędu. Na przykład aby umożliwić 10% aplikacji w złej kondycji, ta wartość będzie wynosić 10.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową aplikacji, które mogą być w złej kondycji, zanim klaster zostanie uznany za błąd.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jedna aplikacja w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Jest to obliczane przez podzielenie liczby aplikacji w złej kondycji na łączną liczbę wystąpień aplikacji w klastrze, z wyłączeniem aplikacji typów aplikacji uwzględnionych w metryce ApplicationTypeHealthPolicyMap.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na małej liczbie aplikacji. Wartość procentowa domyślna to zero.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100
maxPercentUnhealthyNodes Maksymalny dozwolony procent węzłów w złej kondycji przed zgłoszeniem błędu. Na przykład aby umożliwić 10% węzłów w złej kondycji, ta wartość będzie wynosić 10.

Wartość procentowa reprezentuje maksymalny tolerowany procent węzłów, które mogą być w złej kondycji, zanim klaster zostanie uwzględniony w błędzie.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jeden węzeł w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Wartość procentowa jest obliczana przez podzielenie liczby węzłów w złej kondycji na łączną liczbę węzłów w klastrze.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na małej liczbie węzłów. Wartość procentowa domyślna to zero.

W dużych klastrach niektóre węzły będą zawsze wyłączone lub wyłączone w celu naprawy, więc ta wartość procentowa powinna być skonfigurowana tak, aby to tolerowała.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100

Właściwości klastra

Nazwa Opis Wartość
addOnFeatures Lista funkcji dodatków do włączenia w klastrze. Tablica ciągów zawierająca dowolną z:
"BackupRestoreService"
"DnsService"
"RepairManager"
"ResourceMonitorService"
applicationTypeVersionsCleanupPolicy Zasady używane do czyszczenia nieużywanych wersji. ApplicationTypeVersionsCleanupPolicy
azureActiveDirectory Ustawienia uwierzytelniania usługi AAD klastra. AzureActiveDirectory
certyfikat Certyfikat używany do zabezpieczania klastra. Podany certyfikat będzie używany do zabezpieczeń węzła w ramach klastra, certyfikatu SSL dla punktu końcowego zarządzania klastrem i domyślnego klienta administracyjnego. CertificateDescription
certificateCommonNames Opisuje listę certyfikatów serwera, do których odwołuje się nazwa pospolita używana do zabezpieczania klastra. ServerCertificateCommonNames
clientCertificateCommonNames Lista certyfikatów klienta, do których odwołuje się nazwa pospolita, które mogą zarządzać klastrem. ClientCertificateCommonName[]
clientCertificateThumbprints Lista certyfikatów klienta, do których odwołuje się odcisk palca, które mogą zarządzać klastrem. ClientCertificateThumbprint[]
clusterCodeVersion Wersja środowiska uruchomieniowego usługi Service Fabric klastra. Ta właściwość może być ustawiana tylko przez ustawienie użytkownika, gdy upgradeMode jest ustawiona na wartość "Manual". Aby uzyskać listę dostępnych wersji usługi Service Fabric dla nowych klastrów, użyj interfejsu API ClusterVersion. Aby uzyskać listę dostępnych wersji dla istniejących klastrów, użyj availableClusterVersions. struna
diagnosticsStorageAccountConfig Informacje o koncie magazynu do przechowywania dzienników diagnostycznych usługi Service Fabric. DiagnosticsStorageAccountConfig
enableHttpGatewayExclusiveAuthMode Jeśli wartość true, uwierzytelnianie oparte na tokenach nie jest dozwolone w punkcie HttpGatewayEndpoint. Jest to wymagane do obsługi protokołu TLS w wersji 1.3 lub nowszej. Jeśli jest używane uwierzytelnianie oparte na tokenach, należy zdefiniować parametr HttpGatewayTokenAuthEndpointPort. Bool
eventStoreServiceEnabled Wskazuje, czy usługa magazynu zdarzeń jest włączona. Bool
fabricSettings Lista niestandardowych ustawień sieci szkieletowej do skonfigurowania klastra. SettingsSectionDescription[]
infrastructureServiceManager Wskazuje, czy menedżer usług infrastruktury jest włączony. Bool
managementEndpoint Punkt końcowy zarządzania http klastra. ciąg (wymagany)
nodeTypes Lista typów węzłów w klastrze. NodeTypeDescription[] (wymagane)
Powiadomienia Wskazuje listę kanałów powiadomień dla zdarzeń klastra. powiadomienia[]
reliabilityLevel Poziom niezawodności ustawia rozmiar zestawu replik usług systemowych. Dowiedz się więcej o ReliabilityLevel.

- Brak — uruchom usługi systemowe z docelową liczbą zestawów replik 1. Powinno to być używane tylko w przypadku klastrów testowych.
- Brąz — uruchom usługi systemowe z docelową liczbą zestawów replik 3. Powinno to być używane tylko w przypadku klastrów testowych.
- Silver — uruchom usługi systemowe z docelową liczbą zestawów replik 5.
- Gold - Uruchom usługi systemowe z docelową liczbą zestawów replik 7.
- Platinum — uruchom usługi systemowe z docelową liczbą zestawów replik 9.		 "Brązowy"
"Złoto"
"Brak"
"Platyna"
"Silver"
reverseProxyCertificate Certyfikat serwera używany przez zwrotny serwer proxy. CertificateDescription
reverseProxyCertificateCommonNames Opisuje listę certyfikatów serwera, do których odwołuje się nazwa pospolita używana do zabezpieczania klastra. ServerCertificateCommonNames
sfZonalUpgradeMode Ta właściwość steruje logicznym grupowaniem maszyn wirtualnych w domenach uaktualniania (UD). Tej właściwości nie można zmodyfikować, jeśli typ węzła z wieloma strefami dostępności jest już obecny w klastrze. "Hierarchiczny"
"Równoległe"
upgradeDescription Zasady do użycia podczas uaktualniania klastra. ClusterUpgradePolicy
upgradeMode Tryb uaktualniania klastra, gdy jest dostępna nowa wersja środowiska uruchomieniowego usługi Service Fabric. "Automatyczny"
"Ręczne"
upgradePauseEndTimestampUtc Wskazuje datę i godzinę zakończenia wstrzymania automatycznych uaktualnień wersji środowiska uruchomieniowego w klastrze przez określony okres czasu w klastrze (UTC). struna
upgradePauseStartTimestampUtc Wskazuje datę i godzinę rozpoczęcia wstrzymania automatycznych uaktualnień wersji środowiska uruchomieniowego w klastrze przez określony okres czasu w klastrze (UTC). struna
upgradeWave Wskazuje, kiedy nowe uaktualnienia wersji środowiska uruchomieniowego klastra zostaną zastosowane po ich wydaniu. Domyślnie to Wave0. Ma zastosowanie tylko wtedy, gdy upgradeMode jest ustawiona na wartość "Automatyczna". "Wave0"
"Wave1"
"Wave2"
vmImage Skonfigurowano zestaw skalowania maszyn wirtualnych z obrazem maszyny wirtualnej. Można używać nazw ogólnych, takich jak Windows lub Linux. struna
vmssZonalUpgradeMode Ta właściwość definiuje tryb uaktualniania zestawu skalowania maszyn wirtualnych, jest obowiązkowy, jeśli dodano typ węzła z wieloma strefami dostępności. "Hierarchiczny"
"Równoległe"
waveUpgradePaused Wartość logiczna w celu wstrzymania automatycznych uaktualnień wersji środowiska uruchomieniowego do klastra. Bool

ClusterUpgradeDeltaHealthPolicy

Nazwa Opis Wartość
applicationDeltaHealthPolicies Definiuje mapę zasad kondycji różnicowej aplikacji używaną do oceny kondycji aplikacji lub jednej z jej jednostek podrzędnych podczas uaktualniania klastra. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications Maksymalny dozwolony procent pogorszenia kondycji aplikacji dozwolony podczas uaktualniania klastra.
Różnica jest mierzona między stanem aplikacji na początku uaktualniania a stanem aplikacji w momencie oceny kondycji.
Sprawdzanie jest wykonywane po każdym zakończeniu uaktualniania domeny, aby upewnić się, że stan globalny klastra mieści się w granicach tolerowanych. Usługi systemowe nie są w tym uwzględnione.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100 (wymagane)
maxPercentDeltaUnhealthyNodes Maksymalny dozwolony procent obniżenia kondycji węzłów dozwolony podczas uaktualniania klastra.
Delta jest mierzona między stanem węzłów na początku uaktualniania a stanem węzłów w czasie oceny kondycji.
Sprawdzanie jest wykonywane po każdym zakończeniu uaktualniania domeny, aby upewnić się, że stan globalny klastra mieści się w granicach tolerowanych.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100 (wymagane)
maxPercentUpgradeDomainDeltaUnhealthyNodes Maksymalny dozwolony procent obniżenia kondycji węzłów domeny uaktualnienia dozwolony podczas uaktualniania klastra.
Różnica jest mierzona między stanem węzłów domeny uaktualnienia na początku uaktualnienia a stanem węzłów domeny uaktualnienia w momencie oceny kondycji.
Sprawdzanie jest wykonywane po każdym ukończeniu uaktualniania domeny dla wszystkich ukończonych domen uaktualniania, aby upewnić się, że stan domen uaktualnienia mieści się w granicach tolerowanych.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100 (wymagane)

ClusterUpgradePolicy

Nazwa Opis Wartość
deltaHealthPolicy Zasady kondycji różnicowej klastra używane podczas uaktualniania klastra. ClusterUpgradeDeltaHealthPolicy
forceRestart Jeśli to prawda, procesy są wymuszane podczas uaktualniania, nawet jeśli wersja kodu nie uległa zmianie (uaktualnienie zmienia tylko konfigurację lub dane). Bool
healthCheckRetryTimeout Czas ponawiania próby oceny kondycji, gdy aplikacja lub klaster jest w złej kondycji przed wycofaniem uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
healthCheckStableDuration Czas, przez jaki aplikacja lub klaster musi pozostać w dobrej kondycji, zanim uaktualnienie przejdzie do następnej domeny uaktualnienia. Czas trwania może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
healthCheckWaitDuration Czas oczekiwania po ukończeniu domeny uaktualnienia przed przeprowadzeniem kontroli kondycji. Czas trwania może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
healthPolicy Zasady kondycji klastra używane podczas uaktualniania klastra. ClusterHealthPolicy (wymagane)
upgradeDomainTimeout Czas ukończenia każdej domeny uaktualnienia przed wycofaniem uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
upgradeReplicaSetCheckTimeout Maksymalny czas blokowania przetwarzania domeny uaktualnienia i zapobiegania utracie dostępności, gdy występują nieoczekiwane problemy. Po wygaśnięciu tego limitu czasu przetwarzanie domeny uaktualnienia będzie kontynuowane niezależnie od problemów z utratą dostępności. Limit czasu jest resetowany na początku każdej domeny uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
upgradeTimeout Czas ukończenia uaktualnienia ogólnego przed wycofaniem uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)

DiagnosticsStorageAccountConfig

Nazwa Opis Wartość
blobEndpoint Punkt końcowy obiektu blob konta usługi Azure Storage. ciąg (wymagany)
protectedAccountKeyName Nazwa chronionego klucza magazynu diagnostyki. ciąg (wymagany)
protectedAccountKeyName2 Nazwa pomocniczego chronionego klucza magazynu diagnostyki. Jeśli jeden z kluczy konta magazynu zostanie obrócony, klaster wróci do używania drugiego. struna
queueEndpoint Punkt końcowy kolejki konta usługi Azure Storage. ciąg (wymagany)
storageAccountName Nazwa konta usługi Azure Storage. ciąg (wymagany)
tableEndpoint Punkt końcowy tabeli konta usługi Azure Storage. ciąg (wymagany)

EndpointRangeDescription

Nazwa Opis Wartość
endPort Końcowy port zakresu portów int (wymagane)
startPort Początkowy port zakresu portów int (wymagane)

Microsoft.ServiceFabric/clusters

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobów platformy Azure. ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości zasobu klastra ClusterProperties
Tagi Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.ServiceFabric/clusters@2023-11-01-preview"

NodeTypeDescription

Nazwa Opis Wartość
applicationPorts Zakres portów, z których klaster przypisał port do aplikacji usługi Service Fabric. endpointRangeDescription
Pojemności Tagi pojemności zastosowane do węzłów w typie węzła, menedżer zasobów klastra używa tych tagów, aby zrozumieć, ile zasobów ma węzeł. NodeTypeDescriptionCapacities
clientConnectionEndpointPort Port punktu końcowego zarządzania klastrem TCP. int (wymagane)
trwałośćPoszczel Poziom trwałości typu węzła. Dowiedz się więcej o TrwałośćLevel.

- Brąz - Brak uprawnień. Jest to wartość domyślna.
- Silver — zadania infrastruktury można wstrzymać przez czas 10 minut na użytkownika.
- Złoto — zadania infrastruktury mogą być wstrzymane przez czas trwania 2 godzin na użytkownika. Trwałość złota może być włączona tylko w przypadku jednostek SKU maszyn wirtualnych z pełnym węzłem, takich jak D15_V2, G5 itp.		 "Brązowy"
"Złoto"
"Silver"
efemerycznePorts Zakres efemerycznych portów, z którymi należy skonfigurować węzły tego typu węzłów. endpointRangeDescription
httpGatewayEndpointPort Port punktu końcowego zarządzania klastrem HTTP. int (wymagane)
httpGatewayTokenAuthEndpointPort Port używany na potrzeby połączeń HTTPS opartych na tokenach z klastrem. Nie można ustawić tego samego portu co HttpGatewayEndpoint. Int
isPrimary Typ węzła, w którym będą uruchamiane usługi systemowe. Jako podstawowy powinien być oznaczony tylko jeden typ węzła. Nie można usunąć ani zmienić typu węzła podstawowego dla istniejących klastrów. bool (wymagane)
isStateless Wskazuje, czy typ węzła może hostować tylko obciążenia bezstanowe. Bool
multipleAvailabilityZones Wskazuje, czy typ węzła jest włączony do obsługi wielu stref. Bool
nazwa Nazwa typu węzła. ciąg (wymagany)
placementProperties Tagi umieszczania stosowane do węzłów w typie węzła, których można użyć do wskazania, gdzie powinny być uruchomione określone usługi (obciążenie). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Punkt końcowy używany przez zwrotny serwer proxy. Int
vmInstanceCount Wartość VMInstanceCount powinna być od 1 do n, gdzie n wskazuje liczbę wystąpień maszyn wirtualnych odpowiadających temu nodeType. Wartość VMInstanceCount = 0 można wykonać tylko w następujących scenariuszach: NodeType jest węzłem pomocniczymType. Trwałość = brąz lub trwałość >= brąz i infrastrukturaServiceManager = true. Jeśli wartość VMInstanceCount = 0, oznacza to, że maszyny wirtualne dla tego typu węzła nie będą używane do obliczania początkowego rozmiaru klastra. Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 2147483647 (wymagane)

NodeTypeDescriptionCapacities

Nazwa Opis Wartość

NodeTypeDescriptionPlacementProperties

Nazwa Opis Wartość

Powiadomienie

Nazwa Opis Wartość
isEnabled Wskazuje, czy powiadomienie jest włączone. bool (wymagane)
notificationCategory Kategoria powiadomienia. "WaveProgress" (wymagane)
notificationLevel Poziom powiadomień. "Wszystko"
"Krytyczne" (wymagane)
notificationTargets Lista obiektów docelowych, które subskrybują powiadomienie. NotificationTarget[] (wymagane)

NotificationTarget

Nazwa Opis Wartość
notificationChannel Kanał powiadomień wskazuje typ odbiorników subskrybowanych do powiadomienia— użytkownika lub subskrypcji. "EmailSubscription"
"EmailUser" (wymagany)
Odbiorniki Lista obiektów docelowych, które subskrybują powiadomienie. string[] (wymagane)

Tagi zasobów

Nazwa Opis Wartość

ServerCertificateCommonName

Nazwa Opis Wartość
certificateCommonName Nazwa pospolita certyfikatu serwera. ciąg (wymagany)
certificateIssuerThumbprint Odcisk palca wystawcy certyfikatu serwera. ciąg (wymagany)

ServerCertificateCommonNames

Nazwa Opis Wartość
commonNames Lista certyfikatów serwera, do których odwołuje się nazwa pospolita, która jest używana do zabezpieczania klastra. ServerCertificateCommonName[]
x509StoreName Lokalizacja lokalnego magazynu certyfikatów. "Adresbook"
"AuthRoot"
"CertificateAuthority"
"Niedozwolone"
"Mój"
"Katalog główny"
"Zaufani ludzie"
"TrustedPublisher"

ServiceTypeDeltaHealthPolicy

Nazwa Opis Wartość
maxPercentDeltaUnhealthyServices Maksymalny dozwolony procent obniżenia kondycji usług dozwolony podczas uaktualniania klastra.
Różnica jest mierzona między stanem usług na początku uaktualniania a stanem usług w momencie oceny kondycji.
Sprawdzanie jest wykonywane po każdym zakończeniu uaktualniania domeny, aby upewnić się, że stan globalny klastra mieści się w granicach tolerowanych.		 Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100

ServiceTypeDeltaHealthPolicyMap

Nazwa Opis Wartość

ServiceTypeHealthPolicy

Nazwa Opis Wartość
maxPercentUnhealthyServices Maksymalny procent usług, które mogą być w złej kondycji, zanim aplikacja zostanie uznana za błędną. Int

Ograniczenia:
Minimalna wartość = 0
Wartość maksymalna = 100

ServiceTypeHealthPolicyMap

Nazwa Opis Wartość

SettingsParameterDescription

Nazwa Opis Wartość
nazwa Nazwa parametru ustawienia sieci szkieletowej. ciąg (wymagany)
wartość Wartość parametru ustawienia sieci szkieletowej. ciąg (wymagany)

UstawieniaSectionDescription

Nazwa Opis Wartość
nazwa Nazwa sekcji ustawień sieci szkieletowej. ciąg (wymagany)
Parametry Kolekcja parametrów w sekcji . SettingsParameterDescription[] (wymagane)