Condividi tramite

Cluster Microsoft.ServiceFabric 2017-07-01-preview

  • Articolo

Definizione di risorsa Bicep

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

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

Formato di risorsa

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

resource symbolicname 'Microsoft.ServiceFabric/clusters@2017-07-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    addOnFeatures: [
      'string'
    ]
    availableClusterVersions: [
      {
        codeVersion: 'string'
        environment: 'string'
        supportExpiryUtc: 'string'
      }
    ]
    azureActiveDirectory: {
      clientApplication: 'string'
      clusterApplication: 'string'
      tenantId: 'string'
    }
    certificate: {
      thumbprint: 'string'
      thumbprintSecondary: 'string'
      x509StoreName: 'string'
    }
    clientCertificateCommonNames: [
      {
        certificateCommonName: 'string'
        certificateIssuerThumbprint: 'string'
        isAdmin: bool
      }
    ]
    clientCertificateThumbprints: [
      {
        certificateThumbprint: 'string'
        isAdmin: bool
      }
    ]
    clusterCodeVersion: 'string'
    clusterState: 'string'
    diagnosticsStorageAccountConfig: {
      blobEndpoint: 'string'
      protectedAccountKeyName: 'string'
      queueEndpoint: 'string'
      storageAccountName: 'string'
      tableEndpoint: 'string'
    }
    fabricSettings: [
      {
        name: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
      }
    ]
    managementEndpoint: 'string'
    nodeTypes: [
      {
        applicationPorts: {
          endPort: int
          startPort: int
        }
        capacities: {
          {customized property}: 'string'
        }
        clientConnectionEndpointPort: int
        durabilityLevel: 'string'
        ephemeralPorts: {
          endPort: int
          startPort: int
        }
        httpGatewayEndpointPort: int
        isPrimary: bool
        name: 'string'
        placementProperties: {
          {customized property}: 'string'
        }
        reverseProxyEndpointPort: int
        vmInstanceCount: int
      }
    ]
    reliabilityLevel: 'string'
    reverseProxyCertificate: {
      thumbprint: 'string'
      thumbprintSecondary: 'string'
      x509StoreName: 'string'
    }
    upgradeDescription: {
      deltaHealthPolicy: {
        maxPercentDeltaUnhealthyApplications: int
        maxPercentDeltaUnhealthyNodes: int
        maxPercentUpgradeDomainDeltaUnhealthyNodes: int
      }
      forceRestart: bool
      healthCheckRetryTimeout: 'string'
      healthCheckStableDuration: 'string'
      healthCheckWaitDuration: 'string'
      healthPolicy: {
        maxPercentUnhealthyApplications: int
        maxPercentUnhealthyNodes: int
      }
      upgradeDomainTimeout: 'string'
      upgradeReplicaSetCheckTimeout: 'string'
      upgradeTimeout: 'string'
    }
    upgradeMode: 'string'
    vmImage: 'string'
  }
}

Valori delle proprietà

clusters

Nome Descrizione valore
name Nome della risorsa stringa (obbligatoria)

Limite di caratteri: 4-23

Caratteri validi:
Lettere minuscole, numeri e trattini.

Deve iniziare con una lettera minuscola. Deve terminare con una lettera minuscola o un numero.
posizione Percorso della risorsa. stringa (obbligatoria)
tags Tag di risorse. Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
properties Proprietà della risorsa del cluster ClusterProperties

ClusterProperties

Nome Descrizione Valore
addOnFeatures Elenco delle funzionalità del componente aggiuntivo da abilitare nel cluster. Matrice di stringhe contenente uno qualsiasi di:
'BackupRestoreService'
'DnsService'
'RepairManager'
availableClusterVersions Versioni di runtime di Service Fabric disponibili per questo cluster. ClusterVersionDetails[]
azureActiveDirectory Impostazioni di autenticazione AAD del cluster. AzureActiveDirectory
certificato Certificato da usare per proteggere il cluster. Il certificato fornito verrà usato per la sicurezza del nodo a nodo all'interno del cluster, il certificato SSL per l'endpoint di gestione del cluster e il client amministratore predefinito. CertificateDescription
clientCertificateCommonNames Elenco dei certificati client a cui fa riferimento il nome comune che è consentito 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 l'API ClusterVersion. Per ottenere l'elenco della versione disponibile per i cluster esistenti, usare availableClusterVersions. string
clusterState Stato corrente del cluster.

