Condividi tramite


Cluster Microsoft.ServiceFabric 2019-03-01

Definizione di risorsa Bicep

Il tipo di risorsa cluster può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.ServiceFabric/clusters, aggiungere il bicep seguente al modello.

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

Valori delle proprietà

ApplicationDeltaHealthPolicy

Nome Descrizione Valore
defaultServiceTypeDeltaHealthPolicy I criteri di integrità differenziale usati per impostazione predefinita per valutare l'integrità di un tipo di servizio durante l'aggiornamento del cluster. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies Mappa con i criteri di integrità differenziali del tipo di servizio per ogni nome del tipo di servizio. La mappa è vuota per impostazione predefinita. ServiceTypeDeltaHealthPolicyMap

ApplicationDeltaHealthPolicyMap

Nome Descrizione Valore

ApplicationHealthPolicy

Nome Descrizione Valore
defaultServiceTypeHealthPolicy Criteri di integrità usati per impostazione predefinita per valutare l'integrità di un tipo di servizio. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Mappa con i criteri di integrità del tipo di servizio per ogni nome del tipo di servizio. La mappa è vuota per impostazione predefinita. ServiceTypeHealthPolicyMap

ApplicationHealthPolicyMap

Nome Descrizione Valore

AzureActiveDirectory

Nome Descrizione Valore
clientApplication ID applicazione client di Azure Active Directory. corda
clusterApplication ID applicazione cluster di Azure Active Directory. corda
tenantId ID tenant di Azure Active Directory. corda

CertificateDescription

Nome Descrizione Valore
Identificazione personale Identificazione personale del certificato primario. stringa (obbligatorio)
thumbprintSecondary Identificazione personale del certificato secondario. corda
x509StoreName Percorso dell'archivio certificati locale. 'AddressBook'
'AuthRoot'
'CertificateAuthority'
'Non consentito'
'My'
'Root'
'TrustedPeople'
'TrustedPublisher'

ClientCertificateCommonName

Nome Descrizione Valore
certificateCommonName Nome comune del certificato client. stringa (obbligatorio)
certificateIssuerThumbprint Identificazione personale dell'autorità di certificazione del certificato client. stringa (obbligatorio)
isAdmin Indica se il certificato client ha accesso amministratore al cluster. I client non amministratori possono eseguire solo operazioni di sola lettura nel cluster. bool (obbligatorio)

ClientCertificateThumbprint

Nome Descrizione Valore
certificateThumbprint Identificazione personale del certificato client. stringa (obbligatorio)
isAdmin Indica se il certificato client ha accesso amministratore al cluster. I client non amministratori possono eseguire solo operazioni di sola lettura nel cluster. bool (obbligatorio)

ClusterHealthPolicy

Nome Descrizione Valore
applicationHealthPolicies Definisce la mappa dei criteri di integrità dell'applicazione usata per valutare l'integrità di un'applicazione o di una delle relative entità figlio. ApplicationHealthPolicyMap
maxPercentUnhealthyApplications Percentuale massima consentita di applicazioni non integre prima di segnalare un errore. Ad esempio, per consentire che 10% di applicazioni non siano integre, questo valore sarà 10.

La percentuale rappresenta la percentuale massima tollerata di applicazioni che possono non essere integre prima che il cluster venga considerato in errore.
Se la percentuale viene rispettata ma è presente almeno un'applicazione non integra, l'integrità viene valutata come Avviso.
Questo valore viene calcolato dividendo il numero di applicazioni non integre rispetto al numero totale di istanze dell'applicazione nel cluster, escluse le applicazioni di tipi di applicazione inclusi in ApplicationTypeHealthPolicyMap.
Il calcolo arrotonda fino a tollerare un errore in un numero ridotto di applicazioni. La percentuale predefinita è zero.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100
maxPercentUnhealthyNodes Percentuale massima consentita di nodi non integri prima di segnalare un errore. Ad esempio, per consentire che 10% di nodi non siano integri, questo valore sarà 10.

La percentuale rappresenta la percentuale massima tollerata di nodi che possono non essere integri prima che il cluster venga considerato in errore.
Se la percentuale viene rispettata ma è presente almeno un nodo non integro, l'integrità viene valutata come Avviso.
La percentuale viene calcolata dividendo il numero di nodi non integri rispetto al numero totale di nodi nel cluster.
Il calcolo arrotonda fino a tollerare un errore in un numero ridotto di nodi. La percentuale predefinita è zero.

In cluster di grandi dimensioni alcuni nodi saranno sempre inattivo o inattivo per le riparazioni, quindi questa percentuale deve essere configurata per tollerarlo.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100

Proprietà cluster

Nome Descrizione Valore
addOnFeatures Elenco delle funzionalità del componente aggiuntivo da abilitare nel cluster. Matrice di stringhe contenente uno dei seguenti elementi:
'BackupRestoreService'
'DnsService'
'RepairManager'
'ResourceMonitorService'
azureActiveDirectory Impostazioni di autenticazione di AAD del cluster. azureActiveDirectory
certificato Certificato da usare per proteggere il cluster. Il certificato fornito verrà usato per la sicurezza da nodo a nodo all'interno del cluster, certificato SSL per l'endpoint di gestione del cluster e client amministratore predefinito. CertificateDescription
certificateCommonNames Descrive un elenco di certificati server a cui fa riferimento il nome comune usato per proteggere il cluster. serverCertificateCommonNames
clientCertificateCommonNames Elenco dei certificati client a cui fa riferimento il nome comune autorizzato a gestire il cluster. ClientCertificateCommonName[]
clientCertificateThumbprints Elenco dei certificati client a cui fa riferimento l'identificazione personale consentita per gestire il cluster. ClientCertificateThumbprint[]
clusterCodeVersion Versione del runtime di Service Fabric del cluster. Questa proprietà può essere impostata solo dall'utente quando upgradeMode è impostato su 'Manual'. Per ottenere l'elenco delle versioni di Service Fabric disponibili per i nuovi cluster, usare 'API ClusterVersion. Per ottenere l'elenco della versione disponibile per i cluster esistenti, usare disponibiliClusterVersions. corda
diagnosticsStorageAccountConfig Informazioni sull'account di archiviazione per l'archiviazione dei log di diagnostica di Service Fabric. DiagnosticsStorageAccountConfig
eventStoreServiceEnabled Indica se il servizio dell'archivio eventi è abilitato. Bool
fabricSettings Elenco di impostazioni di infrastruttura personalizzate per configurare il cluster. SettingsSectionDescription[]
managementEndpoint Endpoint di gestione HTTP del cluster. stringa (obbligatorio)
nodeTypes Elenco dei tipi di nodo nel cluster. NodeTypeDescription[] (obbligatorio)
reliabilityLevel Il livello di affidabilità imposta le dimensioni del set di repliche dei servizi di sistema. Informazioni su ReliabilityLevel.

