Partilhar via

Clusters do Microsoft.ServiceFabric 2020-12-01-preview

  • Artigo

Definição de recursos do bíceps

O tipo de recurso de clusters pode ser implantado com operações que visam:

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

Formato do recurso

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

resource symbolicname 'Microsoft.ServiceFabric/clusters@2020-12-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    addOnFeatures: [
      'string'
    ]
    applicationTypeVersionsCleanupPolicy: {
      maxUnusedVersionsToKeep: int
    }
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
    }
    certificate: {
      thumbprint: 'string'
      thumbprintSecondary: 'string'
      x509StoreName: 'string'
    }
    certificateCommonNames: {
      commonNames: [
        {
          certificateCommonName: 'string'
          certificateIssuerThumbprint: 'string'
        }
      ]
      x509StoreName: 'string'
    }
    clientCertificateCommonNames: [
      {
        certificateCommonName: 'string'
        certificateIssuerThumbprint: 'string'
        isAdmin: bool
      }
    ]
    clientCertificateThumbprints: [
      {
        certificateThumbprint: 'string'
        isAdmin: bool
      }
    ]
    clusterCodeVersion: 'string'
    diagnosticsStorageAccountConfig: {
      blobEndpoint: 'string'
      protectedAccountKeyName: 'string'
      protectedAccountKeyName2: 'string'
      queueEndpoint: 'string'
      storageAccountName: 'string'
      tableEndpoint: 'string'
    }
    eventStoreServiceEnabled: bool
    fabricSettings: [
      {
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
      }
    ]
    managementEndpoint: 'string'
    nodeTypes: [
      {
        applicationPorts: {
          endPort: int
          startPort: int
        }
        capacities: {
          {customized property}: 'string'
        }
        clientConnectionEndpointPort: int
        durabilityLevel: 'string'
        ephemeralPorts: {
          endPort: int
          startPort: int
        }
        httpGatewayEndpointPort: int
        isPrimary: bool
        name: 'string'
        placementProperties: {
          {customized property}: 'string'
        }
        reverseProxyEndpointPort: int
        vmInstanceCount: int
      }
    ]
    reliabilityLevel: 'string'
    reverseProxyCertificate: {
      thumbprint: 'string'
      thumbprintSecondary: 'string'
      x509StoreName: 'string'
    }
    reverseProxyCertificateCommonNames: {
      commonNames: [
        {
          certificateCommonName: 'string'
          certificateIssuerThumbprint: 'string'
        }
      ]
      x509StoreName: 'string'
    }
    upgradeDescription: {
      deltaHealthPolicy: {
        applicationDeltaHealthPolicies: {
          {customized property}: {
            defaultServiceTypeDeltaHealthPolicy: {
              maxPercentDeltaUnhealthyServices: int
            }
            serviceTypeDeltaHealthPolicies: {
              {customized property}: {
                maxPercentDeltaUnhealthyServices: int
              }
            }
          }
        }
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
      }
      forceRestart: bool
      healthCheckRetryTimeout: 'string'
      healthCheckStableDuration: 'string'
      healthCheckWaitDuration: 'string'
      healthPolicy: {
        applicationHealthPolicies: {
          {customized property}: {
            defaultServiceTypeHealthPolicy: {
              maxPercentUnhealthyServices: int
            }
            serviceTypeHealthPolicies: {
              {customized property}: {
                maxPercentUnhealthyServices: int
              }
            }
          }
        }
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
      }
      upgradeDomainTimeout: 'string'
      upgradeReplicaSetCheckTimeout: 'string'
      upgradeTimeout: 'string'
    }
    upgradeMode: 'string'
    vmImage: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

ApplicationDeltaHealthPolicy

Designação Descrição Valor
defaultServiceTypeDeltaHealthPolicy A diretiva de integridade delta usada por padrão para avaliar a integridade de um tipo de serviço ao atualizar o cluster. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies O mapa com a política de integridade delta do tipo de serviço por nome de tipo de serviço. O mapa está vazio por padrão. ServiceTypeDeltaHealthPolicyMap

ApplicationDeltaHealthPolicyMap

Designação Descrição Valor

ApplicationHealthPolicy

Designação Descrição Valor
defaultServiceTypeHealthPolicy A política de integridade usada por padrão para avaliar a integridade de um tipo de serviço. ServiceTypeHealthPolicy
serviceTypeHealthPolicies O mapa com a política de integridade do tipo de serviço por nome de tipo de serviço. O mapa está vazio por padrão. ServiceTypeHealthPolicyMap

ApplicationHealthPolicyMap

Designação Descrição Valor

ApplicationTypeVersionsCleanupPolicy

Designação Descrição Valor
maxUnusedVersionsToKeep Número de versões não utilizadas por tipo de aplicativo a ser mantido. Int

Restrições:
Valor mínimo = 0 (obrigatório)

AzureActiveDirectory

Designação Descrição Valor
clienteAplicação ID do aplicativo cliente do Ative Directory do Azure. string
clusterAplicação ID do aplicativo de cluster do Ative Directory do Azure. string
inquilinoId ID do locatário do Ative Directory do Azure. string

CertificadoDescrição

Designação Descrição Valor
impressão digital Impressão digital do certificado principal. string (obrigatório)
impressão digitalSecundário Impressão digital do certificado secundário. string
x509StoreName O local do armazenamento de certificados local. 'Livro de Endereços'
'AuthRoot'
«Autoridade certificadora»
'Não permitido'
'Meu'
'Raiz'
'Pessoas de confiança'
'Editora confiável'

ClientCertificateCommonName

Designação Descrição Valor
certificadoCommonName O nome comum do certificado do cliente. string (obrigatório)
certificadoEmissor Impressão digital A impressão digital do emissor do certificado do cliente. string (obrigatório)
isAdmin Indica se o certificado do cliente tem acesso de administrador ao cluster. Os clientes não administradores podem executar apenas operações somente leitura no cluster. bool (obrigatório)

ClientCertificateImpressão digital

Designação Descrição Valor
certificadoImpressão digital A impressão digital do certificado do cliente. string (obrigatório)
isAdmin Indica se o certificado do cliente tem acesso de administrador ao cluster. Os clientes não administradores podem executar apenas operações somente leitura no cluster. bool (obrigatório)

ClusterHealthPolicy

Designação Descrição Valor
applicationHealthPolicies Define o mapa de política de integridade do aplicativo usado para avaliar a integridade de um aplicativo ou de uma de suas entidades filhas. ApplicationHealthPolicyMap
maxPercentUnhealthyApplications A porcentagem máxima permitida de aplicativos não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% de aplicativos não sejam íntegros, esse valor seria 10.

A porcentagem representa a porcentagem máxima tolerada de aplicativos que podem não estar íntegros antes que o cluster seja considerado errado.
Se a percentagem for respeitada, mas houver pelo menos uma aplicação insalubre, a saúde é avaliada como Aviso.
Isso é calculado dividindo o número de aplicativos não íntegros pelo número total de instâncias de aplicativo no cluster, excluindo aplicativos de tipos de aplicativo incluídos no ApplicationTypeHealthPolicyMap.
O cálculo arredonda para cima para tolerar uma falha em um pequeno número de aplicações. A percentagem por defeito é zero.		 Int

Restrições:
Valor mínimo = 0
Valor máximo = 100
maxPercentUnhealthyNodes A porcentagem máxima permitida de nós não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% dos nós não estejam íntegros, esse valor seria 10.

A porcentagem representa a porcentagem máxima tolerada de nós que podem não estar íntegros antes que o cluster seja considerado errado.
Se a porcentagem for respeitada, mas houver pelo menos um nó não íntegro, a integridade será avaliada como Aviso.
A porcentagem é calculada dividindo o número de nós não íntegros sobre o número total de nós no cluster.
O cálculo arredonda para cima para tolerar uma falha em pequenos números de nós. A percentagem por defeito é zero.

