Clusters Microsoft.ServiceFabric 2017-07-01-preview
Definição de recurso do Bicep
O tipo de recurso dos clusters pode ser implementado com operações que visam:
- Grupos de recursos – veja os comandos de implementação do grupo 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, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.ServiceFabric/clusters@2017-07-01-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
addOnFeatures: [
'string'
]
availableClusterVersions: [
{
codeVersion: 'string'
environment: 'string'
supportExpiryUtc: 'string'
}
]
azureActiveDirectory: {
clientApplication: 'string'
clusterApplication: 'string'
tenantId: 'string'
}
certificate: {
thumbprint: 'string'
thumbprintSecondary: 'string'
x509StoreName: 'string'
}
clientCertificateCommonNames: [
{
certificateCommonName: 'string'
certificateIssuerThumbprint: 'string'
isAdmin: bool
}
]
clientCertificateThumbprints: [
{
certificateThumbprint: 'string'
isAdmin: bool
}
]
clusterCodeVersion: 'string'
clusterState: 'string'
diagnosticsStorageAccountConfig: {
blobEndpoint: 'string'
protectedAccountKeyName: 'string'
queueEndpoint: 'string'
storageAccountName: 'string'
tableEndpoint: 'string'
}
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'
}
upgradeDescription: {
deltaHealthPolicy: {
maxPercentDeltaUnhealthyApplications: int
maxPercentDeltaUnhealthyNodes: int
maxPercentUpgradeDomainDeltaUnhealthyNodes: int
}
forceRestart: bool
healthCheckRetryTimeout: 'string'
healthCheckStableDuration: 'string'
healthCheckWaitDuration: 'string'
healthPolicy: {
maxPercentUnhealthyApplications: int
maxPercentUnhealthyNodes: int
}
upgradeDomainTimeout: 'string'
upgradeReplicaSetCheckTimeout: 'string'
upgradeTimeout: 'string'
}
upgradeMode: 'string'
vmImage: 'string'
}
}
Valores de propriedade
clusters
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso | cadeia (obrigatório) Limite de carateres: 4-23 Carateres válidos: Letras minúsculas, números e hífenes. Comece com letras minúsculas. Termine com letra minúscula ou número. |
| localização | Localização do recurso. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| propriedades | As propriedades do recurso do cluster | ClusterProperties |
ClusterProperties
| Nome | Descrição | Valor |
|---|---|---|
| addOnFeatures | A lista de funcionalidades de suplemento a ativar no cluster. | Matriz de cadeia que contém qualquer um dos seguintes: "BackupRestoreService" "DnsService" "RepairManager" |
| availableClusterVersions | As versões de runtime do Service Fabric disponíveis para este cluster. | ClusterVersionDetails[] |
| azureActiveDirectory | As definições de autenticação do AAD do cluster. | AzureActiveDirectory |
| certificado | O certificado a utilizar para proteger o cluster. O certificado fornecido será utilizado para a segurança do nó no nó no cluster, o certificado SSL para o ponto final de gestão do cluster e o cliente de administração predefinido. | CertificateDescription |
| clientCertificateCommonNames | A lista de certificados de cliente referenciados pelo nome comum que têm permissão para gerir o cluster. | ClientCertificateCommonName[] |
| clientCertificateThumbprints | A lista de certificados de cliente referenciados pelo thumbprint que têm permissão para gerir o cluster. | ClientCertificateThumbprint[] |
| clusterCodeVersion | A versão de runtime do Service Fabric do cluster. Esta propriedade só pode ser definida pelo utilizador quando upgradeMode está definido como "Manual". Para obter uma lista das versões disponíveis do Service Fabric para novos clusters, utilize a API ClusterVersion. Para obter a lista de versões disponíveis para clusters existentes, utilize availableClusterVersions. | string |
| clusterState | O estado atual do cluster. - WaitingForNodes - Indica que o recurso do cluster foi criado e que o fornecedor de recursos está à espera que a extensão da VM do Service Fabric arranque e comunique ao mesmo. - A implementar – indica que o runtime do Service Fabric está a ser instalado nas VMs. O recurso de cluster estará neste estado até que o cluster arranque e os serviços do sistema estejam em funcionamento. - BaselineUpgrade - Indica que o cluster está a atualizar para estabelecer a versão do cluster. Esta atualização é iniciada automaticamente quando o cluster arranca pela primeira vez. - UpdatingUserConfiguration - Indica que o cluster está a ser atualizado com a configuração fornecida pelo utilizador. - UpdatingUserCertificate - Indica que o cluster está a ser atualizado com o certificado fornecido pelo utilizador. - UpdatingInfrastructure - Indica que o cluster está a ser atualizado com a versão mais recente do runtime do Service Fabric. Isto só acontece quando o upgradeMode está definido como "Automático". - EnforcingClusterVersion - Indica que o cluster está numa versão diferente do esperado e que o cluster está a ser atualizado para a versão esperada. - UpgradeServiceUnreachable - Indica que o serviço de sistema no cluster já não está a consultar o Fornecedor de Recursos. Os clusters neste estado não podem ser geridos pelo Fornecedor de Recursos. - Dimensionamento Automático - Indica que o Nível de Fiabilidade do cluster está a ser ajustado. - Pronto - Indica que o cluster está num estado estável. |
"Dimensionamento Automático" "BaselineUpgrade" "A implementar" "EnforcingClusterVersion" "Pronto" "UpdatingInfrastructure" "UpdatingUserCertificate" "UpdatingUserConfiguration" "UpgradeServiceUnreachable" 'WaitingForNodes' |
| diagnosticsStorageAccountConfig | As informações da conta de armazenamento para armazenar registos de diagnóstico do Service Fabric. | DiagnosticsStorageAccountConfig |
| recursos de infraestruturaDefinições | A lista de definições de recursos de infraestrutura personalizados para configurar o cluster. | SettingsSectionDescription[] |
| managementEndpoint | O ponto final de gestão http do cluster. | cadeia (obrigatório) |
| nodeTypes | A lista de tipos de nós no cluster. | NodeTypeDescription[] (obrigatório) |
| fiabilidadeLevel | O nível de fiabilidade define o tamanho do conjunto de réplicas dos serviços do sistema. Saiba mais sobre a FiabilidadeLevel. - Nenhum - Execute os serviços do Sistema com uma contagem de conjuntos de réplicas de destino de 1. Esta ação só deve ser utilizada para clusters de teste. - Bronze - Execute os serviços do Sistema com uma contagem de 3 conjuntos de réplicas de destino. Esta ação só deve ser utilizada para clusters de teste. - Prata – execute os serviços do Sistema com uma contagem de 5 conjuntos de réplicas de destino. - 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 9 conjuntos de réplicas de destino. |
'Bronze' 'Gold' "Nenhum" 'Platinum' 'Prata' |
| reverseProxyCertificate | O certificado de servidor utilizado pelo proxy inverso. | CertificateDescription |
| upgradeDescription | A política a utilizar ao atualizar o cluster. | ClusterUpgradePolicy |
| upgradeMode | O modo de atualização do cluster quando está disponível a nova versão de runtime do Service Fabric. - Automático - O cluster será atualizado automaticamente para a versão de runtime mais recente do Service Fabric assim que estiver disponível. - Manual – o cluster não será atualizado automaticamente para a versão de runtime mais recente do Service Fabric. O cluster é atualizado ao definir a propriedade clusterCodeVersion no recurso do cluster. |
"Automático" "Manual" |
| vmImage | A VMSS da imagem de VM foi configurada com. Podem ser utilizados nomes genéricos, como Windows ou Linux. | string |
ClusterVersionDetails
| Nome | Descrição | Valor |
|---|---|---|
| codeVersion | A versão de runtime do Service Fabric do cluster. | string |
| ambiente | Indica se esta versão se destina ao sistema operativo Windows ou Linux. | 'Linux' 'Windows' |
| supportExpiryUtc | A data de expiração do suporte da versão. | string |
AzureActiveDirectory
| Nome | Descrição | Valor |
|---|---|---|
| clientApplication | ID da aplicação cliente do Azure Active Directory. | string |
| clusterApplication | ID da aplicação do cluster do Azure Active Directory. | string |
| tenantId | ID do inquilino do Azure Active Directory. | string |
CertificateDescription
| Nome | Descrição | Valor |
|---|---|---|
| thumbprint | Thumbprint do certificado primário. | cadeia (obrigatório) |
| thumbprintSecondary | Thumbprint do certificado secundário. | string |
| x509StoreName | A localização do arquivo de certificados local. | "AddressBook" 'AuthRoot' "CertificateAuthority" "Não permitido" 'O Meu' "Raiz" "TrustedPeople" "TrustedPublisher" |
ClientCertificateCommonName
| Nome | Descrição | Valor |
|---|---|---|
| certificateCommonName | O nome comum do certificado de cliente. | cadeia (obrigatório) |
| certificateIssuerThumbprint | O thumbprint do emissor do certificado de cliente. | cadeia (obrigatório) |
| isAdmin | Indica se o certificado de cliente tem acesso de administrador ao cluster. Os clientes não administradores só podem realizar operações só de leitura no cluster. | bool (obrigatório) |
ClientCertificateThumbprint
| Nome | Descrição | Valor |
|---|---|---|
| certificateThumbprint | O thumbprint do certificado de cliente. | cadeia (obrigatório) |
| isAdmin | Indica se o certificado de cliente tem acesso de administrador ao cluster. Os clientes não administradores só podem realizar operações só de leitura no cluster. | bool (obrigatório) |
DiagnosticsStorageAccountConfig
| Nome | Descrição | Valor |
|---|---|---|
| blobEndpoint | O ponto final do blob da conta de armazenamento do Azure. | cadeia (obrigatório) |
| protectedAccountKeyName | O nome da chave de armazenamento de diagnóstico protegido. | cadeia (obrigatório) |
| queueEndpoint | O ponto final da fila da conta de armazenamento do Azure. | cadeia (obrigatório) |
| storageAccountName | O nome da conta de armazenamento do Azure. | cadeia (obrigatório) |
| tableEndpoint | O ponto final da tabela da conta de armazenamento do Azure. | cadeia (obrigatório) |
SettingsSectionDescription
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da secção das definições de recursos de infraestrutura. | cadeia (obrigatório) |
| parâmetros | A coleção de parâmetros na secção. | SettingsParameterDescription[] (obrigatório) |
DefiniçõesParameterDescription
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do parâmetro da definição de recursos de infraestrutura. | cadeia (obrigatório) |
| valor | O valor do parâmetro da definição de recursos de infraestrutura. | cadeia (obrigatório) |
NodeTypeDescription
| Nome | Descrição | Valor |
|---|---|---|
| applicationPorts | O intervalo de portas a partir do qual o cluster atribuiu a porta às aplicações do Service Fabric. | EndpointRangeDescription |
| capacidades | As etiquetas de capacidade aplicadas aos nós no tipo de nó, o gestor de recursos do cluster utiliza estas etiquetas para compreender a quantidade de recursos que um nó tem. | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | A porta de ponto final de gestão do cluster TCP. | int (obrigatório) |
| durabilityLevel | O nível de durabilidade do tipo de nó. Saiba mais sobre DurabilityLevel. - Bronze - Sem privilégios. Esta é a predefinição. - Prata – as tarefas de infraestrutura podem ser colocadas em pausa durante 30 minutos por UD. - Gold – as tarefas de infraestrutura podem ser colocadas em pausa durante 2 horas por UD. A durabilidade dourada só pode ser ativada em SKUs de VM de nós completos, como D15_V2, G5, etc. |
'Bronze' 'Gold' 'Prata' |
| efémerosPorts | O intervalo de portas efémeras com que os nós neste tipo de nó devem ser configurados. | EndpointRangeDescription |
| httpGatewayEndpointPort | A porta de ponto final de gestão do cluster HTTP. | int (obrigatório) |
| isPrimary | O tipo de nó no qual os serviços de sistema serão executados. Apenas um tipo de nó deve ser marcado como primário. Não é possível eliminar ou alterar o tipo de nó principal para clusters existentes. | bool (obrigatório) |
| name | O nome do tipo de nó. | cadeia (obrigatório) |
| placementProperties | As etiquetas de colocação aplicadas aos nós no tipo de nó, que podem ser utilizadas para indicar onde determinados serviços (carga de trabalho) devem ser executados. | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | O ponto final utilizado pelo proxy inverso. | int |
| vmInstanceCount | O número de nós no tipo de nó. Esta contagem deve corresponder à propriedade de capacidade no recurso VirtualMachineScaleSet correspondente. | int (obrigatório) Restrições: Valor mínimo = 1 Valor máximo = 2147483647 |
EndpointRangeDescription
| Nome | Descrição | Valor |
|---|---|---|
| endPort | Porta de fim de um intervalo de portas | int (obrigatório) |
| startPort | Porta inicial de um intervalo de portas | int (obrigatório) |
NodeTypeDescriptionCapacities
| Nome | Descrição | Valor |
|---|---|---|
| {customized property} | string |
NodeTypeDescriptionPlacementProperties
| Nome | Descrição | Valor |
|---|---|---|
| {customized property} | string |
ClusterUpgradePolicy
| Nome | Descrição | Valor |
|---|---|---|
| deltaHealthPolicy | A política de estado de funcionamento delta utilizada ao atualizar o cluster. | ClusterUpgradeDeltaHealthPolicy |
| 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 |
| 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 atualização ser revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
| 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. A duração pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
| healthCheckWaitDuration | O período de tempo a aguardar depois de concluir um domínio de atualização antes de efetuar verificações de estado de funcionamento. A duração pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
| healthPolicy | A política de estado de funcionamento do cluster utilizada ao atualizar o cluster. | ClusterHealthPolicy (obrigatório) |
| upgradeDomainTimeout | A quantidade de tempo que cada domínio de atualização tem de ser concluído antes de a atualização ser revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (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 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. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
| upgradeTimeout | A quantidade de tempo que a atualização geral tem de ser concluída antes de a atualização ser revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
ClusterUpgradeDeltaHealthPolicy
| Nome | Descrição | Valor |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | A percentagem máxima permitida de degradação do estado de funcionamento das aplicações permitida durante as atualizações do cluster. O delta é medido entre o estado das aplicações no início da atualização e o estado das aplicações no momento da avaliação do estado de funcionamento. A verificação é efetuada após cada conclusão de atualização de domínio de atualização para garantir que o estado global do cluster está dentro dos limites tolerados. Os serviços de sistema não estão incluídos neste. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentDeltaUnhealthyNodes | A percentagem máxima permitida de degradação do estado de funcionamento dos nós permitida durante as atualizações do 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 do estado de funcionamento. A verificação é efetuada após cada conclusão de atualização de domínio de atualização para garantir que o estado global do cluster está dentro dos limites tolerados. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | A percentagem máxima permitida de degradação do estado de funcionamento dos nós de domínio de atualização permitida durante as atualizações do 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 do estado de funcionamento. A verificação é efetuada após cada conclusão de atualização de domínio de atualização para todos os domínios de atualização concluídos para garantir que o estado dos domínios de atualização está dentro dos limites tolerados. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
ClusterHealthPolicy
| Nome | Descrição | Valor |
|---|---|---|
| maxPercentUnhealthyApplications | A percentagem máxima permitida de aplicações em mau estado de funcionamento antes de comunicar um erro. Por exemplo, para permitir que 10% das aplicações estejam em mau estado de funcionamento, este valor seria 10. | int Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentUnhealthyNodes | A percentagem máxima permitida de nós em mau estado de funcionamento antes de comunicar um erro. Por exemplo, para permitir que 10% dos nós estejam em mau estado de funcionamento, este valor seria 10. | int Restrições: Valor mínimo = 0 Valor máximo = 100 |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
Implementar um Cluster do Service Fabric do Ubuntu de 5 Nós |
Este modelo permite-lhe implementar um Cluster do Service Fabric de 5 nós seguro com o Ubuntu numa VMSS de Tamanho Standard_D2_V2. |
| Implementar um Cluster Seguro de 5 Nós |
Este modelo permite-lhe implementar um Cluster do Service Fabric de 5 nós seguro com o Windows Server 2019 Datacenter num VMSS de Tamanho Standard_D2_v2. |
| Implementar um Cluster Seguro de 3 Nós com NSGs ativados |
Este modelo permite-lhe implementar um Cluster de Recursos de Infraestrutura de Serviço de 3 nós seguro com o Centro de Dados do Windows Server 2016 num Standard_D2 Size VMs. Utilizar este modelo permite-lhe controlar o tráfego de rede de entrada e saída através de Grupos de Segurança de Rede. |
Definição de recurso de modelo do ARM
O tipo de recurso de clusters pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo 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": "2017-07-01-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"addOnFeatures": [ "string" ],
"availableClusterVersions": [
{
"codeVersion": "string",
"environment": "string",
"supportExpiryUtc": "string"
}
],
"azureActiveDirectory": {
"clientApplication": "string",
"clusterApplication": "string",
"tenantId": "string"
},
"certificate": {
"thumbprint": "string",
"thumbprintSecondary": "string",
"x509StoreName": "string"
},
"clientCertificateCommonNames": [
{
"certificateCommonName": "string",
"certificateIssuerThumbprint": "string",
"isAdmin": "bool"
}
],
"clientCertificateThumbprints": [
{
"certificateThumbprint": "string",
"isAdmin": "bool"
}
],
"clusterCodeVersion": "string",
"clusterState": "string",
"diagnosticsStorageAccountConfig": {
"blobEndpoint": "string",
"protectedAccountKeyName": "string",
"queueEndpoint": "string",
"storageAccountName": "string",
"tableEndpoint": "string"
},
"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"
},
"upgradeDescription": {
"deltaHealthPolicy": {
"maxPercentDeltaUnhealthyApplications": "int",
"maxPercentDeltaUnhealthyNodes": "int",
"maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
},
"forceRestart": "bool",
"healthCheckRetryTimeout": "string",
"healthCheckStableDuration": "string",
"healthCheckWaitDuration": "string",
"healthPolicy": {
"maxPercentUnhealthyApplications": "int",
"maxPercentUnhealthyNodes": "int"
},
"upgradeDomainTimeout": "string",
"upgradeReplicaSetCheckTimeout": "string",
"upgradeTimeout": "string"
},
"upgradeMode": "string",
"vmImage": "string"
}
}
Valores de propriedade
clusters
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.ServiceFabric/clusters" |
| apiVersion | A versão da API de recursos | '2017-07-01-preview' |
| name | O nome do recurso | cadeia (obrigatório) Limite de carateres: 4-23 Carateres válidos: Letras minúsculas, números e hífenes. Comece com letras minúsculas. Termine com letra ou número em minúsculas. |
| localização | Localização do recurso. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| propriedades | As propriedades do recurso do cluster | ClusterProperties |
ClusterProperties
| Nome | Descrição | Valor |
|---|---|---|
| addOnFeatures | A lista de funcionalidades de suplementos a ativar no cluster. | Matriz de cadeias que contém qualquer um dos seguintes: "BackupRestoreService" "DnsService" "RepairManager" |
| availableClusterVersions | As versões de runtime do Service Fabric disponíveis para este cluster. | ClusterVersionDetails[] |
| azureActiveDirectory | As definições de autenticação do AAD do cluster. | AzureActiveDirectory |
| certificado | O certificado a utilizar para proteger o cluster. O certificado fornecido será utilizado para a segurança do nó no nó no cluster, o certificado SSL para o ponto final de gestão do cluster e o cliente de administração predefinido. | CertificateDescription |
| clientCertificateCommonNames | A lista de certificados de cliente referenciados pelo nome comum que têm permissão para gerir o cluster. | ClientCertificateCommonName[] |
| clientCertificateThumbprints | A lista de certificados de cliente referenciados por thumbprint que têm permissão para gerir o cluster. | ClientCertificateThumbprint[] |
| clusterCodeVersion | A versão de runtime do Service Fabric do cluster. Esta propriedade só pode definir o utilizador quando upgradeMode está definido como "Manual". Para obter uma lista das versões disponíveis do Service Fabric para novos clusters, utilize a API ClusterVersion. Para obter a lista de versões disponíveis para clusters existentes, utilize availableClusterVersions. | string |
| clusterState | O estado atual do cluster. - WaitingForNodes - Indica que o recurso do cluster foi criado e que o fornecedor de recursos está à espera que a extensão da VM do Service Fabric arranque e comunique com o mesmo. - Implementação – indica que o runtime do Service Fabric está a ser instalado nas VMs. O recurso de cluster estará neste estado até que o cluster arranque e os serviços do sistema estejam em funcionamento. - BaselineUpgrade - Indica que o cluster está a atualizar para estabelecer a versão do cluster. Esta atualização é iniciada automaticamente quando o cluster arranca pela primeira vez. - UpgradeUserConfiguration - Indica que o cluster está a ser atualizado com a configuração fornecida pelo utilizador. - UpdatingUserCertificate - Indica que o cluster está a ser atualizado com o certificado fornecido pelo utilizador. - UpgradeInfrastructure - Indica que o cluster está a ser atualizado com a versão de runtime mais recente do Service Fabric. Isto só acontece quando o upgradeMode está definido como "Automático". - EnforcingClusterVersion - Indica que o cluster está numa versão diferente do esperado e que o cluster está a ser atualizado para a versão esperada. - UpgradeServiceUnreachable - Indica que o serviço de sistema no cluster já não está a consultar o Fornecedor de Recursos. Os clusters neste estado não podem ser geridos pelo Fornecedor de Recursos. - Dimensionamento Automático - Indica que o Nível de Fiabilidade do cluster está a ser ajustado. - Pronto - Indica que o cluster está num estado estável. |
"Dimensionamento Automático" "BaselineUpgrade" "Implementar" "EnforcingClusterVersion" 'Pronto' "UpdatingInfrastructure" "UpdatingUserCertificate" "UpdatingUserConfiguration" "UpgradeServiceUnreachable" 'WaitingForNodes' |
| diagnosticsStorageAccountConfig | As informações da conta de armazenamento para armazenar registos de diagnóstico do Service Fabric. | DiagnosticsStorageAccountConfig |
| recursos de infraestruturaDefinições | A lista de definições de recursos de infraestrutura personalizados para configurar o cluster. | SettingsSectionDescription[] |
| managementEndpoint | O ponto final de gestão http do cluster. | cadeia (obrigatório) |
| nodeTypes | A lista de tipos de nós no cluster. | NodeTypeDescription[] (obrigatório) |
| fiabilidadeLevel | O nível de fiabilidade define o tamanho do conjunto de réplicas dos serviços do sistema. Saiba mais sobre a FiabilidadeLevel. - Nenhum - Execute os serviços do Sistema com uma contagem de conjuntos de réplicas de destino de 1. Esta ação só deve ser utilizada para clusters de teste. - Bronze - Execute os serviços do Sistema com uma contagem de 3 conjuntos de réplicas de destino. Esta ação só deve ser utilizada para clusters de teste. - Prata – execute os serviços do Sistema com uma contagem de 5 conjuntos de réplicas de destino. - 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 9 conjuntos de réplicas de destino. |
'Bronze' 'Gold' "Nenhum" 'Platinum' 'Prata' |
| reverseProxyCertificate | O certificado de servidor utilizado pelo proxy inverso. | CertificateDescription |
| upgradeDescription | A política a utilizar ao atualizar o cluster. | ClusterUpgradePolicy |
| upgradeMode | O modo de atualização do cluster quando está disponível a nova versão de runtime do Service Fabric. - Automático - O cluster será atualizado automaticamente para a versão de runtime mais recente do Service Fabric assim que estiver disponível. - Manual – o cluster não será atualizado automaticamente para a versão de runtime mais recente do Service Fabric. O cluster é atualizado ao definir a propriedade clusterCodeVersion no recurso do cluster. |
"Automático" "Manual" |
| vmImage | A VMSS da imagem de VM foi configurada com. Podem ser utilizados nomes genéricos, como Windows ou Linux. | string |
ClusterVersionDetails
| Nome | Descrição | Valor |
|---|---|---|
| codeVersion | A versão de runtime do Service Fabric do cluster. | string |
| ambiente | Indica se esta versão se destina ao sistema operativo Windows ou Linux. | 'Linux' 'Windows' |
| supportExpiryUtc | A data de expiração do suporte da versão. | string |
AzureActiveDirectory
| Nome | Descrição | Valor |
|---|---|---|
| clientApplication | ID da aplicação cliente do Azure Active Directory. | string |
| clusterApplication | ID da aplicação do cluster do Azure Active Directory. | string |
| tenantId | ID do inquilino do Azure Active Directory. | string |
CertificateDescription
| Nome | Descrição | Valor |
|---|---|---|
| thumbprint | Thumbprint do certificado primário. | cadeia (obrigatório) |
| thumbprintSecondary | Thumbprint do certificado secundário. | string |
| x509StoreName | A localização do arquivo de certificados local. | "AddressBook" 'AuthRoot' "CertificateAuthority" "Não permitido" 'O Meu' "Raiz" "TrustedPeople" "TrustedPublisher" |
ClientCertificateCommonName
| Nome | Descrição | Valor |
|---|---|---|
| certificateCommonName | O nome comum do certificado de cliente. | cadeia (obrigatório) |
| certificateIssuerThumbprint | O thumbprint do emissor do certificado de cliente. | cadeia (obrigatório) |
| isAdmin | Indica se o certificado de cliente tem acesso de administrador ao cluster. Os clientes não administradores só podem realizar operações só de leitura no cluster. | bool (obrigatório) |
ClientCertificateThumbprint
| Nome | Descrição | Valor |
|---|---|---|
| certificateThumbprint | O thumbprint do certificado de cliente. | cadeia (obrigatório) |
| isAdmin | Indica se o certificado de cliente tem acesso de administrador ao cluster. Os clientes não administradores só podem realizar operações só de leitura no cluster. | bool (obrigatório) |
DiagnosticsStorageAccountConfig
| Nome | Descrição | Valor |
|---|---|---|
| blobEndpoint | O ponto final do blob da conta de armazenamento do Azure. | cadeia (obrigatório) |
| protectedAccountKeyName | O nome da chave de armazenamento de diagnóstico protegido. | cadeia (obrigatório) |
| queueEndpoint | O ponto final da fila da conta de armazenamento do Azure. | cadeia (obrigatório) |
| storageAccountName | O nome da conta de armazenamento do Azure. | cadeia (obrigatório) |
| tableEndpoint | O ponto final da tabela da conta de armazenamento do Azure. | cadeia (obrigatório) |
SettingsSectionDescription
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da secção das definições de recursos de infraestrutura. | cadeia (obrigatório) |
| parâmetros | A coleção de parâmetros na secção . | SettingsParameterDescription[] (obrigatório) |
DefiniçõesParameterDescription
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do parâmetro da definição de recursos de infraestrutura. | cadeia (obrigatório) |
| valor | O valor do parâmetro da definição de recursos de infraestrutura. | cadeia (obrigatório) |
NodeTypeDescription
| Nome | Descrição | Valor |
|---|---|---|
| applicationPorts | O intervalo de portas a partir das quais o cluster atribuiu a porta às aplicações do Service Fabric. | EndpointRangeDescription |
| capacidades | As etiquetas de capacidade aplicadas aos nós no tipo de nó, o gestor de recursos do cluster utiliza estas etiquetas para compreender a quantidade de recursos que um nó tem. | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | A porta de ponto final de gestão do cluster TCP. | int (obrigatório) |
| durabilityLevel | O nível de durabilidade do tipo de nó. Saiba mais sobre DurabilityLevel. - Bronze - Sem privilégios. Esta é a predefinição. - Prata - As tarefas de infraestrutura podem ser colocadas em pausa durante 30 minutos por UD. - Ouro - As tarefas de infraestrutura podem ser colocadas em pausa durante 2 horas por UD. A durabilidade gold só pode ser ativada em skUs de VM de nó completos, como D15_V2, G5, etc. |
'Bronze' 'Gold' 'Prata' |
| efémerosPorts | O intervalo de portas efémeras com que os nós neste tipo de nó devem ser configurados. | EndpointRangeDescription |
| httpGatewayEndpointPort | A porta de ponto final de gestão do cluster HTTP. | int (obrigatório) |
| isPrimary | O tipo de nó no qual os serviços de sistema serão executados. Apenas um tipo de nó deve ser marcado como primário. Não é possível eliminar ou alterar o tipo de nó principal para clusters existentes. | bool (obrigatório) |
| name | O nome do tipo de nó. | cadeia (obrigatório) |
| placementProperties | As etiquetas de colocação aplicadas aos nós no tipo de nó, que podem ser utilizadas para indicar onde determinados serviços (carga de trabalho) devem ser executados. | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | O ponto final utilizado pelo proxy inverso. | int |
| vmInstanceCount | O número de nós no tipo de nó. Esta contagem deve corresponder à propriedade de capacidade no recurso VirtualMachineScaleSet correspondente. | int (obrigatório) Restrições: Valor mínimo = 1 Valor máximo = 2147483647 |
EndpointRangeDescription
| Nome | Descrição | Valor |
|---|---|---|
| endPort | Porta de fim de um intervalo de portas | int (obrigatório) |
| startPort | Porta inicial de um intervalo de portas | int (obrigatório) |
NodeTypeDescriptionCapacities
| Nome | Descrição | Valor |
|---|---|---|
| {customized property} | string |
NodeTypeDescriptionPlacementProperties
| Nome | Descrição | Valor |
|---|---|---|
| {customized property} | string |
ClusterUpgradePolicy
| Nome | Descrição | Valor |
|---|---|---|
| deltaHealthPolicy | A política de estado de funcionamento delta utilizada ao atualizar o cluster. | ClusterUpgradeDeltaHealthPolicy |
| 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 |
| 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 atualização ser revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
| 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. A duração pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
| healthCheckWaitDuration | O período de tempo a aguardar depois de concluir um domínio de atualização antes de efetuar verificações de estado de funcionamento. A duração pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
| healthPolicy | A política de estado de funcionamento do cluster utilizada ao atualizar o cluster. | ClusterHealthPolicy (obrigatório) |
| upgradeDomainTimeout | A quantidade de tempo que cada domínio de atualização tem de ser concluído antes de a atualização ser revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (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 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. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
| upgradeTimeout | A quantidade de tempo que a atualização geral tem de ser concluída antes de a atualização ser revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
ClusterUpgradeDeltaHealthPolicy
| Nome | Descrição | Valor |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | A percentagem máxima permitida de degradação do estado de funcionamento das aplicações permitida durante as atualizações do cluster. O delta é medido entre o estado das aplicações no início da atualização e o estado das aplicações no momento da avaliação do estado de funcionamento. A verificação é efetuada após cada conclusão de atualização de domínio de atualização para garantir que o estado global do cluster está dentro dos limites tolerados. Os serviços de sistema não estão incluídos neste. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentDeltaUnhealthyNodes | A percentagem máxima permitida de degradação do estado de funcionamento dos nós permitida durante as atualizações do 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 do estado de funcionamento. A verificação é efetuada após cada conclusão de atualização da atualização do domínio para garantir que o estado global do cluster está dentro dos limites tolerados. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | A percentagem máxima permitida de degradação do estado de funcionamento dos nós de domínio de atualização permitida durante as atualizações do 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 do estado de funcionamento. A verificação é efetuada após cada conclusão de atualizaçã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 está dentro dos limites tolerados. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
ClusterHealthPolicy
| Nome | Descrição | Valor |
|---|---|---|
| maxPercentUnhealthyApplications | A percentagem máxima permitida de aplicações em mau estado de funcionamento antes de comunicar um erro. Por exemplo, para permitir que 10% das aplicações estejam em mau estado de funcionamento, este valor seria 10. | int Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentUnhealthyNodes | A percentagem máxima permitida de nós em mau estado de funcionamento antes de comunicar um erro. Por exemplo, para permitir que 10% dos nós estejam em mau estado de funcionamento, este valor seria 10. | int Restrições: Valor mínimo = 0 Valor máximo = 100 |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
| Implementar um Cluster do Service Fabric do Ubuntu de 5 Nós |
Este modelo permite-lhe implementar um Cluster do Service Fabric de 5 nós seguro com o Ubuntu numa VMSS de Tamanho Standard_D2_V2. |
| Implementar um Cluster Seguro de 5 Nós |
Este modelo permite-lhe implementar um Cluster do Service Fabric de 5 nós seguro com o Windows Server 2019 Datacenter num VMSS de Tamanho Standard_D2_v2. |
| Implementar um Cluster Seguro de 3 Nós com NSGs ativados |
Este modelo permite-lhe implementar um Cluster de Recursos de Infraestrutura de Serviço de 3 nós seguro com o Centro de Dados do Windows Server 2016 num Standard_D2 Size VMs. Utilizar este modelo permite-lhe controlar o tráfego de rede de entrada e saída através de Grupos de Segurança de Rede. |
Definição de recurso do Terraform (fornecedor AzAPI)
O tipo de recurso de clusters pode ser implementado com operações que visam:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo 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@2017-07-01-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
addOnFeatures = [
"string"
]
availableClusterVersions = [
{
codeVersion = "string"
environment = "string"
supportExpiryUtc = "string"
}
]
azureActiveDirectory = {
clientApplication = "string"
clusterApplication = "string"
tenantId = "string"
}
certificate = {
thumbprint = "string"
thumbprintSecondary = "string"
x509StoreName = "string"
}
clientCertificateCommonNames = [
{
certificateCommonName = "string"
certificateIssuerThumbprint = "string"
isAdmin = bool
}
]
clientCertificateThumbprints = [
{
certificateThumbprint = "string"
isAdmin = bool
}
]
clusterCodeVersion = "string"
clusterState = "string"
diagnosticsStorageAccountConfig = {
blobEndpoint = "string"
protectedAccountKeyName = "string"
queueEndpoint = "string"
storageAccountName = "string"
tableEndpoint = "string"
}
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"
}
upgradeDescription = {
deltaHealthPolicy = {
maxPercentDeltaUnhealthyApplications = int
maxPercentDeltaUnhealthyNodes = int
maxPercentUpgradeDomainDeltaUnhealthyNodes = int
}
forceRestart = bool
healthCheckRetryTimeout = "string"
healthCheckStableDuration = "string"
healthCheckWaitDuration = "string"
healthPolicy = {
maxPercentUnhealthyApplications = int
maxPercentUnhealthyNodes = int
}
upgradeDomainTimeout = "string"
upgradeReplicaSetCheckTimeout = "string"
upgradeTimeout = "string"
}
upgradeMode = "string"
vmImage = "string"
}
})
}
Valores de propriedade
clusters
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.ServiceFabric/clusters@2017-07-01-preview" |
| name | O nome do recurso | cadeia (obrigatório) Limite de carateres: 4-23 Carateres válidos: Letras minúsculas, números e hífenes. Comece com letras minúsculas. Termine com letra ou número em minúsculas. |
| localização | Localização do recurso. | cadeia (obrigatório) |
| parent_id | Para implementar num grupo de recursos, utilize o ID desse grupo de recursos. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. |
| propriedades | As propriedades do recurso do cluster | ClusterProperties |
ClusterProperties
| Nome | Descrição | Valor |
|---|---|---|
| addOnFeatures | A lista de funcionalidades de suplementos a ativar no cluster. | Matriz de cadeias que contém qualquer um dos seguintes: "BackupRestoreService" "DnsService" "RepairManager" |
| availableClusterVersions | As versões de runtime do Service Fabric disponíveis para este cluster. | ClusterVersionDetails[] |
| azureActiveDirectory | As definições de autenticação do AAD do cluster. | AzureActiveDirectory |
| certificado | O certificado a utilizar para proteger o cluster. O certificado fornecido será utilizado para a segurança do nó no nó no cluster, o certificado SSL para o ponto final de gestão do cluster e o cliente de administração predefinido. | CertificateDescription |
| clientCertificateCommonNames | A lista de certificados de cliente referenciados pelo nome comum que têm permissão para gerir o cluster. | ClientCertificateCommonName[] |
| clientCertificateThumbprints | A lista de certificados de cliente referenciados por thumbprint que têm permissão para gerir o cluster. | ClientCertificateThumbprint[] |
| clusterCodeVersion | A versão de runtime do Service Fabric do cluster. Esta propriedade só pode definir o utilizador quando upgradeMode está definido como "Manual". Para obter uma lista das versões disponíveis do Service Fabric para novos clusters, utilize a API ClusterVersion. Para obter a lista de versões disponíveis para clusters existentes, utilize availableClusterVersions. | string |
| clusterState | O estado atual do cluster. - WaitingForNodes - Indica que o recurso do cluster foi criado e que o fornecedor de recursos está à espera que a extensão da VM do Service Fabric arranque e comunique com o mesmo. - Implementação – indica que o runtime do Service Fabric está a ser instalado nas VMs. O recurso de cluster estará neste estado até que o cluster arranque e os serviços do sistema estejam em funcionamento. - BaselineUpgrade - Indica que o cluster está a atualizar para estabelecer a versão do cluster. Esta atualização é iniciada automaticamente quando o cluster arranca pela primeira vez. - UpgradeUserConfiguration - Indica que o cluster está a ser atualizado com a configuração fornecida pelo utilizador. - UpdatingUserCertificate - Indica que o cluster está a ser atualizado com o certificado fornecido pelo utilizador. - UpgradeInfrastructure - Indica que o cluster está a ser atualizado com a versão de runtime mais recente do Service Fabric. Isto só acontece quando o upgradeMode está definido como "Automático". - EnforcingClusterVersion - Indica que o cluster está numa versão diferente do esperado e que o cluster está a ser atualizado para a versão esperada. - UpgradeServiceUnreachable - Indica que o serviço de sistema no cluster já não está a consultar o Fornecedor de Recursos. Os clusters neste estado não podem ser geridos pelo Fornecedor de Recursos. - Dimensionamento Automático - Indica que o Nível de Fiabilidade do cluster está a ser ajustado. - Pronto - Indica que o cluster está num estado estável. |
"Dimensionamento Automático" "BaselineUpgrade" "Implementar" "EnforcingClusterVersion" “Pronto” "UpdatingInfrastructure" "UpdatingUserCertificate" "UpdatingUserConfiguration" "UpgradeServiceUnreachable" "WaitingForNodes" |
| diagnosticsStorageAccountConfig | As informações da conta de armazenamento para armazenar registos de diagnóstico do Service Fabric. | DiagnosticsStorageAccountConfig |
| recursos de infraestruturaDefinições | A lista de definições de recursos de infraestrutura personalizados para configurar o cluster. | SettingsSectionDescription[] |
| managementEndpoint | O ponto final de gestão http do cluster. | cadeia (obrigatório) |
| nodeTypes | A lista de tipos de nós no cluster. | NodeTypeDescription[] (obrigatório) |
| fiabilidadeLevel | O nível de fiabilidade define o tamanho do conjunto de réplicas dos serviços do sistema. Saiba mais sobre a FiabilidadeLevel. - Nenhum - Execute os serviços do Sistema com uma contagem de conjuntos de réplicas de destino de 1. Esta ação só deve ser utilizada para clusters de teste. - Bronze - Execute os serviços do Sistema com uma contagem de 3 conjuntos de réplicas de destino. Esta ação só deve ser utilizada para clusters de teste. - Prata – execute os serviços do Sistema com uma contagem de 5 conjuntos de réplicas de destino. - 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 9 conjuntos de réplicas de destino. |
"Bronze" "Dourado" "Nenhum" "Platina" "Prata" |
| reverseProxyCertificate | O certificado de servidor utilizado pelo proxy inverso. | CertificateDescription |
| upgradeDescription | A política a utilizar ao atualizar o cluster. | ClusterUpgradePolicy |
| upgradeMode | O modo de atualização do cluster quando está disponível a nova versão de runtime do Service Fabric. - Automático - O cluster será atualizado automaticamente para a versão de runtime mais recente do Service Fabric assim que estiver disponível. - Manual – o cluster não será atualizado automaticamente para a versão de runtime mais recente do Service Fabric. O cluster é atualizado ao definir a propriedade clusterCodeVersion no recurso do cluster. |
"Automático" "Manual" |
| vmImage | A VMSS da imagem de VM foi configurada com. Podem ser utilizados nomes genéricos, como Windows ou Linux. | string |
ClusterVersionDetails
| Nome | Descrição | Valor |
|---|---|---|
| codeVersion | A versão de runtime do Service Fabric do cluster. | string |
| ambiente | Indica se esta versão se destina ao sistema operativo Windows ou Linux. | "Linux" "Windows" |
| supportExpiryUtc | A data de expiração do suporte da versão. | string |
AzureActiveDirectory
| Nome | Descrição | Valor |
|---|---|---|
| clientApplication | ID da aplicação cliente do Azure Active Directory. | string |
| clusterApplication | ID da aplicação de cluster do Azure Active Directory. | string |
| tenantId | ID de inquilino do Azure Active Directory. | string |
CertificateDescription
| Nome | Descrição | Valor |
|---|---|---|
| thumbprint | Thumbprint do certificado primário. | cadeia (obrigatório) |
| thumbprintSecondary | Thumbprint do certificado secundário. | string |
| x509StoreName | A localização do arquivo de certificados local. | "AddressBook" "AuthRoot" "CertificateAuthority" "Não permitido" "O Meu" "Raiz" "TrustedPeople" "TrustedPublisher" |
ClientCertificateCommonName
| Nome | Descrição | Valor |
|---|---|---|
| certificateCommonName | O nome comum do certificado de cliente. | cadeia (obrigatório) |
| certificateIssuerThumbprint | O thumbprint do emissor do certificado de cliente. | cadeia (obrigatório) |
| isAdmin | Indica se o certificado de cliente tem acesso de administrador ao cluster. Os clientes não administradores só podem realizar operações só de leitura no cluster. | bool (obrigatório) |
ClientCertificateThumbprint
| Nome | Descrição | Valor |
|---|---|---|
| certificateThumbprint | O thumbprint do certificado de cliente. | cadeia (obrigatório) |
| isAdmin | Indica se o certificado de cliente tem acesso de administrador ao cluster. Os clientes não administradores só podem realizar operações só de leitura no cluster. | bool (obrigatório) |
DiagnosticsStorageAccountConfig
| Nome | Descrição | Valor |
|---|---|---|
| blobEndpoint | O ponto final do blob da conta de armazenamento do Azure. | cadeia (obrigatório) |
| protectedAccountKeyName | O nome da chave de armazenamento de diagnóstico protegido. | cadeia (obrigatório) |
| queueEndpoint | O ponto final da fila da conta de armazenamento do Azure. | cadeia (obrigatório) |
| storageAccountName | O nome da conta de armazenamento do Azure. | cadeia (obrigatório) |
| tableEndpoint | O ponto final da tabela da conta de armazenamento do Azure. | cadeia (obrigatório) |
SettingsSectionDescription
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da secção das definições de recursos de infraestrutura. | cadeia (obrigatório) |
| parâmetros | A coleção de parâmetros na secção . | SettingsParameterDescription[] (obrigatório) |
DefiniçõesParameterDescription
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do parâmetro da definição de recursos de infraestrutura. | cadeia (obrigatório) |
| valor | O valor do parâmetro da definição de recursos de infraestrutura. | cadeia (obrigatório) |
NodeTypeDescription
| Nome | Descrição | Valor |
|---|---|---|
| applicationPorts | O intervalo de portas a partir das quais o cluster atribuiu a porta às aplicações do Service Fabric. | EndpointRangeDescription |
| capacidades | As etiquetas de capacidade aplicadas aos nós no tipo de nó, o gestor de recursos do cluster utiliza estas etiquetas para compreender a quantidade de recursos que um nó tem. | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | A porta de ponto final de gestão do cluster TCP. | int (obrigatório) |
| durabilityLevel | O nível de durabilidade do tipo de nó. Saiba mais sobre DurabilityLevel. - Bronze - Sem privilégios. Esta é a predefinição. - Prata - As tarefas de infraestrutura podem ser colocadas em pausa durante 30 minutos por UD. - Ouro - As tarefas de infraestrutura podem ser colocadas em pausa durante 2 horas por UD. A durabilidade gold só pode ser ativada em skUs de VM de nó completos, como D15_V2, G5, etc. |
"Bronze" "Ouro" "Prata" |
| efémerosPorts | O intervalo de portas efémeras com que os nós neste tipo de nó devem ser configurados. | EndpointRangeDescription |
| httpGatewayEndpointPort | A porta de ponto final de gestão do cluster HTTP. | int (obrigatório) |
| isPrimary | O tipo de nó no qual os serviços de sistema serão executados. Apenas um tipo de nó deve ser marcado como primário. Não é possível eliminar ou alterar o tipo de nó principal para clusters existentes. | bool (obrigatório) |
| name | O nome do tipo de nó. | cadeia (obrigatório) |
| placementProperties | As etiquetas de colocação aplicadas aos nós no tipo de nó, que podem ser utilizadas para indicar onde determinados serviços (carga de trabalho) devem ser executados. | NodeTypeDescriptionPlacementProperties |
| reverseProxyEndpointPort | O ponto final utilizado pelo proxy inverso. | int |
| vmInstanceCount | O número de nós no tipo de nó. Esta contagem deve corresponder à propriedade de capacidade no recurso VirtualMachineScaleSet correspondente. | int (obrigatório) Restrições: Valor mínimo = 1 Valor máximo = 2147483647 |
EndpointRangeDescription
| Nome | Descrição | Valor |
|---|---|---|
| endPort | Porta de fim de um intervalo de portas | int (obrigatório) |
| startPort | Porta inicial de um intervalo de portas | int (obrigatório) |
NodeTypeDescriptionCapacities
| Nome | Descrição | Valor |
|---|---|---|
| {customized property} | string |
NodeTypeDescriptionPlacementProperties
| Nome | Descrição | Valor |
|---|---|---|
| {customized property} | string |
ClusterUpgradePolicy
| Nome | Descrição | Valor |
|---|---|---|
| deltaHealthPolicy | A política de estado de funcionamento delta utilizada ao atualizar o cluster. | ClusterUpgradeDeltaHealthPolicy |
| 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 |
| 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 atualização ser revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
| 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. A duração pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
| healthCheckWaitDuration | O período de tempo a aguardar depois de concluir um domínio de atualização antes de efetuar verificações de estado de funcionamento. A duração pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
| healthPolicy | A política de estado de funcionamento do cluster utilizada ao atualizar o cluster. | ClusterHealthPolicy (obrigatório) |
| upgradeDomainTimeout | A quantidade de tempo que cada domínio de atualização tem de ser concluído antes de a atualização ser revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (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 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. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
| upgradeTimeout | A quantidade de tempo que a atualização geral tem de ser concluída antes de a atualização ser revertida. O tempo limite pode estar no formato hh:mm:ss ou no formato d.hh:mm:ss.ms. | cadeia (obrigatório) |
ClusterUpgradeDeltaHealthPolicy
| Nome | Descrição | Valor |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | A percentagem máxima permitida de degradação do estado de funcionamento das aplicações permitida durante as atualizações do cluster. O delta é medido entre o estado das aplicações no início da atualização e o estado das aplicações no momento da avaliação do estado de funcionamento. A verificação é efetuada após cada conclusão de atualização de domínio de atualização para garantir que o estado global do cluster está dentro dos limites tolerados. Os serviços de sistema não estão incluídos neste. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentDeltaUnhealthyNodes | A percentagem máxima permitida de degradação do estado de funcionamento dos nós permitida durante as atualizações do 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 do estado de funcionamento. A verificação é efetuada após cada conclusão de atualização de domínio de atualização para garantir que o estado global do cluster está dentro dos limites tolerados. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | A percentagem máxima permitida de degradação do estado de funcionamento dos nós de domínio de atualização permitida durante as atualizações do 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 do estado de funcionamento. A verificação é efetuada após cada conclusão de atualização de domínio de atualização para todos os domínios de atualização concluídos para garantir que o estado dos domínios de atualização está dentro dos limites tolerados. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
ClusterHealthPolicy
| Nome | Descrição | Valor |
|---|---|---|
| maxPercentUnhealthyApplications | A percentagem máxima permitida de aplicações em mau estado de funcionamento antes de comunicar um erro. Por exemplo, para permitir que 10% das aplicações estejam em mau estado de funcionamento, este valor seria 10. | int Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentUnhealthyNodes | A percentagem máxima permitida de nós em mau estado de funcionamento antes de comunicar um erro. Por exemplo, para permitir que 10% dos nós estejam em mau estado de funcionamento, este valor seria 10. | int Restrições: Valor mínimo = 0 Valor máximo = 100 |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários