Partilhar via

Clusters/aplicações Microsoft.ServiceFabric 2020-03-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso clusters/aplicações pode ser implementado com operações que visam:

Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.ServiceFabric/clusters/applications, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.ServiceFabric/clusters/applications@2020-03-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    managedIdentities: [
      {
        name: 'string'
        principalId: 'string'
      }
    ]
    maximumNodes: int
    metrics: [
      {
        maximumCapacity: int
        name: 'string'
        reservationCapacity: int
        totalApplicationCapacity: int
      }
    ]
    minimumNodes: int
    parameters: {
      {customized property}: 'string'
    }
    removeApplicationCapacity: bool
    typeName: 'string'
    typeVersion: '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
      recreateApplication: bool
      rollingUpgradeMonitoringPolicy: {
        failureAction: 'string'
        healthCheckRetryTimeout: 'string'
        healthCheckStableDuration: 'string'
        healthCheckWaitDuration: 'string'
        upgradeDomainTimeout: 'string'
        upgradeTimeout: 'string'
      }
      upgradeMode: 'string'
      upgradeReplicaSetCheckTimeout: 'string'
    }
  }
}

Valores de propriedade

clusters/aplicações

Nome Descrição Valor
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados no Bicep.		 cadeia (obrigatório)
localização Será preterido na Nova API, a localização dos recursos depende do recurso principal. string
etiquetas Etiquetas de recursos do Azure. Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
principal No Bicep, pode especificar o recurso principal de um recurso subordinado. Só tem de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal.

Para obter mais informações, veja Recurso subordinado fora do recurso principal.		 Nome simbólico para recurso do tipo: clusters
identidade Descreve as identidades geridas de um recurso do Azure. ManagedIdentity
propriedades As propriedades do recurso da aplicação. ApplicationResourceProperties

ManagedIdentity

Nome Descrição Valor
tipo O tipo de identidade gerida do recurso. "Nenhum"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities A lista de identidades de utilizador associadas ao recurso. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário:
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
 UserAssignedIdentityMap

UserAssignedIdentityMap

Nome Descrição Valor
{customized property} UserAssignedIdentity

UserAssignedIdentity

Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.

ApplicationResourceProperties

Nome Descrição Valor
managedIdentities Lista de identidades atribuídas pelo utilizador para a aplicação, cada uma mapeada para um nome amigável. ApplicationUserAssignedIdentity[]
maximumNodes O número máximo de nós em que o Service Fabric reserva capacidade para esta aplicação. Tenha em atenção que isto não significa que os serviços desta aplicação serão colocados em todos esses nós. Por predefinição, o valor desta propriedade é zero e significa que os serviços podem ser colocados em qualquer nó. int

Restrições:
Valor mínimo = 0
metrics Lista de descrição da métrica de capacidade da aplicação. ApplicationMetricDescription[]
minimumNodes O número mínimo de nós em que o Service Fabric reserva capacidade para esta aplicação. Tenha em atenção que isto não significa que os serviços desta aplicação serão colocados em todos esses nós. Se esta propriedade estiver definida como zero, nenhuma capacidade será reservada. O valor desta propriedade não pode ser superior ao valor da propriedade MaximumNodes. int

Restrições:
Valor mínimo = 0
parâmetros Lista de parâmetros da aplicação com valores substituídos dos valores predefinidos especificados no manifesto da aplicação. ApplicationParameterList
removeApplicationCapacity Remova as definições atuais da capacidade da aplicação. bool
typeName O nome do tipo de aplicação, conforme definido no manifesto da aplicação. string
typeVersion A versão do tipo de aplicação, conforme definido no manifesto da aplicação. string
upgradePolicy Descreve a política para uma atualização de aplicação monitorizada. ApplicationUpgradePolicy

ApplicationUserAssignedIdentity

Nome Descrição Valor
name O nome amigável da identidade atribuída pelo utilizador. cadeia (obrigatório)
principalId O ID principal da identidade atribuída pelo utilizador. cadeia (obrigatório)