Em clusters grandes, alguns nós sempre estarão inativos ou fora para reparos, então essa porcentagem deve ser configurada para tolerar isso.		 Int

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

ClusterProperties

Designação Descrição Valor
addOnRecursos A lista de recursos complementares a serem habilitados no cluster. Matriz de cadeia de caracteres contendo qualquer uma das:
'BackupRestoreService'
'DnsService'
'Gestor de Reparações'
'ResourceMonitorService'
applicationTypeVersionsCleanupPolicy A política usada para limpar versões não utilizadas. ApplicationTypeVersionsCleanupPolicy
azureActiveDirectory As configurações de autenticação do AAD do cluster. AzureActiveDirectory
certificado O certificado a ser usado para proteger o cluster. O certificado fornecido será usado para segurança de nó a nó dentro do cluster, certificado SSL para ponto de extremidade de gerenciamento de cluster e cliente de administração padrão. CertificateDescription
certificadoCommonNames Descreve uma lista de certificados de servidor referenciados por nome comum que são usados para proteger o cluster. ServerCertificateCommonNames
clientCertificateCommonNames A lista de certificados de cliente referenciados por nome comum que têm permissão para gerenciar o cluster. ClientCertificateCommonName[]
clientCertificateImpressões digitais A lista de certificados de cliente referenciados pela impressão digital que têm permissão para gerenciar o cluster. ClientCertificateThumbprint[]
clusterCodeVersion A versão de tempo de execução do Service Fabric do cluster. Esta propriedade só pode definir o usuário quando upgradeMode estiver definido como 'Manual'. Para obter uma lista de versões disponíveis do Service Fabric para novos clusters, use API ClusterVersion. Para obter a lista de versões disponíveis para clusters existentes, use availableClusterVersions. string
diagnosticsStorageAccountConfig As informações da conta de armazenamento para armazenar logs de diagnóstico do Service Fabric. DiagnosticsStorageAccountConfig
eventStoreServiceEnabled Indica se o serviço de armazenamento de eventos está habilitado. Bool
fabricSettings A lista de configurações de malha personalizada para configurar o cluster. ConfiguraçõesSecçãoDescrição[]
managementEndpoint O ponto de extremidade de gerenciamento http do cluster. string (obrigatório)
nodeTypes A lista de tipos de nó no cluster. NodeTypeDescription[] (obrigatório)
fiabilidadeNível O nível de confiabilidade define o tamanho do conjunto de réplicas dos serviços do sistema. Saiba mais sobre ConfiabilidadeNível.

- Nenhum - Execute os serviços do sistema com uma contagem de conjunto de réplicas de destino de 1. Isso só deve ser usado para clusters de teste.
- Bronze - Execute os serviços do sistema com uma contagem de conjuntos de réplicas de destino de 3. Isso só deve ser usado para clusters de teste.
- Prata - Execute os serviços do sistema com uma contagem de conjuntos de réplicas de destino de 5.
- Gold - Execute os serviços do sistema com uma contagem de conjuntos de réplicas de destino de 7.
- Platinum - Execute os serviços do sistema com uma contagem de conjuntos de réplicas alvo de 9.		 'Bronze'
'Ouro'
'Nenhuma'
'Platina'
'Prata'
reverseProxyCertificate O certificado do servidor usado pelo proxy reverso. CertificateDescription
reverseProxyCertificateCommonNames Descreve uma lista de certificados de servidor referenciados por nome comum que são usados para proteger o cluster. ServerCertificateCommonNames
upgradeDescrição A política a ser usada ao atualizar o cluster. ClusterUpgradePolicy
upgradeMode O modo de atualização do cluster quando a nova versão de tempo de execução do Service Fabric estiver disponível.

- Automático - O cluster será atualizado automaticamente para a versão mais recente do tempo de execução do Service Fabric assim que estiver disponível.
- Manual - O cluster não será atualizado automaticamente para a versão mais recente do tempo de execução do Service Fabric. O cluster é atualizado definindo a propriedade clusterCodeVersion no recurso de cluster.		 'Automático'
'Manual'
vmImage [en] A imagem VM VMSS foi configurada com. Nomes genéricos como Windows ou Linux podem ser usados. string

ClusterUpgradeDeltaHealthPolicy

Designação Descrição Valor
applicationDeltaHealthPolicies Define o mapa de diretiva de integridade delta do aplicativo usado para avaliar a integridade de um aplicativo ou de uma de suas entidades filhas ao atualizar o cluster. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications A porcentagem máxima permitida de degradação da integridade dos aplicativos permitida durante as atualizações de cluster.
O delta é medido entre o estado dos aplicativos no início da atualização e o estado dos aplicativos no momento da avaliação de integridade.
A verificação é realizada após a conclusão de cada atualização de domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados. Os serviços do sistema não estão incluídos neste.		 Int

Restrições:
Valor mínimo = 0
Valor máximo = 100 (obrigatório)
maxPercentDeltaUnhealthyNodes A porcentagem máxima permitida de degradação da integridade dos nós permitida durante as atualizações de cluster.
O delta é medido entre o estado dos nós no início da atualização e o estado dos nós no momento da avaliação de integridade.
A verificação é realizada após a conclusão de cada atualização de domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados.		 Int

Restrições:
Valor mínimo = 0
Valor máximo = 100 (obrigatório)
maxPercentUpgradeDomainDeltaUnhealthyNodes A porcentagem máxima permitida de degradação da integridade dos nós de domínio de atualização permitida durante as atualizações de cluster.
O delta é medido entre o estado dos nós de domínio de atualização no início da atualização e o estado dos nós de domínio de atualização no momento da avaliação de integridade.
A verificação é realizada após cada conclusão de atualização de domínio para todos os domínios de atualização concluídos para garantir que o estado dos domínios de atualização esteja dentro dos limites tolerados.		 Int

Restrições:
Valor mínimo = 0
Valor máximo = 100 (obrigatório)

ClusterUpgradePolicy

Designação Descrição Valor
deltaHealthPolicy A diretiva de integridade delta do cluster usada ao atualizar o cluster. ClusterUpgradeDeltaHealthPolicy
forceRestart Se verdadeiro, os processos são reiniciados à força durante a atualização, mesmo quando a versão do código não foi alterada (a atualização apenas altera a configuração ou os dados). Bool
healthCheckRetryTimeout A quantidade de tempo para repetir a avaliação de integridade quando o aplicativo ou cluster não está íntegro antes que a atualização seja revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. string (obrigatório)
healthCheckStableDuration A quantidade de tempo que o aplicativo ou cluster deve permanecer íntegro antes que a atualização prossiga para o próximo domínio de atualização. A duração pode ser no formato hh:mm:ss ou d.hh:mm:ss.ms. string (obrigatório)
healthCheckWaitDuration O período de tempo de espera após a conclusão de um domínio de atualização antes de executar verificações de integridade. A duração pode ser no formato hh:mm:ss ou d.hh:mm:ss.ms. string (obrigatório)
Política de saúde A diretiva de integridade do cluster usada ao atualizar o cluster. ClusterHealthPolicy (obrigatório)
upgradeDomainTimeout A quantidade de tempo que cada domínio de atualização tem que ser concluído antes que a atualização seja revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. string (obrigatório)
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 há problemas inesperados. Quando esse tempo limite expirar, o processamento do domínio de atualização prosseguirá independentemente de problemas de perda de disponibilidade. O tempo limite é redefinido no início de cada domínio de atualização. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. string (obrigatório)
upgradeTimeout A quantidade de tempo que a atualização geral tem que ser concluída antes que a atualização seja revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. string (obrigatório)

DiagnosticsStorageAccountConfig

