Udostępnij za pośrednictwem

Microsoft.ServiceFabric managedclusters/applications

  • Artykuł

Definicja zasobu Bicep

Typ zasobu managedclusters/applications można wdrożyć z operacjami docelowymi:

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/applications, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.ServiceFabric/managedclusters/applications@2024-04-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    managedIdentities: [
      {
        name: 'string'
        principalId: 'string'
      }
    ]
    parameters: {
      {customized property}: 'string'
    }
    upgradePolicy: {
      applicationHealthPolicy: {
        considerWarningAsError: bool
        defaultServiceTypeHealthPolicy: {
          maxPercentUnhealthyPartitionsPerService: int
          maxPercentUnhealthyReplicasPerPartition: int
          maxPercentUnhealthyServices: int
        }
        maxPercentUnhealthyDeployedApplications: int
        serviceTypeHealthPolicyMap: {
          {customized property}: {
            maxPercentUnhealthyPartitionsPerService: int
            maxPercentUnhealthyReplicasPerPartition: int
            maxPercentUnhealthyServices: int
          }
        }
      }
      forceRestart: bool
      instanceCloseDelayDuration: int
      recreateApplication: bool
      rollingUpgradeMonitoringPolicy: {
        failureAction: 'string'
        healthCheckRetryTimeout: 'string'
        healthCheckStableDuration: 'string'
        healthCheckWaitDuration: 'string'
        upgradeDomainTimeout: 'string'
        upgradeTimeout: 'string'
      }
      upgradeMode: 'string'
      upgradeReplicaSetCheckTimeout: int
    }
    version: 'string'
  }
}

Wartości właściwości

managedclusters/applications

Nazwa Opis Wartość
name Nazwa zasobu

Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w aplikacji Bicep.		 ciąg (wymagany)
location Lokalizacja zasobu zależy od zasobu nadrzędnego. ciąg
tags Tagi zasobów platformy Azure. Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
Nadrzędny W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.		 Nazwa symboliczna zasobu typu managedclusters
identity Opisuje tożsamości zarządzane dla zasobu platformy Azure. ManagedIdentity
properties Właściwości zasobu aplikacji. ApplicationResourceProperties

ManagedIdentity

Nazwa Opis Wartość
typ Typ tożsamości zarządzanej zasobu. "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą zawierać identyfikatory zasobów usługi ARM w postaci:
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
 UserAssignedIdentityMap

UserAssignedIdentityMap

Nazwa Opis Wartość
{niestandardowa właściwość} UserAssignedIdentity

UserAssignedIdentity

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

ApplicationResourceProperties

Nazwa Opis Wartość
managedIdentities Lista tożsamości przypisanych przez użytkownika dla aplikacji, z których każda została zamapowana na przyjazną nazwę. ApplicationUserAssignedIdentity[]
parameters Lista parametrów aplikacji z wartościami zastępowanymi z ich wartości domyślnych określonych w manifeście aplikacji. ApplicationParameterList
upgradePolicy Opisuje zasady dotyczące monitorowanego uaktualniania aplikacji. ApplicationUpgradePolicy
Wersja Wersja typu aplikacji zdefiniowana w manifeście aplikacji.
Ta nazwa musi być pełnym identyfikatorem zasobu arm dla wersji typu aplikacji, do których odwołuje się odwołanie.
 ciąg

ApplicationUserAssignedIdentity

Nazwa Opis Wartość
name Przyjazna nazwa tożsamości przypisanej przez użytkownika. ciąg (wymagany)
principalId Identyfikator podmiotu zabezpieczeń tożsamości przypisanej przez użytkownika. ciąg (wymagany)

ApplicationParameterList

Nazwa Opis Wartość
{niestandardowa właściwość} ciąg

ApplicationUpgradePolicy