ApplicationMetricDescription

Nome Descrição Valor
maximumCapacity A capacidade máxima do nó para a aplicação do Service Fabric.
Esta é a Carga máxima para uma instância desta aplicação num único nó. Mesmo que a capacidade do nó seja maior do que este valor, o Service Fabric limitará a carga total de serviços dentro da aplicação em cada nó a este valor.
Se estiver definido como zero, a capacidade desta métrica é ilimitada em cada nó.
Ao criar uma nova aplicação com capacidade de aplicação definida, o produto de MaximumNodes e este valor tem de ser sempre menor ou igual a TotalApplicationCapacity.
Ao atualizar a aplicação existente com a capacidade da aplicação, o produto de MaximumNodes e este valor têm de ser sempre menores ou iguais a TotalApplicationCapacity.		 int
name O nome da métrica. string
reservationCapacity A capacidade de reserva de nós para a aplicação do Service Fabric.
Esta é a quantidade de carga reservada nos nós que têm instâncias desta aplicação.
Se MinimumNodes for especificado, o produto destes valores será a capacidade reservada no cluster para a aplicação.
Se estiver definido como zero, nenhuma capacidade está reservada para esta métrica.
Ao definir a capacidade da aplicação ou ao atualizar a capacidade da aplicação; este valor tem de ser menor ou igual a MaximumCapacity para cada métrica.		 int
totalApplicationCapacity A capacidade total de métricas para a aplicação do Service Fabric.
Esta é a capacidade total de métricas para esta aplicação no cluster. O Service Fabric tentará limitar a soma de cargas de serviços na aplicação a este valor.
Ao criar uma nova aplicação com capacidade de aplicação definida, o produto de MaximumNodes e MaximumCapacity tem de ser sempre menor ou igual a este valor.
 int

ApplicationParameterList

Nome Descrição Valor
{customized property} string

ApplicationUpgradePolicy

Nome Descrição Valor
applicationHealthPolicy Define uma política de estado de funcionamento utilizada para avaliar o estado de funcionamento de uma aplicação ou de uma das entidades subordinadas. ArmApplicationHealthPolicy
forceRestart Se for verdadeiro, os processos são reiniciados com força durante a atualização, mesmo quando a versão do código não foi alterada (a atualização só altera a configuração ou os dados). bool
recriarAplicação Determina se a aplicação deve ser recriada na atualização. Se value=true, os restantes parâmetros da política de atualização não são permitidos e resultarão na perda de disponibilidade. bool
rollingUpgradeMonitoringPolicy A política utilizada para monitorizar a atualização da aplicação ArmRollingUpgradeMonitoringPolicy
upgradeMode O modo utilizado para monitorizar o estado de funcionamento durante uma atualização sem interrupção. Os valores são UnmonitoredAuto, UnmonitoredManual e Monitored. "Inválido"
"Monitorizado"
"UnmonitoredAuto"
"UnmonitoredManual"
upgradeReplicaSetCheckTimeout A quantidade máxima de tempo para bloquear o processamento de um domínio de atualização e evitar a perda de disponibilidade quando existem problemas inesperados. Quando este tempo limite expirar, o processamento do domínio de atualização irá prosseguir independentemente dos problemas de perda de disponibilidade. O tempo limite é reposto no início de cada domínio de atualização. Os valores válidos estão entre 0 e 42949672925 inclusive. (número inteiro de 32 bits não assinado). string

ArmApplicationHealthPolicy