- WaitingForNodes : indica che la risorsa del cluster viene creata e il provider di risorse è in attesa dell'avvio e del report dell'estensione della macchina virtuale di Service Fabric.
- Distribuzione: indica che il runtime di Service Fabric viene installato nelle macchine virtuali. La risorsa del cluster sarà in questo stato fino all'avvio del cluster e ai servizi di sistema.
- BaselineUpgrade: indica che il cluster sta eseguendo l'aggiornamento per stabilire la versione del cluster. Questo aggiornamento viene avviato automaticamente quando il cluster viene avviato per la prima volta.
- AggiornamentoUserConfiguration: indica che il cluster viene aggiornato con la configurazione fornita dall'utente.
- AggiornamentoUserCertificate: indica che il cluster viene aggiornato con il certificato fornito dall'utente.
- AggiornamentoInfrastruttura: indica che il cluster viene aggiornato con la versione più recente del runtime di Service Fabric. Ciò avviene solo quando l'aggiornamentoMode è impostato su 'Automatico'.
- Applicazione diClusterVersion: indica che il cluster è in una versione diversa rispetto a quella prevista e che il cluster viene aggiornato alla versione prevista.
- UpgradeServiceUnreachable : indica che il servizio di sistema nel cluster non esegue più il polling del provider di risorse. I cluster in questo stato non possono essere gestiti dal provider di risorse.
- Scalabilità automatica: indica che l'affidabilitàlevel del cluster viene modificato.
- Pronto: indica che il cluster è in uno stato stabile.		 'Scalabilità automatica'
'BaselineUpgrade'
'Distribuzione'
'Applicazione diClusterVersion'
'Pronto'
'AggiornamentoInfrastruttura'
'AggiornamentoUserCertificate'
'UpdatingUserConfiguration'
'UpgradeServiceUnreachable'
'WaitingForNodes'
diagnosticsStorageAccountConfig Informazioni sull'account di archiviazione per l'archiviazione dei log di diagnostica di Service Fabric. DiagnosticsStorageAccountConfig
fabricSettings Elenco delle impostazioni dell'infrastruttura personalizzate per configurare il cluster. SettingsSectionDescription[]
managementEndpoint Endpoint di gestione HTTP del cluster. stringa (obbligatorio)
nodeTypes Elenco di 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
upgradeDescription Criteri da usare per 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 sarà 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. string

ClusterVersionDetails

Nome Descrizione Valore
codeVersion Versione di runtime di Service Fabric del cluster. string
ambiente Indica se questa versione è per il sistema operativo Windows o Linux. 'Linux'
'Windows'
supportExpiryUtc Data di scadenza del supporto della versione. string

AzureActiveDirectory

Nome Descrizione Valore
clientApplication ID applicazione client di Azure Active Directory. string
clusterApplication ID applicazione cluster di Azure Active Directory. string
TenantId ID tenant di Azure Active Directory. string

CertificateDescription

Nome Descrizione Valore
thumbprint Identificazione personale del certificato primario. stringa (obbligatorio)
identificazione personaleSecondario Identificazione personale del certificato secondario. string
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 (obbligatoria)
certificateIssuerThumbprint Identificazione personale dell'autorità di certificazione del certificato client. stringa (obbligatoria)
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 (obbligatoria)
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)

DiagnosticaStorageAccountConfig

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

ImpostazioniSectionDescription

Nome Descrizione valore
name Nome della sezione delle impostazioni dell'infrastruttura. stringa (obbligatoria)
parametri Raccolta di parametri nella sezione . ImpostazioniParameterDescription[] (obbligatorio)

ImpostazioniParameterDescription

Nome Descrizione valore
name Nome del parametro dell'impostazione dell'infrastruttura. stringa (obbligatoria)
Valore Valore del parametro dell'impostazione dell'infrastruttura. stringa (obbligatoria)

NodeTypeDescription

Nome Descrizione Valore
applicationPorts Intervallo di porte da cui il cluster assegnato la porta alle applicazioni di Service Fabric. EndpointRangeDescription
capacities 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. Questo è il valore predefinito.
- Silver: i processi di infrastruttura possono essere sospesi per una durata di 30 minuti per UD.
- Gold : i posti di lavoro dell'infrastruttura possono essere sospesi per una durata di 2 ore per UD. La durata Gold può essere abilitata solo per gli SKU VM con tutti i nodi come D15_V2, G5 e così via.		 'Bronzo'
'Oro'
'Silver'
ephemeralPorts L'intervallo di porte temporanee con cui i nodi di questo tipo di nodo devono essere configurati. EndpointRangeDescription
httpGatewayEndpointPort Porta dell'endpoint di gestione del cluster HTTP. int (obbligatorio)
isPrimary Tipo di nodo in cui verranno eseguiti i servizi di sistema. È necessario contrassegnare un solo tipo di nodo come primario. Il tipo di nodo primario non può essere eliminato o modificato per i cluster esistenti. bool (obbligatorio)
name Nome del tipo di nodo. stringa (obbligatoria)
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à di capacità nella risorsa VirtualMachineScaleSet corrispondente. int (obbligatorio)

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647

EndpointRangeDescription