Designação Descrição Valor
blobEndpoint O ponto de extremidade de blob da conta de armazenamento azure. string (obrigatório)
protectedAccountKeyName O nome da chave de armazenamento de diagnóstico protegido. string (obrigatório)
protectedAccountKeyName2 O nome da chave de armazenamento de diagnóstico secundário protegido. Se uma das chaves da conta de armazenamento for girada, o cluster voltará a usar a outra. string
queueEndpoint O ponto de extremidade da fila da conta de armazenamento azure. string (obrigatório)
storageAccountName O nome da conta de armazenamento do Azure. string (obrigatório)
tableEndpoint O ponto de extremidade da tabela da conta de armazenamento azure. string (obrigatório)

EndpointRangeDescrição

Designação Descrição Valor
endPort [en] Porta final de um intervalo de portas int (obrigatório)
startPort Porta inicial de uma variedade de portas int (obrigatório)

Microsoft.ServiceFabric/clusters

Designação Descrição Valor
Localização Local do recurso do Azure. string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades As propriedades do recurso de cluster ClusterProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

NodeTypeDescription

Designação Descrição Valor
applicationPorts O intervalo de portas a partir do qual o cluster atribuiu porta a aplicativos do Service Fabric. EndpointRangeDescription
capacidades As tags de capacidade aplicadas aos nós no tipo de nó, o gerenciador de recursos de cluster usa essas tags para entender quanto recurso um nó tem. NodeTypeDescriptionCapacities
clientConnectionEndpointPort A porta do ponto de extremidade de gerenciamento de cluster TCP. int (obrigatório)
nível de durabilidade O nível de durabilidade do tipo de nó. Saiba mais sobre DurabilityLevel.

- Bronze - Sem privilégios. Este é o padrão.
- Prata - Os trabalhos de infraestrutura podem ser pausados por uma duração de 10 minutos por UD.
- Ouro - Os trabalhos de infraestrutura podem ser pausados por uma duração de 2 horas por UD. A durabilidade Gold pode ser ativada apenas em skus VM de nó completo como D15_V2, G5 etc.		 'Bronze'
'Ouro'
'Prata'
ephemeralPorts O intervalo de portas efêmeras com o qual os nós nesse tipo de nó devem ser configurados. EndpointRangeDescription
httpGatewayEndpointPort A porta do ponto de extremidade de gerenciamento de cluster HTTP. int (obrigatório)
isPrimário O tipo de nó no qual os serviços do sistema serão executados. Apenas um tipo de nó deve ser marcado como primário. O tipo de nó primário não pode ser excluído ou alterado para clusters existentes. bool (obrigatório)
Designação O nome do tipo de nó. string (obrigatório)
placementPropriedades As tags de posicionamento aplicadas aos nós no tipo de nó, que podem ser usadas para indicar onde determinados serviços (carga de trabalho) devem ser executados. NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort O ponto de extremidade usado pelo proxy reverso. Int
vmInstanceCount O número de nós no tipo de nó. Essa contagem deve corresponder à propriedade capacity no recurso VirtualMachineScaleSet correspondente. Int

Restrições:
Valor mínimo = 1
Valor máximo = 2147483647 (obrigatório)

NodeTypeDescriptionCapacities

Designação Descrição Valor

NodeTypeDescriptionPlacementProperties

Designação Descrição Valor

Tags de Recursos

Designação Descrição Valor

ServerCertificateCommonName

Designação Descrição Valor
certificadoCommonName O nome comum do certificado do servidor. string (obrigatório)
certificadoEmissor Impressão digital A impressão digital do emissor do certificado do servidor. string (obrigatório)

ServerCertificateCommonNames

Designação Descrição Valor
nomes comuns A lista de certificados de servidor referenciados por nome comum que são usados para proteger o cluster. ServerCertificateCommonName[]
x509StoreName O local do armazenamento de certificados local. 'Livro de Endereços'
'AuthRoot'
«Autoridade certificadora»
'Não permitido'
'Meu'
'Raiz'
'Pessoas de confiança'
'Editora confiável'

ServiceTypeDeltaHealthPolicy

Designação Descrição Valor
maxPercentDeltaUnhealthyServices A porcentagem máxima permitida de degradação da integridade dos serviços permitida durante as atualizações de cluster.
O delta é medido entre o estado dos serviços no início da atualização e o estado dos serviços no momento da avaliação de saúde.
A verificação é realizada após a conclusão de cada atualização de domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados.		 Int

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

ServiceTypeDeltaHealthPolicyMap

Designação Descrição Valor

ServiceTypeHealthPolicy

Designação Descrição Valor
maxPercentUnhealthyServices A porcentagem máxima de serviços permitidos como não íntegros antes que seu aplicativo seja considerado errado. Int

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

ServiceTypeHealthPolicyMap

Designação Descrição Valor

SettingsParameterDescription

Designação Descrição Valor
Designação O nome do parâmetro da configuração de malha. string (obrigatório)
valor O valor do parâmetro da configuração de malha. string (obrigatório)

ConfiguraçõesSecçãoDescrição

Designação Descrição Valor
Designação O nome da seção das configurações de malha. string (obrigatório)
Parâmetros A coleção de parâmetros na seção. SettingsParameterDescription[] (obrigatório)

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
implantar um de cluster seguro de 5 nós Este modelo permite implantar um cluster seguro de 5 nós do Service Fabric executando o Windows Server 2019 Datacenter em um VMSS de tamanho Standard_D2_v2.

Definição de recurso de modelo ARM

O tipo de recurso de clusters pode ser implantado com operações que visam:

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

Formato do recurso

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