Nome Descrição Valor
considerarWarningAsError Indica se os avisos são tratados com a mesma gravidade que os erros. bool
defaultServiceTypeHealthPolicy A política de estado de funcionamento utilizada por predefinição para avaliar o estado de funcionamento de um tipo de serviço. ArmServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications A percentagem máxima permitida de aplicações implementadas em mau estado de funcionamento. Os valores permitidos são valores de Byte de zero a 100.
A percentagem representa a percentagem máxima tolerada de aplicações implementadas que podem estar em mau estado de funcionamento antes de a aplicação ser considerada como erro.
Isto é calculado ao dividir o número de aplicações implementadas em mau estado de funcionamento em relação ao número de nós em que a aplicação está atualmente implementada no cluster.
O cálculo arredonda para tolerar uma falha num pequeno número de nós. A percentagem predefinida é zero.		 int
serviceTypeHealthPolicyMap O mapa com o tipo de serviço política de estado de funcionamento por nome do tipo de serviço. O mapa está vazio por predefinição. ArmServiceTypeHealthPolicyMap

ArmServiceTypeHealthPolicy

Nome Descrição Valor
maxPercentUnhealthyPartitionsPerService A percentagem máxima de partições por serviço pode estar em mau estado de funcionamento antes de a aplicação ser considerada como erro. int

Restrições:
Valor mínimo = 0
Valor máximo = 100
maxPercentUnhealthyReplicasPerPartition A percentagem máxima de réplicas por partição pode estar em mau estado de funcionamento antes de a aplicação ser considerada como erro. int

Restrições:
Valor mínimo = 0
Valor máximo = 100
maxPercentUnhealthyServices A percentagem máxima de serviços autorizados a estar em mau estado de funcionamento antes de a sua aplicação ser considerada como erro. int

Restrições:
Valor mínimo = 0
Valor máximo = 100

ArmServiceTypeHealthPolicyMap

Nome Descrição Valor
{customized property} ArmServiceTypeHealthPolicy

ArmRollingUpgradeMonitoringPolicy

Nome Descrição Valor
failureAction O Modo de ativação do pacote de serviço "Manual"
"Reversão"
healthCheckRetryTimeout A quantidade de tempo para repetir a avaliação do estado de funcionamento quando a aplicação ou o cluster está em mau estado de funcionamento antes da execução de FailureAction. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string
healthCheckStableDuration O período de tempo durante o qual a aplicação ou cluster tem de permanecer em bom estado de funcionamento antes de a atualização avançar para o domínio de atualização seguinte. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string
healthCheckWaitDuration A quantidade de tempo a aguardar depois de concluir um domínio de atualização antes de aplicar políticas de estado de funcionamento. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string
upgradeDomainTimeout A quantidade de tempo que cada domínio de atualização tem de ser concluído antes da execução de FailureAction. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string
upgradeTimeout A quantidade de tempo que a atualização geral tem de ser concluída antes de FailureAction ser executada. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string

Definição de recurso do modelo arm

O tipo de recurso clusters/aplicações pode ser implementado com operações que visam:

Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.ServiceFabric/clusters/aplicações, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.ServiceFabric/clusters/applications",
  "apiVersion": "2020-03-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "managedIdentities": [
      {
        "name": "string",
        "principalId": "string"
      }
    ],
    "maximumNodes": "int",
    "metrics": [
      {
        "maximumCapacity": "int",
        "name": "string",
        "reservationCapacity": "int",
        "totalApplicationCapacity": "int"
      }
    ],
    "minimumNodes": "int",
    "parameters": {
      "{customized property}": "string"
    },
    "removeApplicationCapacity": "bool",
    "typeName": "string",
    "typeVersion": "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",
      "recreateApplication": "bool",
      "rollingUpgradeMonitoringPolicy": {
        "failureAction": "string",
        "healthCheckRetryTimeout": "string",
        "healthCheckStableDuration": "string",
        "healthCheckWaitDuration": "string",
        "upgradeDomainTimeout": "string",
        "upgradeTimeout": "string"
      },
      "upgradeMode": "string",
      "upgradeReplicaSetCheckTimeout": "string"
    }
  }
}

Valores de propriedade

