Udostępnij za pośrednictwem


Microsoft.ServiceFabric managedClusters 2024-04-01

Definicja zasobu Bicep

Typ zasobu managedClusters można wdrożyć za pomocą operacji docelowych:

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

Format zasobu

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

resource symbolicname 'Microsoft.ServiceFabric/managedClusters@2024-04-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  properties: {
    addonFeatures: [
      'string'
    ]
    adminPassword: 'string'
    adminUserName: 'string'
    allowRdpAccess: bool
    applicationTypeVersionsCleanupPolicy: {
      maxUnusedVersionsToKeep: int
    }
    auxiliarySubnets: [
      {
        enableIpv6: bool
        name: 'string'
        networkSecurityGroupId: 'string'
        privateEndpointNetworkPolicies: 'string'
        privateLinkServiceNetworkPolicies: 'string'
      }
    ]
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
    }
    clientConnectionPort: int
    clients: [
      {
        commonName: 'string'
        isAdmin: bool
        issuerThumbprint: 'string'
        thumbprint: 'string'
      }
    ]
    clusterCodeVersion: 'string'
    clusterUpgradeCadence: 'string'
    clusterUpgradeMode: 'string'
    ddosProtectionPlanId: 'string'
    dnsName: 'string'
    enableAutoOSUpgrade: bool
    enableHttpGatewayExclusiveAuthMode: bool
    enableIpv6: bool
    enableServicePublicIP: bool
    fabricSettings: [
      {
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
      }
    ]
    httpGatewayConnectionPort: int
    httpGatewayTokenAuthConnectionPort: int
    ipTags: [
      {
        ipTagType: 'string'
        tag: 'string'
      }
    ]
    loadBalancingRules: [
      {
        backendPort: int
        frontendPort: int
        loadDistribution: 'string'
        probePort: int
        probeProtocol: 'string'
        probeRequestPath: 'string'
        protocol: 'string'
      }
    ]
    networkSecurityRules: [
      {
        access: 'string'
        description: 'string'
        destinationAddressPrefix: 'string'
        destinationAddressPrefixes: [
          'string'
        ]
        destinationPortRange: 'string'
        destinationPortRanges: [
          'string'
        ]
        direction: 'string'
        name: 'string'
        priority: int
        protocol: 'string'
        sourceAddressPrefix: 'string'
        sourceAddressPrefixes: [
          'string'
        ]
        sourcePortRange: 'string'
        sourcePortRanges: [
          'string'
        ]
      }
    ]
    publicIPPrefixId: 'string'
    publicIPv6PrefixId: 'string'
    serviceEndpoints: [
      {
        locations: [
          'string'
        ]
        service: 'string'
      }
    ]
    subnetId: 'string'
    upgradeDescription: {
      deltaHealthPolicy: {
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
      }
      forceRestart: bool
      healthPolicy: {
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
      }
      monitoringPolicy: {
        healthCheckRetryTimeout: 'string'
        healthCheckStableDuration: 'string'
        healthCheckWaitDuration: 'string'
        upgradeDomainTimeout: 'string'
        upgradeTimeout: 'string'
      }
      upgradeReplicaSetCheckTimeout: 'string'
    }
    useCustomVnet: bool
    zonalResiliency: bool
    zonalUpdateMode: 'string'
  }
}

Wartości właściwości

managedClusters

Nazwa Opis Wartość
name Nazwa zasobu ciąg (wymagany)
location Lokalizacja zasobu platformy Azure. ciąg (wymagany)
tags Tagi zasobów platformy Azure. Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
sku Jednostka SKU klastra zarządzanego Jednostka SKU (wymagana )
properties Właściwości zasobu klastra zarządzanego ManagedClusterProperties

ManagedClusterProperties

Nazwa Opis Wartość
addonFeatures Lista funkcji dodatków do włączenia w klastrze. Tablica ciągów zawierająca dowolną z:
"BackupRestoreService"
"DnsService"
"ResourceMonitorService"
adminPassword Hasło użytkownika administratora maszyny wirtualnej. ciąg

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
adminUserName Nazwa użytkownika administratora maszyny wirtualnej. ciąg (wymagany)
allowRdpAccess Ustawienie wartości true powoduje włączenie dostępu RDP do maszyny wirtualnej. Domyślna reguła sieciowej grupy zabezpieczeń otwiera port RDP do Internetu, który można zastąpić niestandardowymi regułami zabezpieczeń sieci. Wartość domyślna tego ustawienia to false. bool
applicationTypeVersionsCleanupPolicy Zasady używane do czyszczenia nieużywanych wersji. ApplicationTypeVersionsCleanupPolicy
pomocnicze podsieci Pomocnicze podsieci klastra. Podsieć[]
azureActiveDirectory Ustawienia uwierzytelniania usługi AAD klastra. AzureActiveDirectory
clientConnectionPort Port używany do połączeń klienta z klastrem. int
Klientów Certyfikaty klienta, które mogą zarządzać klastrem. ClientCertificate[]
clusterCodeVersion Wersja środowiska uruchomieniowego usługi Service Fabric klastra. Ta właściwość jest wymagana, gdy klasterUpgradeMode jest ustawiony 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 dostępnej bibliotekiClusterVersions. ciąg
clusterUpgradeCadence Wskazuje, kiedy nowe uaktualnienia wersji środowiska uruchomieniowego klastra zostaną zastosowane po ich wydaniu. Domyślnie to Wave0. Ma zastosowanie tylko wtedy, gdy klasterUpgradeMode jest ustawiony na wartość "Automatic". "Wave0"
"Wave1"
"Wave2"
clusterUpgradeMode Tryb uaktualniania klastra, gdy jest dostępna nowa wersja środowiska uruchomieniowego usługi Service Fabric. "Automatyczne"
"Ręczne"
ddosProtectionPlanId Określ identyfikator zasobu planu ochrony sieci DDoS, który zostanie skojarzony z siecią wirtualną klastra. ciąg
dnsName Nazwa DNS klastra. ciąg (wymagany)
enableAutoOSUpgrade Ustawienie wartości true umożliwia automatyczne uaktualnianie systemu operacyjnego dla typów węzłów utworzonych przy użyciu dowolnego obrazu systemu operacyjnego platformy z wersją "latest". Wartość domyślna tego ustawienia to false. bool
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ć wartość HttpGatewayTokenAuthConnectionPort. bool
enableIpv6 Ustawienie wartości true powoduje utworzenie przestrzeni adresowej IPv6 dla domyślnej sieci wirtualnej używanej przez klaster. Nie można zmienić tego ustawienia po utworzeniu klastra. Wartość domyślna tego ustawienia to false. bool
enableServicePublicIP Ustawienie wartości true spowoduje połączenie adresu IPv4 jako servicePublicIP adresu IPv6. Można go ustawić tylko na wartość True, jeśli protokół IPv6 jest włączony w klastrze. bool
fabricSettings Lista niestandardowych ustawień sieci szkieletowej do skonfigurowania klastra. SettingsSectionDescription[]
httpGatewayConnectionPort Port używany do połączeń HTTP z klastrem. int
httpGatewayTokenAuthConnectionPort Port używany do nawiązywania połączeń HTTPS opartych na tokenach z klastrem. Nie można ustawić tego samego portu co HttpGatewayEndpoint. int
ipTags Lista tagów IP skojarzonych z domyślnym publicznym adresem IP klastra. IpTag[]
loadBalancingRules Reguły równoważenia obciążenia stosowane do publicznego modułu równoważenia obciążenia klastra. LoadBalancingRule[]
networkSecurityRules Niestandardowe reguły zabezpieczeń sieci, które są stosowane do Virtual Network klastra. NetworkSecurityRule[]
publicIPPrefixId Określ identyfikator zasobu publicznego prefiksu IPv4, z którego moduł równoważenia obciążenia przydzieli publiczny adres IPv4. Nie można zmienić tego ustawienia po utworzeniu klastra. ciąg
publicIPv6PrefixId Określ identyfikator zasobu publicznego prefiksu IPv6, z którego moduł równoważenia obciążenia przydzieli publiczny adres IPv6. Nie można zmienić tego ustawienia po utworzeniu klastra. ciąg
serviceEndpoints Punkty końcowe usługi dla podsieci w klastrze. ServiceEndpoint[]
subnetId Jeśli zostanie określony, typy węzłów klastra są tworzone w tej podsieci zamiast domyślnej sieci wirtualnej. SieciSecurityRules określone dla klastra są również stosowane do tej podsieci. Nie można zmienić tego ustawienia po utworzeniu klastra. ciąg
upgradeDescription Zasady do użycia podczas uaktualniania klastra. ClusterUpgradePolicy
useCustomVnet W przypadku nowych klastrów ten parametr wskazuje, że używa własnej sieci wirtualnej, ale podsieć jest określona na poziomie typu węzła; i dla takich klastrów właściwość subnetId jest wymagana dla typów węzłów. bool
strefowaResiliency Wskazuje, czy klaster ma odporność strefy. bool
zonalUpdateMode Wskazuje tryb aktualizacji dla klastrów Cross Az. "Szybkie"
"Standardowa"