- Nessuno: eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 1. Questa operazione deve essere usata solo per i cluster di test.
- Bronze : eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 3. Questa operazione deve essere usata solo per i cluster di test.
- Silver: eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 5.
- Gold: eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 7.
- Platinum: eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 9.
'Bronze'
'Oro'
'Nessuno'
'Platinum'
'Silver'
reverseProxyCertificate Certificato server utilizzato dal proxy inverso. CertificateDescription
reverseProxyCertificateCommonNames Descrive un elenco di certificati server a cui fa riferimento il nome comune usato per proteggere il cluster. serverCertificateCommonNames
upgradeDescription Criteri da usare durante l'aggiornamento del cluster. ClusterUpgradePolicy
upgradeMode Modalità di aggiornamento del cluster quando è disponibile una nuova versione del runtime di Service Fabric.

- Automatico: il cluster verrà aggiornato automaticamente alla versione più recente del runtime di Service Fabric non appena è disponibile.
- Manuale: il cluster non verrà aggiornato automaticamente alla versione più recente del runtime di Service Fabric. Il cluster viene aggiornato impostando la proprietà clusterCodeVersion nella risorsa cluster.
'Automatico'
'Manual'
vmImage Il set di scalabilità di macchine virtuali dell'immagine della macchina virtuale è stato configurato con . È possibile usare nomi generici come Windows o Linux. corda

ClusterUpgradeDeltaHealthPolicy

Nome Descrizione Valore
applicationDeltaHealthPolicies Definisce la mappa dei criteri di integrità differenziale dell'applicazione usata per valutare l'integrità di un'applicazione o una delle relative entità figlio durante l'aggiornamento del cluster. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications Percentuale massima consentita di riduzione dell'integrità delle applicazioni consentita durante gli aggiornamenti del cluster.
Il delta viene misurato tra lo stato delle applicazioni all'inizio dell'aggiornamento e lo stato delle applicazioni al momento della valutazione dell'integrità.
Il controllo viene eseguito dopo il completamento di ogni aggiornamento del dominio di aggiornamento per assicurarsi che lo stato globale del cluster sia entro limiti tollerati. I servizi di sistema non sono inclusi in questo.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100 (obbligatorio)
maxPercentDeltaUnhealthyNodes Percentuale massima consentita di riduzione dell'integrità dei nodi consentita durante gli aggiornamenti del cluster.
Il delta viene misurato tra lo stato dei nodi all'inizio dell'aggiornamento e lo stato dei nodi al momento della valutazione dell'integrità.
Il controllo viene eseguito dopo il completamento di ogni aggiornamento del dominio di aggiornamento per assicurarsi che lo stato globale del cluster sia entro limiti tollerati.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100 (obbligatorio)
maxPercentUpgradeDomainDeltaUnhealthyNodes Percentuale massima consentita di riduzione dell'integrità dei nodi del dominio di aggiornamento consentita durante gli aggiornamenti del cluster.
Il delta viene misurato tra lo stato dei nodi del dominio di aggiornamento all'inizio dell'aggiornamento e lo stato dei nodi del dominio di aggiornamento al momento della valutazione dell'integrità.
Il controllo viene eseguito dopo ogni completamento dell'aggiornamento del dominio di aggiornamento per tutti i domini di aggiornamento completati per assicurarsi che lo stato dei domini di aggiornamento sia entro limiti tollerati.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100 (obbligatorio)

ClusterUpgradePolicy

Nome Descrizione Valore
deltaHealthPolicy Criteri di integrità differenziale del cluster usati durante l'aggiornamento del cluster. ClusterUpgradeDeltaHealthPolicy
forceRestart Se true, i processi vengono riavviati forzatamente durante l'aggiornamento anche quando la versione del codice non è stata modificata (l'aggiornamento modifica solo la configurazione o i dati). Bool
healthCheckRetryTimeout Tempo di ripetizione della valutazione dell'integrità quando l'applicazione o il cluster non è integro prima del rollback dell'aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
healthCheckStableDuration Periodo di tempo in cui l'applicazione o il cluster deve rimanere integro prima che l'aggiornamento proceda al dominio di aggiornamento successivo. La durata può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
healthCheckWaitDuration Periodo di attesa dopo il completamento di un dominio di aggiornamento prima di eseguire i controlli di integrità. La durata può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
healthPolicy Criteri di integrità del cluster usati durante l'aggiornamento del cluster. clusterHealthPolicy (obbligatorio)
upgradeDomainTimeout Tempo necessario per il completamento di ogni dominio di aggiornamento prima del rollback dell'aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
upgradeReplicaSetCheckTimeout Quantità massima di tempo per bloccare l'elaborazione di un dominio di aggiornamento e impedire la perdita di disponibilità in caso di problemi imprevisti. Alla scadenza di questo timeout, l'elaborazione del dominio di aggiornamento procederà indipendentemente dai problemi di perdita di disponibilità. Il timeout viene reimpostato all'inizio di ogni dominio di aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
upgradeTimeout Tempo necessario per il completamento dell'aggiornamento complessivo prima del rollback dell'aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)

DiagnosticsStorageAccountConfig

Nome Descrizione Valore
blobEndpoint Endpoint BLOB dell'account di archiviazione di Azure. stringa (obbligatorio)
protectedAccountKeyName Nome della chiave di archiviazione di diagnostica protetta. stringa (obbligatorio)
queueEndpoint Endpoint della coda dell'account di archiviazione di Azure. stringa (obbligatorio)
storageAccountName Nome dell'account di archiviazione di Azure. stringa (obbligatorio)
tableEndpoint Endpoint della tabella dell'account di archiviazione di Azure. stringa (obbligatorio)

EndpointRangeDescription

Nome Descrizione Valore
endPort Porta finale di un intervallo di porte int (obbligatorio)
startPort Porta iniziale di un intervallo di porte int (obbligatorio)

Microsoft.ServiceFabric/clusters

Nome Descrizione Valore
ubicazione Località delle risorse di Azure. stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà delle risorse del cluster ClusterProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

NodeTypeDescription

Nome Descrizione Valore
applicationPorts Intervallo di porte da cui il cluster ha assegnato la porta alle applicazioni di Service Fabric. EndpointRangeDescription
Capacità I tag di capacità applicati ai nodi nel tipo di nodo, gestione risorse cluster usa questi tag per comprendere la quantità di risorse di un nodo. NodeTypeDescriptionCapacities
clientConnectionEndpointPort Porta dell'endpoint di gestione del cluster TCP. int (obbligatorio)
durabilitàLevel Livello di durabilità del tipo di nodo. Informazioni su DurabilitàLevel.