Nazwa Opis Wartość
applicationHealthPolicy Definiuje zasady kondycji używane do oceny kondycji aplikacji lub jednej z jej jednostek podrzędnych. ApplicationHealthPolicy
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
instanceCloseDelayDuration Czas trwania w sekundach, aby poczekać przed zamknięciem wystąpienia bezstanowego, aby umożliwić bezproblemowe opróżnianie aktywnych żądań. Byłoby to skuteczne, gdy wystąpienie jest zamykane podczas uaktualniania aplikacji/klastra, tylko w przypadku tych wystąpień, które mają niezerowy czas trwania opóźnienia skonfigurowany w opisie usługi. int
ponowne tworzenie aplikacji Określa, czy aplikacja powinna zostać ponownie utworzona podczas aktualizacji. Jeśli parametr value=true, pozostałe parametry zasad uaktualniania są niedozwolone. bool
rollingUpgradeMonitoringPolicy Zasady używane do monitorowania uaktualnienia aplikacji RollingUpgradeMonitoringPolicy
upgradeMode Tryb używany do monitorowania kondycji podczas uaktualniania stopniowego. Wartości są monitorowane i niemonitorowaneAuto. "Monitorowane"
"UnmonitoredAuto"
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. Prawidłowe wartości należą do przedziału od 0 do 42949672925 włącznie. (niepodpisane 32-bitowe liczby całkowite). int

ApplicationHealthPolicy

Nazwa Opis Wartość
considerWarningAsError Wskazuje, czy ostrzeżenia są traktowane z taką samą ważnością jak błędy. bool (wymagane)
defaultServiceTypeHealthPolicy Zasady kondycji używane domyślnie do oceny kondycji typu usługi. ServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications Maksymalna dozwolona wartość procentowa aplikacji wdrożonych w złej kondycji. Dozwolone wartości to wartości bajtowe z zakresu od zera do 100.
Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową wdrożonych aplikacji, które mogą być w złej kondycji, zanim aplikacja zostanie uznana za błędną.
Jest to obliczane przez podzielenie liczby wdrożonych aplikacji w złej kondycji na liczbę węzłów, w których aplikacja jest obecnie wdrożona 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.		 int (wymagane)
serviceTypeHealthPolicyMap Mapa z zasadami kondycji typu usługi na nazwę typu usługi. Mapa jest domyślnie pusta. ServiceTypeHealthPolicyMap

ServiceTypeHealthPolicy

Nazwa Opis Wartość
maxPercentUnhealthyPartitionsPerService Maksymalna dozwolona wartość procentowa partycji w złej kondycji na usługę.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową partycji, które mogą być w złej kondycji, zanim usługa zostanie uznana za błędną.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jedna partycja w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Wartość procentowa jest obliczana przez podzielenie liczby partycji w złej kondycji na łączną liczbę partycji w usłudze.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na małej liczbie partycji.		 int (wymagane)

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100
maxPercentUnhealthyReplicasPerPartition Maksymalna dozwolona wartość procentowa replik w złej kondycji na partycję.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową replik, które mogą być w złej kondycji, zanim partycja zostanie uznana za błędną.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jedna replika w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Wartość procentowa jest obliczana przez podzielenie liczby replik w złej kondycji na łączną liczbę replik w partycji.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na małej liczbie replik.		 int (wymagane)

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100
maxPercentUnhealthyServices Maksymalna dozwolona wartość procentowa usług w złej kondycji.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową usług, które mogą być w złej kondycji, zanim aplikacja zostanie uznana za błędną.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jedna usługa w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Jest to obliczane przez podzielenie liczby usług w złej kondycji określonego typu usługi na łączną liczbę usług określonego typu usługi.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na niewielkiej liczbie usług.
 int (wymagane)

Ograniczenia:
Wartość minimalna = 0
Maksymalna wartość = 100

ServiceTypeHealthPolicyMap

Nazwa Opis Wartość
{niestandardowa właściwość} ServiceTypeHealthPolicy

RollingUpgradeMonitoringPolicy