Nome Descrizione Valore
endPort Porta finale di un intervallo di porte int (obbligatorio)
startPort Avvio della porta di un intervallo di porte int (obbligatorio)

NodeTypeDescriptionCapacities

Nome Descrizione Valore
{proprietà personalizzata} string

NodeTypeDescriptionPlacementProperties

Nome Descrizione Valore
{proprietà personalizzata} string

ClusterUpgradePolicy

Nome Descrizione Valore
deltaHealthPolicy I criteri di integrità delta 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 (obbligatoria)
healthCheckStableDuration Tempo di attesa per cui l'applicazione o il cluster devono rimanere integri prima di passare al dominio di aggiornamento successivo. La durata può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatoria)
healthCheckWaitDuration Tempo di attesa dopo il completamento di un dominio di aggiornamento prima di eseguire controlli di integrità. La durata può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatoria)
healthPolicy I criteri di integrità del cluster usati durante l'aggiornamento del cluster. ClusterHealthPolicy (obbligatorio)
upgradeDomainTimeout Il tempo necessario per completare 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 (obbligatoria)
upgradeReplicaSetCheckTimeout Tempo massimo per bloccare l'elaborazione di un dominio di aggiornamento ed evitare la perdita di disponibilità quando si verificano problemi imprevisti. Quando il timeout scade, l'elaborazione del dominio di aggiornamento procede 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 (obbligatoria)
upgradeTimeout Il tempo necessario per completare l'aggiornamento complessivo prima del rollback dell'aggiornamento. Il timeout può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatoria)

ClusterUpgradeDeltaHealthPolicy

Nome Descrizione Valore
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 dell'aggiornamento di ciascun dominio di aggiornamento per assicurarsi che lo stato complessivo del cluster rientri nei limiti di tolleranza. I servizi di sistema non sono inclusi in questo. int (obbligatorio)

Vincoli:
Valore minimo = 0
Valore massimo = 100
maxPercentDeltaUnhealthyNodes Percentuale massima di riduzione dell'integrità dei nodi consentita durante gli aggiornamenti del cluster. Il valore delta è misurato tra lo stato dei nodi e all'inizio dell'aggiornamento e lo stato dei nodi al momento della valutazione dell'integrità. Il controllo viene eseguito dopo il completamento dell'aggiornamento di ciascun dominio di aggiornamento per assicurarsi che lo stato complessivo del cluster rientri nei limiti di tolleranza. int (obbligatorio)

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

Vincoli:
Valore minimo = 0
Valore massimo = 100

ClusterHealthPolicy

Nome Descrizione Valore
maxPercentUnhealthyApplications Percentuale massima consentita di applicazioni non integre prima che venga segnalato un errore. Ad esempio, per consentire il 10% di applicazioni non integre, questo valore deve corrispondere a 10. INT

Vincoli:
Valore minimo = 0
Valore massimo = 100
maxPercentUnhealthyNodes Percentuale massima consentita di nodi non integri prima che venga segnalato un errore. Ad esempio, per consentire il 10% di nodi non integri, questo valore deve corrispondere a 10. INT

Vincoli:
Valore minimo = 0
Valore massimo = 100

Modelli di avvio rapido

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

Modello Descrizione
Distribuire un cluster Ubuntu Service Fabric a 5 nodi

Distribuisci in Azure 		Questo modello consente di distribuire un cluster di Service Fabric a 5 nodi sicuro che esegue Ubuntu in una macchina virtuale di dimensioni Standard_D2_V2.
Distribuire un cluster sicuro di 5 nodi

Distribuisci in Azure 		Questo modello consente di distribuire un cluster di Service Fabric a 5 nodi sicuro che esegue Windows Server 2019 Datacenter in una macchina virtuale di dimensioni Standard_D2_v2.
Distribuire un cluster sicuro 3 nodetype con gruppi di sicurezza di rete abilitati

Distribuisci in Azure 		Questo modello consente di distribuire un cluster di Service Fabric di tipo nodetype sicuro 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.

Definizione della risorsa modello di Resource Manager

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

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

Formato di risorsa

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