- Bronzo - Nessun privilegio. Si tratta dell'impostazione predefinita.
- Silver: i processi dell'infrastruttura possono essere sospesi per una durata di 10 minuti per tipo definito dall'utente.
- Gold: i processi di infrastruttura possono essere sospesi per una durata di 2 ore per ogni UD. La durabilità Gold può essere abilitata solo in SKU di macchine virtuali a nodo completo, ad esempio D15_V2, G5 e così via.
'Bronze'
'Oro'
'Silver'
effimeroPorts L'intervallo di porte temporanee con cui devono essere configurati i nodi in questo tipo di nodo. EndpointRangeDescription
httpGatewayEndpointPort Porta dell'endpoint di gestione del cluster HTTP. int (obbligatorio)
isPrimary Tipo di nodo in cui verranno eseguiti i servizi di sistema. Un solo tipo di nodo deve essere contrassegnato come primario. Non è possibile eliminare o modificare il tipo di nodo primario per i cluster esistenti. bool (obbligatorio)
nome Nome del tipo di nodo. stringa (obbligatorio)
placementProperties I tag di posizionamento applicati ai nodi nel tipo di nodo, che possono essere usati per indicare dove devono essere eseguiti determinati servizi (carico di lavoro). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Endpoint usato dal proxy inverso. Int
vmInstanceCount Numero di nodi nel tipo di nodo. Questo conteggio deve corrispondere alla proprietà capacity nella risorsa VirtualMachineScaleSet corrispondente. Int

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647 (obbligatorio)

NodeTypeDescriptionCapacities

Nome Descrizione Valore

NodeTypeDescriptionPlacementProperties

Nome Descrizione Valore

ResourceTags

Nome Descrizione Valore

ServerCertificateCommonName

Nome Descrizione Valore
certificateCommonName Nome comune del certificato del server. stringa (obbligatorio)
certificateIssuerThumbprint Identificazione personale dell'autorità di certificazione del certificato del server. stringa (obbligatorio)

ServerCertificateCommonNames

Nome Descrizione Valore
commonNames Elenco di certificati server a cui fa riferimento il nome comune usato per proteggere il cluster. ServerCertificateCommonName[]
x509StoreName Percorso dell'archivio certificati locale. 'AddressBook'
'AuthRoot'
'CertificateAuthority'
'Non consentito'
'My'
'Root'
'TrustedPeople'
'TrustedPublisher'

ServiceTypeDeltaHealthPolicy

Nome Descrizione Valore
maxPercentDeltaUnhealthyServices Percentuale massima consentita di riduzione dell'integrità dei servizi consentita durante gli aggiornamenti del cluster.
Il delta viene misurato tra lo stato dei servizi all'inizio dell'aggiornamento e lo stato dei servizi al momento della valutazione dell'integrità.
Il controllo viene eseguito dopo il completamento di ogni aggiornamento del dominio di aggiornamento per assicurarsi che lo stato globale del cluster sia entro limiti tollerati.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100

ServiceTypeDeltaHealthPolicyMap

Nome Descrizione Valore

ServiceTypeHealthPolicy

Nome Descrizione Valore
maxPercentUnhealthyServices Percentuale massima di servizi non integri prima che l'applicazione venga considerata in errore. Int

Vincoli:
Valore minimo = 0
Valore massimo = 100

ServiceTypeHealthPolicyMap

Nome Descrizione Valore

SettingsParameterDescription

Nome Descrizione Valore
nome Nome del parametro dell'impostazione dell'infrastruttura. stringa (obbligatorio)
valore Valore del parametro dell'impostazione dell'infrastruttura. stringa (obbligatorio)

SettingsSectionDescription

Nome Descrizione Valore
nome Nome della sezione delle impostazioni dell'infrastruttura. stringa (obbligatorio)
Parametri Raccolta di parametri nella sezione . SettingsParameterDescription[] (obbligatorio)

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File Descrizione
Distribuire un cluster sicuro a 5 nodi Questo modello consente di distribuire un cluster di Service Fabric sicuro a 5 nodi che esegue Windows Server 2019 Datacenter in un set di scalabilità di macchine virtuali di dimensioni Standard_D2_v2.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa cluster può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.ServiceFabric/clusters, aggiungere il codice JSON seguente al modello.

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

Valori delle proprietà

ApplicationDeltaHealthPolicy

Nome Descrizione Valore
defaultServiceTypeDeltaHealthPolicy I criteri di integrità differenziale usati per impostazione predefinita per valutare l'integrità di un tipo di servizio durante l'aggiornamento del cluster. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies Mappa con i criteri di integrità differenziali del tipo di servizio per ogni nome del tipo di servizio. La mappa è vuota per impostazione predefinita. ServiceTypeDeltaHealthPolicyMap

ApplicationDeltaHealthPolicyMap

Nome Descrizione Valore

ApplicationHealthPolicy

Nome Descrizione Valore
defaultServiceTypeHealthPolicy Criteri di integrità usati per impostazione predefinita per valutare l'integrità di un tipo di servizio. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Mappa con i criteri di integrità del tipo di servizio per ogni nome del tipo di servizio. La mappa è vuota per impostazione predefinita. ServiceTypeHealthPolicyMap

ApplicationHealthPolicyMap

Nome Descrizione Valore

AzureActiveDirectory

Nome Descrizione Valore
clientApplication ID applicazione client di Azure Active Directory. corda
clusterApplication ID applicazione cluster di Azure Active Directory. corda
tenantId ID tenant di Azure Active Directory. corda

CertificateDescription

Nome Descrizione Valore
Identificazione personale Identificazione personale del certificato primario. stringa (obbligatorio)
thumbprintSecondary Identificazione personale del certificato secondario. corda
x509StoreName Percorso dell'archivio certificati locale. 'AddressBook'
'AuthRoot'
'CertificateAuthority'
'Non consentito'
'My'
'Root'
'TrustedPeople'
'TrustedPublisher'

ClientCertificateCommonName

Nome Descrizione Valore
certificateCommonName Nome comune del certificato client. stringa (obbligatorio)
certificateIssuerThumbprint Identificazione personale dell'autorità di certificazione del certificato client. stringa (obbligatorio)
isAdmin Indica se il certificato client ha accesso amministratore al cluster. I client non amministratori possono eseguire solo operazioni di sola lettura nel cluster. bool (obbligatorio)

ClientCertificateThumbprint

Nome Descrizione Valore
certificateThumbprint Identificazione personale del certificato client. stringa (obbligatorio)
isAdmin Indica se il certificato client ha accesso amministratore al cluster. I client non amministratori possono eseguire solo operazioni di sola lettura nel cluster. bool (obbligatorio)