ApplicationTypeVersionsCleanupPolicy

Nazwa Opis Wartość
maxUnusedVersionsToKeep Liczba nieużywanych wersji na typ aplikacji do zachowania. int (wymagane)

Ograniczenia:
Minimalna wartość = 0

Podsieć

Nazwa Opis Wartość
enableIpv6 Wskazuje, że do włączenia protokołu Ipv6 lub nie. Jeśli nie zostanie podana, zajmie to samą konfigurację co klaster. bool
name Nazwa podsieci. ciąg (wymagany)
networkSecurityGroupId Pełny identyfikator zasobu dla sieciowej grupy zabezpieczeń. ciąg
privateEndpointNetworkPolicies Włączanie lub wyłączanie stosowania zasad sieciowych w prywatnym punkcie końcowym w podsieci. "wyłączone"
"włączone"
privateLinkServiceNetworkPolicies Włączanie lub wyłączanie stosowania zasad sieciowych w usłudze łącza prywatnego w podsieci. "wyłączone"
"włączone"

AzureActiveDirectory

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

Clientcertificate

Nazwa Opis Wartość
commonName Nazwa pospolita certyfikatu. ciąg
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)
issuerThumbprint Odcisk palca wystawcy dla certyfikatu. Używane tylko razem z nazwą CommonName. ciąg
Odcisk palca Odcisk palca certyfikatu. ciąg

UstawieniaSectionDescription

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

SettingsParameterDescription

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

IpTag

Nazwa Opis Wartość
ipTagType Typ tagu IP. Przykład: FirstPartyUsage. ciąg (wymagany)
tag Tag IP skojarzony z publicznym adresem IP. Przykład: SQL, Storage itp. ciąg (wymagany)

LoadBalancingRule

Nazwa Opis Wartość
backendPort Port używany do połączeń wewnętrznych w punkcie końcowym. Dopuszczalne wartości to od 1 do 65535. int (wymagane)

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 65534
frontendPort Port zewnętrznego punktu końcowego. Numery portów dla każdej reguły muszą być unikatowe w ramach Load Balancer. Dopuszczalne wartości to od 1 do 65534. int (wymagane)

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 65534
loadDistribution Zasady dystrybucji obciążenia dla tej reguły. ciąg
probePort Port prob używany przez regułę równoważenia obciążenia. Dopuszczalne wartości to od 1 do 65535. int

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 65534
probeProtocol odwołanie do sondy modułu równoważenia obciążenia używanej przez regułę równoważenia obciążenia. 'http'
'https'
"tcp" (wymagany)
probeRequestPath Ścieżka żądania sondy. Obsługiwane tylko w przypadku sond HTTP/HTTPS. ciąg
Protokół Odwołanie do protokołu transportowego używanego przez regułę równoważenia obciążenia. "tcp"
"udp" (wymagane)

NetworkSecurityRule

Nazwa Opis Wartość
access Ruch sieciowy jest dozwolony lub blokowany. "Zezwalaj"
"odmów" (wymagane)
description (opis) Opis reguły zabezpieczeń sieci. ciąg
destinationAddressPrefix Prefiks adresu docelowego. CiDR lub docelowy zakres adresów IP. Gwiazdka "*" może być również używana do dopasowania wszystkich źródłowych adresów IP. Można również używać tagów domyślnych, takich jak "VirtualNetwork", "AzureLoadBalancer" i "Internet". ciąg
destinationAddressPrefixes Prefiksy adresów docelowych. CiDR lub docelowe zakresy adresów IP. ciąg[]
destinationPortRange port docelowy lub zakres. Liczba całkowita lub zakres z zakresu od 0 do 65535. Gwiazdka "*" może być również używana do dopasowania wszystkich portów. ciąg
destinationPortRanges Zakresy portów docelowych. ciąg[]
kierunek Kierunek reguły zabezpieczeń sieci. "przychodzący"
"wychodzący" (wymagany)
name Nazwa reguły zabezpieczeń sieci. ciąg (wymagany)
priority Priorytet reguły. Wartość może być w zakresie od 1000 do 3000. Wartości spoza tego zakresu są zarezerwowane dla dostawcy zasobów usługi Service FabricCluster. Numer priorytetu musi być unikatowy dla każdej reguły w kolekcji. Im niższy numer priorytetu, tym wyższy priorytet reguły. int (wymagane)