{
  "type": "Microsoft.ServiceFabric/clusters",
  "apiVersion": "2017-07-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "addOnFeatures": [ "string" ],
    "availableClusterVersions": [
      {
        "codeVersion": "string",
        "environment": "string",
        "supportExpiryUtc": "string"
      }
    ],
    "azureActiveDirectory": {
      "clientApplication": "string",
      "clusterApplication": "string",
      "tenantId": "string"
    },
    "certificate": {
      "thumbprint": "string",
      "thumbprintSecondary": "string",
      "x509StoreName": "string"
    },
    "clientCertificateCommonNames": [
      {
        "certificateCommonName": "string",
        "certificateIssuerThumbprint": "string",
        "isAdmin": "bool"
      }
    ],
    "clientCertificateThumbprints": [
      {
        "certificateThumbprint": "string",
        "isAdmin": "bool"
      }
    ],
    "clusterCodeVersion": "string",
    "clusterState": "string",
    "diagnosticsStorageAccountConfig": {
      "blobEndpoint": "string",
      "protectedAccountKeyName": "string",
      "queueEndpoint": "string",
      "storageAccountName": "string",
      "tableEndpoint": "string"
    },
    "fabricSettings": [
      {
        "name": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ]
      }
    ],
    "managementEndpoint": "string",
    "nodeTypes": [
      {
        "applicationPorts": {
          "endPort": "int",
          "startPort": "int"
        },
        "capacities": {
          "{customized property}": "string"
        },
        "clientConnectionEndpointPort": "int",
        "durabilityLevel": "string",
        "ephemeralPorts": {
          "endPort": "int",
          "startPort": "int"
        },
        "httpGatewayEndpointPort": "int",
        "isPrimary": "bool",
        "name": "string",
        "placementProperties": {
          "{customized property}": "string"
        },
        "reverseProxyEndpointPort": "int",
        "vmInstanceCount": "int"
      }
    ],
    "reliabilityLevel": "string",
    "reverseProxyCertificate": {
      "thumbprint": "string",
      "thumbprintSecondary": "string",
      "x509StoreName": "string"
    },
    "upgradeDescription": {
      "deltaHealthPolicy": {
        "maxPercentDeltaUnhealthyApplications": "int",
        "maxPercentDeltaUnhealthyNodes": "int",
        "maxPercentUpgradeDomainDeltaUnhealthyNodes": "int"
      },
      "forceRestart": "bool",
      "healthCheckRetryTimeout": "string",
      "healthCheckStableDuration": "string",
      "healthCheckWaitDuration": "string",
      "healthPolicy": {
        "maxPercentUnhealthyApplications": "int",
        "maxPercentUnhealthyNodes": "int"
      },
      "upgradeDomainTimeout": "string",
      "upgradeReplicaSetCheckTimeout": "string",
      "upgradeTimeout": "string"
    },
    "upgradeMode": "string",
    "vmImage": "string"
  }
}

Valori delle proprietà

clusters

Nome Descrizione Valore
tipo Tipo di risorsa 'Microsoft.ServiceFabric/clusters'
apiVersion Versione dell'API risorsa '2017-07-01-preview'
name Nome della risorsa stringa (obbligatoria)

Limite di caratteri: 4-23

Caratteri validi:
Lettere minuscole, numeri e trattini.

Deve iniziare con una lettera minuscola. Deve terminare con una lettera minuscola o un numero.
posizione Percorso della risorsa. stringa (obbligatoria)
tags Tag di risorse. Dizionario dei nomi e dei valori dei tag. Vedere Tag nei modelli
properties Proprietà della risorsa del cluster ClusterProperties

ClusterProperties

Nome Descrizione Valore
addOnFeatures Elenco delle funzionalità del componente aggiuntivo da abilitare nel cluster. Matrice di stringhe contenente uno qualsiasi di:
'BackupRestoreService'
'DnsService'
'RepairManager'
availableClusterVersions Versioni di runtime di Service Fabric disponibili per questo cluster. ClusterVersionDetails[]
azureActiveDirectory Impostazioni di autenticazione AAD del cluster. AzureActiveDirectory
certificato Certificato da usare per proteggere il cluster. Il certificato fornito verrà usato per la sicurezza del nodo a nodo all'interno del cluster, il certificato SSL per l'endpoint di gestione del cluster e il client amministratore predefinito. CertificateDescription
clientCertificateCommonNames Elenco dei certificati client a cui fa riferimento il nome comune che è consentito 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 l'API ClusterVersion. Per ottenere l'elenco della versione disponibile per i cluster esistenti, usare availableClusterVersions. string
clusterState Stato corrente del cluster.