ClusterHealthPolicy

Nome Descrizione Valore
applicationHealthPolicies Definisce la mappa dei criteri di integrità dell'applicazione usata per valutare l'integrità di un'applicazione o di una delle relative entità figlio. ApplicationHealthPolicyMap
maxPercentUnhealthyApplications Percentuale massima consentita di applicazioni non integre prima di segnalare un errore. Ad esempio, per consentire che 10% di applicazioni non siano integre, questo valore sarà 10.

La percentuale rappresenta la percentuale massima tollerata di applicazioni che possono non essere integre prima che il cluster venga considerato in errore.
Se la percentuale viene rispettata ma è presente almeno un'applicazione non integra, l'integrità viene valutata come Avviso.
Questo valore viene calcolato dividendo il numero di applicazioni non integre rispetto al numero totale di istanze dell'applicazione nel cluster, escluse le applicazioni di tipi di applicazione inclusi in ApplicationTypeHealthPolicyMap.
Il calcolo arrotonda fino a tollerare un errore in un numero ridotto di applicazioni. La percentuale predefinita è zero.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100
maxPercentUnhealthyNodes Percentuale massima consentita di nodi non integri prima di segnalare un errore. Ad esempio, per consentire che 10% di nodi non siano integri, questo valore sarà 10.

La percentuale rappresenta la percentuale massima tollerata di nodi che possono non essere integri prima che il cluster venga considerato in errore.
Se la percentuale viene rispettata ma è presente almeno un nodo non integro, l'integrità viene valutata come Avviso.
La percentuale viene calcolata dividendo il numero di nodi non integri rispetto al numero totale di nodi nel cluster.
Il calcolo arrotonda fino a tollerare un errore in un numero ridotto di nodi. La percentuale predefinita è zero.

In cluster di grandi dimensioni alcuni nodi saranno sempre inattivo o inattivo per le riparazioni, quindi questa percentuale deve essere configurata per tollerarlo.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100

Proprietà cluster

Nome Descrizione Valore
addOnFeatures Elenco delle funzionalità del componente aggiuntivo da abilitare nel cluster. Matrice di stringhe contenente uno dei seguenti elementi:
'BackupRestoreService'
'DnsService'
'RepairManager'
'ResourceMonitorService'
azureActiveDirectory Impostazioni di autenticazione di AAD del cluster. azureActiveDirectory
certificato Certificato da usare per proteggere il cluster. Il certificato fornito verrà usato per la sicurezza da nodo a nodo all'interno del cluster, certificato SSL per l'endpoint di gestione del cluster e client amministratore predefinito. CertificateDescription
certificateCommonNames Descrive un elenco di certificati server a cui fa riferimento il nome comune usato per proteggere il cluster. serverCertificateCommonNames
clientCertificateCommonNames Elenco dei certificati client a cui fa riferimento il nome comune autorizzato a gestire il cluster. ClientCertificateCommonName[]
clientCertificateThumbprints Elenco dei certificati client a cui fa riferimento l'identificazione personale consentita per gestire il cluster. ClientCertificateThumbprint[]
clusterCodeVersion Versione del runtime di Service Fabric del cluster. Questa proprietà può essere impostata solo dall'utente quando upgradeMode è impostato su 'Manual'. Per ottenere l'elenco delle versioni di Service Fabric disponibili per i nuovi cluster, usare 'API ClusterVersion. Per ottenere l'elenco della versione disponibile per i cluster esistenti, usare disponibiliClusterVersions. corda
diagnosticsStorageAccountConfig Informazioni sull'account di archiviazione per l'archiviazione dei log di diagnostica di Service Fabric. DiagnosticsStorageAccountConfig
eventStoreServiceEnabled Indica se il servizio dell'archivio eventi è abilitato. Bool
fabricSettings Elenco di impostazioni di infrastruttura personalizzate per configurare il cluster. SettingsSectionDescription[]
managementEndpoint Endpoint di gestione HTTP del cluster. stringa (obbligatorio)
nodeTypes Elenco dei tipi di nodo nel cluster. NodeTypeDescription[] (obbligatorio)
reliabilityLevel Il livello di affidabilità imposta le dimensioni del set di repliche dei servizi di sistema. Informazioni su ReliabilityLevel.

- Nessuno: eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 1. Questa operazione deve essere usata solo per i cluster di test.
- Bronze : eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 3. Questa operazione deve essere usata solo per i cluster di test.
- Silver: eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 5.
- Gold: eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 7.
- Platinum: eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 9.
'Bronze'
'Oro'
'Nessuno'
'Platinum'
'Silver'
reverseProxyCertificate Certificato server utilizzato dal proxy inverso. CertificateDescription
reverseProxyCertificateCommonNames Descrive un elenco di certificati server a cui fa riferimento il nome comune usato per proteggere il cluster. serverCertificateCommonNames
upgradeDescription Criteri da usare durante l'aggiornamento del cluster. ClusterUpgradePolicy
upgradeMode Modalità di aggiornamento del cluster quando è disponibile una nuova versione del runtime di Service Fabric.

- Automatico: il cluster verrà aggiornato automaticamente alla versione più recente del runtime di Service Fabric non appena è disponibile.
- Manuale: il cluster non verrà aggiornato automaticamente alla versione più recente del runtime di Service Fabric. Il cluster viene aggiornato impostando la proprietà clusterCodeVersion nella risorsa cluster.
'Automatico'
'Manual'
vmImage Il set di scalabilità di macchine virtuali dell'immagine della macchina virtuale è stato configurato con . È possibile usare nomi generici come Windows o Linux. corda

ClusterUpgradeDeltaHealthPolicy

Nome Descrizione Valore
applicationDeltaHealthPolicies Definisce la mappa dei criteri di integrità differenziale dell'applicazione usata per valutare l'integrità di un'applicazione o una delle relative entità figlio durante l'aggiornamento del cluster. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications Percentuale massima consentita di riduzione dell'integrità delle applicazioni consentita durante gli aggiornamenti del cluster.
Il delta viene misurato tra lo stato delle applicazioni all'inizio dell'aggiornamento e lo stato delle applicazioni al momento della valutazione dell'integrità.
Il controllo viene eseguito dopo il completamento di ogni aggiornamento del dominio di aggiornamento per assicurarsi che lo stato globale del cluster sia entro limiti tollerati. I servizi di sistema non sono inclusi in questo.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100 (obbligatorio)
maxPercentDeltaUnhealthyNodes Percentuale massima consentita di riduzione dell'integrità dei nodi consentita durante gli aggiornamenti del cluster.
Il delta viene misurato tra lo stato dei nodi all'inizio dell'aggiornamento e lo stato dei nodi al momento della valutazione dell'integrità.
Il controllo viene eseguito dopo il completamento di ogni aggiornamento del dominio di aggiornamento per assicurarsi che lo stato globale del cluster sia entro limiti tollerati.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100 (obbligatorio)
maxPercentUpgradeDomainDeltaUnhealthyNodes Percentuale massima consentita di riduzione dell'integrità dei nodi del dominio di aggiornamento consentita durante gli aggiornamenti del cluster.
Il delta viene misurato tra lo stato dei nodi del dominio di aggiornamento all'inizio dell'aggiornamento e lo stato dei nodi del dominio di aggiornamento al momento della valutazione dell'integrità.
Il controllo viene eseguito dopo ogni completamento dell'aggiornamento del dominio di aggiornamento per tutti i domini di aggiornamento completati per assicurarsi che lo stato dei domini di aggiornamento sia entro limiti tollerati.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100 (obbligatorio)