Ograniczenia:
Minimalna wartość = 1000
Maksymalna wartość = 3000
Protokół Protokół sieciowy, do których ma zastosowanie ta reguła. "ah"
"esp"
'http'
'https'
"icmp"
"tcp"
"udp" (wymagane)
sourceAddressPrefix CiDR lub źródłowy zakres adresów IP. Gwiazdka "*" może być również używana do dopasowania wszystkich źródłowych adresów IP. Można również używać tagów domyślnych, takich jak "VirtualNetwork", "AzureLoadBalancer" i "Internet". Jeśli jest to reguła ruchu przychodzącego, określa, skąd pochodzi ruch sieciowy. ciąg
sourceAddressPrefixes Zakresy ciDR lub źródłowych adresów IP. ciąg[]
sourcePortRange Port źródłowy lub zakres. Liczba całkowita lub zakres z zakresu od 0 do 65535. Gwiazdka "*" może być również używana do dopasowania wszystkich portów. ciąg
sourcePortRanges Zakresy portów źródłowych. ciąg[]

ServiceEndpoint

Nazwa Opis Wartość
locations Lista lokalizacji. ciąg[]
usługa Typ usługi punktu końcowego. ciąg (wymagany)

ClusterUpgradePolicy

Nazwa Opis Wartość
deltaHealthPolicy Zasady kondycji różnicowej klastra definiują zasady kondycji używane do oceny kondycji klastra podczas uaktualniania klastra. ClusterUpgradeDeltaHealthPolicy
forceRestart Jeśli to prawda, procesy są wymuszane ponownie podczas uaktualniania nawet wtedy, gdy wersja kodu nie uległa zmianie (uaktualnienie zmienia tylko konfigurację lub dane). bool
healthPolicy Zasady kondycji klastra definiują zasady kondycji używane do oceny kondycji klastra podczas uaktualniania klastra. ClusterHealthPolicy
monitoringPolicy Zasady monitorowania klastra opisują parametry monitorowania uaktualnienia w trybie monitorowym. ClusterMonitoringPolicy
upgradeReplicaSetCheckTimeout Maksymalny czas blokowania przetwarzania domeny uaktualnienia i zapobiegania utracie dostępności w przypadku nieoczekiwanych problemów.
Po upływie 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 mieć format hh:mm:ss lub d.hh:mm:ss.ms.
Ta wartość musi należeć do zakresu od 00:00:00 do 49710.06:28:15 (liczba całkowita bez znaku 32-bitowa w sekundach)
ciąg

ClusterUpgradeDeltaHealthPolicy

Nazwa Opis Wartość
maxPercentDeltaUnhealthyApplications Maksymalny dozwolony procent obniżenia 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 ukończeniu uaktualniania domeny, aby upewnić się, że globalny stan klastra mieści się w granicach tolerowanych. Usługi systemowe nie są w tym uwzględnione.
UWAGA: Ta wartość spowoduje zastąpienie wartości określonej we właściwościach. UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications
int

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100
maxPercentDeltaUnhealthyNodes Maksymalny dozwolony procent obniżenia kondycji węzłów dozwolony podczas uaktualniania klastra.
Różnica 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 ukończeniu uaktualniania domeny, aby upewnić się, że globalny stan klastra mieści się w granicach tolerowanych.
int (wymagane)

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100
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 uaktualniania a stanem węzłów domeny uaktualnienia w momencie oceny kondycji.
Sprawdzanie jest wykonywane po każdym zakończeniu uaktualniania domeny uaktualnienia dla wszystkich ukończonych domen uaktualnienia, aby upewnić się, że stan domen uaktualnienia mieści się w granicach tolerowanych.
int

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100

ClusterHealthPolicy

Nazwa Opis Wartość
maxPercentUnhealthyApplications Maksymalny dozwolony procent aplikacji w złej kondycji przed zgłoszeniem błędu. Na przykład aby zezwolić 10% aplikacji na złą kondycję, 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 (wymagane)

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100
maxPercentUnhealthyNodes Maksymalna dozwolona wartość procentowa węzłów w złej kondycji przed zgłoszeniem błędu. Na przykład aby zezwolić 10% węzłów na złą kondycję, ta wartość będzie wynosić 10.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową węzłów, 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 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łączane lub wyłączane w celu naprawy, więc ta wartość procentowa powinna być skonfigurowana tak, aby to tolerowała.
int (wymagane)

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100

ClusterMonitoringPolicy

Nazwa Opis Wartość
healthCheckRetryTimeout Czas ponawiania próby oceny kondycji, gdy aplikacja lub klaster jest w złej kondycji, zanim uaktualnienie zostanie wycofane. Limit czasu może mieć format 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 mieć format 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 mieć format hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
upgradeDomainTimeout Czas ukończenia każdej domeny uaktualniania przed wycofaniem uaktualnienia. Limit czasu może mieć format hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
upgradeTimeout Czas potrzebny na ukończenie ogólnego uaktualnienia przed wycofaniem uaktualnienia. Limit czasu może mieć format hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)

SKU

Nazwa Opis Wartość
name Nazwa jednostki SKU. "Podstawowa"
"Standard" (wymagany)

Definicja zasobu szablonu usługi ARM

Typ zasobu managedClusters można wdrożyć za pomocą operacji docelowych:

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

Format zasobu

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

{
  "type": "Microsoft.ServiceFabric/managedClusters",
  "apiVersion": "2024-04-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "properties": {
    "addonFeatures": [ "string" ],
    "adminPassword": "string",
    "adminUserName": "string",
    "allowRdpAccess": "bool",
    "applicationTypeVersionsCleanupPolicy": {
      "maxUnusedVersionsToKeep": "int"
    },
    "auxiliarySubnets": [
      {
        "enableIpv6": "bool",
        "name": "string",
        "networkSecurityGroupId": "string",
        "privateEndpointNetworkPolicies": "string",
        "privateLinkServiceNetworkPolicies": "string"
      }
    ],
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string"
    },
    "clientConnectionPort": "int",
    "clients": [
      {
        "commonName": "string",
        "isAdmin": "bool",
        "issuerThumbprint": "string",
        "thumbprint": "string"
      }
    ],
    "clusterCodeVersion": "string",
    "clusterUpgradeCadence": "string",
    "clusterUpgradeMode": "string",
    "ddosProtectionPlanId": "string",
    "dnsName": "string",
    "enableAutoOSUpgrade": "bool",
    "enableHttpGatewayExclusiveAuthMode": "bool",
    "enableIpv6": "bool",
    "enableServicePublicIP": "bool",
    "fabricSettings": [
      {
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ]
      }
    ],
    "httpGatewayConnectionPort": "int",
    "httpGatewayTokenAuthConnectionPort": "int",
    "ipTags": [
      {
        "ipTagType": "string",
        "tag": "string"
      }
    ],
    "loadBalancingRules": [
      {
        "backendPort": "int",
        "frontendPort": "int",
        "loadDistribution": "string",
        "probePort": "int",
        "probeProtocol": "string",
        "probeRequestPath": "string",
        "protocol": "string"
      }
    ],
    "networkSecurityRules": [
      {
        "access": "string",
        "description": "string",
        "destinationAddressPrefix": "string",
        "destinationAddressPrefixes": [ "string" ],
        "destinationPortRange": "string",
        "destinationPortRanges": [ "string" ],
        "direction": "string",
        "name": "string",
        "priority": "int",
        "protocol": "string",
        "sourceAddressPrefix": "string",
        "sourceAddressPrefixes": [ "string" ],
        "sourcePortRange": "string",
        "sourcePortRanges": [ "string" ]
      }
    ],
    "publicIPPrefixId": "string",
    "publicIPv6PrefixId": "string",
    "serviceEndpoints": [
      {
        "locations": [ "string" ],
        "service": "string"
      }
    ],
    "subnetId": "string",
    "upgradeDescription": {
      "deltaHealthPolicy": {
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
      },
      "forceRestart": "bool",
      "healthPolicy": {
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int"
      },
      "monitoringPolicy": {
        "healthCheckRetryTimeout": "string",
        "healthCheckStableDuration": "string",
        "healthCheckWaitDuration": "string",
        "upgradeDomainTimeout": "string",
        "upgradeTimeout": "string"
      },
      "upgradeReplicaSetCheckTimeout": "string"
    },
    "useCustomVnet": "bool",
    "zonalResiliency": "bool",
    "zonalUpdateMode": "string"
  }
}

