Cluster Microsoft.ServiceFabric
- più recenti
- 2023-11-01-preview
- 2021-06-01
- 12-01-preview 2020
- 2020-03-01
- 2019-11-01-preview
- 2019-06-01-preview
- 2019-03-01
- 03-03-2019
- 2018-02-01
- 07-07-01-preview 2017
- 2016-09-01
Definizione di risorsa Bicep
Il tipo di risorsa cluster può essere distribuito con operazioni destinate a:
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@2023-11-01-preview' = {
location: 'string'
name: 'string'
properties: {
addOnFeatures: [
'string'
]
applicationTypeVersionsCleanupPolicy: {
maxUnusedVersionsToKeep: int
}
azureActiveDirectory: {
clientApplication: 'string'
clusterApplication: 'string'
tenantId: 'string'
}
certificate: {
thumbprint: 'string'
thumbprintSecondary: 'string'
x509StoreName: 'string'
}
certificateCommonNames: {
commonNames: [
{
certificateCommonName: 'string'
certificateIssuerThumbprint: 'string'
}
]
x509StoreName: 'string'
}
clientCertificateCommonNames: [
{
certificateCommonName: 'string'
certificateIssuerThumbprint: 'string'
isAdmin: bool
}
]
clientCertificateThumbprints: [
{
certificateThumbprint: 'string'
isAdmin: bool
}
]
clusterCodeVersion: 'string'
diagnosticsStorageAccountConfig: {
blobEndpoint: 'string'
protectedAccountKeyName: 'string'
protectedAccountKeyName2: 'string'
queueEndpoint: 'string'
storageAccountName: 'string'
tableEndpoint: 'string'
}
enableHttpGatewayExclusiveAuthMode: bool
eventStoreServiceEnabled: bool
fabricSettings: [
{
name: 'string'
parameters: [
{
name: 'string'
value: 'string'
}
]
}
]
infrastructureServiceManager: bool
managementEndpoint: 'string'
nodeTypes: [
{
applicationPorts: {
endPort: int
startPort: int
}
capacities: {
{customized property}: 'string'
}
clientConnectionEndpointPort: int
durabilityLevel: 'string'
ephemeralPorts: {
endPort: int
startPort: int
}
httpGatewayEndpointPort: int
httpGatewayTokenAuthEndpointPort: int
isPrimary: bool
isStateless: bool
multipleAvailabilityZones: bool
name: 'string'
placementProperties: {
{customized property}: 'string'
}
reverseProxyEndpointPort: int
vmInstanceCount: int
}
]
notifications: [
{
isEnabled: bool
notificationCategory: 'string'
notificationLevel: 'string'
notificationTargets: [
{
notificationChannel: 'string'
receivers: [
'string'
]
}
]
}
]
reliabilityLevel: 'string'
reverseProxyCertificate: {
thumbprint: 'string'
thumbprintSecondary: 'string'
x509StoreName: 'string'
}
reverseProxyCertificateCommonNames: {
commonNames: [
{
certificateCommonName: 'string'
certificateIssuerThumbprint: 'string'
}
]
x509StoreName: 'string'
}
sfZonalUpgradeMode: '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'
upgradePauseEndTimestampUtc: 'string'
upgradePauseStartTimestampUtc: 'string'
upgradeWave: 'string'
vmImage: 'string'
vmssZonalUpgradeMode: 'string'
waveUpgradePaused: bool
}
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 |
|---|
ApplicationTypeVersionsCleanupPolicy
| Nome | Descrizione | Valore |
|---|---|---|
| maxUnusedVersionsToKeep | Numero di versioni inutilizzate per tipo di applicazione da mantenere. | Int Vincoli: Valore minimo = 0 (obbligatorio) |
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' |
| applicationTypeVersionsCleanupPolicy | Criteri usati per pulire le versioni inutilizzate. | ApplicationTypeVersionsCleanupPolicy |
| 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 |
| enableHttpGatewayExclusiveAuthMode | Se true, l'autenticazione basata su token non è consentita in HttpGatewayEndpoint. Questa operazione è necessaria per supportare TLS versioni 1.3 e successive. Se si usa l'autenticazione basata su token, è necessario definire HttpGatewayTokenAuthEndpointPort. | Bool |
| eventStoreServiceEnabled | Indica se il servizio dell'archivio eventi è abilitato. | Bool |
| fabricSettings | Elenco di impostazioni di infrastruttura personalizzate per configurare il cluster. | SettingsSectionDescription[] |
| infrastructureServiceManager | Indica se infrastructure service manager è abilitato. | Bool |
| managementEndpoint | Endpoint di gestione HTTP del cluster. | stringa (obbligatorio) |
| nodeTypes | Elenco dei tipi di nodo nel cluster. | NodeTypeDescription[] (obbligatorio) |
| Notifiche | Indica un elenco di canali di notifica per gli eventi del cluster. | notifica[] |
| 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 |
| sfZonalUpgradeMode | Questa proprietà controlla il raggruppamento logico delle macchine virtuali nei domini di aggiornamento .This property controls the logical grouping of VMs in upgrade domains (UDS). Questa proprietà non può essere modificata se nel cluster è già presente un tipo di nodo con più zone di disponibilità. | 'Gerarchico' 'Parallel' |
| 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' 'Manual' |
| upgradePauseEndTimestampUtc | Indica la data e l'ora di fine per sospendere gli aggiornamenti automatici della versione del runtime nel cluster per un periodo di tempo specifico nel cluster (UTC). | corda |
| upgradePauseStartTimestampUtc | Indica la data e l'ora di inizio per sospendere gli aggiornamenti automatici della versione del runtime nel cluster per un periodo di tempo specifico nel cluster (UTC). | corda |
| upgradeWave | Indica quando verranno applicati i nuovi aggiornamenti della versione del runtime del cluster dopo il rilascio. Per impostazione predefinita, wave0. Si applica solo quando upgradeMode è impostato su "Automatico". | 'Wave0' 'Wave1' 'Wave2' |
| 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 |
| vmssZonalUpgradeMode | Questa proprietà definisce la modalità di aggiornamento per il set di scalabilità di macchine virtuali, è obbligatorio se viene aggiunto un tipo di nodo con più zone di disponibilità. | 'Gerarchico' 'Parallel' |
| waveUpgradePaused | Valore booleano per sospendere gli aggiornamenti automatici delle versioni di runtime al cluster. | Bool |
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) |
| protectedAccountKeyName2 | Nome della chiave di archiviazione di diagnostica protetta secondaria. Se una delle chiavi dell'account di archiviazione viene ruotata, il cluster eseguirà il fallback all'uso dell'altro. | corda |
| 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 | |
| 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) |
| httpGatewayTokenAuthEndpointPort | Porta usata per le connessioni HTTPS basate su token al cluster. Impossibile impostare la stessa porta di HttpGatewayEndpoint. | Int |
| 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) |
| isStateless | Indica se il tipo di nodo può ospitare solo carichi di lavoro senza stato. | Bool |
| multipleAvailabilityZones | Indica se il tipo di nodo è abilitato per supportare più zone. | Bool |
| 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 | VMInstanceCount deve essere da 1 a n, dove n indica il numero di istanze di vm corrispondenti a questo nodeType. VMInstanceCount = 0 può essere eseguito solo in questi scenari: NodeType è un nodeType secondario. Durabilità = Bronzo o Durabilità >= Bronze e InfrastructureServiceManager = true. Se VMInstanceCount = 0, implica che le macchine virtuali per questo nodeType non verranno usate per il calcolo iniziale delle dimensioni del cluster. | Int Vincoli: Valore minimo = 0 Valore massimo = 2147483647 (obbligatorio) |
NodeTypeDescriptionCapacities
| Nome | Descrizione | Valore |
|---|
NodeTypeDescriptionPlacementProperties
| Nome | Descrizione | Valore |
|---|
Notifica
| Nome | Descrizione | Valore |
|---|---|---|
| isEnabled | Indica se la notifica è abilitata. | bool (obbligatorio) |
| notificationCategory | Categoria di notifica. | 'WaveProgress' (obbligatorio) |
| notificationLevel | Livello di notifica. | 'All' 'Critical' (obbligatorio) |
| notificationTargets | Elenco di destinazioni che sottoscrivono la notifica. | NotificationTarget[] (obbligatorio) |
NotificationTarget
| Nome | Descrizione | Valore |
|---|---|---|
| notificationChannel | Il canale di notifica indica il tipo di ricevitori sottoscritti alla notifica, utente o sottoscrizione. | 'EmailSubscription' 'EmailUser' (obbligatorio) |
| Ricevitori | Elenco di destinazioni che sottoscrivono la notifica. | string[] (obbligatorio) |
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:
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": "2023-11-01-preview",
"name": "string",
"location": "string",
"properties": {
"addOnFeatures": [ "string" ],
"applicationTypeVersionsCleanupPolicy": {
"maxUnusedVersionsToKeep": "int"
},
"azureActiveDirectory": {
"clientApplication": "string",
"clusterApplication": "string",
"tenantId": "string"
},
"certificate": {
"thumbprint": "string",
"thumbprintSecondary": "string",
"x509StoreName": "string"
},
"certificateCommonNames": {
"commonNames": [
{
"certificateCommonName": "string",
"certificateIssuerThumbprint": "string"
}
],
"x509StoreName": "string"
},
"clientCertificateCommonNames": [
{
"certificateCommonName": "string",
"certificateIssuerThumbprint": "string",
"isAdmin": "bool"
}
],
"clientCertificateThumbprints": [
{
"certificateThumbprint": "string",
"isAdmin": "bool"
}
],
"clusterCodeVersion": "string",
"diagnosticsStorageAccountConfig": {
"blobEndpoint": "string",
"protectedAccountKeyName": "string",
"protectedAccountKeyName2": "string",
"queueEndpoint": "string",
"storageAccountName": "string",
"tableEndpoint": "string"
},
"enableHttpGatewayExclusiveAuthMode": "bool",
"eventStoreServiceEnabled": "bool",
"fabricSettings": [
{
"name": "string",
"parameters": [
{
"name": "string",
"value": "string"
}
]
}
],
"infrastructureServiceManager": "bool",
"managementEndpoint": "string",
"nodeTypes": [
{
"applicationPorts": {
"endPort": "int",
"startPort": "int"
},
"capacities": {
"{customized property}": "string"
},
"clientConnectionEndpointPort": "int",
"durabilityLevel": "string",
"ephemeralPorts": {
"endPort": "int",
"startPort": "int"
},
"httpGatewayEndpointPort": "int",
"httpGatewayTokenAuthEndpointPort": "int",
"isPrimary": "bool",
"isStateless": "bool",
"multipleAvailabilityZones": "bool",
"name": "string",
"placementProperties": {
"{customized property}": "string"
},
"reverseProxyEndpointPort": "int",
"vmInstanceCount": "int"
}
],
"notifications": [
{
"isEnabled": "bool",
"notificationCategory": "string",
"notificationLevel": "string",
"notificationTargets": [
{
"notificationChannel": "string",
"receivers": [ "string" ]
}
]
}
],
"reliabilityLevel": "string",
"reverseProxyCertificate": {
"thumbprint": "string",
"thumbprintSecondary": "string",
"x509StoreName": "string"
},
"reverseProxyCertificateCommonNames": {
"commonNames": [
{
"certificateCommonName": "string",
"certificateIssuerThumbprint": "string"
}
],
"x509StoreName": "string"
},
"sfZonalUpgradeMode": "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",
"upgradePauseEndTimestampUtc": "string",
"upgradePauseStartTimestampUtc": "string",
"upgradeWave": "string",
"vmImage": "string",
"vmssZonalUpgradeMode": "string",
"waveUpgradePaused": "bool"
},
"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 |
|---|
ApplicationTypeVersionsCleanupPolicy
| Nome | Descrizione | Valore |
|---|---|---|
| maxUnusedVersionsToKeep | Numero di versioni inutilizzate per tipo di applicazione da mantenere. | Int Vincoli: Valore minimo = 0 (obbligatorio) |
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' |
| applicationTypeVersionsCleanupPolicy | Criteri usati per pulire le versioni inutilizzate. | ApplicationTypeVersionsCleanupPolicy |
| 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 |
| enableHttpGatewayExclusiveAuthMode | Se true, l'autenticazione basata su token non è consentita in HttpGatewayEndpoint. Questa operazione è necessaria per supportare TLS versioni 1.3 e successive. Se si usa l'autenticazione basata su token, è necessario definire HttpGatewayTokenAuthEndpointPort. | Bool |
| eventStoreServiceEnabled | Indica se il servizio dell'archivio eventi è abilitato. | Bool |
| fabricSettings | Elenco di impostazioni di infrastruttura personalizzate per configurare il cluster. | SettingsSectionDescription[] |
| infrastructureServiceManager | Indica se infrastructure service manager è abilitato. | Bool |
| managementEndpoint | Endpoint di gestione HTTP del cluster. | stringa (obbligatorio) |
| nodeTypes | Elenco dei tipi di nodo nel cluster. | NodeTypeDescription[] (obbligatorio) |
| Notifiche | Indica un elenco di canali di notifica per gli eventi del cluster. | notifica[] |
| 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 |
| sfZonalUpgradeMode | Questa proprietà controlla il raggruppamento logico delle macchine virtuali nei domini di aggiornamento .This property controls the logical grouping of VMs in upgrade domains (UDS). Questa proprietà non può essere modificata se nel cluster è già presente un tipo di nodo con più zone di disponibilità. | 'Gerarchico' 'Parallel' |
| 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' 'Manual' |
| upgradePauseEndTimestampUtc | Indica la data e l'ora di fine per sospendere gli aggiornamenti automatici della versione del runtime nel cluster per un periodo di tempo specifico nel cluster (UTC). | corda |
| upgradePauseStartTimestampUtc | Indica la data e l'ora di inizio per sospendere gli aggiornamenti automatici della versione del runtime nel cluster per un periodo di tempo specifico nel cluster (UTC). | corda |
| upgradeWave | Indica quando verranno applicati i nuovi aggiornamenti della versione del runtime del cluster dopo il rilascio. Per impostazione predefinita, wave0. Si applica solo quando upgradeMode è impostato su "Automatico". | 'Wave0' 'Wave1' 'Wave2' |
| 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 |
| vmssZonalUpgradeMode | Questa proprietà definisce la modalità di aggiornamento per il set di scalabilità di macchine virtuali, è obbligatorio se viene aggiunto un tipo di nodo con più zone di disponibilità. | 'Gerarchico' 'Parallel' |
| waveUpgradePaused | Valore booleano per sospendere gli aggiornamenti automatici delle versioni di runtime al cluster. | Bool |
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) |
| protectedAccountKeyName2 | Nome della chiave di archiviazione di diagnostica protetta secondaria. Se una delle chiavi dell'account di archiviazione viene ruotata, il cluster eseguirà il fallback all'uso dell'altro. | corda |
| 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 | '2023-11-01-preview' |
| ubicazione | Località delle risorse di Azure. | stringa (obbligatorio) |
| nome | Nome della risorsa | stringa (obbligatorio) |
| proprietà | Proprietà delle risorse del cluster | |
| 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) |
| httpGatewayTokenAuthEndpointPort | Porta usata per le connessioni HTTPS basate su token al cluster. Impossibile impostare la stessa porta di HttpGatewayEndpoint. | Int |
| 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) |
| isStateless | Indica se il tipo di nodo può ospitare solo carichi di lavoro senza stato. | Bool |
| multipleAvailabilityZones | Indica se il tipo di nodo è abilitato per supportare più zone. | Bool |
| 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 | VMInstanceCount deve essere da 1 a n, dove n indica il numero di istanze di vm corrispondenti a questo nodeType. VMInstanceCount = 0 può essere eseguito solo in questi scenari: NodeType è un nodeType secondario. Durabilità = Bronzo o Durabilità >= Bronze e InfrastructureServiceManager = true. Se VMInstanceCount = 0, implica che le macchine virtuali per questo nodeType non verranno usate per il calcolo iniziale delle dimensioni del cluster. | Int Vincoli: Valore minimo = 0 Valore massimo = 2147483647 (obbligatorio) |
NodeTypeDescriptionCapacities
| Nome | Descrizione | Valore |
|---|
NodeTypeDescriptionPlacementProperties
| Nome | Descrizione | Valore |
|---|
Notifica
| Nome | Descrizione | Valore |
|---|---|---|
| isEnabled | Indica se la notifica è abilitata. | bool (obbligatorio) |
| notificationCategory | Categoria di notifica. | 'WaveProgress' (obbligatorio) |
| notificationLevel | Livello di notifica. | 'All' 'Critical' (obbligatorio) |
| notificationTargets | Elenco di destinazioni che sottoscrivono la notifica. | NotificationTarget[] (obbligatorio) |
NotificationTarget
| Nome | Descrizione | Valore |
|---|---|---|
| notificationChannel | Il canale di notifica indica il tipo di ricevitori sottoscritti alla notifica, utente o sottoscrizione. | 'EmailSubscription' 'EmailUser' (obbligatorio) |
| Ricevitori | Elenco di destinazioni che sottoscrivono la notifica. | string[] (obbligatorio) |
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
|
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
|
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
|
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@2023-11-01-preview"
name = "string"
location = "string"
body = jsonencode({
properties = {
addOnFeatures = [
"string"
]
applicationTypeVersionsCleanupPolicy = {
maxUnusedVersionsToKeep = int
}
azureActiveDirectory = {
clientApplication = "string"
clusterApplication = "string"
tenantId = "string"
}
certificate = {
thumbprint = "string"
thumbprintSecondary = "string"
x509StoreName = "string"
}
certificateCommonNames = {
commonNames = [
{
certificateCommonName = "string"
certificateIssuerThumbprint = "string"
}
]
x509StoreName = "string"
}
clientCertificateCommonNames = [
{
certificateCommonName = "string"
certificateIssuerThumbprint = "string"
isAdmin = bool
}
]
clientCertificateThumbprints = [
{
certificateThumbprint = "string"
isAdmin = bool
}
]
clusterCodeVersion = "string"
diagnosticsStorageAccountConfig = {
blobEndpoint = "string"
protectedAccountKeyName = "string"
protectedAccountKeyName2 = "string"
queueEndpoint = "string"
storageAccountName = "string"
tableEndpoint = "string"
}
enableHttpGatewayExclusiveAuthMode = bool
eventStoreServiceEnabled = bool
fabricSettings = [
{
name = "string"
parameters = [
{
name = "string"
value = "string"
}
]
}
]
infrastructureServiceManager = bool
managementEndpoint = "string"
nodeTypes = [
{
applicationPorts = {
endPort = int
startPort = int
}
capacities = {
{customized property} = "string"
}
clientConnectionEndpointPort = int
durabilityLevel = "string"
ephemeralPorts = {
endPort = int
startPort = int
}
httpGatewayEndpointPort = int
httpGatewayTokenAuthEndpointPort = int
isPrimary = bool
isStateless = bool
multipleAvailabilityZones = bool
name = "string"
placementProperties = {
{customized property} = "string"
}
reverseProxyEndpointPort = int
vmInstanceCount = int
}
]
notifications = [
{
isEnabled = bool
notificationCategory = "string"
notificationLevel = "string"
notificationTargets = [
{
notificationChannel = "string"
receivers = [
"string"
]
}
]
}
]
reliabilityLevel = "string"
reverseProxyCertificate = {
thumbprint = "string"
thumbprintSecondary = "string"
x509StoreName = "string"
}
reverseProxyCertificateCommonNames = {
commonNames = [
{
certificateCommonName = "string"
certificateIssuerThumbprint = "string"
}
]
x509StoreName = "string"
}
sfZonalUpgradeMode = "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"
upgradePauseEndTimestampUtc = "string"
upgradePauseStartTimestampUtc = "string"
upgradeWave = "string"
vmImage = "string"
vmssZonalUpgradeMode = "string"
waveUpgradePaused = bool
}
})
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 |
|---|
ApplicationTypeVersionsCleanupPolicy
| Nome | Descrizione | Valore |
|---|---|---|
| maxUnusedVersionsToKeep | Numero di versioni inutilizzate per tipo di applicazione da mantenere. | Int Vincoli: Valore minimo = 0 (obbligatorio) |
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' |
| applicationTypeVersionsCleanupPolicy | Criteri usati per pulire le versioni inutilizzate. | ApplicationTypeVersionsCleanupPolicy |
| 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 |
| enableHttpGatewayExclusiveAuthMode | Se true, l'autenticazione basata su token non è consentita in HttpGatewayEndpoint. Questa operazione è necessaria per supportare TLS versioni 1.3 e successive. Se si usa l'autenticazione basata su token, è necessario definire HttpGatewayTokenAuthEndpointPort. | Bool |
| eventStoreServiceEnabled | Indica se il servizio dell'archivio eventi è abilitato. | Bool |
| fabricSettings | Elenco di impostazioni di infrastruttura personalizzate per configurare il cluster. | SettingsSectionDescription[] |
| infrastructureServiceManager | Indica se infrastructure service manager è abilitato. | Bool |
| managementEndpoint | Endpoint di gestione HTTP del cluster. | stringa (obbligatorio) |
| nodeTypes | Elenco dei tipi di nodo nel cluster. | NodeTypeDescription[] (obbligatorio) |
| Notifiche | Indica un elenco di canali di notifica per gli eventi del cluster. | notifica[] |
| 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 |
| sfZonalUpgradeMode | Questa proprietà controlla il raggruppamento logico delle macchine virtuali nei domini di aggiornamento .This property controls the logical grouping of VMs in upgrade domains (UDS). Questa proprietà non può essere modificata se nel cluster è già presente un tipo di nodo con più zone di disponibilità. | 'Gerarchico' 'Parallel' |
| 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' 'Manual' |
| upgradePauseEndTimestampUtc | Indica la data e l'ora di fine per sospendere gli aggiornamenti automatici della versione del runtime nel cluster per un periodo di tempo specifico nel cluster (UTC). | corda |
| upgradePauseStartTimestampUtc | Indica la data e l'ora di inizio per sospendere gli aggiornamenti automatici della versione del runtime nel cluster per un periodo di tempo specifico nel cluster (UTC). | corda |
| upgradeWave | Indica quando verranno applicati i nuovi aggiornamenti della versione del runtime del cluster dopo il rilascio. Per impostazione predefinita, wave0. Si applica solo quando upgradeMode è impostato su "Automatico". | 'Wave0' 'Wave1' 'Wave2' |
| 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 |
| vmssZonalUpgradeMode | Questa proprietà definisce la modalità di aggiornamento per il set di scalabilità di macchine virtuali, è obbligatorio se viene aggiunto un tipo di nodo con più zone di disponibilità. | 'Gerarchico' 'Parallel' |
| waveUpgradePaused | Valore booleano per sospendere gli aggiornamenti automatici delle versioni di runtime al cluster. | Bool |
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) |
| protectedAccountKeyName2 | Nome della chiave di archiviazione di diagnostica protetta secondaria. Se una delle chiavi dell'account di archiviazione viene ruotata, il cluster eseguirà il fallback all'uso dell'altro. | corda |
| 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 | |
| Tag | Tag delle risorse | Dizionario di nomi e valori di tag. |
| digitare | Tipo di risorsa | "Microsoft.ServiceFabric/clusters@2023-11-01-preview" |
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) |
| httpGatewayTokenAuthEndpointPort | Porta usata per le connessioni HTTPS basate su token al cluster. Impossibile impostare la stessa porta di HttpGatewayEndpoint. | Int |
| 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) |
| isStateless | Indica se il tipo di nodo può ospitare solo carichi di lavoro senza stato. | Bool |
| multipleAvailabilityZones | Indica se il tipo di nodo è abilitato per supportare più zone. | Bool |
| 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 | VMInstanceCount deve essere da 1 a n, dove n indica il numero di istanze di vm corrispondenti a questo nodeType. VMInstanceCount = 0 può essere eseguito solo in questi scenari: NodeType è un nodeType secondario. Durabilità = Bronzo o Durabilità >= Bronze e InfrastructureServiceManager = true. Se VMInstanceCount = 0, implica che le macchine virtuali per questo nodeType non verranno usate per il calcolo iniziale delle dimensioni del cluster. | Int Vincoli: Valore minimo = 0 Valore massimo = 2147483647 (obbligatorio) |
NodeTypeDescriptionCapacities
| Nome | Descrizione | Valore |
|---|
NodeTypeDescriptionPlacementProperties
| Nome | Descrizione | Valore |
|---|
Notifica
| Nome | Descrizione | Valore |
|---|---|---|
| isEnabled | Indica se la notifica è abilitata. | bool (obbligatorio) |
| notificationCategory | Categoria di notifica. | 'WaveProgress' (obbligatorio) |
| notificationLevel | Livello di notifica. | 'All' 'Critical' (obbligatorio) |
| notificationTargets | Elenco di destinazioni che sottoscrivono la notifica. | NotificationTarget[] (obbligatorio) |
NotificationTarget
| Nome | Descrizione | Valore |
|---|---|---|
| notificationChannel | Il canale di notifica indica il tipo di ricevitori sottoscritti alla notifica, utente o sottoscrizione. | 'EmailSubscription' 'EmailUser' (obbligatorio) |
| Ricevitori | Elenco di destinazioni che sottoscrivono la notifica. | string[] (obbligatorio) |
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) |