ClusterUpgradePolicy

Nome Descrizione Valore
deltaHealthPolicy Criteri di integrità differenziale del cluster usati durante l'aggiornamento del cluster. ClusterUpgradeDeltaHealthPolicy
forceRestart Se true, i processi vengono riavviati forzatamente durante l'aggiornamento anche quando la versione del codice non è stata modificata (l'aggiornamento modifica solo la configurazione o i dati). Bool
healthCheckRetryTimeout Tempo di ripetizione della valutazione dell'integrità quando l'applicazione o il cluster non è integro prima del rollback dell'aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
healthCheckStableDuration Periodo di tempo in cui l'applicazione o il cluster deve rimanere integro prima che l'aggiornamento proceda al dominio di aggiornamento successivo. La durata può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
healthCheckWaitDuration Periodo di attesa dopo il completamento di un dominio di aggiornamento prima di eseguire i controlli di integrità. La durata può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
healthPolicy Criteri di integrità del cluster usati durante l'aggiornamento del cluster. clusterHealthPolicy (obbligatorio)
upgradeDomainTimeout Tempo necessario per il completamento di ogni dominio di aggiornamento prima del rollback dell'aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
upgradeReplicaSetCheckTimeout Quantità massima di tempo per bloccare l'elaborazione di un dominio di aggiornamento e impedire la perdita di disponibilità in caso di problemi imprevisti. Alla scadenza di questo timeout, l'elaborazione del dominio di aggiornamento procederà indipendentemente dai problemi di perdita di disponibilità. Il timeout viene reimpostato all'inizio di ogni dominio di aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
upgradeTimeout Tempo necessario per il completamento dell'aggiornamento complessivo prima del rollback dell'aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)

DiagnosticsStorageAccountConfig

Nome Descrizione Valore
blobEndpoint Endpoint BLOB dell'account di archiviazione di Azure. stringa (obbligatorio)
protectedAccountKeyName Nome della chiave di archiviazione di diagnostica protetta. stringa (obbligatorio)
queueEndpoint Endpoint della coda dell'account di archiviazione di Azure. stringa (obbligatorio)
storageAccountName Nome dell'account di archiviazione di Azure. stringa (obbligatorio)
tableEndpoint Endpoint della tabella dell'account di archiviazione di Azure. stringa (obbligatorio)

EndpointRangeDescription

Nome Descrizione Valore
endPort Porta finale di un intervallo di porte int (obbligatorio)
startPort Porta iniziale di un intervallo di porte int (obbligatorio)

Microsoft.ServiceFabric/clusters

Nome Descrizione Valore
apiVersion Versione dell'API '2019-03-01'
ubicazione Località delle risorse di Azure. stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà delle risorse del cluster ClusterProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.ServiceFabric/clusters'

NodeTypeDescription

Nome Descrizione Valore
applicationPorts Intervallo di porte da cui il cluster ha assegnato la porta alle applicazioni di Service Fabric. EndpointRangeDescription
Capacità I tag di capacità applicati ai nodi nel tipo di nodo, gestione risorse cluster usa questi tag per comprendere la quantità di risorse di un nodo. NodeTypeDescriptionCapacities
clientConnectionEndpointPort Porta dell'endpoint di gestione del cluster TCP. int (obbligatorio)
durabilitàLevel Livello di durabilità del tipo di nodo. Informazioni su DurabilitàLevel.

- Bronzo - Nessun privilegio. Si tratta dell'impostazione predefinita.
- Silver: i processi dell'infrastruttura possono essere sospesi per una durata di 10 minuti per tipo definito dall'utente.
- Gold: i processi di infrastruttura possono essere sospesi per una durata di 2 ore per ogni UD. La durabilità Gold può essere abilitata solo in SKU di macchine virtuali a nodo completo, ad esempio D15_V2, G5 e così via.
'Bronze'
'Oro'
'Silver'
effimeroPorts L'intervallo di porte temporanee con cui devono essere configurati i nodi in questo tipo di nodo. EndpointRangeDescription
httpGatewayEndpointPort Porta dell'endpoint di gestione del cluster HTTP. int (obbligatorio)
isPrimary Tipo di nodo in cui verranno eseguiti i servizi di sistema. Un solo tipo di nodo deve essere contrassegnato come primario. Non è possibile eliminare o modificare il tipo di nodo primario per i cluster esistenti. bool (obbligatorio)
nome Nome del tipo di nodo. stringa (obbligatorio)
placementProperties I tag di posizionamento applicati ai nodi nel tipo di nodo, che possono essere usati per indicare dove devono essere eseguiti determinati servizi (carico di lavoro). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Endpoint usato dal proxy inverso. Int
vmInstanceCount Numero di nodi nel tipo di nodo. Questo conteggio deve corrispondere alla proprietà capacity nella risorsa VirtualMachineScaleSet corrispondente. Int

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647 (obbligatorio)

NodeTypeDescriptionCapacities

Nome Descrizione Valore

NodeTypeDescriptionPlacementProperties

Nome Descrizione Valore

ResourceTags

Nome Descrizione Valore

ServerCertificateCommonName

Nome Descrizione Valore
certificateCommonName Nome comune del certificato del server. stringa (obbligatorio)
certificateIssuerThumbprint Identificazione personale dell'autorità di certificazione del certificato del server. stringa (obbligatorio)

ServerCertificateCommonNames

Nome Descrizione Valore
commonNames Elenco di certificati server a cui fa riferimento il nome comune usato per proteggere il cluster. ServerCertificateCommonName[]
x509StoreName Percorso dell'archivio certificati locale. 'AddressBook'
'AuthRoot'
'CertificateAuthority'
'Non consentito'
'My'
'Root'
'TrustedPeople'
'TrustedPublisher'

ServiceTypeDeltaHealthPolicy

