Clusters Microsoft.ServiceFabric 2016-09-01
Definição de recurso do Bicep
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 Bicep ao seu modelo.
resource symbolicname 'Microsoft.ServiceFabric/clusters@2016-09-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
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'
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
}
overrideUserUpgradePolicy: bool
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 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 |
|---|---|---|
| azureActiveDirectory | As definições para ativar a autenticação do AAD no cluster | AzureActiveDirectory |
| certificado | Este certificado primário será utilizado como nó de cluster para segurança de nós, certificado SSL para o ponto final de gestão de clusters e cliente administrador predefinido | CertificateDescription |
| clientCertificateCommonNames | Lista de certificados de cliente a confiar com base em nomes comuns | ClientCertificateCommonName[] |
| clientCertificateThumbprints | Os detalhes do thumbprint do cliente são utilizados para o acesso ao cliente para a operação de cluster | ClientCertificateThumbprint[] |
| clusterCodeVersion | A versão do código ServiceFabric em execução no cluster | string |
| diagnosticsStorageAccountConfig | Os detalhes de configuração da conta de diagnóstico de armazenamento | DiagnosticsStorageAccountConfig |
| recursos de infraestruturaDefinições | 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 que compõem o cluster | NodeTypeDescription[] (obrigatório) |
| fiabilidadeLevel | O nível de fiabilidade do cluster indica o tamanho do conjunto de réplicas do serviço de sistema | 'Bronze' 'Gold' '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 indica se a atualização de recursos de infraestrutura é iniciada automaticamente pelo sistema ou não | "Automático" "Manual" |
| vmImage | O nome da VM image VMSS foi configurado com. Podem ser utilizados nomes genéricos, como Windows ou Linux. | 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 | Nome comum do certificado a conceder acesso; tenha cuidado ao utilizar nomes comuns de cartões selvagens | cadeia (obrigatório) |
| certificateIssuerThumbprint | Thumbprint do emissor de certificados | cadeia (obrigatório) |
| isAdmin | Este certificado é utilizado para o acesso de administrador do cliente, se for falso, for utilizado ou consultar apenas o acesso | bool (obrigatório) |
ClientCertificateThumbprint
| Nome | Descrição | Valor |
|---|---|---|
| certificateThumbprint | Thumbprint do certificado | cadeia (obrigatório) |
| isAdmin | Este certificado é utilizado para o acesso de administrador do cliente, se for falso, é utilizado ou consulta apenas acesso | bool (obrigatório) |
DiagnosticsStorageAccountConfig
| Nome | Descrição | Valor |
|---|---|---|
| blobEndpoint | Ponto final do blob da conta de armazenamento de diagnósticos | cadeia (obrigatório) |
| protectedAccountKeyName | Nome da chave de armazenamento de Diagnóstico Protegido | cadeia (obrigatório) |
| queueEndpoint | Ponto final da fila da conta de armazenamento de diagnósticos | cadeia (obrigatório) |
| storageAccountName | Nome da conta de armazenamento de diagnósticos | cadeia (obrigatório) |
| tableEndpoint | Ponto final da tabela da conta de armazenamento de diagnósticos | cadeia (obrigatório) |
SettingsSectionDescription
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da secção de definições | cadeia (obrigatório) |
| parâmetros | Coleção de definições na secção, cada definição é uma cadeia de identificação que consiste em definir o nome e o valor | SettingsParameterDescription[] (obrigatório) |
DefiniçõesParameterDescription
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da propriedade definições | cadeia (obrigatório) |
| valor | O valor da propriedade | cadeia (obrigatório) |
NodeTypeDescription
| Nome | Descrição | Valor |
|---|---|---|
| applicationPorts | Portas utilizadas pelas aplicações | 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 um recurso que um nó tem | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | A porta de ponto final de gestão do cluster TCP | int (obrigatório) |
| durabilityLevel | Nível de durabilidade do tipo de nó | 'Bronze' 'Gold' 'Prata' |
| efémerosPorts | Portas de aplicação atribuídas pelo sistema | EndpointRangeDescription |
| httpGatewayEndpointPort | A porta de ponto final de gestão do cluster HTTP | int (obrigatório) |
| isPrimary | Marcar isto como o tipo de nó principal | bool (obrigatório) |
| name | 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 | Ponto final utilizado pelo proxy inverso | int |
| vmInstanceCount | O número de instâncias de nós no tipo de nó | 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 de início 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 | Política de estado de funcionamento delta | ClusterUpgradeDeltaHealthPolicy |
| forceRestart | Forçar o nó a reiniciar ou não | bool |
| healthCheckRetryTimeout | O período de tempo em que as verificações de estado de funcionamento podem falhar continuamente, representa o TimeSpan do .Net | cadeia (obrigatório) |
| healthCheckStableDuration | O período de tempo que as verificações de estado de funcionamento têm de passar continuamente, representa o .Net TimeSpan | 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, representa o .Net TimeSpan | cadeia (obrigatório) |
| healthPolicy | Política de estado de funcionamento do cluster | ClusterHealthPolicy (obrigatório) |
| overrideUserUpgradePolicy | Utilizar ou não a política de atualização definida pelo utilizador | bool |
| upgradeDomainTimeout | O tempo limite para qualquer domínio de atualização, representa o .Net TimeSpan | cadeia (obrigatório) |
| upgradeReplicaSetCheckTimeout | Tempo limite para a atualização do conjunto de réplicas ser concluída, representa o TimeSpan do .Net | cadeia (obrigatório) |
| upgradeTimeout | O tempo limite da atualização representa o .Net TimeSpan | cadeia (obrigatório) |
ClusterUpgradeDeltaHealthPolicy
| Nome | Descrição | Valor |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | Percentagem adicional de aplicações em mau estado de funcionamento | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentDeltaUnhealthyNodes | Percentagem adicional de nós em mau estado de funcionamento | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | Percentagem adicional de nós em mau estado de funcionamento por domínio de atualização | 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 num 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 Datacenter do Windows Server 2016 numa VM de Tamanho Standard_D2. 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 modelo arm
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 JSON ao seu modelo.
{
"type": "Microsoft.ServiceFabric/clusters",
"apiVersion": "2016-09-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"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",
"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"
},
"overrideUserUpgradePolicy": "bool",
"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 | '2016-09-01' |
| 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 |
|---|---|---|
| azureActiveDirectory | As definições para ativar a autenticação do AAD no cluster | AzureActiveDirectory |
| certificado | Este certificado primário será utilizado como nó de cluster para segurança de nós, certificado SSL para o ponto final de gestão do cluster e cliente de administração predefinido | CertificateDescription |
| clientCertificateCommonNames | Lista de certificados de cliente a confiar com base em nomes comuns | ClientCertificateCommonName[] |
| clientCertificateThumbprints | Os detalhes do thumbprint do cliente são utilizados para o acesso de cliente para a operação de cluster | ClientCertificateThumbprint[] |
| clusterCodeVersion | A versão do código ServiceFabric em execução no cluster | string |
| diagnosticsStorageAccountConfig | Os detalhes de configuração da conta de diagnóstico de armazenamento | DiagnosticsStorageAccountConfig |
| recursos de infraestruturaDefinições | 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 que compõem o cluster | NodeTypeDescription[] (obrigatório) |
| fiabilidadeLevel | O nível de fiabilidade do cluster indica o tamanho do conjunto de réplicas do serviço de sistema | 'Bronze' 'Gold' '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 indica se a atualização de recursos de infraestrutura é iniciada automaticamente pelo sistema ou não | "Automático" "Manual" |
| vmImage | O nome da VM image VMSS foi configurado com. Podem ser utilizados nomes genéricos, como Windows ou Linux. | 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 | Nome comum do certificado a conceder acesso; tenha cuidado ao utilizar nomes comuns de cartões selvagens | cadeia (obrigatório) |
| certificateIssuerThumbprint | Thumbprint do emissor de certificados | cadeia (obrigatório) |
| isAdmin | Este certificado é utilizado para o acesso de administrador do cliente, se for falso, for utilizado ou consultar apenas o acesso | bool (obrigatório) |
ClientCertificateThumbprint
| Nome | Descrição | Valor |
|---|---|---|
| certificateThumbprint | Thumbprint do certificado | cadeia (obrigatório) |
| isAdmin | Este certificado é utilizado para o acesso de administrador do cliente, se for falso, é utilizado ou consulta apenas acesso | bool (obrigatório) |
DiagnosticsStorageAccountConfig
| Nome | Descrição | Valor |
|---|---|---|
| blobEndpoint | Ponto final do blob da conta de armazenamento de diagnósticos | cadeia (obrigatório) |
| protectedAccountKeyName | Nome da chave de armazenamento de Diagnóstico Protegido | cadeia (obrigatório) |
| queueEndpoint | Ponto final da fila da conta de armazenamento de diagnósticos | cadeia (obrigatório) |
| storageAccountName | Nome da conta de armazenamento de diagnósticos | cadeia (obrigatório) |
| tableEndpoint | Ponto final da tabela da conta de armazenamento de diagnósticos | cadeia (obrigatório) |
SettingsSectionDescription
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da secção de definições | cadeia (obrigatório) |
| parâmetros | Coleção de definições na secção, cada definição é uma cadeia de identificação que consiste em definir o nome e o valor | SettingsParameterDescription[] (obrigatório) |
DefiniçõesParameterDescription
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da propriedade de definições | cadeia (obrigatório) |
| valor | O valor da propriedade | cadeia (obrigatório) |
NodeTypeDescription
| Nome | Descrição | Valor |
|---|---|---|
| applicationPorts | Portas utilizadas pelas aplicações | 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 um recurso que um nó tem | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | A porta de ponto final de gestão do cluster TCP | int (obrigatório) |
| durabilityLevel | Nível de durabilidade do tipo de nó | 'Bronze' 'Gold' 'Prata' |
| efémerosPorts | Portas de aplicação atribuídas pelo sistema | EndpointRangeDescription |
| httpGatewayEndpointPort | A porta de ponto final de gestão do cluster HTTP | int (obrigatório) |
| isPrimary | Marcar como o tipo de nó principal | bool (obrigatório) |
| name | 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 | Ponto final utilizado pelo proxy inverso | int |
| vmInstanceCount | O número de instâncias de nós no tipo de nó | 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 | Política de estado de funcionamento Delta | ClusterUpgradeDeltaHealthPolicy |
| forceRestart | Forçar o nó a reiniciar ou não | bool |
| healthCheckRetryTimeout | O período de tempo durante o qual as verificações de estado de funcionamento podem falhar continuamente, representa o TimeSpan do .Net | cadeia (obrigatório) |
| healthCheckStableDuration | O período de tempo durante o qual as verificações de estado de funcionamento têm de passar continuamente, representa o TimeSpan do .Net | 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, representa o TimeSpan do .Net | cadeia (obrigatório) |
| healthPolicy | Política de estado de funcionamento do cluster | ClusterHealthPolicy (obrigatório) |
| overrideUserUpgradePolicy | Utilizar a política de atualização definida pelo utilizador ou não | bool |
| upgradeDomainTimeout | O tempo limite para qualquer domínio de atualização, representa o TimeSpan do .Net | cadeia (obrigatório) |
| upgradeReplicaSetCheckTimeout | Tempo limite para a conclusão da atualização do conjunto de réplicas, representa o TimeSpan do .Net | cadeia (obrigatório) |
| upgradeTimeout | O tempo limite da atualização representa o TimeSpan do .Net | cadeia (obrigatório) |
ClusterUpgradeDeltaHealthPolicy
| Nome | Descrição | Valor |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | Percentagem adicional de aplicações em mau estado de funcionamento | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentDeltaUnhealthyNodes | Percentagem adicional de nós em mau estado de funcionamento | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | Percentagem adicional de nós em mau estado de funcionamento por domínio de atualização | 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 num 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 Datacenter do Windows Server 2016 numa VM de Tamanho Standard_D2. 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 terraform (fornecedor AzAPI)
O tipo de recurso dos clusters pode ser implementado com operações que visam:
- Grupos de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.ServiceFabric/clusters, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceFabric/clusters@2016-09-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
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"
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
}
overrideUserUpgradePolicy = bool
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@2016-09-01" |
| 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) |
| 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 |
|---|---|---|
| azureActiveDirectory | As definições para ativar a autenticação do AAD no cluster | AzureActiveDirectory |
| certificado | Este certificado primário será utilizado como nó de cluster para segurança de nós, certificado SSL para o ponto final de gestão de clusters e cliente administrador predefinido | CertificateDescription |
| clientCertificateCommonNames | Lista de certificados de cliente a confiar com base em nomes comuns | ClientCertificateCommonName[] |
| clientCertificateThumbprints | Os detalhes do thumbprint do cliente são utilizados para o acesso ao cliente para a operação de cluster | ClientCertificateThumbprint[] |
| clusterCodeVersion | A versão do código ServiceFabric em execução no cluster | string |
| diagnosticsStorageAccountConfig | Os detalhes de configuração da conta de diagnóstico de armazenamento | DiagnosticsStorageAccountConfig |
| recursos de infraestruturaDefinições | 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 que compõem o cluster | NodeTypeDescription[] (obrigatório) |
| fiabilidadeLevel | O nível de fiabilidade do cluster indica o tamanho do conjunto de réplicas do serviço de sistema | "Bronze" "Dourado" "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 indica se a atualização de recursos de infraestrutura é iniciada automaticamente pelo sistema ou não | "Automático" "Manual" |
| vmImage | O nome da VM image VMSS foi configurado com. Podem ser utilizados nomes genéricos, como Windows ou Linux. | 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 | Nome comum do certificado a conceder acesso; tenha cuidado ao utilizar nomes comuns de cartões selvagens | cadeia (obrigatório) |
| certificateIssuerThumbprint | Thumbprint do emissor de certificados | cadeia (obrigatório) |
| isAdmin | Este certificado é utilizado para o acesso de administrador do cliente, se for falso, for utilizado ou consultar apenas o acesso | bool (obrigatório) |
ClientCertificateThumbprint
| Nome | Descrição | Valor |
|---|---|---|
| certificateThumbprint | Thumbprint do certificado | cadeia (obrigatório) |
| isAdmin | Este certificado é utilizado para o acesso de administrador do cliente, se for falso, é utilizado ou consulta apenas acesso | bool (obrigatório) |
DiagnosticsStorageAccountConfig
| Nome | Descrição | Valor |
|---|---|---|
| blobEndpoint | Ponto final do blob da conta de armazenamento de diagnósticos | cadeia (obrigatório) |
| protectedAccountKeyName | Nome da chave de armazenamento de Diagnóstico Protegido | cadeia (obrigatório) |
| queueEndpoint | Ponto final da fila da conta de armazenamento de diagnósticos | cadeia (obrigatório) |
| storageAccountName | Nome da conta de armazenamento de diagnósticos | cadeia (obrigatório) |
| tableEndpoint | Ponto final da tabela da conta de armazenamento de diagnósticos | cadeia (obrigatório) |
SettingsSectionDescription
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da secção de definições | cadeia (obrigatório) |
| parâmetros | Coleção de definições na secção, cada definição é uma cadeia de identificação que consiste em definir o nome e o valor | SettingsParameterDescription[] (obrigatório) |
DefiniçõesParameterDescription
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome da propriedade de definições | cadeia (obrigatório) |
| valor | O valor da propriedade | cadeia (obrigatório) |
NodeTypeDescription
| Nome | Descrição | Valor |
|---|---|---|
| applicationPorts | Portas utilizadas pelas aplicações | 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 um recurso que um nó tem | NodeTypeDescriptionCapacities |
| clientConnectionEndpointPort | A porta de ponto final de gestão do cluster TCP | int (obrigatório) |
| durabilityLevel | Nível de durabilidade do tipo de nó | "Bronze" "Ouro" "Prata" |
| efémerosPorts | Portas de aplicação atribuídas pelo sistema | EndpointRangeDescription |
| httpGatewayEndpointPort | A porta de ponto final de gestão do cluster HTTP | int (obrigatório) |
| isPrimary | Marcar como o tipo de nó principal | bool (obrigatório) |
| name | 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 | Ponto final utilizado pelo proxy inverso | int |
| vmInstanceCount | O número de instâncias de nós no tipo de nó | 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 de início 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 | Política de estado de funcionamento delta | ClusterUpgradeDeltaHealthPolicy |
| forceRestart | Forçar o nó a reiniciar ou não | bool |
| healthCheckRetryTimeout | O período de tempo em que as verificações de estado de funcionamento podem falhar continuamente, representa o TimeSpan do .Net | cadeia (obrigatório) |
| healthCheckStableDuration | O período de tempo que as verificações de estado de funcionamento têm de passar continuamente, representa o .Net TimeSpan | 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, representa o .Net TimeSpan | cadeia (obrigatório) |
| healthPolicy | Política de estado de funcionamento do cluster | ClusterHealthPolicy (obrigatório) |
| overrideUserUpgradePolicy | Utilizar ou não a política de atualização definida pelo utilizador | bool |
| upgradeDomainTimeout | O tempo limite para qualquer domínio de atualização, representa o .Net TimeSpan | cadeia (obrigatório) |
| upgradeReplicaSetCheckTimeout | Tempo limite para a atualização do conjunto de réplicas ser concluída, representa o TimeSpan do .Net | cadeia (obrigatório) |
| upgradeTimeout | O tempo limite da atualização representa o .Net TimeSpan | cadeia (obrigatório) |
ClusterUpgradeDeltaHealthPolicy
| Nome | Descrição | Valor |
|---|---|---|
| maxPercentDeltaUnhealthyApplications | Percentagem adicional de aplicações em mau estado de funcionamento | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentDeltaUnhealthyNodes | Percentagem adicional de nós em mau estado de funcionamento | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 100 |
| maxPercentUpgradeDomainDeltaUnhealthyNodes | Percentagem adicional de nós em mau estado de funcionamento por domínio de atualização | 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