- WaitingForNodes - Indica che la risorsa cluster è stata creata e che il provider di risorse è in attesa dell'avvio e del report dell'estensione vm di Service Fabric.
- Distribuzione : indica che il runtime di Service Fabric è in fase di installazione nelle macchine virtuali. La risorsa cluster sarà in questo stato fino all'avvio del cluster e fino all'avvio dei servizi di sistema.
- BaselineUpgrade - Indica che il cluster sta eseguendo l'aggiornamento per stabilire la versione del cluster. Questo aggiornamento viene avviato automaticamente all'avvio del cluster per la prima volta.
- UpdatingUserConfiguration : indica che il cluster viene aggiornato con la configurazione fornita dall'utente.
- UpdatingUserCertificate - Indica che il cluster viene aggiornato con il certificato fornito dall'utente.
- UpdatingInfrastructure - Indica che il cluster viene aggiornato con la versione più recente del runtime di Service Fabric. Ciò si verifica solo quando upgradeMode è impostato su "Automatico".
- Applicazione diClusterVersion: indica che il cluster si trova in una versione diversa del previsto e che il cluster viene aggiornato alla versione prevista.
- UpgradeServiceUnreachable - Indica che il servizio di sistema nel cluster non esegue più il polling del provider di risorse. I cluster in questo stato non possono essere gestiti dal provider di risorse.
- Scalabilità automatica- Indica che l'affidabilitàLevel del cluster viene modificata.
- Pronto - Indica che il cluster si trova in uno stato stabile.		 'Scalabilità automatica'
'BaselineUpgrade'
'Distribuzione'
'EnforcingClusterVersion'
'Pronto'
'UpdatingInfrastructure'
'UpdatingUserCertificate'
'UpdatingUserConfiguration'
'UpgradeServiceUnreachable'
'WaitingForNodes'
diagnosticsStorageAccountConfig Informazioni sull'account di archiviazione per l'archiviazione dei log di diagnostica di Service Fabric. DiagnosticsStorageAccountConfig
fabricSettings Elenco delle impostazioni dell'infrastruttura personalizzate per configurare il cluster. SettingsSectionDescription[]
managementEndpoint Endpoint di gestione HTTP del cluster. stringa (obbligatorio)
nodeTypes Elenco di 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
upgradeDescription Criteri da usare per 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 sarà 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. string

ClusterVersionDetails

Nome Descrizione Valore
codeVersion Versione di runtime di Service Fabric del cluster. string
ambiente Indica se questa versione è per il sistema operativo Windows o Linux. 'Linux'
'Windows'
supportExpiryUtc Data di scadenza del supporto della versione. string

AzureActiveDirectory

Nome Descrizione Valore
clientApplication ID applicazione client di Azure Active Directory. string
clusterApplication ID applicazione cluster di Azure Active Directory. string
TenantId ID tenant di Azure Active Directory. string

CertificateDescription

Nome Descrizione Valore
thumbprint Identificazione personale del certificato primario. stringa (obbligatorio)
identificazione personaleSecondario Identificazione personale del certificato secondario. string
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)

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 Il nome dell'account di archiviazione di Azure. stringa (obbligatorio)
tableEndpoint Endpoint della tabella dell'account di archiviazione di Azure. stringa (obbligatorio)

SettingsSectionDescription

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

SettingsParameterDescription

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

NodeTypeDescription

Nome Descrizione Valore
applicationPorts Intervallo di porte da cui il cluster ha assegnato la porta alle applicazioni di Service Fabric. EndpointRangeDescription
capacities 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 DurabilityLevel.

- Bronzo - Nessun privilegio. Questo è il valore predefinito.
- Silver: i processi di infrastruttura possono essere sospesi per una durata di 30 minuti per ogni UD.
- Gold: i processi di infrastruttura possono essere sospesi per una durata di 2 ore per ogni UD. La durata Gold può essere abilitata solo per gli SKU VM con tutti i nodi come D15_V2, G5 e così via.		 'Bronze'
'Oro'
'Silver'
effimeroPorts L'intervallo di porte temporanee con cui devono essere configurati i nodi di 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. Solo un tipo di nodo deve essere contrassegnato come primario. Non è possibile eliminare o modificare il tipo di nodo primario per i cluster esistenti. bool (obbligatorio)
name Nome del tipo di nodo. stringa (obbligatorio)
placementProperties 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 (obbligatorio)

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647

EndpointRangeDescription

Nome Descrizione Valore
endPort Porta finale di un intervallo di porte int (obbligatorio)
startPort Avvio della porta di un intervallo di porte int (obbligatorio)

NodeTypeDescriptionCapacities

Nome Descrizione Valore
{proprietà personalizzata} string

NodeTypeDescriptionPlacementProperties

Nome Descrizione Valore
{proprietà personalizzata} string

ClusterUpgradePolicy

Nome Descrizione Valore
deltaHealthPolicy Criteri di integrità differenziale usati per 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 Tempo di attesa per cui l'applicazione o il cluster devono rimanere integri prima di passare al dominio di aggiornamento successivo. La durata può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
healthCheckWaitDuration Intervallo di tempo 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 Tempo massimo per bloccare l'elaborazione di un dominio di aggiornamento ed evitare la perdita di disponibilità quando si verificano problemi imprevisti. Quando il timeout scade, l'elaborazione del dominio di aggiornamento procede 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)

ClusterUpgradeDeltaHealthPolicy

Nome Descrizione Valore
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 dell'aggiornamento di ciascun dominio di aggiornamento per assicurarsi che lo stato complessivo del cluster rientri nei limiti di tolleranza. I servizi di sistema non sono inclusi in questo. int (obbligatorio)