Nazwa Opis Wartość
failureAction Akcja wyrównywująca, która ma być wykonywana, gdy monitorowane uaktualnienie napotyka naruszenia zasad monitorowania lub zasad kondycji. Nieprawidłowa wskazuje, że akcja niepowodzenia jest nieprawidłowa. Wycofanie określa, że uaktualnienie rozpocznie się automatycznie. Ręczne wskazuje, że uaktualnienie przełączy się do trybu niemonitorowanegoManual uaktualniania. "Ręczne"
"Wycofywanie" (wymagane)
healthCheckRetryTimeout Czas ponawiania próby oceny kondycji, gdy aplikacja lub klaster jest w złej kondycji przed wykonaniem polecenia FailureAction. Jest on interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)
healthCheckStableDuration Czas, przez jaki aplikacja lub klaster musi pozostać w dobrej kondycji, zanim uaktualnienie przejdzie do następnej domeny uaktualnienia. Jest on interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)
healthCheckWaitDuration Czas oczekiwania po ukończeniu domeny uaktualnienia przed zastosowaniem zasad kondycji. Jest on interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)
upgradeDomainTimeout Czas ukończenia każdej domeny uaktualnienia przed wykonaniem operacji FailureAction. Nie można przekroczyć 12 godzin. Jest on interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)
upgradeTimeout Czas ukończenia ogólnego uaktualnienia przed wykonaniem operacji FailureAction. Nie można przekroczyć 12 godzin. Jest on interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)

Definicja zasobu szablonu usługi ARM

Typ zasobu managedclusters/applications można wdrożyć z operacjami docelowymi:

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/applications, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.ServiceFabric/managedclusters/applications",
  "apiVersion": "2024-04-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "managedIdentities": [
      {
        "name": "string",
        "principalId": "string"
      }
    ],
    "parameters": {
      "{customized property}": "string"
    },
    "upgradePolicy": {
      "applicationHealthPolicy": {
        "considerWarningAsError": "bool",
        "defaultServiceTypeHealthPolicy": {
          "maxPercentUnhealthyPartitionsPerService": "int",
          "maxPercentUnhealthyReplicasPerPartition": "int",
          "maxPercentUnhealthyServices": "int"
        },
        "maxPercentUnhealthyDeployedApplications": "int",
        "serviceTypeHealthPolicyMap": {
          "{customized property}": {
            "maxPercentUnhealthyPartitionsPerService": "int",
            "maxPercentUnhealthyReplicasPerPartition": "int",
            "maxPercentUnhealthyServices": "int"
          }
        }
      },
      "forceRestart": "bool",
      "instanceCloseDelayDuration": "int",
      "recreateApplication": "bool",
      "rollingUpgradeMonitoringPolicy": {
        "failureAction": "string",
        "healthCheckRetryTimeout": "string",
        "healthCheckStableDuration": "string",
        "healthCheckWaitDuration": "string",
        "upgradeDomainTimeout": "string",
        "upgradeTimeout": "string"
      },
      "upgradeMode": "string",
      "upgradeReplicaSetCheckTimeout": "int"
    },
    "version": "string"
  }
}

Wartości właściwości

managedclusters/applications

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.ServiceFabric/managedclusters/applications"
apiVersion Wersja interfejsu API zasobów '2024-04-01'
name Nazwa zasobu

Zobacz, jak ustawiać nazwy i typy dla zasobów podrzędnych w szablonach usługi ARM JSON.		 ciąg (wymagany)
location Lokalizacja zasobu zależy od zasobu nadrzędnego. ciąg
tags Tagi zasobów platformy Azure. Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
identity Opisuje tożsamości zarządzane dla zasobu platformy Azure. ManagedIdentity
properties Właściwości zasobu aplikacji. ApplicationResourceProperties

ManagedIdentity

Nazwa Opis Wartość
typ Typ tożsamości zarządzanej zasobu. "Brak"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w formularzu:
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
 UserAssignedIdentityMap

UserAssignedIdentityMap

Nazwa Opis Wartość
{niestandardowa właściwość} UserAssignedIdentity

UserAssignedIdentity

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

ApplicationResourceProperties

Nazwa Opis Wartość
managedIdentities Lista tożsamości przypisanych przez użytkownika dla aplikacji, z których każda została zamapowana na przyjazną nazwę. ApplicationUserAssignedIdentity[]
parameters Lista parametrów aplikacji z wartościami zastępowanymi z ich wartości domyślnych określonych w manifeście aplikacji. ApplicationParameterList
upgradePolicy Opisuje zasady dotyczące monitorowanego uaktualnienia aplikacji. ApplicationUpgradePolicy
Wersja Wersja typu aplikacji zdefiniowana w manifeście aplikacji.
Ta nazwa musi być pełnym identyfikatorem zasobu usługi Arm dla wersji typu aplikacji, do których odwołuje się odwołanie.
 ciąg