{
  "type": "Microsoft.ServiceFabric/clusters",
  "apiVersion": "2020-12-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "addOnFeatures": [ "string" ],
    "applicationTypeVersionsCleanupPolicy": {
      "maxUnusedVersionsToKeep": "int"
    },
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string"
    },
    "certificate": {
      "thumbprint": "string",
      "thumbprintSecondary": "string",
      "x509StoreName": "string"
    },
    "certificateCommonNames": {
      "commonNames": [
        {
          "certificateCommonName": "string",
          "certificateIssuerThumbprint": "string"
        }
      ],
      "x509StoreName": "string"
    },
    "clientCertificateCommonNames": [
      {
        "certificateCommonName": "string",
        "certificateIssuerThumbprint": "string",
        "isAdmin": "bool"
      }
    ],
    "clientCertificateThumbprints": [
      {
        "certificateThumbprint": "string",
        "isAdmin": "bool"
      }
    ],
    "clusterCodeVersion": "string",
    "diagnosticsStorageAccountConfig": {
      "blobEndpoint": "string",
      "protectedAccountKeyName": "string",
      "protectedAccountKeyName2": "string",
      "queueEndpoint": "string",
      "storageAccountName": "string",
      "tableEndpoint": "string"
    },
    "eventStoreServiceEnabled": "bool",
    "fabricSettings": [
      {
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ]
      }
    ],
    "managementEndpoint": "string",
    "nodeTypes": [
      {
        "applicationPorts": {
          "endPort": "int",
          "startPort": "int"
        },
        "capacities": {
          "{customized property}": "string"
        },
        "clientConnectionEndpointPort": "int",
        "durabilityLevel": "string",
        "ephemeralPorts": {
          "endPort": "int",
          "startPort": "int"
        },
        "httpGatewayEndpointPort": "int",
        "isPrimary": "bool",
        "name": "string",
        "placementProperties": {
          "{customized property}": "string"
        },
        "reverseProxyEndpointPort": "int",
        "vmInstanceCount": "int"
      }
    ],
    "reliabilityLevel": "string",
    "reverseProxyCertificate": {
      "thumbprint": "string",
      "thumbprintSecondary": "string",
      "x509StoreName": "string"
    },
    "reverseProxyCertificateCommonNames": {
      "commonNames": [
        {
          "certificateCommonName": "string",
          "certificateIssuerThumbprint": "string"
        }
      ],
      "x509StoreName": "string"
    },
    "upgradeDescription": {
      "deltaHealthPolicy": {
        "applicationDeltaHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeDeltaHealthPolicy": {
              "maxPercentDeltaUnhealthyServices": "int"
            },
            "serviceTypeDeltaHealthPolicies": {
              "{customized property}": {
                "maxPercentDeltaUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
      },
      "forceRestart": "bool",
      "healthCheckRetryTimeout": "string",
      "healthCheckStableDuration": "string",
      "healthCheckWaitDuration": "string",
      "healthPolicy": {
        "applicationHealthPolicies": {
          "{customized property}": {
            "defaultServiceTypeHealthPolicy": {
              "maxPercentUnhealthyServices": "int"
            },
            "serviceTypeHealthPolicies": {
              "{customized property}": {
                "maxPercentUnhealthyServices": "int"
              }
            }
          }
        },
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int"
      },
      "upgradeDomainTimeout": "string",
      "upgradeReplicaSetCheckTimeout": "string",
      "upgradeTimeout": "string"
    },
    "upgradeMode": "string",
    "vmImage": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

ApplicationDeltaHealthPolicy

Designação Descrição Valor
defaultServiceTypeDeltaHealthPolicy A diretiva de integridade delta usada por padrão para avaliar a integridade de um tipo de serviço ao atualizar o cluster. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies O mapa com a política de integridade delta do tipo de serviço por nome de tipo de serviço. O mapa está vazio por padrão. ServiceTypeDeltaHealthPolicyMap

ApplicationDeltaHealthPolicyMap

Designação Descrição Valor

ApplicationHealthPolicy

Designação Descrição Valor
defaultServiceTypeHealthPolicy A política de integridade usada por padrão para avaliar a integridade de um tipo de serviço. ServiceTypeHealthPolicy
serviceTypeHealthPolicies O mapa com a política de integridade do tipo de serviço por nome de tipo de serviço. O mapa está vazio por padrão. ServiceTypeHealthPolicyMap

ApplicationHealthPolicyMap

Designação Descrição Valor

ApplicationTypeVersionsCleanupPolicy

Designação Descrição Valor
maxUnusedVersionsToKeep Número de versões não utilizadas por tipo de aplicativo a ser mantido. Int

Restrições:
Valor mínimo = 0 (obrigatório)

AzureActiveDirectory

Designação Descrição Valor
clienteAplicação ID do aplicativo cliente do Ative Directory do Azure. string
clusterAplicação ID do aplicativo de cluster do Ative Directory do Azure. string
inquilinoId ID do locatário do Ative Directory do Azure. string

CertificadoDescrição

Designação Descrição Valor
impressão digital Impressão digital do certificado principal. string (obrigatório)
impressão digitalSecundário Impressão digital do certificado secundário. string
x509StoreName O local do armazenamento de certificados local. 'Livro de Endereços'
'AuthRoot'
«Autoridade certificadora»
'Não permitido'
'Meu'
'Raiz'
'Pessoas de confiança'
'Editora confiável'

ClientCertificateCommonName

Designação Descrição Valor
certificadoCommonName O nome comum do certificado do cliente. string (obrigatório)
certificadoEmissor Impressão digital A impressão digital do emissor do certificado do cliente. string (obrigatório)
isAdmin Indica se o certificado do cliente tem acesso de administrador ao cluster. Os clientes não administradores podem executar apenas operações somente leitura no cluster. bool (obrigatório)

ClientCertificateImpressão digital

Designação Descrição Valor
certificadoImpressão digital A impressão digital do certificado do cliente. string (obrigatório)
isAdmin Indica se o certificado do cliente tem acesso de administrador ao cluster. Os clientes não administradores podem executar apenas operações somente leitura no cluster. bool (obrigatório)

ClusterHealthPolicy

Designação Descrição Valor
applicationHealthPolicies Define o mapa de política de integridade do aplicativo usado para avaliar a integridade de um aplicativo ou de uma de suas entidades filhas. ApplicationHealthPolicyMap
maxPercentUnhealthyApplications A porcentagem máxima permitida de aplicativos não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% de aplicativos não sejam íntegros, esse valor seria 10.

A porcentagem representa a porcentagem máxima tolerada de aplicativos que podem não estar íntegros antes que o cluster seja considerado errado.
Se a percentagem for respeitada, mas houver pelo menos uma aplicação insalubre, a saúde é avaliada como Aviso.
Isso é calculado dividindo o número de aplicativos não íntegros pelo número total de instâncias de aplicativo no cluster, excluindo aplicativos de tipos de aplicativo incluídos no ApplicationTypeHealthPolicyMap.
O cálculo arredonda para cima para tolerar uma falha em um pequeno número de aplicações. A percentagem por defeito é zero.		 Int

Restrições:
Valor mínimo = 0
Valor máximo = 100
maxPercentUnhealthyNodes A porcentagem máxima permitida de nós não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% dos nós não estejam íntegros, esse valor seria 10.

A porcentagem representa a porcentagem máxima tolerada de nós que podem não estar íntegros antes que o cluster seja considerado errado.
Se a porcentagem for respeitada, mas houver pelo menos um nó não íntegro, a integridade será avaliada como Aviso.
A porcentagem é calculada dividindo o número de nós não íntegros sobre o número total de nós no cluster.
O cálculo arredonda para cima para tolerar uma falha em pequenos números de nós. A percentagem por defeito é zero.

Em clusters grandes, alguns nós sempre estarão inativos ou fora para reparos, então essa porcentagem deve ser configurada para tolerar isso.		 Int

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

ClusterProperties

Designação Descrição Valor
addOnRecursos A lista de recursos complementares a serem habilitados no cluster. Matriz de cadeia de caracteres contendo qualquer uma das:
'BackupRestoreService'
'DnsService'
'Gestor de Reparações'
'ResourceMonitorService'
applicationTypeVersionsCleanupPolicy A política usada para limpar versões não utilizadas. ApplicationTypeVersionsCleanupPolicy
azureActiveDirectory As configurações de autenticação do AAD do cluster. AzureActiveDirectory
certificado O certificado a ser usado para proteger o cluster. O certificado fornecido será usado para segurança de nó a nó dentro do cluster, certificado SSL para ponto de extremidade de gerenciamento de cluster e cliente de administração padrão. CertificateDescription
certificadoCommonNames Descreve uma lista de certificados de servidor referenciados por nome comum que são usados para proteger o cluster. ServerCertificateCommonNames
clientCertificateCommonNames A lista de certificados de cliente referenciados por nome comum que têm permissão para gerenciar o cluster. ClientCertificateCommonName[]
clientCertificateImpressões digitais A lista de certificados de cliente referenciados pela impressão digital que têm permissão para gerenciar o cluster. ClientCertificateThumbprint[]
clusterCodeVersion A versão de tempo de execução do Service Fabric do cluster. Esta propriedade só pode definir o usuário quando upgradeMode estiver definido como 'Manual'. Para obter uma lista de versões disponíveis do Service Fabric para novos clusters, use API ClusterVersion. Para obter a lista de versões disponíveis para clusters existentes, use availableClusterVersions. string
diagnosticsStorageAccountConfig As informações da conta de armazenamento para armazenar logs de diagnóstico do Service Fabric. DiagnosticsStorageAccountConfig
eventStoreServiceEnabled Indica se o serviço de armazenamento de eventos está habilitado. Bool
fabricSettings A lista de configurações de malha personalizada para configurar o cluster. ConfiguraçõesSecçãoDescrição[]
managementEndpoint O ponto de extremidade de gerenciamento http do cluster. string (obrigatório)
nodeTypes A lista de tipos de nó no cluster. NodeTypeDescription[] (obrigatório)
fiabilidadeNível O nível de confiabilidade define o tamanho do conjunto de réplicas dos serviços do sistema. Saiba mais sobre ConfiabilidadeNível.

- Nenhum - Execute os serviços do sistema com uma contagem de conjunto de réplicas de destino de 1. Isso só deve ser usado para clusters de teste.
- Bronze - Execute os serviços do sistema com uma contagem de conjuntos de réplicas de destino de 3. Isso só deve ser usado para clusters de teste.
- Prata - Execute os serviços do sistema com uma contagem de conjuntos de réplicas de destino de 5.
- Gold - Execute os serviços do sistema com uma contagem de conjuntos de réplicas de destino de 7.
- Platinum - Execute os serviços do sistema com uma contagem de conjuntos de réplicas alvo de 9.		 'Bronze'
'Ouro'
'Nenhuma'
'Platina'
'Prata'
reverseProxyCertificate O certificado do servidor usado pelo proxy reverso. CertificateDescription
reverseProxyCertificateCommonNames Descreve uma lista de certificados de servidor referenciados por nome comum que são usados para proteger o cluster. ServerCertificateCommonNames
upgradeDescrição A política a ser usada ao atualizar o cluster. ClusterUpgradePolicy
upgradeMode O modo de atualização do cluster quando a nova versão de tempo de execução do Service Fabric estiver disponível.

- Automático - O cluster será atualizado automaticamente para a versão mais recente do tempo de execução do Service Fabric assim que estiver disponível.
- Manual - O cluster não será atualizado automaticamente para a versão mais recente do tempo de execução do Service Fabric. O cluster é atualizado definindo a propriedade clusterCodeVersion no recurso de cluster.		 'Automático'
'Manual'
vmImage [en] A imagem VM VMSS foi configurada com. Nomes genéricos como Windows ou Linux podem ser usados. string

ClusterUpgradeDeltaHealthPolicy

Designação Descrição Valor
applicationDeltaHealthPolicies Define o mapa de diretiva de integridade delta do aplicativo usado para avaliar a integridade de um aplicativo ou de uma de suas entidades filhas ao atualizar o cluster. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications A porcentagem máxima permitida de degradação da integridade dos aplicativos permitida durante as atualizações de cluster.
O delta é medido entre o estado dos aplicativos no início da atualização e o estado dos aplicativos no momento da avaliação de integridade.
A verificação é realizada após a conclusão de cada atualização de domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados. Os serviços do sistema não estão incluídos neste.		 Int

Restrições:
Valor mínimo = 0
Valor máximo = 100 (obrigatório)
maxPercentDeltaUnhealthyNodes A porcentagem máxima permitida de degradação da integridade dos nós permitida durante as atualizações de cluster.
O delta é medido entre o estado dos nós no início da atualização e o estado dos nós no momento da avaliação de integridade.
A verificação é realizada após a conclusão de cada atualização de domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados.		 Int

Restrições:
Valor mínimo = 0
Valor máximo = 100 (obrigatório)
maxPercentUpgradeDomainDeltaUnhealthyNodes A porcentagem máxima permitida de degradação da integridade dos nós de domínio de atualização permitida durante as atualizações de cluster.
O delta é medido entre o estado dos nós de domínio de atualização no início da atualização e o estado dos nós de domínio de atualização no momento da avaliação de integridade.
A verificação é realizada após cada conclusão de atualização de domínio para todos os domínios de atualização concluídos para garantir que o estado dos domínios de atualização esteja dentro dos limites tolerados.		 Int

Restrições:
Valor mínimo = 0
Valor máximo = 100 (obrigatório)

ClusterUpgradePolicy

Designação Descrição Valor
deltaHealthPolicy A diretiva de integridade delta do cluster usada ao atualizar o cluster. ClusterUpgradeDeltaHealthPolicy
forceRestart Se verdadeiro, os processos são reiniciados à força durante a atualização, mesmo quando a versão do código não foi alterada (a atualização apenas altera a configuração ou os dados). Bool
healthCheckRetryTimeout A quantidade de tempo para repetir a avaliação de integridade quando o aplicativo ou cluster não está íntegro antes que a atualização seja revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. string (obrigatório)
healthCheckStableDuration A quantidade de tempo que o aplicativo ou cluster deve permanecer íntegro antes que a atualização prossiga para o próximo domínio de atualização. A duração pode ser no formato hh:mm:ss ou d.hh:mm:ss.ms. string (obrigatório)
healthCheckWaitDuration O período de tempo de espera após a conclusão de um domínio de atualização antes de executar verificações de integridade. A duração pode ser no formato hh:mm:ss ou d.hh:mm:ss.ms. string (obrigatório)
Política de saúde A diretiva de integridade do cluster usada ao atualizar o cluster. ClusterHealthPolicy (obrigatório)
upgradeDomainTimeout A quantidade de tempo que cada domínio de atualização tem que ser concluído antes que a atualização seja revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. string (obrigatório)
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 há problemas inesperados. Quando esse tempo limite expirar, o processamento do domínio de atualização prosseguirá independentemente de problemas de perda de disponibilidade. O tempo limite é redefinido no início de cada domínio de atualização. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. string (obrigatório)
upgradeTimeout A quantidade de tempo que a atualização geral tem que ser concluída antes que a atualização seja revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. string (obrigatório)

DiagnosticsStorageAccountConfig

Designação Descrição Valor
blobEndpoint O ponto de extremidade de blob da conta de armazenamento azure. string (obrigatório)
protectedAccountKeyName O nome da chave de armazenamento de diagnóstico protegido. string (obrigatório)
protectedAccountKeyName2 O nome da chave de armazenamento de diagnóstico secundário protegido. Se uma das chaves da conta de armazenamento for girada, o cluster voltará a usar a outra. string
queueEndpoint O ponto de extremidade da fila da conta de armazenamento azure. string (obrigatório)
storageAccountName O nome da conta de armazenamento do Azure. string (obrigatório)
tableEndpoint O ponto de extremidade da tabela da conta de armazenamento azure. string (obrigatório)

EndpointRangeDescrição

Designação Descrição Valor
endPort [en] Porta final de um intervalo de portas int (obrigatório)
startPort Porta inicial de uma variedade de portas int (obrigatório)

Microsoft.ServiceFabric/clusters

Designação Descrição Valor
apiVersion A versão api '2020-12-01-pré-visualização'
Localização Local do recurso do Azure. string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades As propriedades do recurso de cluster ClusterProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.ServiceFabric/clusters'

NodeTypeDescription

Designação Descrição Valor
applicationPorts O intervalo de portas a partir do qual o cluster atribuiu porta a aplicativos do Service Fabric. EndpointRangeDescription
capacidades As tags de capacidade aplicadas aos nós no tipo de nó, o gerenciador de recursos de cluster usa essas tags para entender quanto recurso um nó tem. NodeTypeDescriptionCapacities
clientConnectionEndpointPort A porta do ponto de extremidade de gerenciamento de cluster TCP. int (obrigatório)
nível de durabilidade O nível de durabilidade do tipo de nó. Saiba mais sobre DurabilityLevel.

- Bronze - Sem privilégios. Este é o padrão.
- Prata - Os trabalhos de infraestrutura podem ser pausados por uma duração de 10 minutos por UD.
- Ouro - Os trabalhos de infraestrutura podem ser pausados por uma duração de 2 horas por UD. A durabilidade Gold pode ser ativada apenas em skus VM de nó completo como D15_V2, G5 etc.		 'Bronze'
'Ouro'
'Prata'
ephemeralPorts O intervalo de portas efêmeras com o qual os nós nesse tipo de nó devem ser configurados. EndpointRangeDescription
httpGatewayEndpointPort A porta do ponto de extremidade de gerenciamento de cluster HTTP. int (obrigatório)
isPrimário O tipo de nó no qual os serviços do sistema serão executados. Apenas um tipo de nó deve ser marcado como primário. O tipo de nó primário não pode ser excluído ou alterado para clusters existentes. bool (obrigatório)
Designação O nome do tipo de nó. string (obrigatório)
placementPropriedades As tags de posicionamento aplicadas aos nós no tipo de nó, que podem ser usadas para indicar onde determinados serviços (carga de trabalho) devem ser executados. NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort O ponto de extremidade usado pelo proxy reverso. Int
vmInstanceCount O número de nós no tipo de nó. Essa contagem deve corresponder à propriedade capacity no recurso VirtualMachineScaleSet correspondente. Int

Restrições:
Valor mínimo = 1
Valor máximo = 2147483647 (obrigatório)

NodeTypeDescriptionCapacities

Designação Descrição Valor

NodeTypeDescriptionPlacementProperties

Designação Descrição Valor

Tags de Recursos

Designação Descrição Valor

ServerCertificateCommonName

Designação Descrição Valor
certificadoCommonName O nome comum do certificado do servidor. string (obrigatório)
certificadoEmissor Impressão digital A impressão digital do emissor do certificado do servidor. string (obrigatório)

ServerCertificateCommonNames

Designação Descrição Valor
nomes comuns A lista de certificados de servidor referenciados por nome comum que são usados para proteger o cluster. ServerCertificateCommonName[]
x509StoreName O local do armazenamento de certificados local. 'Livro de Endereços'
'AuthRoot'
«Autoridade certificadora»
'Não permitido'
'Meu'
'Raiz'
'Pessoas de confiança'
'Editora confiável'

ServiceTypeDeltaHealthPolicy

Designação Descrição Valor
maxPercentDeltaUnhealthyServices A porcentagem máxima permitida de degradação da integridade dos serviços permitida durante as atualizações de cluster.
O delta é medido entre o estado dos serviços no início da atualização e o estado dos serviços no momento da avaliação de saúde.
A verificação é realizada após a conclusão de cada atualização de domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados.		 Int

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

ServiceTypeDeltaHealthPolicyMap

Designação Descrição Valor

ServiceTypeHealthPolicy

Designação Descrição Valor
maxPercentUnhealthyServices A porcentagem máxima de serviços permitidos como não íntegros antes que seu aplicativo seja considerado errado. Int

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

ServiceTypeHealthPolicyMap

Designação Descrição Valor

SettingsParameterDescription

Designação Descrição Valor
Designação O nome do parâmetro da configuração de malha. string (obrigatório)
valor O valor do parâmetro da configuração de malha. string (obrigatório)

ConfiguraçõesSecçãoDescrição

Designação Descrição Valor
Designação O nome da seção das configurações de malha. string (obrigatório)
Parâmetros A coleção de parâmetros na seção. SettingsParameterDescription[] (obrigatório)

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Implantar um cluster seguro de 3 tipos de nós com NSGs habilitados

Implantar no Azure 		Este modelo permite implantar um cluster seguro de 3 nós do Service Fabric executando o Windows Server 2016 Data center em VMs de tamanho Standard_D2. O uso deste modelo permite controlar o tráfego de rede de entrada e saída usando os Grupos de Segurança de Rede.
implantar um de cluster seguro de 5 nós

Implantar no Azure 		Este modelo permite implantar um cluster seguro de 5 nós do Service Fabric executando o Windows Server 2019 Datacenter em um VMSS de tamanho Standard_D2_v2.
implantar um cluster de 5 nós do Ubuntu Service Fabric

Implantar no Azure 		Este modelo permite que você implante um cluster seguro de 5 nós do Service Fabric executando o Ubuntu em um VMSS de tamanho Standard_D2_V2.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso de clusters pode ser implantado com operações que visam:

  • Grupos de recursos

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

Formato do recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/clusters@2020-12-01-preview"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      addOnFeatures = [
        "string"
      ]
      applicationTypeVersionsCleanupPolicy = {
        maxUnusedVersionsToKeep = int
      }
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
      }
      certificate = {
        thumbprint = "string"
        thumbprintSecondary = "string"
        x509StoreName = "string"
      }
      certificateCommonNames = {
        commonNames = [
          {
            certificateCommonName = "string"
            certificateIssuerThumbprint = "string"
          }
        ]
        x509StoreName = "string"
      }
      clientCertificateCommonNames = [
        {
          certificateCommonName = "string"
          certificateIssuerThumbprint = "string"
          isAdmin = bool
        }
      ]
      clientCertificateThumbprints = [
        {
          certificateThumbprint = "string"
          isAdmin = bool
        }
      ]
      clusterCodeVersion = "string"
      diagnosticsStorageAccountConfig = {
        blobEndpoint = "string"
        protectedAccountKeyName = "string"
        protectedAccountKeyName2 = "string"
        queueEndpoint = "string"
        storageAccountName = "string"
        tableEndpoint = "string"
      }
      eventStoreServiceEnabled = bool
      fabricSettings = [
        {
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
        }
      ]
      managementEndpoint = "string"
      nodeTypes = [
        {
          applicationPorts = {
            endPort = int
            startPort = int
          }
          capacities = {
            {customized property} = "string"
          }
          clientConnectionEndpointPort = int
          durabilityLevel = "string"
          ephemeralPorts = {
            endPort = int
            startPort = int
          }
          httpGatewayEndpointPort = int
          isPrimary = bool
          name = "string"
          placementProperties = {
            {customized property} = "string"
          }
          reverseProxyEndpointPort = int
          vmInstanceCount = int
        }
      ]
      reliabilityLevel = "string"
      reverseProxyCertificate = {
        thumbprint = "string"
        thumbprintSecondary = "string"
        x509StoreName = "string"
      }
      reverseProxyCertificateCommonNames = {
        commonNames = [
          {
            certificateCommonName = "string"
            certificateIssuerThumbprint = "string"
          }
        ]
        x509StoreName = "string"
      }
      upgradeDescription = {
        deltaHealthPolicy = {
          applicationDeltaHealthPolicies = {
            {customized property} = {
              defaultServiceTypeDeltaHealthPolicy = {
                maxPercentDeltaUnhealthyServices = int
              }
              serviceTypeDeltaHealthPolicies = {
                {customized property} = {
                  maxPercentDeltaUnhealthyServices = int
                }
              }
            }
          }
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
        }
        forceRestart = bool
        healthCheckRetryTimeout = "string"
        healthCheckStableDuration = "string"
        healthCheckWaitDuration = "string"
        healthPolicy = {
          applicationHealthPolicies = {
            {customized property} = {
              defaultServiceTypeHealthPolicy = {
                maxPercentUnhealthyServices = int
              }
              serviceTypeHealthPolicies = {
                {customized property} = {
                  maxPercentUnhealthyServices = int
                }
              }
            }
          }
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
        }
        upgradeDomainTimeout = "string"
        upgradeReplicaSetCheckTimeout = "string"
        upgradeTimeout = "string"
      }
      upgradeMode = "string"
      vmImage = "string"
    }
  })
}