Wartości właściwości

managedClusters

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.ServiceFabric/managedClusters"
apiVersion Wersja interfejsu API zasobów '2024-04-01'
name Nazwa zasobu ciąg (wymagany)
location Lokalizacja zasobu platformy Azure. ciąg (wymagany)
tags Tagi zasobów platformy Azure. Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
sku Jednostka SKU klastra zarządzanego Jednostka SKU (wymagana )
properties Właściwości zasobu klastra zarządzanego ManagedClusterProperties

ManagedClusterProperties

Nazwa Opis Wartość
addonFeatures Lista funkcji dodatków do włączenia w klastrze. Tablica ciągów zawierająca dowolną z:
"BackupRestoreService"
"DnsService"
"ResourceMonitorService"
adminPassword Hasło użytkownika administratora maszyny wirtualnej. ciąg

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
adminUserName Nazwa użytkownika administratora maszyny wirtualnej. ciąg (wymagany)
allowRdpAccess Ustawienie wartości true powoduje włączenie dostępu RDP do maszyny wirtualnej. Domyślna reguła sieciowej grupy zabezpieczeń otwiera port RDP do Internetu, który można zastąpić niestandardowymi regułami zabezpieczeń sieci. Wartość domyślna tego ustawienia to false. bool
applicationTypeVersionsCleanupPolicy Zasady używane do czyszczenia nieużywanych wersji. ApplicationTypeVersionsCleanupPolicy
pomocnicze podsieci Pomocnicze podsieci klastra. Podsieć[]
azureActiveDirectory Ustawienia uwierzytelniania usługi AAD klastra. AzureActiveDirectory
clientConnectionPort Port używany do połączeń klienta z klastrem. int
Klientów Certyfikaty klienta, które mogą zarządzać klastrem. ClientCertificate[]
clusterCodeVersion Wersja środowiska uruchomieniowego usługi Service Fabric klastra. Ta właściwość jest wymagana, gdy klasterUpgradeMode jest ustawiony 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 dostępnej bibliotekiClusterVersions. ciąg
clusterUpgradeCadence Wskazuje, kiedy nowe uaktualnienia wersji środowiska uruchomieniowego klastra zostaną zastosowane po ich wydaniu. Domyślnie to Wave0. Ma zastosowanie tylko wtedy, gdy klasterUpgradeMode jest ustawiony na wartość "Automatic". "Wave0"
"Wave1"
"Wave2"
clusterUpgradeMode Tryb uaktualniania klastra, gdy jest dostępna nowa wersja środowiska uruchomieniowego usługi Service Fabric. "Automatyczne"
"Ręczne"
ddosProtectionPlanId Określ identyfikator zasobu planu ochrony sieci DDoS, który zostanie skojarzony z siecią wirtualną klastra. ciąg
dnsName Nazwa DNS klastra. ciąg (wymagany)
enableAutoOSUpgrade Ustawienie wartości true umożliwia automatyczne uaktualnianie systemu operacyjnego dla typów węzłów utworzonych przy użyciu dowolnego obrazu systemu operacyjnego platformy z wersją "latest". Wartość domyślna tego ustawienia to false. bool
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ć wartość HttpGatewayTokenAuthConnectionPort. bool
enableIpv6 Ustawienie wartości true powoduje utworzenie przestrzeni adresowej IPv6 dla domyślnej sieci wirtualnej używanej przez klaster. Nie można zmienić tego ustawienia po utworzeniu klastra. Wartość domyślna tego ustawienia to false. bool
enableServicePublicIP Ustawienie wartości true spowoduje połączenie adresu IPv4 jako servicePublicIP adresu IPv6. Można go ustawić tylko na wartość True, jeśli protokół IPv6 jest włączony w klastrze. bool
fabricSettings Lista niestandardowych ustawień sieci szkieletowej do skonfigurowania klastra. SettingsSectionDescription[]
httpGatewayConnectionPort Port używany do połączeń HTTP z klastrem. int
httpGatewayTokenAuthConnectionPort Port używany do nawiązywania połączeń HTTPS opartych na tokenach z klastrem. Nie można ustawić tego samego portu co HttpGatewayEndpoint. int
ipTags Lista tagów IP skojarzonych z domyślnym publicznym adresem IP klastra. IpTag[]
loadBalancingRules Reguły równoważenia obciążenia stosowane do publicznego modułu równoważenia obciążenia klastra. LoadBalancingRule[]
networkSecurityRules Niestandardowe reguły zabezpieczeń sieci, które są stosowane do Virtual Network klastra. NetworkSecurityRule[]
publicIPPrefixId Określ identyfikator zasobu publicznego prefiksu IPv4, z którego moduł równoważenia obciążenia przydzieli publiczny adres IPv4. Nie można zmienić tego ustawienia po utworzeniu klastra. ciąg
publicIPv6PrefixId Określ identyfikator zasobu publicznego prefiksu IPv6, z którego moduł równoważenia obciążenia przydzieli publiczny adres IPv6. Nie można zmienić tego ustawienia po utworzeniu klastra. ciąg
serviceEndpoints Punkty końcowe usługi dla podsieci w klastrze. ServiceEndpoint[]
subnetId Jeśli zostanie określony, typy węzłów klastra są tworzone w tej podsieci zamiast domyślnej sieci wirtualnej. SieciSecurityRules określone dla klastra są również stosowane do tej podsieci. Nie można zmienić tego ustawienia po utworzeniu klastra. ciąg
upgradeDescription Zasady do użycia podczas uaktualniania klastra. ClusterUpgradePolicy
useCustomVnet W przypadku nowych klastrów ten parametr wskazuje, że używa własnej sieci wirtualnej, ale podsieć jest określona na poziomie typu węzła; i dla takich klastrów właściwość subnetId jest wymagana dla typów węzłów. bool
strefowaResiliency Wskazuje, czy klaster ma odporność strefy. bool
zonalUpdateMode Wskazuje tryb aktualizacji dla klastrów Cross Az. "Szybkie"
"Standardowa"