ApplicationUserAssignedIdentity

Nazwa Opis Wartość
name Przyjazna nazwa tożsamości przypisanej przez użytkownika. ciąg (wymagany)
principalId Identyfikator podmiotu zabezpieczeń tożsamości przypisanej przez użytkownika. ciąg (wymagany)

ApplicationParameterList

Nazwa Opis Wartość
{niestandardowa właściwość} ciąg

ApplicationUpgradePolicy

Nazwa Opis Wartość
applicationHealthPolicy Definiuje zasady kondycji używane do oceny kondycji aplikacji lub jednej z jej jednostek podrzędnych. ApplicationHealthPolicy
forceRestart Jeśli prawda, procesy są wymuszane ponownie podczas uaktualniania nawet wtedy, gdy wersja kodu nie uległa zmianie (uaktualnienie zmienia tylko konfigurację lub dane). bool
instanceCloseDelayDuration Czas trwania w sekundach, aby poczekać przed zamknięciem wystąpienia bezstanowego, aby zezwolić aktywnym żądaniom na bezproblemowe opróżnianie. Byłoby to skuteczne, gdy wystąpienie jest zamykane podczas uaktualniania aplikacji/klastra, tylko dla tych wystąpień, które mają niezerowy czas trwania opóźnienia skonfigurowany w opisie usługi. int
ponowne tworzenie aplikacji Określa, czy aplikacja powinna zostać ponownie utworzona podczas aktualizacji. Jeśli wartość=true, pozostałe parametry zasad uaktualniania nie są dozwolone. bool
rollingUpgradeMonitoringPolicy Zasady używane do monitorowania uaktualnienia aplikacji RollingUpgradeMonitoringPolicy
upgradeMode Tryb używany do monitorowania kondycji podczas uaktualniania stopniowego. Wartości są monitorowane i niemonitorowaneAuto. "Monitorowane"
"UnmonitoredAuto"
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. Prawidłowe wartości to od 0 do 42949672925 włącznie. (niepodpisane 32-bitowe liczby całkowite). int

ApplicationHealthPolicy

Nazwa Opis Wartość
considerWarningAsError Wskazuje, czy ostrzeżenia są traktowane z taką samą ważnością jak błędy. bool (wymagane)
defaultServiceTypeHealthPolicy Zasady kondycji używane domyślnie do oceny kondycji typu usługi. ServiceTypeHealthPolicy
maxPercent W złej kondycjiDeployedApplications Maksymalna dozwolona wartość procentowa aplikacji wdrożonych w złej kondycji. Dozwolone wartości to wartości bajtów od zera do 100.
Wartość procentowa reprezentuje maksymalny tolerowany procent wdrożonych aplikacji, które mogą być w złej kondycji, zanim aplikacja zostanie uznana za błędną.
Jest to obliczane przez podzielenie liczby wdrożonych aplikacji w złej kondycji na liczbę węzłów, w których aplikacja jest obecnie wdrażana 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.		 int (wymagane)
serviceTypeHealthPolicyMap Mapa z zasadami kondycji typu usługi na nazwę typu usługi. Mapa jest domyślnie pusta. ServiceTypeHealthPolicyMap

ServiceTypeHealthPolicy

Nazwa Opis Wartość
maxPercent W złej kondycjiPartitionsPerService Maksymalna dozwolona wartość procentowa partycji w złej kondycji na usługę.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową partycji, które mogą być w złej kondycji, zanim usługa zostanie uznana za błędną.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jedna partycja w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Wartość procentowa jest obliczana przez podzielenie liczby partycji w złej kondycji na łączną liczbę partycji w usłudze.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na małej liczbie partycji.		 int (wymagane)

Ograniczenia:
Minimalna wartość = 0
Maksymalna wartość = 100
maxPercentUnhealthyReplicasPerPartition Maksymalna dozwolona wartość procentowa replik w złej kondycji na partycję.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową replik, które mogą być w złej kondycji, zanim partycja zostanie uznana za błędną.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jedna replika w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Wartość procentowa jest obliczana przez podzielenie liczby replik w złej kondycji na łączną liczbę replik w partycji.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na małej liczbie replik.		 int (wymagane)