Nome Descrizione Valore
maxPercentDeltaUnhealthyServices Percentuale massima consentita di riduzione dell'integrità dei servizi consentita durante gli aggiornamenti del cluster.
Il delta viene misurato tra lo stato dei servizi all'inizio dell'aggiornamento e lo stato dei servizi al momento della valutazione dell'integrità.
Il controllo viene eseguito dopo il completamento di ogni aggiornamento del dominio di aggiornamento per assicurarsi che lo stato globale del cluster sia entro limiti tollerati.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100

ServiceTypeDeltaHealthPolicyMap

Nome Descrizione Valore

ServiceTypeHealthPolicy

Nome Descrizione Valore
maxPercentUnhealthyServices Percentuale massima di servizi non integri prima che l'applicazione venga considerata in errore. Int

Vincoli:
Valore minimo = 0
Valore massimo = 100

ServiceTypeHealthPolicyMap

Nome Descrizione Valore

SettingsParameterDescription

Nome Descrizione Valore
nome Nome del parametro dell'impostazione dell'infrastruttura. stringa (obbligatorio)
valore Valore del parametro dell'impostazione dell'infrastruttura. stringa (obbligatorio)

SettingsSectionDescription

Nome Descrizione Valore
nome Nome della sezione delle impostazioni dell'infrastruttura. stringa (obbligatorio)
Parametri Raccolta di parametri nella sezione . SettingsParameterDescription[] (obbligatorio)

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Sagoma Descrizione
Distribuire un cluster sicuro a 3 nodi con gruppi di sicurezza di rete abilitati

Distribuire in Azure
Questo modello consente di distribuire un cluster di Service Fabric protetto con tipo di nodo 3 che esegue Windows Server 2016 Data center in una macchina virtuale di dimensioni Standard_D2. Usare questo modello consente di controllare il traffico di rete in ingresso e in uscita usando i gruppi di sicurezza di rete.
Distribuire un cluster sicuro a 5 nodi

Distribuire in Azure
Questo modello consente di distribuire un cluster di Service Fabric sicuro a 5 nodi che esegue Windows Server 2019 Datacenter in un set di scalabilità di macchine virtuali di dimensioni Standard_D2_v2.
Distribuire un cluster ubuntu di Service Fabric a 5 nodi

Distribuire in Azure
Questo modello consente di distribuire un cluster di Service Fabric sicuro a 5 nodi che esegue Ubuntu in un set di scalabilità di macchine virtuali di dimensioni Standard_D2_V2.

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa cluster può essere distribuito con operazioni destinate a:

  • gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.ServiceFabric/clusters, aggiungere il codice Terraform seguente al modello.

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

Valori delle proprietà

ApplicationDeltaHealthPolicy

Nome Descrizione Valore
defaultServiceTypeDeltaHealthPolicy I criteri di integrità differenziale usati per impostazione predefinita per valutare l'integrità di un tipo di servizio durante l'aggiornamento del cluster. ServiceTypeDeltaHealthPolicy
serviceTypeDeltaHealthPolicies Mappa con i criteri di integrità differenziali del tipo di servizio per ogni nome del tipo di servizio. La mappa è vuota per impostazione predefinita. ServiceTypeDeltaHealthPolicyMap

ApplicationDeltaHealthPolicyMap

Nome Descrizione Valore

ApplicationHealthPolicy

Nome Descrizione Valore
defaultServiceTypeHealthPolicy Criteri di integrità usati per impostazione predefinita per valutare l'integrità di un tipo di servizio. ServiceTypeHealthPolicy
serviceTypeHealthPolicies Mappa con i criteri di integrità del tipo di servizio per ogni nome del tipo di servizio. La mappa è vuota per impostazione predefinita. ServiceTypeHealthPolicyMap

ApplicationHealthPolicyMap

Nome Descrizione Valore

AzureActiveDirectory

Nome Descrizione Valore
clientApplication ID applicazione client di Azure Active Directory. corda
clusterApplication ID applicazione cluster di Azure Active Directory. corda
tenantId ID tenant di Azure Active Directory. corda

CertificateDescription

Nome Descrizione Valore
Identificazione personale Identificazione personale del certificato primario. stringa (obbligatorio)
thumbprintSecondary Identificazione personale del certificato secondario. corda
x509StoreName Percorso dell'archivio certificati locale. 'AddressBook'
'AuthRoot'
'CertificateAuthority'
'Non consentito'
'My'
'Root'
'TrustedPeople'
'TrustedPublisher'

ClientCertificateCommonName

Nome Descrizione Valore
certificateCommonName Nome comune del certificato client. stringa (obbligatorio)
certificateIssuerThumbprint Identificazione personale dell'autorità di certificazione del certificato client. stringa (obbligatorio)
isAdmin Indica se il certificato client ha accesso amministratore al cluster. I client non amministratori possono eseguire solo operazioni di sola lettura nel cluster. bool (obbligatorio)

ClientCertificateThumbprint

Nome Descrizione Valore
certificateThumbprint Identificazione personale del certificato client. stringa (obbligatorio)
isAdmin Indica se il certificato client ha accesso amministratore al cluster. I client non amministratori possono eseguire solo operazioni di sola lettura nel cluster. bool (obbligatorio)

ClusterHealthPolicy

Nome Descrizione Valore
applicationHealthPolicies Definisce la mappa dei criteri di integrità dell'applicazione usata per valutare l'integrità di un'applicazione o di una delle relative entità figlio. ApplicationHealthPolicyMap
maxPercentUnhealthyApplications Percentuale massima consentita di applicazioni non integre prima di segnalare un errore. Ad esempio, per consentire che 10% di applicazioni non siano integre, questo valore sarà 10.

La percentuale rappresenta la percentuale massima tollerata di applicazioni che possono non essere integre prima che il cluster venga considerato in errore.
Se la percentuale viene rispettata ma è presente almeno un'applicazione non integra, l'integrità viene valutata come Avviso.
Questo valore viene calcolato dividendo il numero di applicazioni non integre rispetto al numero totale di istanze dell'applicazione nel cluster, escluse le applicazioni di tipi di applicazione inclusi in ApplicationTypeHealthPolicyMap.
Il calcolo arrotonda fino a tollerare un errore in un numero ridotto di applicazioni. La percentuale predefinita è zero.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100
maxPercentUnhealthyNodes Percentuale massima consentita di nodi non integri prima di segnalare un errore. Ad esempio, per consentire che 10% di nodi non siano integri, questo valore sarà 10.

La percentuale rappresenta la percentuale massima tollerata di nodi che possono non essere integri prima che il cluster venga considerato in errore.
Se la percentuale viene rispettata ma è presente almeno un nodo non integro, l'integrità viene valutata come Avviso.
La percentuale viene calcolata dividendo il numero di nodi non integri rispetto al numero totale di nodi nel cluster.
Il calcolo arrotonda fino a tollerare un errore in un numero ridotto di nodi. La percentuale predefinita è zero.