Valores de propriedade

ApplicationDeltaHealthPolicy

Designação Descrição Valor
defaultServiceTypeDeltaHealthPolicy A diretiva de integridade delta usada por padrão para avaliar a integridade de um tipo de serviço ao atualizar o cluster. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies O mapa com a política de integridade delta do tipo de serviço por nome de tipo de serviço. O mapa está vazio por padrão. ServiceTypeDeltaHealthPolicyMap

ApplicationDeltaHealthPolicyMap

Designação Descrição Valor

ApplicationHealthPolicy

Designação Descrição Valor
defaultServiceTypeHealthPolicy A política de integridade usada por padrão para avaliar a integridade de um tipo de serviço. ServiceTypeHealthPolicy
serviceTypeHealthPolicies O mapa com a política de integridade do tipo de serviço por nome de tipo de serviço. O mapa está vazio por padrão. ServiceTypeHealthPolicyMap

ApplicationHealthPolicyMap

Designação Descrição Valor

ApplicationTypeVersionsCleanupPolicy

Designação Descrição Valor
maxUnusedVersionsToKeep Número de versões não utilizadas por tipo de aplicativo a ser mantido. Int

Restrições:
Valor mínimo = 0 (obrigatório)

AzureActiveDirectory

Designação Descrição Valor
clienteAplicação ID do aplicativo cliente do Ative Directory do Azure. string
clusterAplicação ID do aplicativo de cluster do Ative Directory do Azure. string
inquilinoId ID do locatário do Ative Directory do Azure. string