clusters/aplicações

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.ServiceFabric/clusters/applications"
apiVersion A versão da API de recursos '2020-03-01'
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados em modelos arm JSON.		 cadeia (obrigatório)
localização Será preterido na Nova API, a localização dos recursos depende do recurso principal. string
etiquetas Etiquetas de recursos do Azure. Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
identidade Descreve as identidades geridas de um recurso do Azure. ManagedIdentity
propriedades As propriedades do recurso da aplicação. ApplicationResourceProperties

ManagedIdentity

Nome Descrição Valor
tipo O tipo de identidade gerida do recurso. "Nenhum"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities A lista de identidades de utilizador associadas ao recurso. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário:
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
 UserAssignedIdentityMap

UserAssignedIdentityMap

Nome Descrição Valor
{customized property} UserAssignedIdentity

UserAssignedIdentity

Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.

ApplicationResourceProperties

Nome Descrição Valor
managedIdentities Lista de identidades atribuídas pelo utilizador para a aplicação, cada uma mapeada para um nome amigável. ApplicationUserAssignedIdentity[]
maximumNodes O número máximo de nós em que o Service Fabric reserva capacidade para esta aplicação. Tenha em atenção que isto não significa que os serviços desta aplicação serão colocados em todos esses nós. Por predefinição, o valor desta propriedade é zero e significa que os serviços podem ser colocados em qualquer nó. int

Restrições:
Valor mínimo = 0
metrics Lista de descrição da métrica de capacidade da aplicação. ApplicationMetricDescription[]
minimumNodes O número mínimo de nós em que o Service Fabric reserva capacidade para esta aplicação. Tenha em atenção que isto não significa que os serviços desta aplicação serão colocados em todos esses nós. Se esta propriedade estiver definida como zero, nenhuma capacidade será reservada. O valor desta propriedade não pode ser superior ao valor da propriedade MaximumNodes. int

Restrições:
Valor mínimo = 0
parâmetros Lista de parâmetros da aplicação com valores substituídos dos valores predefinidos especificados no manifesto da aplicação. ApplicationParameterList
removeApplicationCapacity Remova as definições atuais da capacidade da aplicação. bool
typeName O nome do tipo de aplicação, conforme definido no manifesto da aplicação. string
typeVersion A versão do tipo de aplicação, conforme definido no manifesto da aplicação. string
upgradePolicy Descreve a política para uma atualização de aplicação monitorizada. ApplicationUpgradePolicy

ApplicationUserAssignedIdentity

Nome Descrição Valor
name O nome amigável da identidade atribuída pelo utilizador. cadeia (obrigatório)
principalId O ID principal da identidade atribuída pelo utilizador. cadeia (obrigatório)

ApplicationMetricDescription

Nome Descrição Valor
maximumCapacity A capacidade máxima do nó para a aplicação do Service Fabric.
Esta é a Carga máxima para uma instância desta aplicação num único nó. Mesmo que a capacidade do nó seja maior do que este valor, o Service Fabric limitará a carga total de serviços dentro da aplicação em cada nó a este valor.
Se estiver definido como zero, a capacidade desta métrica é ilimitada em cada nó.
Ao criar uma nova aplicação com capacidade de aplicação definida, o produto de MaximumNodes e este valor tem de ser sempre menor ou igual a TotalApplicationCapacity.
Ao atualizar a aplicação existente com a capacidade da aplicação, o produto de MaximumNodes e este valor têm de ser sempre menores ou iguais a TotalApplicationCapacity.		 int
name O nome da métrica. string
reservationCapacity A capacidade de reserva de nós para a aplicação do Service Fabric.
Esta é a quantidade de carga reservada nos nós que têm instâncias desta aplicação.
Se MinimumNodes for especificado, o produto destes valores será a capacidade reservada no cluster para a aplicação.
Se estiver definido como zero, nenhuma capacidade está reservada para esta métrica.
Ao definir a capacidade da aplicação ou ao atualizar a capacidade da aplicação; este valor tem de ser menor ou igual a MaximumCapacity para cada métrica.		 int
totalApplicationCapacity A capacidade total da métrica para a aplicação do Service Fabric.
Esta é a capacidade total de métricas para esta aplicação no cluster. O Service Fabric tentará limitar a soma de cargas de serviços na aplicação a este valor.
Ao criar uma nova aplicação com capacidade de aplicação definida, o produto de MaximumNodes e MaximumCapacity tem de ser sempre menor ou igual a este valor.
 int