Vincoli:
Valore minimo = 0
Valore massimo = 100
maxPercentDeltaUnhealthyNodes Percentuale massima di riduzione dell'integrità dei nodi consentita durante gli aggiornamenti del cluster. Il valore delta è misurato tra lo stato dei nodi e all'inizio dell'aggiornamento e lo stato dei nodi al momento della valutazione dell'integrità. Il controllo viene eseguito dopo il completamento dell'aggiornamento di ciascun dominio di aggiornamento per assicurarsi che lo stato complessivo del cluster rientri nei limiti di tolleranza. int (obbligatorio)

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

Vincoli:
Valore minimo = 0
Valore massimo = 100

ClusterHealthPolicy

Nome Descrizione Valore
maxPercentUnhealthyApplications Percentuale massima consentita di applicazioni non integre prima che venga segnalato un errore. Ad esempio, per consentire il 10% di applicazioni non integre, questo valore deve corrispondere a 10. INT

Vincoli:
Valore minimo = 0
Valore massimo = 100
maxPercentUnhealthyNodes Percentuale massima consentita di nodi non integri prima che venga segnalato un errore. Ad esempio, per consentire il 10% di nodi non integri, questo valore deve corrispondere a 10. INT

Vincoli:
Valore minimo = 0
Valore massimo = 100

Modelli di avvio rapido

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

Modello Descrizione
Distribuire un cluster Ubuntu Service Fabric a 5 nodi

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

Distribuisci in Azure 		Questo modello consente di distribuire un cluster di Service Fabric a 5 nodi sicuro che esegue Windows Server 2019 Datacenter in un set di scalabilità di macchine virtuali di dimensioni Standard_D2_v2.
Distribuire un cluster sicuro a 3 tipi di nodo con gruppi di sicurezza di rete abilitati

Distribuisci in Azure 		Questo modello consente di distribuire un cluster di Service Fabric con tipo di nodo sicuro con Windows Server 2016 in un data center 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.

Definizione della 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 di risorsa

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceFabric/clusters@2017-07-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      addOnFeatures = [
        "string"
      ]
      availableClusterVersions = [
        {
          codeVersion = "string"
          environment = "string"
          supportExpiryUtc = "string"
        }
      ]
      azureActiveDirectory = {
        clientApplication = "string"
        clusterApplication = "string"
        tenantId = "string"
      }
      certificate = {
        thumbprint = "string"
        thumbprintSecondary = "string"
        x509StoreName = "string"
      }
      clientCertificateCommonNames = [
        {
          certificateCommonName = "string"
          certificateIssuerThumbprint = "string"
          isAdmin = bool
        }
      ]
      clientCertificateThumbprints = [
        {
          certificateThumbprint = "string"
          isAdmin = bool
        }
      ]
      clusterCodeVersion = "string"
      clusterState = "string"
      diagnosticsStorageAccountConfig = {
        blobEndpoint = "string"
        protectedAccountKeyName = "string"
        queueEndpoint = "string"
        storageAccountName = "string"
        tableEndpoint = "string"
      }
      fabricSettings = [
        {
          name = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
        }
      ]
      managementEndpoint = "string"
      nodeTypes = [
        {
          applicationPorts = {
            endPort = int
            startPort = int
          }
          capacities = {
            {customized property} = "string"
          }
          clientConnectionEndpointPort = int
          durabilityLevel = "string"
          ephemeralPorts = {
            endPort = int
            startPort = int
          }
          httpGatewayEndpointPort = int
          isPrimary = bool
          name = "string"
          placementProperties = {
            {customized property} = "string"
          }
          reverseProxyEndpointPort = int
          vmInstanceCount = int
        }
      ]
      reliabilityLevel = "string"
      reverseProxyCertificate = {
        thumbprint = "string"
        thumbprintSecondary = "string"
        x509StoreName = "string"
      }
      upgradeDescription = {
        deltaHealthPolicy = {
          maxPercentDeltaUnhealthyApplications = int
          maxPercentDeltaUnhealthyNodes = int
          maxPercentUpgradeDomainDeltaUnhealthyNodes = int
        }
        forceRestart = bool
        healthCheckRetryTimeout = "string"
        healthCheckStableDuration = "string"
        healthCheckWaitDuration = "string"
        healthPolicy = {
          maxPercentUnhealthyApplications = int
          maxPercentUnhealthyNodes = int
        }
        upgradeDomainTimeout = "string"
        upgradeReplicaSetCheckTimeout = "string"
        upgradeTimeout = "string"
      }
      upgradeMode = "string"
      vmImage = "string"
    }
  })
}

Valori delle proprietà

clusters

Nome Descrizione Valore
tipo Tipo di risorsa "Microsoft.ServiceFabric/clusters@2017-07-01-preview"
name Nome della risorsa stringa (obbligatorio)