Ograniczenia:
Wartość minimalna = 0
Wartość maksymalna = 100
maxPercentUnhealthyServices Maksymalna dozwolona wartość procentowa usług w złej kondycji.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową usług, które mogą być w złej kondycji, zanim aplikacja zostanie uznana za błędną.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jedna usługa w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Jest to obliczane przez podzielenie liczby usług w złej kondycji określonego typu usługi na łączną liczbę usług określonego typu usługi.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na niewielkiej liczbie usług.
 int (wymagane)

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

ServiceTypeHealthPolicyMap

Nazwa Opis Wartość
{niestandardowa właściwość} ServiceTypeHealthPolicy

RollingUpgradeMonitoringPolicy

Nazwa Opis Wartość
failureAction Akcja wyrównywająca do wykonania, gdy monitorowane uaktualnienie napotyka naruszenia zasad monitorowania lub zasad kondycji. Invalid wskazuje, że akcja niepowodzenia jest nieprawidłowa. Wycofanie określa, że uaktualnienie rozpocznie się automatycznie. Ręczne wskazuje, że uaktualnienie przełączy się do trybu niemonitorowanegoManual upgrade. "Ręczne"
"Wycofywanie" (wymagane)
healthCheckRetryTimeout Czas ponawiania próby oceny kondycji, gdy aplikacja lub klaster jest w złej kondycji przed wykonaniem funkcji FailureAction. Jest interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)
healthCheckStableDuration Czas, przez jaki aplikacja lub klaster musi pozostać w dobrej kondycji, zanim uaktualnienie przejdzie do następnej domeny uaktualnienia. Jest interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)
healthCheckWaitDuration Czas oczekiwania po ukończeniu uaktualniania domeny przed zastosowaniem zasad kondycji. Jest interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)
upgradeDomainTimeout Czas ukończenia każdej domeny uaktualniania przed wykonaniem elementu FailureAction. Nie może być większy niż 12 godzin. Jest interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)
upgradeTimeout Czas potrzebny na ukończenie ogólnego uaktualnienia przed wykonaniem elementu FailureAction. Nie może być większy niż 12 godzin. Jest interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu managedclusters/applications można wdrożyć z operacjami docelowymi:

  • 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/applications, dodaj następujący element Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/managedclusters/applications@2024-04-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      managedIdentities = [
        {
          name = "string"
          principalId = "string"
        }
      ]
      parameters = {
        {customized property} = "string"
      }
      upgradePolicy = {
        applicationHealthPolicy = {
          considerWarningAsError = bool
          defaultServiceTypeHealthPolicy = {
            maxPercentUnhealthyPartitionsPerService = int
            maxPercentUnhealthyReplicasPerPartition = int
            maxPercentUnhealthyServices = int
          }
          maxPercentUnhealthyDeployedApplications = int
          serviceTypeHealthPolicyMap = {
            {customized property} = {
              maxPercentUnhealthyPartitionsPerService = int
              maxPercentUnhealthyReplicasPerPartition = int
              maxPercentUnhealthyServices = int
            }
          }
        }
        forceRestart = bool
        instanceCloseDelayDuration = int
        recreateApplication = bool
        rollingUpgradeMonitoringPolicy = {
          failureAction = "string"
          healthCheckRetryTimeout = "string"
          healthCheckStableDuration = "string"
          healthCheckWaitDuration = "string"
          upgradeDomainTimeout = "string"
          upgradeTimeout = "string"
        }
        upgradeMode = "string"
        upgradeReplicaSetCheckTimeout = int
      }
      version = "string"
    }
  })
}

Wartości właściwości

managedclusters/applications

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.ServiceFabric/managedclusters/applications@2024-04-01"
name Nazwa zasobu ciąg (wymagany)
location Lokalizacja zasobu zależy od zasobu nadrzędnego. ciąg
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu : managedclusters
tags Tagi zasobów platformy Azure. Słownik nazw tagów i wartości.
identity Opisuje tożsamości zarządzane dla zasobu platformy Azure. ManagedIdentity
properties Właściwości zasobu aplikacji. ApplicationResourceProperties