In cluster di grandi dimensioni alcuni nodi saranno sempre inattivo o inattivo per le riparazioni, quindi questa percentuale deve essere configurata per tollerarlo.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100

Proprietà cluster

Nome Descrizione Valore
addOnFeatures Elenco delle funzionalità del componente aggiuntivo da abilitare nel cluster. Matrice di stringhe contenente uno dei seguenti elementi:
'BackupRestoreService'
'DnsService'
'RepairManager'
'ResourceMonitorService'
azureActiveDirectory Impostazioni di autenticazione di AAD del cluster. azureActiveDirectory
certificato Certificato da usare per proteggere il cluster. Il certificato fornito verrà usato per la sicurezza da nodo a nodo all'interno del cluster, certificato SSL per l'endpoint di gestione del cluster e client amministratore predefinito. CertificateDescription
certificateCommonNames Descrive un elenco di certificati server a cui fa riferimento il nome comune usato per proteggere il cluster. serverCertificateCommonNames
clientCertificateCommonNames Elenco dei certificati client a cui fa riferimento il nome comune autorizzato a gestire il cluster. ClientCertificateCommonName[]
clientCertificateThumbprints Elenco dei certificati client a cui fa riferimento l'identificazione personale consentita per gestire il cluster. ClientCertificateThumbprint[]
clusterCodeVersion Versione del runtime di Service Fabric del cluster. Questa proprietà può essere impostata solo dall'utente quando upgradeMode è impostato su 'Manual'. Per ottenere l'elenco delle versioni di Service Fabric disponibili per i nuovi cluster, usare 'API ClusterVersion. Per ottenere l'elenco della versione disponibile per i cluster esistenti, usare disponibiliClusterVersions. corda
diagnosticsStorageAccountConfig Informazioni sull'account di archiviazione per l'archiviazione dei log di diagnostica di Service Fabric. DiagnosticsStorageAccountConfig
eventStoreServiceEnabled Indica se il servizio dell'archivio eventi è abilitato. Bool
fabricSettings Elenco di impostazioni di infrastruttura personalizzate per configurare il cluster. SettingsSectionDescription[]
managementEndpoint Endpoint di gestione HTTP del cluster. stringa (obbligatorio)
nodeTypes Elenco dei tipi di nodo nel cluster. NodeTypeDescription[] (obbligatorio)
reliabilityLevel Il livello di affidabilità imposta le dimensioni del set di repliche dei servizi di sistema. Informazioni su ReliabilityLevel.

- Nessuno: eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 1. Questa operazione deve essere usata solo per i cluster di test.
- Bronze : eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 3. Questa operazione deve essere usata solo per i cluster di test.
- Silver: eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 5.
- Gold: eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 7.
- Platinum: eseguire i servizi di sistema con un numero di set di repliche di destinazione pari a 9.
'Bronze'
'Oro'
'Nessuno'
'Platinum'
'Silver'
reverseProxyCertificate Certificato server utilizzato dal proxy inverso. CertificateDescription
reverseProxyCertificateCommonNames Descrive un elenco di certificati server a cui fa riferimento il nome comune usato per proteggere il cluster. serverCertificateCommonNames
upgradeDescription Criteri da usare durante l'aggiornamento del cluster. ClusterUpgradePolicy
upgradeMode Modalità di aggiornamento del cluster quando è disponibile una nuova versione del runtime di Service Fabric.

- Automatico: il cluster verrà aggiornato automaticamente alla versione più recente del runtime di Service Fabric non appena è disponibile.
- Manuale: il cluster non verrà aggiornato automaticamente alla versione più recente del runtime di Service Fabric. Il cluster viene aggiornato impostando la proprietà clusterCodeVersion nella risorsa cluster.
'Automatico'
'Manual'
vmImage Il set di scalabilità di macchine virtuali dell'immagine della macchina virtuale è stato configurato con . È possibile usare nomi generici come Windows o Linux. corda

ClusterUpgradeDeltaHealthPolicy

Nome Descrizione Valore
applicationDeltaHealthPolicies Definisce la mappa dei criteri di integrità differenziale dell'applicazione usata per valutare l'integrità di un'applicazione o una delle relative entità figlio durante l'aggiornamento del cluster. ApplicationDeltaHealthPolicyMap
maxPercentDeltaUnhealthyApplications Percentuale massima consentita di riduzione dell'integrità delle applicazioni consentita durante gli aggiornamenti del cluster.
Il delta viene misurato tra lo stato delle applicazioni all'inizio dell'aggiornamento e lo stato delle applicazioni al momento della valutazione dell'integrità.
Il controllo viene eseguito dopo il completamento di ogni aggiornamento del dominio di aggiornamento per assicurarsi che lo stato globale del cluster sia entro limiti tollerati. I servizi di sistema non sono inclusi in questo.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100 (obbligatorio)
maxPercentDeltaUnhealthyNodes Percentuale massima consentita di riduzione dell'integrità dei nodi consentita durante gli aggiornamenti del cluster.
Il delta viene misurato tra lo stato dei nodi all'inizio dell'aggiornamento e lo stato dei nodi al momento della valutazione dell'integrità.
Il controllo viene eseguito dopo il completamento di ogni aggiornamento del dominio di aggiornamento per assicurarsi che lo stato globale del cluster sia entro limiti tollerati.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100 (obbligatorio)
maxPercentUpgradeDomainDeltaUnhealthyNodes Percentuale massima consentita di riduzione dell'integrità dei nodi del dominio di aggiornamento consentita durante gli aggiornamenti del cluster.
Il delta viene misurato tra lo stato dei nodi del dominio di aggiornamento all'inizio dell'aggiornamento e lo stato dei nodi del dominio di aggiornamento al momento della valutazione dell'integrità.
Il controllo viene eseguito dopo ogni completamento dell'aggiornamento del dominio di aggiornamento per tutti i domini di aggiornamento completati per assicurarsi che lo stato dei domini di aggiornamento sia entro limiti tollerati.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100 (obbligatorio)

ClusterUpgradePolicy