ApplicationTypeVersionsCleanupPolicy

Nazwa Opis Wartość
maxUnusedVersionsToKeep Liczba nieużywanych wersji na typ aplikacji do zachowania. int (wymagane)

Ograniczenia:
Minimalna wartość = 0

Podsieć

Nazwa Opis Wartość
enableIpv6 Wskazuje, że do włączenia protokołu Ipv6 lub nie. Jeśli nie zostanie podana, zajmie to samą konfigurację co klaster. bool
name Nazwa podsieci. ciąg (wymagany)
networkSecurityGroupId Pełny identyfikator zasobu dla sieciowej grupy zabezpieczeń. ciąg
privateEndpointNetworkPolicies Włącz lub wyłącz stosowanie zasad sieciowych w prywatnym punkcie końcowym w podsieci. "wyłączone"
"włączone"
privateLinkServiceNetworkPolicies Włączanie lub wyłączanie stosowania zasad sieciowych w usłudze private link w podsieci. "wyłączone"
"włączone"

AzureActiveDirectory

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

Clientcertificate

Nazwa Opis Wartość
commonName Nazwa pospolita certyfikatu. ciąg
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)
issuerThumbprint Odcisk palca wystawcy certyfikatu. Używane tylko razem z CommonName. ciąg
Odcisk palca Odcisk palca certyfikatu. ciąg

SettingsSectionDescription

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

SettingsParameterDescription

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

IpTag

Nazwa Opis Wartość
ipTagType Typ tagu IP. Przykład: FirstPartyUsage. ciąg (wymagany)
tag Tag IP skojarzony z publicznym adresem IP. Przykład: SQL, Storage itp. ciąg (wymagany)

LoadBalancingRule

Nazwa Opis Wartość
backendPort Port używany do połączeń wewnętrznych w punkcie końcowym. Dopuszczalne wartości to od 1 do 65535. int (wymagane)

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 65534
frontendPort Port zewnętrznego punktu końcowego. Numery portów dla każdej reguły muszą być unikatowe w obrębie Load Balancer. Dopuszczalne wartości to od 1 do 65534. int (wymagane)

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 65534
loadDistribution Zasady dystrybucji obciążenia dla tej reguły. ciąg
probePort Port prob używany przez regułę równoważenia obciążenia. Dopuszczalne wartości to od 1 do 65535. int

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 65534
probeProtocol odwołanie do sondy modułu równoważenia obciążenia używanej przez regułę równoważenia obciążenia. 'http'
'https'
"tcp" (wymagany)
probeRequestPath Ścieżka żądania sondy. Obsługiwane tylko w przypadku sond HTTP/HTTPS. ciąg
Protokół Odwołanie do protokołu transportowego używanego przez regułę równoważenia obciążenia. "tcp"
"udp" (wymagane)

NetworkSecurityRule

Nazwa Opis Wartość
access Ruch sieciowy jest dozwolony lub blokowany. "Zezwalaj"
"odmów" (wymagane)
description (opis) Opis reguły zabezpieczeń sieci. ciąg
destinationAddressPrefix Prefiks adresu docelowego. CIDR lub docelowy zakres adresów IP. Gwiazdka "*" może być również używana do dopasowywania wszystkich źródłowych adresów IP. Można również używać tagów domyślnych, takich jak "VirtualNetwork", "AzureLoadBalancer" i "Internet". ciąg
destinationAddressPrefixes Prefiksy adresów docelowych. CiDR lub docelowe zakresy adresów IP. ciąg[]
destinationPortRange port docelowy lub zakres. Liczba całkowita lub zakres z zakresu od 0 do 65535. Gwiazdka "*" może być również używana do dopasowania wszystkich portów. ciąg
destinationPortRanges Zakresy portów docelowych. ciąg[]
kierunek Kierunek reguł zabezpieczeń sieci. "przychodzący"
"outbound" (wymagane)
name Nazwa reguły zabezpieczeń sieci. ciąg (wymagany)
priority Priorytet reguły. Wartość może mieścić się w zakresie od 1000 do 3000. Wartości spoza tego zakresu są zarezerwowane dla dostawcy zasobów usługi Service FabricCluster. Numer priorytetu musi być unikatowy dla każdej reguły w kolekcji. Im niższy numer priorytetu, tym wyższy priorytet reguły. int (wymagane)

Ograniczenia:
Wartość minimalna = 1000
Wartość maksymalna = 3000
Protokół Protokół sieciowy, do których ta reguła ma zastosowanie. "ah"
"esp"
'http'
'https'
"icmp"
"tcp"
"udp" (wymagane)
sourceAddressPrefix CiDR lub źródłowy zakres adresów IP. Gwiazdka "*" może być również używana do dopasowywania wszystkich źródłowych adresów IP. Można również używać tagów domyślnych, takich jak "VirtualNetwork", "AzureLoadBalancer" i "Internet". Jeśli jest to reguła ruchu przychodzącego, określa, skąd pochodzi ruch sieciowy. ciąg
sourceAddressPrefixes Zakresy ciDR lub źródłowych adresów IP. ciąg[]
sourcePortRange Port źródłowy lub zakres. Liczba całkowita lub zakres z zakresu od 0 do 65535. Gwiazdka "*" może być również używana do dopasowania wszystkich portów. ciąg
sourcePortRanges Zakresy portów źródłowych. ciąg[]

ServiceEndpoint

Nazwa Opis Wartość
locations Lista lokalizacji. ciąg[]
usługa Typ usługi punktu końcowego. ciąg (wymagany)

ClusterUpgradePolicy

Nazwa Opis Wartość
deltaHealthPolicy Zasady kondycji różnicowej klastra definiują zasady kondycji używane do oceny kondycji klastra podczas uaktualniania klastra. ClusterUpgradeDeltaHealthPolicy
forceRestart Jeśli to prawda, procesy są wymuszane ponownie podczas uaktualniania nawet wtedy, gdy wersja kodu nie uległa zmianie (uaktualnienie zmienia tylko konfigurację lub dane). bool
healthPolicy Zasady kondycji klastra definiują zasady kondycji używane do oceny kondycji klastra podczas uaktualniania klastra. ClusterHealthPolicy
monitoringPolicy Zasady monitorowania klastra opisują parametry monitorowania uaktualnienia w trybie monitorowym. ClusterMonitoringPolicy
upgradeReplicaSetCheckTimeout Maksymalny czas blokowania przetwarzania domeny uaktualnienia i zapobiegania utracie dostępności w przypadku nieoczekiwanych problemów.
Po upływie 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.
Ta wartość musi należeć do zakresu od 00:00:00 do 49710.06:28:15 (niepodpisane 32-bitowej liczby całkowitej przez sekundy)
ciąg

ClusterUpgradeDeltaHealthPolicy