ApplicationParameterList

Nome Descrição Valor
{customized property} string

ApplicationUpgradePolicy

Nome Descrição Valor
applicationHealthPolicy Define uma política de estado de funcionamento utilizada para avaliar o estado de funcionamento de uma aplicação ou de uma das entidades subordinadas. ArmApplicationHealthPolicy
forceRestart Se for verdadeiro, os processos são reiniciados com força durante a atualização, mesmo quando a versão do código não foi alterada (a atualização só altera a configuração ou os dados). bool
recrieApplication Determina se a aplicação deve ser recriada na atualização. Se valor=verdadeiro, os restantes parâmetros da política de atualização não são permitidos e resultarão na perda de disponibilidade. bool
rollingUpgradeMonitoringPolicy A política utilizada para monitorizar a atualização da aplicação ArmRollingUpgradeMonitoringPolicy
upgradeMode O modo utilizado para monitorizar o estado de funcionamento durante uma atualização sem interrupção. Os valores são UnmonitoredAuto, UnmonitoredManual e Monitored. "Inválido"
"Monitorizado"
"UnmonitoredAuto"
"UnmonitoredManual"
upgradeReplicaSetCheckTimeout A quantidade máxima de tempo para bloquear o processamento de um domínio de atualização e evitar a perda de disponibilidade quando existem problemas inesperados. Quando este tempo limite expirar, o processamento do domínio de atualização irá prosseguir independentemente dos problemas de perda de disponibilidade. O tempo limite é reposto no início de cada domínio de atualização. Os valores válidos estão entre 0 e 42949672925 inclusive. (número inteiro de 32 bits não assinado). string

ArmApplicationHealthPolicy

Nome Descrição Valor
considerarWarningAsError Indica se os avisos são tratados com a mesma gravidade que os erros. bool
defaultServiceTypeHealthPolicy A política de estado de funcionamento utilizada por predefinição para avaliar o estado de funcionamento de um tipo de serviço. ArmServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications A percentagem máxima permitida de aplicações implementadas em mau estado de funcionamento. Os valores permitidos são valores byte de zero a 100.
A percentagem representa a percentagem máxima tolerada de aplicações implementadas que podem estar em mau estado de funcionamento antes de a aplicação ser considerada como erro.
Isto é calculado ao dividir o número de aplicações implementadas em mau estado de funcionamento em relação ao número de nós em que a aplicação está atualmente implementada no cluster.
A computação arredonda para tolerar uma falha num pequeno número de nós. A percentagem predefinida é zero.		 int
serviceTypeHealthPolicyMap O mapa com o tipo de serviço política de estado de funcionamento por nome do tipo de serviço. O mapa está vazio por predefinição. ArmServiceTypeHealthPolicyMap

ArmServiceTypeHealthPolicy

Nome Descrição Valor
maxPercentUnhealthyPartitionsPerService A percentagem máxima de partições por serviço pode estar em mau estado de funcionamento antes de a sua aplicação ser considerada como erro. int

Restrições:
Valor mínimo = 0
Valor máximo = 100
maxPercentUnhealthyReplicasPerPartition A percentagem máxima de réplicas por partição pode estar em mau estado de funcionamento antes de a sua aplicação ser considerada como erro. int

Restrições:
Valor mínimo = 0
Valor máximo = 100
maxPercentUnhealthyServices A percentagem máxima de serviços autorizados a estar em mau estado de funcionamento antes de a sua aplicação ser considerada como erro. int