CertificadoDescrição

Designação Descrição Valor
impressão digital Impressão digital do certificado principal. string (obrigatório)
impressão digitalSecundário Impressão digital do certificado secundário. string
x509StoreName O local do armazenamento de certificados local. 'Livro de Endereços'
'AuthRoot'
«Autoridade certificadora»
'Não permitido'
'Meu'
'Raiz'
'Pessoas de confiança'
'Editora confiável'

ClientCertificateCommonName

Designação Descrição Valor
certificadoCommonName O nome comum do certificado do cliente. string (obrigatório)
certificadoEmissor Impressão digital A impressão digital do emissor do certificado do cliente. string (obrigatório)
isAdmin Indica se o certificado do cliente tem acesso de administrador ao cluster. Os clientes não administradores podem executar apenas operações somente leitura no cluster. bool (obrigatório)

ClientCertificateImpressão digital

Designação Descrição Valor
certificadoImpressão digital A impressão digital do certificado do cliente. string (obrigatório)
isAdmin Indica se o certificado do cliente tem acesso de administrador ao cluster. Os clientes não administradores podem executar apenas operações somente leitura no cluster. bool (obrigatório)

ClusterHealthPolicy

Designação Descrição Valor
applicationHealthPolicies Define o mapa de política de integridade do aplicativo usado para avaliar a integridade de um aplicativo ou de uma de suas entidades filhas. ApplicationHealthPolicyMap
maxPercentUnhealthyApplications A porcentagem máxima permitida de aplicativos não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% de aplicativos não sejam íntegros, esse valor seria 10.