ManagedIdentity

Nazwa Opis Wartość
typ Typ tożsamości zarządzanej zasobu. "SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
identity_ids Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w formularzu:
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
 Tablica identyfikatorów tożsamości użytkownika.

UserAssignedIdentityMap

Nazwa Opis Wartość
{niestandardowa właściwość} UserAssignedIdentity

UserAssignedIdentity

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

ApplicationResourceProperties

Nazwa Opis Wartość
managedIdentities Lista tożsamości przypisanych przez użytkownika dla aplikacji, z których każda została zamapowana na przyjazną nazwę. ApplicationUserAssignedIdentity[]
parameters Lista parametrów aplikacji z wartościami zastępowanymi z ich wartości domyślnych określonych w manifeście aplikacji. ApplicationParameterList
upgradePolicy Opisuje zasady dotyczące monitorowanego uaktualnienia aplikacji. ApplicationUpgradePolicy
Wersja Wersja typu aplikacji zdefiniowana w manifeście aplikacji.
Ta nazwa musi być pełnym identyfikatorem zasobu usługi Arm dla wersji typu aplikacji, do których odwołuje się odwołanie.
 ciąg

ApplicationUserAssignedIdentity

Nazwa Opis Wartość
name Przyjazna nazwa tożsamości przypisanej przez użytkownika. ciąg (wymagany)
principalId Identyfikator podmiotu zabezpieczeń tożsamości przypisanej przez użytkownika. ciąg (wymagany)

ApplicationParameterList

Nazwa Opis Wartość
{niestandardowa właściwość} ciąg

ApplicationUpgradePolicy

Nazwa Opis Wartość
applicationHealthPolicy Definiuje zasady kondycji używane do oceny kondycji aplikacji lub jednej z jej jednostek podrzędnych. ApplicationHealthPolicy
forceRestart Jeśli prawda, procesy są wymuszane ponownie podczas uaktualniania nawet wtedy, gdy wersja kodu nie uległa zmianie (uaktualnienie zmienia tylko konfigurację lub dane). bool
instanceCloseDelayDuration Czas trwania w sekundach, aby poczekać przed zamknięciem wystąpienia bezstanowego, aby zezwolić aktywnym żądaniom na bezproblemowe opróżnianie. Byłoby to skuteczne, gdy wystąpienie jest zamykane podczas uaktualniania aplikacji/klastra, tylko dla tych wystąpień, które mają niezerowy czas trwania opóźnienia skonfigurowany w opisie usługi. int
ponowne tworzenie aplikacji Określa, czy aplikacja powinna zostać ponownie utworzona podczas aktualizacji. Jeśli wartość=true, pozostałe parametry zasad uaktualniania nie są dozwolone. bool
rollingUpgradeMonitoringPolicy Zasady używane do monitorowania uaktualnienia aplikacji RollingUpgradeMonitoringPolicy
upgradeMode Tryb używany do monitorowania kondycji podczas uaktualniania stopniowego. Wartości są monitorowane i niemonitorowaneAuto. "Monitorowane"
"UnmonitoredAuto"
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. Prawidłowe wartości to od 0 do 42949672925 włącznie. (niepodpisane 32-bitowe liczby całkowite). int

ApplicationHealthPolicy

Nazwa Opis Wartość
considerWarningAsError Wskazuje, czy ostrzeżenia są traktowane z taką samą ważnością jak błędy. bool (wymagane)
defaultServiceTypeHealthPolicy Zasady kondycji używane domyślnie do oceny kondycji typu usługi. ServiceTypeHealthPolicy
maxPercent W złej kondycjiDeployedApplications Maksymalna dozwolona wartość procentowa aplikacji wdrożonych w złej kondycji. Dozwolone wartości to wartości bajtów od zera do 100.
Wartość procentowa reprezentuje maksymalny tolerowany procent wdrożonych aplikacji, które mogą być w złej kondycji, zanim aplikacja zostanie uznana za błędną.
Jest to obliczane przez podzielenie liczby wdrożonych aplikacji w złej kondycji na liczbę węzłów, w których aplikacja jest obecnie wdrażana 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.		 int (wymagane)
serviceTypeHealthPolicyMap Mapa z zasadami kondycji typu usługi na nazwę typu usługi. Mapa jest domyślnie pusta. ServiceTypeHealthPolicyMap