Restrições:
Valor mínimo = 0
Valor máximo = 100

ArmServiceTypeHealthPolicyMap

Nome Descrição Valor
{customized property} ArmServiceTypeHealthPolicy

ArmRollingUpgradeMonitoringPolicy

Nome Descrição Valor
failureAction O Modo de ativação do pacote de serviço "Manual"
"Reversão"
healthCheckRetryTimeout A quantidade de tempo para repetir a avaliação do estado de funcionamento quando a aplicação ou o cluster está em mau estado de funcionamento antes da execução de FailureAction. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string
healthCheckStableDuration O período de tempo durante o qual a aplicação ou cluster tem de permanecer em bom estado de funcionamento antes de a atualização avançar para o domínio de atualização seguinte. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string
healthCheckWaitDuration A quantidade de tempo a aguardar depois de concluir um domínio de atualização antes de aplicar políticas de estado de funcionamento. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string
upgradeDomainTimeout A quantidade de tempo que cada domínio de atualização tem de ser concluído antes da execução de FailureAction. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string
upgradeTimeout A quantidade de tempo que a atualização geral tem de ser concluída antes de FailureAction ser executada. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string

Definição de recurso terraform (fornecedor AzAPI)

O tipo de recurso clusters/aplicações pode ser implementado com operações que visam:

  • Grupos de recursos

Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.ServiceFabric/clusters/aplicações, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/clusters/applications@2020-03-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"
        }
      ]
      maximumNodes = int
      metrics = [
        {
          maximumCapacity = int
          name = "string"
          reservationCapacity = int
          totalApplicationCapacity = int
        }
      ]
      minimumNodes = int
      parameters = {
        {customized property} = "string"
      }
      removeApplicationCapacity = bool
      typeName = "string"
      typeVersion = "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
        recreateApplication = bool
        rollingUpgradeMonitoringPolicy = {
          failureAction = "string"
          healthCheckRetryTimeout = "string"
          healthCheckStableDuration = "string"
          healthCheckWaitDuration = "string"
          upgradeDomainTimeout = "string"
          upgradeTimeout = "string"
        }
        upgradeMode = "string"
        upgradeReplicaSetCheckTimeout = "string"
      }
    }
  })
}

Valores de propriedade

clusters/aplicações

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.ServiceFabric/clusters/applications@2020-03-01"
name O nome do recurso cadeia (obrigatório)
localização Será preterido na Nova API, a localização dos recursos depende do recurso principal. string
parent_id O ID do recurso que é o principal para este recurso. ID do recurso do tipo: clusters
etiquetas Etiquetas de recursos do Azure. Dicionário de nomes e valores de etiquetas.
identidade Descreve as identidades geridas de um recurso do Azure. ManagedIdentity
propriedades As propriedades do recurso da aplicação. ApplicationResourceProperties

ManagedIdentity

Nome Descrição Valor
tipo O tipo de identidade gerida do recurso. "SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
identity_ids A lista de identidades de utilizador associadas ao recurso. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário:
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".
 Matriz de IDs de identidade do utilizador.

UserAssignedIdentityMap

Nome Descrição Valor
{customized property} UserAssignedIdentity

UserAssignedIdentity

Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.

ApplicationResourceProperties

Nome Descrição Valor
managedIdentities Lista de identidades atribuídas pelo utilizador para a aplicação, cada uma mapeada para um nome amigável. ApplicationUserAssignedIdentity[]
maximumNodes O número máximo de nós em que o Service Fabric reserva capacidade para esta aplicação. Tenha em atenção que isto não significa que os serviços desta aplicação serão colocados em todos esses nós. Por predefinição, o valor desta propriedade é zero e significa que os serviços podem ser colocados em qualquer nó. int