Nome Descrizione Valore
deltaHealthPolicy Criteri di integrità differenziale del cluster usati durante l'aggiornamento del cluster. ClusterUpgradeDeltaHealthPolicy
forceRestart Se true, i processi vengono riavviati forzatamente durante l'aggiornamento anche quando la versione del codice non è stata modificata (l'aggiornamento modifica solo la configurazione o i dati). Bool
healthCheckRetryTimeout Tempo di ripetizione della valutazione dell'integrità quando l'applicazione o il cluster non è integro prima del rollback dell'aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
healthCheckStableDuration Periodo di tempo in cui l'applicazione o il cluster deve rimanere integro prima che l'aggiornamento proceda al dominio di aggiornamento successivo. La durata può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
healthCheckWaitDuration Periodo di attesa dopo il completamento di un dominio di aggiornamento prima di eseguire i controlli di integrità. La durata può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
healthPolicy Criteri di integrità del cluster usati durante l'aggiornamento del cluster. clusterHealthPolicy (obbligatorio)
upgradeDomainTimeout Tempo necessario per il completamento di ogni dominio di aggiornamento prima del rollback dell'aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
upgradeReplicaSetCheckTimeout Quantità massima di tempo per bloccare l'elaborazione di un dominio di aggiornamento e impedire la perdita di disponibilità in caso di problemi imprevisti. Alla scadenza di questo timeout, l'elaborazione del dominio di aggiornamento procederà indipendentemente dai problemi di perdita di disponibilità. Il timeout viene reimpostato all'inizio di ogni dominio di aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
upgradeTimeout Tempo necessario per il completamento dell'aggiornamento complessivo prima del rollback dell'aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)

DiagnosticsStorageAccountConfig

Nome Descrizione Valore
blobEndpoint Endpoint BLOB dell'account di archiviazione di Azure. stringa (obbligatorio)
protectedAccountKeyName Nome della chiave di archiviazione di diagnostica protetta. stringa (obbligatorio)
queueEndpoint Endpoint della coda dell'account di archiviazione di Azure. stringa (obbligatorio)
storageAccountName Nome dell'account di archiviazione di Azure. stringa (obbligatorio)
tableEndpoint Endpoint della tabella dell'account di archiviazione di Azure. stringa (obbligatorio)

EndpointRangeDescription

Nome Descrizione Valore
endPort Porta finale di un intervallo di porte int (obbligatorio)
startPort Porta iniziale di un intervallo di porte int (obbligatorio)

Microsoft.ServiceFabric/clusters

Nome Descrizione Valore
ubicazione Località delle risorse di Azure. stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà delle risorse del cluster ClusterProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.ServiceFabric/clusters@2019-03-01"

NodeTypeDescription

Nome Descrizione Valore
applicationPorts Intervallo di porte da cui il cluster ha assegnato la porta alle applicazioni di Service Fabric. EndpointRangeDescription
Capacità I tag di capacità applicati ai nodi nel tipo di nodo, gestione risorse cluster usa questi tag per comprendere la quantità di risorse di un nodo. NodeTypeDescriptionCapacities
clientConnectionEndpointPort Porta dell'endpoint di gestione del cluster TCP. int (obbligatorio)
durabilitàLevel Livello di durabilità del tipo di nodo. Informazioni su DurabilitàLevel.

- Bronzo - Nessun privilegio. Si tratta dell'impostazione predefinita.
- Silver: i processi dell'infrastruttura possono essere sospesi per una durata di 10 minuti per tipo definito dall'utente.
- Gold: i processi di infrastruttura possono essere sospesi per una durata di 2 ore per ogni UD. La durabilità Gold può essere abilitata solo in SKU di macchine virtuali a nodo completo, ad esempio D15_V2, G5 e così via.
'Bronze'
'Oro'
'Silver'
effimeroPorts L'intervallo di porte temporanee con cui devono essere configurati i nodi in questo tipo di nodo. EndpointRangeDescription
httpGatewayEndpointPort Porta dell'endpoint di gestione del cluster HTTP. int (obbligatorio)
isPrimary Tipo di nodo in cui verranno eseguiti i servizi di sistema. Un solo tipo di nodo deve essere contrassegnato come primario. Non è possibile eliminare o modificare il tipo di nodo primario per i cluster esistenti. bool (obbligatorio)
nome Nome del tipo di nodo. stringa (obbligatorio)
placementProperties I tag di posizionamento applicati ai nodi nel tipo di nodo, che possono essere usati per indicare dove devono essere eseguiti determinati servizi (carico di lavoro). NodeTypeDescriptionPlacementProperties
reverseProxyEndpointPort Endpoint usato dal proxy inverso. Int
vmInstanceCount Numero di nodi nel tipo di nodo. Questo conteggio deve corrispondere alla proprietà capacity nella risorsa VirtualMachineScaleSet corrispondente. Int

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647 (obbligatorio)

NodeTypeDescriptionCapacities

Nome Descrizione Valore

NodeTypeDescriptionPlacementProperties

Nome Descrizione Valore

ResourceTags

Nome Descrizione Valore

ServerCertificateCommonName

Nome Descrizione Valore
certificateCommonName Nome comune del certificato del server. stringa (obbligatorio)
certificateIssuerThumbprint Identificazione personale dell'autorità di certificazione del certificato del server. stringa (obbligatorio)

ServerCertificateCommonNames

Nome Descrizione Valore
commonNames Elenco di certificati server a cui fa riferimento il nome comune usato per proteggere il cluster. ServerCertificateCommonName[]
x509StoreName Percorso dell'archivio certificati locale. 'AddressBook'
'AuthRoot'
'CertificateAuthority'
'Non consentito'
'My'
'Root'
'TrustedPeople'
'TrustedPublisher'

ServiceTypeDeltaHealthPolicy

Nome Descrizione Valore
maxPercentDeltaUnhealthyServices Percentuale massima consentita di riduzione dell'integrità dei servizi consentita durante gli aggiornamenti del cluster.
Il delta viene misurato tra lo stato dei servizi all'inizio dell'aggiornamento e lo stato dei servizi al momento della valutazione dell'integrità.
Il controllo viene eseguito dopo il completamento di ogni aggiornamento del dominio di aggiornamento per assicurarsi che lo stato globale del cluster sia entro limiti tollerati.
Int

Vincoli:
Valore minimo = 0
Valore massimo = 100

ServiceTypeDeltaHealthPolicyMap

Nome Descrizione Valore

ServiceTypeHealthPolicy

Nome Descrizione Valore
maxPercentUnhealthyServices Percentuale massima di servizi non integri prima che l'applicazione venga considerata in errore. Int

Vincoli:
Valore minimo = 0
Valore massimo = 100

ServiceTypeHealthPolicyMap

Nome Descrizione Valore

SettingsParameterDescription

Nome Descrizione Valore
nome Nome del parametro dell'impostazione dell'infrastruttura. stringa (obbligatorio)
valore Valore del parametro dell'impostazione dell'infrastruttura. stringa (obbligatorio)

SettingsSectionDescription

Nome Descrizione Valore
nome Nome della sezione delle impostazioni dell'infrastruttura. stringa (obbligatorio)
Parametri Raccolta di parametri nella sezione . SettingsParameterDescription[] (obbligatorio)