A porcentagem representa a porcentagem máxima tolerada de aplicativos que podem não estar íntegros antes que o cluster seja considerado errado.
Se a percentagem for respeitada, mas houver pelo menos uma aplicação insalubre, a saúde é avaliada como Aviso.
Isso é calculado dividindo o número de aplicativos não íntegros pelo número total de instâncias de aplicativo no cluster, excluindo aplicativos de tipos de aplicativo incluídos no ApplicationTypeHealthPolicyMap.
O cálculo arredonda para cima para tolerar uma falha em um pequeno número de aplicações. A percentagem por defeito é zero.		 Int

Restrições:
Valor mínimo = 0
Valor máximo = 100
maxPercentUnhealthyNodes A porcentagem máxima permitida de nós não íntegros antes de relatar um erro. Por exemplo, para permitir que 10% dos nós não estejam íntegros, esse valor seria 10.

A porcentagem representa a porcentagem máxima tolerada de nós que podem não estar íntegros antes que o cluster seja considerado errado.
Se a porcentagem for respeitada, mas houver pelo menos um nó não íntegro, a integridade será avaliada como Aviso.
A porcentagem é calculada dividindo o número de nós não íntegros sobre o número total de nós no cluster.
O cálculo arredonda para cima para tolerar uma falha em pequenos números de nós. A percentagem por defeito é zero.

Em clusters grandes, alguns nós sempre estarão inativos ou fora para reparos, então essa porcentagem deve ser configurada para tolerar isso.		 Int

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

ClusterProperties

Designação Descrição Valor
addOnRecursos A lista de recursos complementares a serem habilitados no cluster. Matriz de cadeia de caracteres contendo qualquer uma das:
'BackupRestoreService'
'DnsService'
'Gestor de Reparações'
'ResourceMonitorService'
applicationTypeVersionsCleanupPolicy A política usada para limpar versões não utilizadas. ApplicationTypeVersionsCleanupPolicy
azureActiveDirectory As configurações de autenticação do AAD do cluster. AzureActiveDirectory
certificado O certificado a ser usado para proteger o cluster. O certificado fornecido será usado para segurança de nó a nó dentro do cluster, certificado SSL para ponto de extremidade de gerenciamento de cluster e cliente de administração padrão. CertificateDescription
certificadoCommonNames Descreve uma lista de certificados de servidor referenciados por nome comum que são usados para proteger o cluster. ServerCertificateCommonNames
clientCertificateCommonNames A lista de certificados de cliente referenciados por nome comum que têm permissão para gerenciar o cluster. ClientCertificateCommonName[]
clientCertificateImpressões digitais A lista de certificados de cliente referenciados pela impressão digital que têm permissão para gerenciar o cluster. ClientCertificateThumbprint[]
clusterCodeVersion A versão de tempo de execução do Service Fabric do cluster. Esta propriedade só pode definir o usuário quando upgradeMode estiver definido como 'Manual'. Para obter uma lista de versões disponíveis do Service Fabric para novos clusters, use API ClusterVersion. Para obter a lista de versões disponíveis para clusters existentes, use availableClusterVersions. string
diagnosticsStorageAccountConfig As informações da conta de armazenamento para armazenar logs de diagnóstico do Service Fabric. DiagnosticsStorageAccountConfig
eventStoreServiceEnabled Indica se o serviço de armazenamento de eventos está habilitado. Bool
fabricSettings A lista de configurações de malha personalizada para configurar o cluster. ConfiguraçõesSecçãoDescrição[]
managementEndpoint O ponto de extremidade de gerenciamento http do cluster. string (obrigatório)
nodeTypes A lista de tipos de nó no cluster. NodeTypeDescription[] (obrigatório)
fiabilidadeNível O nível de confiabilidade define o tamanho do conjunto de réplicas dos serviços do sistema. Saiba mais sobre ConfiabilidadeNível.

- Nenhum - Execute os serviços do sistema com uma contagem de conjunto de réplicas de destino de 1. Isso só deve ser usado para clusters de teste.
- Bronze - Execute os serviços do sistema com uma contagem de conjuntos de réplicas de destino de 3. Isso só deve ser usado para clusters de teste.
- Prata - Execute os serviços do sistema com uma contagem de conjuntos de réplicas de destino de 5.
- Gold - Execute os serviços do sistema com uma contagem de conjuntos de réplicas de destino de 7.
- Platinum - Execute os serviços do sistema com uma contagem de conjuntos de réplicas alvo de 9.		 'Bronze'
'Ouro'
'Nenhuma'
'Platina'
'Prata'
reverseProxyCertificate O certificado do servidor usado pelo proxy reverso. CertificateDescription
reverseProxyCertificateCommonNames Descreve uma lista de certificados de servidor referenciados por nome comum que são usados para proteger o cluster. ServerCertificateCommonNames
upgradeDescrição A política a ser usada ao atualizar o cluster. ClusterUpgradePolicy
upgradeMode O modo de atualização do cluster quando a nova versão de tempo de execução do Service Fabric estiver disponível.

- Automático - O cluster será atualizado automaticamente para a versão mais recente do tempo de execução do Service Fabric assim que estiver disponível.
- Manual - O cluster não será atualizado automaticamente para a versão mais recente do tempo de execução do Service Fabric. O cluster é atualizado definindo a propriedade clusterCodeVersion no recurso de cluster.		 'Automático'
'Manual'
vmImage [en] A imagem VM VMSS foi configurada com. Nomes genéricos como Windows ou Linux podem ser usados. string

ClusterUpgradeDeltaHealthPolicy

Designação Descrição Valor
applicationDeltaHealthPolicies Define o mapa de diretiva de integridade delta do aplicativo usado para avaliar a integridade de um aplicativo ou de uma de suas entidades filhas ao atualizar o cluster. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications A porcentagem máxima permitida de degradação da integridade dos aplicativos permitida durante as atualizações de cluster.
O delta é medido entre o estado dos aplicativos no início da atualização e o estado dos aplicativos no momento da avaliação de integridade.
A verificação é realizada após a conclusão de cada atualização de domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados. Os serviços do sistema não estão incluídos neste.		 Int

Restrições:
Valor mínimo = 0
Valor máximo = 100 (obrigatório)
maxPercentDeltaUnhealthyNodes A porcentagem máxima permitida de degradação da integridade dos nós permitida durante as atualizações de cluster.
O delta é medido entre o estado dos nós no início da atualização e o estado dos nós no momento da avaliação de integridade.
A verificação é realizada após a conclusão de cada atualização de domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados.		 Int