Limite di caratteri: 4-23

Caratteri validi:
Lettere minuscole, numeri e trattini.

Deve iniziare con una lettera minuscola. Deve terminare con una lettera minuscola o un numero.
posizione Percorso della risorsa. stringa (obbligatorio)
parent_id Per eseguire la distribuzione in un gruppo di risorse, usare l'ID del gruppo di risorse. stringa (obbligatorio)
tags Tag delle risorse. Dizionario di nomi e valori di tag.
properties Proprietà delle risorse cluster ClusterProperties

ClusterProperties

Nome Descrizione Valore
addOnFeatures Elenco di funzionalità del componente aggiuntivo da abilitare nel cluster. Matrice di stringhe contenente uno dei seguenti elementi:
"BackupRestoreService"
"DnsService"
"RepairManager"
availableClusterVersions Versioni di runtime di Service Fabric disponibili per questo cluster. ClusterVersionDetails[]
azureActiveDirectory Impostazioni di autenticazione AAD del cluster. AzureActiveDirectory
certificato Certificato da usare per proteggere il cluster. Il certificato fornito verrà usato per la sicurezza del nodo a nodo all'interno del cluster, il certificato SSL per l'endpoint di gestione del cluster e il client amministratore predefinito. CertificateDescription
clientCertificateCommonNames Elenco dei certificati client a cui fa riferimento il nome comune che è consentito 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 l'API ClusterVersion. Per ottenere l'elenco della versione disponibile per i cluster esistenti, usare availableClusterVersions. string
clusterState Stato corrente del cluster.

- WaitingForNodes : indica che la risorsa del cluster viene creata e il provider di risorse è in attesa dell'avvio e del report dell'estensione della macchina virtuale di Service Fabric.
- Distribuzione: indica che il runtime di Service Fabric viene installato nelle macchine virtuali. La risorsa del cluster sarà in questo stato fino all'avvio del cluster e ai servizi di sistema.
- BaselineUpgrade: indica che il cluster sta eseguendo l'aggiornamento per stabilire la versione del cluster. Questo aggiornamento viene avviato automaticamente quando il cluster viene avviato per la prima volta.
- AggiornamentoUserConfiguration: indica che il cluster viene aggiornato con la configurazione fornita dall'utente.
- AggiornamentoUserCertificate: indica che il cluster viene aggiornato con il certificato fornito dall'utente.
- AggiornamentoInfrastruttura: indica che il cluster viene aggiornato con la versione più recente del runtime di Service Fabric. Ciò avviene solo quando l'aggiornamentoMode è impostato su 'Automatico'.
- Applicazione diClusterVersion: indica che il cluster è in una versione diversa rispetto a quella prevista e che il cluster viene aggiornato alla versione prevista.
- UpgradeServiceUnreachable : indica che il servizio di sistema nel cluster non esegue più il polling del provider di risorse. I cluster in questo stato non possono essere gestiti dal provider di risorse.
- Scalabilità automatica: indica che l'affidabilitàlevel del cluster viene modificato.
- Pronto: indica che il cluster è in uno stato stabile.		 "Scalabilità automatica"
"BaselineUpgrade"
"Distribuzione"
"Applicazione diClusterVersion"
"Pronto"
"Aggiornamentoinfrastruttura"
"AggiornamentoUserCertificate"
"AggiornamentoUserConfiguration"
"UpgradeServiceUnreachable"
"WaitingForNodes"
diagnosticsStorageAccountConfig Informazioni sull'account di archiviazione per l'archiviazione dei log di diagnostica di Service Fabric. DiagnosticaStorageAccountConfig
fabricSettings Elenco delle impostazioni di infrastruttura personalizzate per configurare il cluster. ImpostazioniSectionDescription[]
managementEndpoint Endpoint di gestione http del cluster. stringa (obbligatoria)
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.
- Bronzo - 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.		 "Bronzo"
"Oro"
"None"
"Platinum"
"Silver"
reverseProxyCertificate Certificato del server usato dal proxy inverso. CertificateDescription
upgradeDescription Criterio da usare durante l'aggiornamento del cluster. ClusterUpgradePolicy
upgradeMode Modalità di aggiornamento del cluster quando è disponibile la nuova versione del runtime di Service Fabric.

- Automatico: il cluster verrà aggiornato automaticamente alla versione di runtime più recente 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 del cluster.		 "Automatico"
"Manuale"
vmImage La macchina virtuale vm vmss è stata configurata con. È possibile usare nomi generici come Windows o Linux. string

ClusterVersionDetails

Nome Descrizione Valore
codeVersion Versione del runtime di Service Fabric del cluster. string
ambiente Indica se questa versione è per il sistema operativo Windows o Linux. "Linux"
"Windows"
supportExpiryUtc Data di scadenza del supporto della versione. string