Restrições:
Valor mínimo = 0
metrics Lista de descrição da métrica de capacidade da aplicação. ApplicationMetricDescription[]
minimumNodes O número mínimo de nós em que o Service Fabric reserva capacidade para esta aplicação. Tenha em atenção que isto não significa que os serviços desta aplicação serão colocados em todos esses nós. Se esta propriedade estiver definida como zero, nenhuma capacidade será reservada. O valor desta propriedade não pode ser superior ao valor da propriedade MaximumNodes. int

Restrições:
Valor mínimo = 0
parâmetros Lista de parâmetros da aplicação com valores substituídos dos valores predefinidos especificados no manifesto da aplicação. ApplicationParameterList
removeApplicationCapacity Remova as definições atuais da capacidade da aplicação. bool
typeName O nome do tipo de aplicação, conforme definido no manifesto da aplicação. string
typeVersion A versão do tipo de aplicação, conforme definido no manifesto da aplicação. string
upgradePolicy Descreve a política para uma atualização de aplicação monitorizada. ApplicationUpgradePolicy

ApplicationUserAssignedIdentity

Nome Descrição Valor
name O nome amigável da identidade atribuída pelo utilizador. cadeia (obrigatório)
principalId O ID principal da identidade atribuída pelo utilizador. cadeia (obrigatório)

ApplicationMetricDescription

Nome Descrição Valor
maximumCapacity A capacidade máxima do nó para a aplicação do Service Fabric.
Esta é a Carga máxima para uma instância desta aplicação num único nó. Mesmo que a capacidade do nó seja maior do que este valor, o Service Fabric limitará a carga total de serviços dentro da aplicação em cada nó a este valor.
Se estiver definido como zero, a capacidade desta métrica é ilimitada em cada nó.
Ao criar uma nova aplicação com capacidade de aplicação definida, o produto de MaximumNodes e este valor tem de ser sempre menor ou igual a TotalApplicationCapacity.
Ao atualizar a aplicação existente com a capacidade da aplicação, o produto de MaximumNodes e este valor têm de ser sempre menores ou iguais a TotalApplicationCapacity.		 int
name O nome da métrica. string
reservationCapacity A capacidade de reserva de nós para a aplicação do Service Fabric.
Esta é a quantidade de carga reservada nos nós que têm instâncias desta aplicação.
Se MinimumNodes for especificado, o produto destes valores será a capacidade reservada no cluster para a aplicação.
Se estiver definido como zero, nenhuma capacidade está reservada para esta métrica.
Ao definir a capacidade da aplicação ou ao atualizar a capacidade da aplicação; este valor tem de ser menor ou igual a MaximumCapacity para cada métrica.		 int
totalApplicationCapacity A capacidade total de métricas para a aplicação do Service Fabric.
Esta é a capacidade total de métricas para esta aplicação no cluster. O Service Fabric tentará limitar a soma de cargas de serviços na aplicação a este valor.
Ao criar uma nova aplicação com capacidade de aplicação definida, o produto de MaximumNodes e MaximumCapacity tem de ser sempre menor ou igual a este valor.
 int

ApplicationParameterList

Nome Descrição Valor
{customized property} string

ApplicationUpgradePolicy

Nome Descrição Valor
applicationHealthPolicy Define uma política de estado de funcionamento utilizada para avaliar o estado de funcionamento de uma aplicação ou de uma das entidades subordinadas. ArmApplicationHealthPolicy
forceRestart Se for verdadeiro, os processos são reiniciados com força durante a atualização, mesmo quando a versão do código não foi alterada (a atualização só altera a configuração ou os dados). bool
recriarAplicação Determina se a aplicação deve ser recriada na atualização. Se value=true, os restantes parâmetros da política de atualização não são permitidos e resultarão na perda de disponibilidade. bool
rollingUpgradeMonitoringPolicy A política utilizada para monitorizar a atualização da aplicação ArmRollingUpgradeMonitoringPolicy
upgradeMode O modo utilizado para monitorizar o estado de funcionamento durante uma atualização sem interrupção. Os valores são UnmonitoredAuto, UnmonitoredManual e Monitored. "Inválido"
"Monitorizado"
"UnmonitoredAuto"
"UnmonitoredManual"
upgradeReplicaSetCheckTimeout A quantidade máxima de tempo para bloquear o processamento de um domínio de atualização e evitar a perda de disponibilidade quando existem problemas inesperados. Quando este tempo limite expirar, o processamento do domínio de atualização irá prosseguir independentemente dos problemas de perda de disponibilidade. O tempo limite é reposto no início de cada domínio de atualização. Os valores válidos estão entre 0 e 42949672925 inclusive. (número inteiro de 32 bits não assinado). string