Restrições:
Valor mínimo = 0
Valor máximo = 100 (obrigatório)
maxPercentUpgradeDomainDeltaUnhealthyNodes A porcentagem máxima permitida de degradação da integridade dos nós de domínio de atualização permitida durante as atualizações de cluster.
O delta é medido entre o estado dos nós de domínio de atualização no início da atualização e o estado dos nós de domínio de atualização no momento da avaliação de integridade.
A verificação é realizada após cada conclusão de atualização de domínio para todos os domínios de atualização concluídos para garantir que o estado dos domínios de atualização esteja dentro dos limites tolerados.		 Int

Restrições:
Valor mínimo = 0
Valor máximo = 100 (obrigatório)

ClusterUpgradePolicy

Designação Descrição Valor
deltaHealthPolicy A diretiva de integridade delta do cluster usada ao atualizar o cluster. ClusterUpgradeDeltaHealthPolicy
forceRestart Se verdadeiro, os processos são reiniciados à força durante a atualização, mesmo quando a versão do código não foi alterada (a atualização apenas altera a configuração ou os dados). Bool
healthCheckRetryTimeout A quantidade de tempo para repetir a avaliação de integridade quando o aplicativo ou cluster não está íntegro antes que a atualização seja revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. string (obrigatório)
healthCheckStableDuration A quantidade de tempo que o aplicativo ou cluster deve permanecer íntegro antes que a atualização prossiga para o próximo domínio de atualização. A duração pode ser no formato hh:mm:ss ou d.hh:mm:ss.ms. string (obrigatório)
healthCheckWaitDuration O período de tempo de espera após a conclusão de um domínio de atualização antes de executar verificações de integridade. A duração pode ser no formato hh:mm:ss ou d.hh:mm:ss.ms. string (obrigatório)
Política de saúde A diretiva de integridade do cluster usada ao atualizar o cluster. ClusterHealthPolicy (obrigatório)
upgradeDomainTimeout A quantidade de tempo que cada domínio de atualização tem que ser concluído antes que a atualização seja revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. string (obrigatório)
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 há problemas inesperados. Quando esse tempo limite expirar, o processamento do domínio de atualização prosseguirá independentemente de problemas de perda de disponibilidade. O tempo limite é redefinido no início de cada domínio de atualização. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. string (obrigatório)
upgradeTimeout A quantidade de tempo que a atualização geral tem que ser concluída antes que a atualização seja revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. string (obrigatório)

DiagnosticsStorageAccountConfig

Designação Descrição Valor
blobEndpoint O ponto de extremidade de blob da conta de armazenamento azure. string (obrigatório)
protectedAccountKeyName O nome da chave de armazenamento de diagnóstico protegido. string (obrigatório)
protectedAccountKeyName2 O nome da chave de armazenamento de diagnóstico secundário protegido. Se uma das chaves da conta de armazenamento for girada, o cluster voltará a usar a outra. string
queueEndpoint O ponto de extremidade da fila da conta de armazenamento azure. string (obrigatório)
storageAccountName O nome da conta de armazenamento do Azure. string (obrigatório)
tableEndpoint O ponto de extremidade da tabela da conta de armazenamento azure. string (obrigatório)

EndpointRangeDescrição

Designação Descrição Valor
endPort [en] Porta final de um intervalo de portas int (obrigatório)
startPort Porta inicial de uma variedade de portas int (obrigatório)

Microsoft.ServiceFabric/clusters

Designação Descrição Valor
Localização Local do recurso do Azure. string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades As propriedades do recurso de cluster ClusterProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.ServiceFabric/clusters@2020-12-01-preview"

NodeTypeDescription

Designação Descrição Valor
applicationPorts O intervalo de portas a partir do qual o cluster atribuiu porta a aplicativos do Service Fabric. EndpointRangeDescription
capacidades As tags de capacidade aplicadas aos nós no tipo de nó, o gerenciador de recursos de cluster usa essas tags para entender quanto recurso um nó tem. NodeTypeDescriptionCapacities
clientConnectionEndpointPort A porta do ponto de extremidade de gerenciamento de cluster TCP. int (obrigatório)
nível de durabilidade O nível de durabilidade do tipo de nó. Saiba mais sobre DurabilityLevel.

- Bronze - Sem privilégios. Este é o padrão.
- Prata - Os trabalhos de infraestrutura podem ser pausados por uma duração de 10 minutos por UD.
- Ouro - Os trabalhos de infraestrutura podem ser pausados por uma duração de 2 horas por UD. A durabilidade Gold pode ser ativada apenas em skus VM de nó completo como D15_V2, G5 etc.		 'Bronze'
'Ouro'
'Prata'
ephemeralPorts O intervalo de portas efêmeras com o qual os nós nesse tipo de nó devem ser configurados. EndpointRangeDescription
httpGatewayEndpointPort A porta do ponto de extremidade de gerenciamento de cluster HTTP. int (obrigatório)
isPrimário O tipo de nó no qual os serviços do sistema serão executados. Apenas um tipo de nó deve ser marcado como primário. O tipo de nó primário não pode ser excluído ou alterado para clusters existentes. bool (obrigatório)
Designação O nome do tipo de nó. string (obrigatório)
placementPropriedades As tags de posicionamento aplicadas aos nós no tipo de nó, que podem ser usadas para indicar onde determinados serviços (carga de trabalho) devem ser executados. NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort O ponto de extremidade usado pelo proxy reverso. Int
vmInstanceCount O número de nós no tipo de nó. Essa contagem deve corresponder à propriedade capacity no recurso VirtualMachineScaleSet correspondente. Int

Restrições:
Valor mínimo = 1
Valor máximo = 2147483647 (obrigatório)

NodeTypeDescriptionCapacities

Designação Descrição Valor

NodeTypeDescriptionPlacementProperties

Designação Descrição Valor

Tags de Recursos

Designação Descrição Valor

ServerCertificateCommonName

Designação Descrição Valor
certificadoCommonName O nome comum do certificado do servidor. string (obrigatório)
certificadoEmissor Impressão digital A impressão digital do emissor do certificado do servidor. string (obrigatório)

ServerCertificateCommonNames

Designação Descrição Valor
nomes comuns A lista de certificados de servidor referenciados por nome comum que são usados para proteger o cluster. ServerCertificateCommonName[]
x509StoreName O local do armazenamento de certificados local. 'Livro de Endereços'
'AuthRoot'
«Autoridade certificadora»
'Não permitido'
'Meu'
'Raiz'
'Pessoas de confiança'
'Editora confiável'

ServiceTypeDeltaHealthPolicy

Designação Descrição Valor
maxPercentDeltaUnhealthyServices A porcentagem máxima permitida de degradação da integridade dos serviços permitida durante as atualizações de cluster.
O delta é medido entre o estado dos serviços no início da atualização e o estado dos serviços no momento da avaliação de saúde.
A verificação é realizada após a conclusão de cada atualização de domínio de atualização para garantir que o estado global do cluster esteja dentro dos limites tolerados.		 Int

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

ServiceTypeDeltaHealthPolicyMap

Designação Descrição Valor

ServiceTypeHealthPolicy

Designação Descrição Valor
maxPercentUnhealthyServices A porcentagem máxima de serviços permitidos como não íntegros antes que seu aplicativo seja considerado errado. Int

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

ServiceTypeHealthPolicyMap

Designação Descrição Valor

SettingsParameterDescription

Designação Descrição Valor
Designação O nome do parâmetro da configuração de malha. string (obrigatório)
valor O valor do parâmetro da configuração de malha. string (obrigatório)

ConfiguraçõesSecçãoDescrição

Designação Descrição Valor
Designação O nome da seção das configurações de malha. string (obrigatório)
Parâmetros A coleção de parâmetros na seção. SettingsParameterDescription[] (obrigatório)