AzureActiveDirectory

Nome Descrizione Valore
clientApplication ID applicazione client di Azure Active Directory. string
clusterApplication ID applicazione cluster di Azure Active Directory. string
TenantId ID tenant di Azure Active Directory. string

CertificateDescription

Nome Descrizione Valore
thumbprint Identificazione personale del certificato primario. stringa (obbligatorio)
identificazione personaleSecondario Identificazione personale del certificato secondario. string
x509StoreName Percorso dell'archivio certificati locale. "AddressBook"
"AuthRoot"
"CertificateAuthority"
"Non consentito"
"My"
"Radice"
"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)

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 Il nome dell'account di archiviazione di Azure. stringa (obbligatorio)
tableEndpoint Endpoint della tabella dell'account di archiviazione di Azure. stringa (obbligatorio)

SettingsSectionDescription

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

SettingsParameterDescription

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

NodeTypeDescription

Nome Descrizione Valore
applicationPorts Intervallo di porte da cui il cluster ha assegnato la porta alle applicazioni di Service Fabric. EndpointRangeDescription
capacities 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 DurabilityLevel.

- Bronzo - Nessun privilegio. Questo è il valore predefinito.
- Silver: i processi di infrastruttura possono essere sospesi per una durata di 30 minuti per ogni UD.
- Gold: i processi di infrastruttura possono essere sospesi per una durata di 2 ore per ogni UD. La durata Gold può essere abilitata solo per gli SKU VM con tutti i nodi come D15_V2, G5 e così via.		 "Bronzo"
"Oro"
"Silver"
effimeroPorts L'intervallo di porte temporanee con cui devono essere configurati i nodi di 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. Solo un tipo di nodo deve essere contrassegnato come primario. Non è possibile eliminare o modificare il tipo di nodo primario per i cluster esistenti. bool (obbligatorio)
name Nome del tipo di nodo. stringa (obbligatorio)
placementProperties 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 (obbligatorio)

Vincoli:
Valore minimo = 1
Valore massimo = 2147483647

EndpointRangeDescription

Nome Descrizione Valore
endPort Porta finale di un intervallo di porte int (obbligatorio)
startPort Avvio della porta di un intervallo di porte int (obbligatorio)

NodeTypeDescriptionCapacities

Nome Descrizione Valore
{proprietà personalizzata} string

NodeTypeDescriptionPlacementProperties

Nome Descrizione Valore
{proprietà personalizzata} string

ClusterUpgradePolicy

Nome Descrizione Valore
deltaHealthPolicy Criteri di integrità differenziale usati per 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 Tempo di attesa per cui l'applicazione o il cluster devono rimanere integri prima di passare al dominio di aggiornamento successivo. La durata può essere in formato hh:mm:ss o d.hh:mm:ss.ms. stringa (obbligatorio)
healthCheckWaitDuration Intervallo di tempo 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 Tempo massimo per bloccare l'elaborazione di un dominio di aggiornamento ed evitare la perdita di disponibilità quando si verificano problemi imprevisti. Quando il timeout scade, l'elaborazione del dominio di aggiornamento procede 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)

ClusterUpgradeDeltaHealthPolicy

Nome Descrizione Valore
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 dell'aggiornamento di ciascun dominio di aggiornamento per assicurarsi che lo stato complessivo del cluster rientri nei limiti di tolleranza. I servizi di sistema non sono inclusi in questo. int (obbligatorio)

Vincoli:
Valore minimo = 0
Valore massimo = 100
maxPercentDeltaUnhealthyNodes Percentuale massima di riduzione dell'integrità dei nodi consentita durante gli aggiornamenti del cluster. Il valore delta è misurato tra lo stato dei nodi e all'inizio dell'aggiornamento e lo stato dei nodi al momento della valutazione dell'integrità. Il controllo viene eseguito dopo il completamento dell'aggiornamento di ciascun dominio di aggiornamento per assicurarsi che lo stato complessivo del cluster rientri nei limiti di tolleranza. int (obbligatorio)

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

Vincoli:
Valore minimo = 0
Valore massimo = 100

ClusterHealthPolicy

Nome Descrizione Valore
maxPercentUnhealthyApplications Percentuale massima consentita di applicazioni non integre prima che venga segnalato un errore. Ad esempio, per consentire il 10% di applicazioni non integre, questo valore deve corrispondere a 10. INT

Vincoli:
Valore minimo = 0
Valore massimo = 100
maxPercentUnhealthyNodes Percentuale massima consentita di nodi non integri prima che venga segnalato un errore. Ad esempio, per consentire il 10% di nodi non integri, questo valore deve corrispondere a 10. INT

Vincoli:
Valore minimo = 0
Valore massimo = 100