Nazwa Opis Wartość
maxPercentDeltaUnhealthyApplications Maksymalny dozwolony procent degradacji kondycji aplikacji dozwolony podczas uaktualniania klastra.
Różnica jest mierzona między stanem aplikacji na początku uaktualniania i stanem aplikacji w momencie oceny kondycji.
Sprawdzanie jest wykonywane po każdym zakończeniu uaktualniania domeny, aby upewnić się, że stan globalny klastra jest w granicach tolerowanych. Usługi systemowe nie są w tym uwzględnione.
UWAGA: Ta wartość zastąpi wartość określoną we właściwościach. UpgradeDescription.HealthPolicy.MaxPercent W złej kondycjiApplications
int

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

Ograniczenia:
Minimalna wartość = 0
Maksymalna wartość = 100
maxPercentUpgradeDomainDeltaUnhealthyNodes Maksymalny dozwolony procent degradacji 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 i 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 jest w granicach tolerowanych.
int

Ograniczenia:
Minimalna wartość = 0
Maksymalna wartość = 100

ClusterHealthPolicy

Nazwa Opis Wartość
maxPercent W złej kondycjiAplikacje 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 uwzględniony w błędzie.
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 mapę ApplicationTypeHealthPolicyMap.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na małej liczbie aplikacji. Wartość procentowa domyślna to zero.
int (wymagane)

Ograniczenia:
Minimalna wartość = 0
Maksymalna wartość = 100
maxPercentUnhealthyNodes Maksymalna dozwolona wartość procentowa 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 zaokrągla 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 do naprawy, więc ten procent należy skonfigurować tak, aby to tolerował.
int (wymagane)

Ograniczenia:
Minimalna wartość = 0
Maksymalna wartość = 100

ClusterMonitoringPolicy

Nazwa Opis Wartość
healthCheckRetryTimeout Czas ponawiania próby oceny kondycji, gdy aplikacja lub klaster jest w złej kondycji, zanim uaktualnienie zostanie wycofane. 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)
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)
upgradeTimeout Czas ukończenia ogólnego uaktualnienia przed wycofaniem uaktualnienia. Limit czasu może być w formacie hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)

SKU

Nazwa Opis Wartość
name Nazwa jednostki SKU. "Podstawowa"
"Standard" (wymagany)

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu managedClusters można wdrożyć za pomocą operacji docelowych:

  • Grupy zasobów

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

Format zasobu

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedClusters@2024-04-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      addonFeatures = [
        "string"
      ]
      adminPassword = "string"
      adminUserName = "string"
      allowRdpAccess = bool
      applicationTypeVersionsCleanupPolicy = {
        maxUnusedVersionsToKeep = int
      }
      auxiliarySubnets = [
        {
          enableIpv6 = bool
          name = "string"
          networkSecurityGroupId = "string"
          privateEndpointNetworkPolicies = "string"
          privateLinkServiceNetworkPolicies = "string"
        }
      ]
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
      }
      clientConnectionPort = int
      clients = [
        {
          commonName = "string"
          isAdmin = bool
          issuerThumbprint = "string"
          thumbprint = "string"
        }
      ]
      clusterCodeVersion = "string"
      clusterUpgradeCadence = "string"
      clusterUpgradeMode = "string"
      ddosProtectionPlanId = "string"
      dnsName = "string"
      enableAutoOSUpgrade = bool
      enableHttpGatewayExclusiveAuthMode = bool
      enableIpv6 = bool
      enableServicePublicIP = bool
      fabricSettings = [
        {
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
        }
      ]
      httpGatewayConnectionPort = int
      httpGatewayTokenAuthConnectionPort = int
      ipTags = [
        {
          ipTagType = "string"
          tag = "string"
        }
      ]
      loadBalancingRules = [
        {
          backendPort = int
          frontendPort = int
          loadDistribution = "string"
          probePort = int
          probeProtocol = "string"
          probeRequestPath = "string"
          protocol = "string"
        }
      ]
      networkSecurityRules = [
        {
          access = "string"
          description = "string"
          destinationAddressPrefix = "string"
          destinationAddressPrefixes = [
            "string"
          ]
          destinationPortRange = "string"
          destinationPortRanges = [
            "string"
          ]
          direction = "string"
          name = "string"
          priority = int
          protocol = "string"
          sourceAddressPrefix = "string"
          sourceAddressPrefixes = [
            "string"
          ]
          sourcePortRange = "string"
          sourcePortRanges = [
            "string"
          ]
        }
      ]
      publicIPPrefixId = "string"
      publicIPv6PrefixId = "string"
      serviceEndpoints = [
        {
          locations = [
            "string"
          ]
          service = "string"
        }
      ]
      subnetId = "string"
      upgradeDescription = {
        deltaHealthPolicy = {
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
        }
        forceRestart = bool
        healthPolicy = {
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
        }
        monitoringPolicy = {
          healthCheckRetryTimeout = "string"
          healthCheckStableDuration = "string"
          healthCheckWaitDuration = "string"
          upgradeDomainTimeout = "string"
          upgradeTimeout = "string"
        }
        upgradeReplicaSetCheckTimeout = "string"
      }
      useCustomVnet = bool
      zonalResiliency = bool
      zonalUpdateMode = "string"
    }
    sku = {
      name = "string"
    }
  })
}

Wartości właściwości

managedClusters

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.ServiceFabric/managedClusters@2024-04-01"
name Nazwa zasobu ciąg (wymagany)
location Lokalizacja zasobu platformy Azure. ciąg (wymagany)
parent_id Aby wdrożyć w grupie zasobów, użyj identyfikatora tej grupy zasobów. ciąg (wymagany)
tags Tagi zasobów platformy Azure. Słownik nazw tagów i wartości.
sku Jednostka SKU klastra zarządzanego Jednostka SKU (wymagana )
properties Właściwości zasobu klastra zarządzanego ManagedClusterProperties

ManagedClusterProperties

Nazwa Opis Wartość
addonFeatures Lista funkcji dodatków do włączenia w klastrze. Tablica ciągów zawierająca dowolną z:
"BackupRestoreService"
"DnsService"
"ResourceMonitorService"
adminPassword Hasło użytkownika administratora maszyny wirtualnej. ciąg