ArmApplicationHealthPolicy

Nome Descrição Valor
considerarWarningAsError Indica se os avisos são tratados com a mesma gravidade que os erros. bool
defaultServiceTypeHealthPolicy A política de estado de funcionamento utilizada por predefinição para avaliar o estado de funcionamento de um tipo de serviço. ArmServiceTypeHealthPolicy
maxPercentUnhealthyDeployedApplications A percentagem máxima permitida de aplicações implementadas em mau estado de funcionamento. Os valores permitidos são valores de Byte de zero a 100.
A percentagem representa a percentagem máxima tolerada de aplicações implementadas que podem estar em mau estado de funcionamento antes de a aplicação ser considerada como erro.
Isto é calculado ao dividir o número de aplicações implementadas em mau estado de funcionamento em relação ao número de nós em que a aplicação está atualmente implementada no cluster.
O cálculo arredonda para tolerar uma falha num pequeno número de nós. A percentagem predefinida é zero.		 int
serviceTypeHealthPolicyMap O mapa com o tipo de serviço política de estado de funcionamento por nome do tipo de serviço. O mapa está vazio por predefinição. ArmServiceTypeHealthPolicyMap

ArmServiceTypeHealthPolicy

Nome Descrição Valor
maxPercentUnhealthyPartitionsPerService A percentagem máxima de partições por serviço pode estar em mau estado de funcionamento antes de a aplicação ser considerada como erro. int

Restrições:
Valor mínimo = 0
Valor máximo = 100
maxPercentUnhealthyReplicasPerPartition A percentagem máxima de réplicas por partição pode estar em mau estado de funcionamento antes de a aplicação ser considerada como erro. int

Restrições:
Valor mínimo = 0
Valor máximo = 100
maxPercentUnhealthyServices A percentagem máxima de serviços autorizados a estar em mau estado de funcionamento antes de a sua aplicação ser considerada como erro. int

Restrições:
Valor mínimo = 0
Valor máximo = 100

ArmServiceTypeHealthPolicyMap

Nome Descrição Valor
{customized property} ArmServiceTypeHealthPolicy

ArmRollingUpgradeMonitoringPolicy

Nome Descrição Valor
failureAction O Modo de ativação do pacote de serviço "Manual"
"Reversão"
healthCheckRetryTimeout A quantidade de tempo para repetir a avaliação do estado de funcionamento quando a aplicação ou o cluster está em mau estado de funcionamento antes da execução de FailureAction. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string
healthCheckStableDuration O período de tempo durante o qual a aplicação ou cluster tem de permanecer em bom estado de funcionamento antes de a atualização avançar para o domínio de atualização seguinte. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string
healthCheckWaitDuration A quantidade de tempo a aguardar depois de concluir um domínio de atualização antes de aplicar políticas de estado de funcionamento. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string
upgradeDomainTimeout A quantidade de tempo que cada domínio de atualização tem de ser concluído antes da execução de FailureAction. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string
upgradeTimeout A quantidade de tempo que a atualização geral tem de ser concluída antes de FailureAction ser executada. É interpretada pela primeira vez como uma cadeia que representa uma duração ISO 8601. Se isso falhar, será interpretado como um número que representa o número total de milissegundos. string