ServiceTypeHealthPolicy

Nazwa Opis Wartość
maxPercent W złej kondycjiPartitionsPerService Maksymalna dozwolona wartość procentowa partycji w złej kondycji na usługę.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową partycji, które mogą być w złej kondycji, zanim usługa zostanie uznana za błędną.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jedna partycja w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Wartość procentowa jest obliczana przez podzielenie liczby partycji w złej kondycji na łączną liczbę partycji w usłudze.
Obliczenia są zaokrąglone w górę, aby tolerować jedną awarię na małej liczbie partycji.		 int (wymagane)

Ograniczenia:
Minimalna wartość = 0
Maksymalna wartość = 100
maxPercent W złej kondycjiReplicasPerPartition Maksymalna dozwolona wartość procentowa replik w złej kondycji na partycję.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową replik, które mogą być w złej kondycji, zanim partycja zostanie uznana za błędną.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jedna replika w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Wartość procentowa jest obliczana przez podzielenie liczby replik w złej kondycji na całkowitą liczbę replik w partycji.
Obliczenia zaokrągla się w górę, aby tolerować jedną awarię na małej liczbie replik.		 int (wymagane)

Ograniczenia:
Minimalna wartość = 0
Maksymalna wartość = 100
maxPercent W złej kondycjiUsługi Maksymalny dozwolony procent usług w złej kondycji.

Wartość procentowa reprezentuje maksymalną tolerowaną wartość procentową usług, które mogą być w złej kondycji, zanim aplikacja zostanie uznana za błędną.
Jeśli wartość procentowa jest przestrzegana, ale istnieje co najmniej jedna usługa w złej kondycji, kondycja jest oceniana jako Ostrzeżenie.
Jest to obliczane przez podzielenie liczby usług w złej kondycji określonego typu usługi na łączną liczbę usług określonego typu usługi.
Obliczenia zaokrągla się w górę, aby tolerować jedną awarię na małej liczbie usług.
 int (wymagane)

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

ServiceTypeHealthPolicyMap

Nazwa Opis Wartość
{niestandardowa właściwość} ServiceTypeHealthPolicy

RollingUpgradeMonitoringPolicy

Nazwa Opis Wartość
failureAction Akcja wyrównywująca, która ma być wykonywana, gdy monitorowane uaktualnienie napotyka naruszenia zasad monitorowania lub zasad kondycji. Nieprawidłowa wskazuje, że akcja niepowodzenia jest nieprawidłowa. Wycofanie określa, że uaktualnienie rozpocznie się automatycznie. Ręczne wskazuje, że uaktualnienie przełączy się do trybu niemonitorowanegoManual uaktualniania. "Ręczne"
"Wycofywanie" (wymagane)
healthCheckRetryTimeout Czas ponawiania próby oceny kondycji, gdy aplikacja lub klaster jest w złej kondycji przed wykonaniem polecenia FailureAction. Jest on interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)
healthCheckStableDuration Czas, przez jaki aplikacja lub klaster musi pozostać w dobrej kondycji, zanim uaktualnienie przejdzie do następnej domeny uaktualnienia. Jest on interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)
healthCheckWaitDuration Czas oczekiwania po ukończeniu domeny uaktualnienia przed zastosowaniem zasad kondycji. Jest on interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)
upgradeDomainTimeout Czas ukończenia każdej domeny uaktualnienia przed wykonaniem operacji FailureAction. Nie można przekroczyć 12 godzin. Jest on interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)
upgradeTimeout Czas ukończenia ogólnego uaktualnienia przed wykonaniem operacji FailureAction. Nie można przekroczyć 12 godzin. Jest on interpretowany jako ciąg reprezentujący czas trwania ISO 8601 o następującym formacie "hh:mm:ss.fff". ciąg (wymagany)