Ograniczenia:
Wartość wrażliwa. Przekaż jako bezpieczny parametr.
adminUserName Nazwa użytkownika administratora maszyny wirtualnej. ciąg (wymagany)
allowRdpAccess Ustawienie wartości true powoduje włączenie dostępu RDP do maszyny wirtualnej. Domyślna reguła sieciowej grupy zabezpieczeń otwiera port RDP do Internetu, który można zastąpić niestandardowymi regułami zabezpieczeń sieci. Wartość domyślna tego ustawienia to false. bool
applicationTypeVersionsCleanupPolicy Zasady używane do czyszczenia nieużywanych wersji. ApplicationTypeVersionsCleanupPolicy
pomocnicze podsieci Pomocnicze podsieci klastra. Podsieć[]
azureActiveDirectory Ustawienia uwierzytelniania usługi AAD klastra. AzureActiveDirectory
clientConnectionPort Port używany do połączeń klienta z klastrem. int
Klientów Certyfikaty klienta, które mogą zarządzać klastrem. ClientCertificate[]
clusterCodeVersion Wersja środowiska uruchomieniowego usługi Service Fabric klastra. Ta właściwość jest wymagana, gdy klasterUpgradeMode jest ustawiony 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 dostępnej bibliotekiClusterVersions. ciąg
clusterUpgradeCadence Wskazuje, kiedy nowe uaktualnienia wersji środowiska uruchomieniowego klastra zostaną zastosowane po ich wydaniu. Domyślnie to Wave0. Ma zastosowanie tylko wtedy, gdy klasterUpgradeMode jest ustawiony na wartość "Automatic". "Wave0"
"Wave1"
"Wave2"
clusterUpgradeMode Tryb uaktualniania klastra, gdy jest dostępna nowa wersja środowiska uruchomieniowego usługi Service Fabric. "Automatyczne"
"Ręczne"
ddosProtectionPlanId Określ identyfikator zasobu planu ochrony sieci DDoS, który zostanie skojarzony z siecią wirtualną klastra. ciąg
dnsName Nazwa DNS klastra. ciąg (wymagany)
enableAutoOSUpgrade Ustawienie wartości true umożliwia automatyczne uaktualnianie systemu operacyjnego dla typów węzłów utworzonych przy użyciu dowolnego obrazu systemu operacyjnego platformy z wersją "latest". Wartość domyślna tego ustawienia to false. bool
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ć wartość HttpGatewayTokenAuthConnectionPort. bool
enableIpv6 Ustawienie wartości true powoduje utworzenie przestrzeni adresowej IPv6 dla domyślnej sieci wirtualnej używanej przez klaster. Nie można zmienić tego ustawienia po utworzeniu klastra. Wartość domyślna tego ustawienia to false. bool
enableServicePublicIP Ustawienie wartości true spowoduje połączenie adresu IPv4 jako servicePublicIP adresu IPv6. Można go ustawić tylko na wartość True, jeśli protokół IPv6 jest włączony w klastrze. bool
fabricSettings Lista niestandardowych ustawień sieci szkieletowej do skonfigurowania klastra. SettingsSectionDescription[]
httpGatewayConnectionPort Port używany do połączeń HTTP z klastrem. int
httpGatewayTokenAuthConnectionPort Port używany do nawiązywania połączeń HTTPS opartych na tokenach z klastrem. Nie można ustawić tego samego portu co HttpGatewayEndpoint. int
ipTags Lista tagów IP skojarzonych z domyślnym publicznym adresem IP klastra. IpTag[]
loadBalancingRules Reguły równoważenia obciążenia stosowane do publicznego modułu równoważenia obciążenia klastra. LoadBalancingRule[]
networkSecurityRules Niestandardowe reguły zabezpieczeń sieci, które są stosowane do Virtual Network klastra. NetworkSecurityRule[]
publicIPPrefixId Określ identyfikator zasobu publicznego prefiksu IPv4, z którego moduł równoważenia obciążenia przydzieli publiczny adres IPv4. Nie można zmienić tego ustawienia po utworzeniu klastra. ciąg
publicIPv6PrefixId Określ identyfikator zasobu publicznego prefiksu IPv6, z którego moduł równoważenia obciążenia przydzieli publiczny adres IPv6. Nie można zmienić tego ustawienia po utworzeniu klastra. ciąg
serviceEndpoints Punkty końcowe usługi dla podsieci w klastrze. ServiceEndpoint[]
subnetId Jeśli zostanie określony, typy węzłów klastra są tworzone w tej podsieci zamiast domyślnej sieci wirtualnej. SieciSecurityRules określone dla klastra są również stosowane do tej podsieci. Nie można zmienić tego ustawienia po utworzeniu klastra. ciąg
upgradeDescription Zasady do użycia podczas uaktualniania klastra. ClusterUpgradePolicy
useCustomVnet W przypadku nowych klastrów ten parametr wskazuje, że używa własnej sieci wirtualnej, ale podsieć jest określona na poziomie typu węzła; i dla takich klastrów właściwość subnetId jest wymagana dla typów węzłów. bool
strefowaResiliency Wskazuje, czy klaster ma odporność strefy. bool
zonalUpdateMode Wskazuje tryb aktualizacji dla klastrów Cross Az. "Szybkie"
"Standardowa"

ApplicationTypeVersionsCleanupPolicy

Nazwa Opis Wartość
maxUnusedVersionsToKeep Liczba nieużywanych wersji na typ aplikacji do zachowania. int (wymagane)

Ograniczenia:
Minimalna wartość = 0

Podsieć

Nazwa Opis Wartość
enableIpv6 Wskazuje, że do włączenia protokołu Ipv6 lub nie. Jeśli nie zostanie podana, zajmie to samą konfigurację co klaster. bool
name Nazwa podsieci. ciąg (wymagany)
networkSecurityGroupId Pełny identyfikator zasobu dla sieciowej grupy zabezpieczeń. ciąg
privateEndpointNetworkPolicies Włącz lub wyłącz stosowanie zasad sieciowych w prywatnym punkcie końcowym w podsieci. "wyłączone"
"włączone"
privateLinkServiceNetworkPolicies Włączanie lub wyłączanie stosowania zasad sieciowych w usłudze private link w podsieci. "wyłączone"
"włączone"

AzureActiveDirectory

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

Clientcertificate

Nazwa Opis Wartość
commonName Nazwa pospolita certyfikatu. ciąg
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)
issuerThumbprint Odcisk palca wystawcy certyfikatu. Używane tylko razem z CommonName. ciąg
Odcisk palca Odcisk palca certyfikatu. ciąg

SettingsSectionDescription

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

SettingsParameterDescription

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

IpTag

Nazwa Opis Wartość
ipTagType Typ tagu IP. Przykład: FirstPartyUsage. ciąg (wymagany)
tag Tag IP skojarzony z publicznym adresem IP. Przykład: SQL, Storage itp. ciąg (wymagany)

LoadBalancingRule

Nazwa Opis Wartość
backendPort Port używany do połączeń wewnętrznych w punkcie końcowym. Dopuszczalne wartości to od 1 do 65535. int (wymagane)

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 65534
frontendPort Port zewnętrznego punktu końcowego. Numery portów dla każdej reguły muszą być unikatowe w obrębie Load Balancer. Dopuszczalne wartości to od 1 do 65534. int (wymagane)

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 65534
loadDistribution Zasady dystrybucji obciążenia dla tej reguły. ciąg
probePort Port prob używany przez regułę równoważenia obciążenia. Dopuszczalne wartości to od 1 do 65535. int

Ograniczenia:
Minimalna wartość = 1
Maksymalna wartość = 65534
probeProtocol odwołanie do sondy modułu równoważenia obciążenia używanej przez regułę równoważenia obciążenia. "http"
"https"
"tcp" (wymagane)
probeRequestPath Ścieżka żądania sondy. Obsługiwane tylko w przypadku sond HTTP/HTTPS. ciąg
Protokół Odwołanie do protokołu transportowego używanego przez regułę równoważenia obciążenia. "tcp"
"udp" (wymagane)

NetworkSecurityRule

Nazwa Opis Wartość
access Ruch sieciowy jest dozwolony lub blokowany. "zezwalaj"
"odmów" (wymagane)
description (opis) Opis reguły zabezpieczeń sieci. ciąg
destinationAddressPrefix Prefiks adresu docelowego. CIDR lub docelowy zakres adresów IP. Gwiazdka "*" może być również używana do dopasowywania wszystkich źródłowych adresów IP. Można również używać tagów domyślnych, takich jak "VirtualNetwork", "AzureLoadBalancer" i "Internet". ciąg
destinationAddressPrefixes Prefiksy adresów docelowych. CiDR lub docelowe zakresy adresów IP. ciąg[]
destinationPortRange port docelowy lub zakres. Liczba całkowita lub zakres z zakresu od 0 do 65535. Gwiazdka "*" może być również używana do dopasowania wszystkich portów. ciąg
destinationPortRanges Zakresy portów docelowych. ciąg[]
kierunek Kierunek reguł zabezpieczeń sieci. "przychodzący"
"wychodzący" (wymagany)
name Nazwa reguły zabezpieczeń sieci. ciąg (wymagany)
priority Priorytet reguły. Wartość może mieścić się w zakresie od 1000 do 3000. Wartości spoza tego zakresu są zarezerwowane dla dostawcy zasobów usługi Service FabricCluster. Numer priorytetu musi być unikatowy dla każdej reguły w kolekcji. Im niższy numer priorytetu, tym wyższy priorytet reguły. int (wymagane)

Ograniczenia:
Wartość minimalna = 1000
Wartość maksymalna = 3000
Protokół Protokół sieciowy, do których ta reguła ma zastosowanie. "ah"
"esp"
"http"
"https"
"icmp"
"tcp"
"udp" (wymagane)
sourceAddressPrefix CiDR lub źródłowy zakres adresów IP. Gwiazdka "*" może być również używana do dopasowywania wszystkich źródłowych adresów IP. Można również używać tagów domyślnych, takich jak "VirtualNetwork", "AzureLoadBalancer" i "Internet". Jeśli jest to reguła ruchu przychodzącego, określa, skąd pochodzi ruch sieciowy. ciąg
sourceAddressPrefixes Zakresy ciDR lub źródłowych adresów IP. ciąg[]
sourcePortRange Port źródłowy lub zakres. Liczba całkowita lub zakres z zakresu od 0 do 65535. Gwiazdka "*" może być również używana do dopasowania wszystkich portów. ciąg
sourcePortRanges Zakresy portów źródłowych. ciąg[]

ServiceEndpoint

Nazwa Opis Wartość
locations Lista lokalizacji. ciąg[]
usługa Typ usługi punktu końcowego. ciąg (wymagany)

ClusterUpgradePolicy

Nazwa Opis Wartość
deltaHealthPolicy Zasady kondycji różnicowej klastra definiują zasady kondycji używane do oceny kondycji klastra podczas uaktualniania klastra. ClusterUpgradeDeltaHealthPolicy
forceRestart Jeśli to prawda, procesy są wymuszane ponownie podczas uaktualniania nawet wtedy, gdy wersja kodu nie uległa zmianie (uaktualnienie zmienia tylko konfigurację lub dane). bool
healthPolicy Zasady kondycji klastra definiują zasady kondycji używane do oceny kondycji klastra podczas uaktualniania klastra. ClusterHealthPolicy
monitoringPolicy Zasady monitorowania klastra opisują parametry monitorowania uaktualnienia w trybie monitorowym. ClusterMonitoringPolicy
upgradeReplicaSetCheckTimeout Maksymalny czas blokowania przetwarzania domeny uaktualnienia i zapobiegania utracie dostępności w przypadku nieoczekiwanych problemów.
Po upływie 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 mieć format hh:mm:ss lub d.hh:mm:ss.ms.
Ta wartość musi należeć do zakresu od 00:00:00 do 49710.06:28:15 (liczba całkowita bez znaku 32-bitowa w sekundach)
ciąg

ClusterUpgradeDeltaHealthPolicy

Nazwa Opis Wartość
maxPercentDeltaUnhealthyApplications Maksymalny dozwolony procent obniżenia 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 ukończeniu uaktualniania domeny, aby upewnić się, że globalny stan klastra mieści się w granicach tolerowanych. Usługi systemowe nie są w tym uwzględnione.
UWAGA: Ta wartość spowoduje zastąpienie wartości określonej we właściwościach. UpgradeDescription.HealthPolicy.MaxPercentUnhealthyApplications
int

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100
maxPercentDeltaUnhealthyNodes Maksymalny dozwolony procent obniżenia kondycji węzłów dozwolony podczas uaktualniania klastra.
Różnica 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 ukończeniu uaktualniania domeny, aby upewnić się, że globalny stan klastra mieści się w granicach tolerowanych.
int (wymagane)

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100
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 uaktualniania a stanem węzłów domeny uaktualnienia w momencie oceny kondycji.
Sprawdzanie jest wykonywane po każdym zakończeniu uaktualniania domeny uaktualnienia dla wszystkich ukończonych domen uaktualnienia, aby upewnić się, że stan domen uaktualnienia mieści się w granicach tolerowanych.
int

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100

ClusterHealthPolicy

Nazwa Opis Wartość
maxPercentUnhealthyApplications Maksymalny dozwolony procent aplikacji w złej kondycji przed zgłoszeniem błędu. Na przykład aby zezwolić 10% aplikacji na złą kondycję, 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 (wymagane)

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100
maxPercentUnhealthyNodes Maksymalna dozwolona wartość procentowa węzłów w złej kondycji przed zgłoszeniem błędu. Na przykład aby zezwolić 10% węzłów na złą kondycję, ta wartość będzie wynosić 10.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową węzłów, 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 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łączane lub wyłączane w celu naprawy, więc ta wartość procentowa powinna być skonfigurowana tak, aby to tolerowała.
int (wymagane)

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100

ClusterMonitoringPolicy

Nazwa Opis Wartość
healthCheckRetryTimeout Czas ponawiania próby oceny kondycji, gdy aplikacja lub klaster jest w złej kondycji, zanim uaktualnienie zostanie wycofane. Limit czasu może mieć format 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 mieć format 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 mieć format hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
upgradeDomainTimeout Czas ukończenia każdej domeny uaktualniania przed wycofaniem uaktualnienia. Limit czasu może mieć format hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)
upgradeTimeout Czas potrzebny na ukończenie ogólnego uaktualnienia przed wycofaniem uaktualnienia. Limit czasu może mieć format hh:mm:ss lub d.hh:mm:ss.ms. ciąg (wymagany)

SKU

Nazwa Opis Wartość
name Nazwa jednostki SKU. "Podstawowa"
"Standardowa" (wymagane)