Parametri di aggiornamento di un'applicazione
Questo articolo descrive i diversi parametri che si applicano durante l'aggiornamento di un'applicazione di Azure Service Fabric. I parametri di aggiornamento di un'applicazione determinano i timeout e i controlli di integrità che vengono applicati durante l'aggiornamento e specificano i criteri da applicare quando un aggiornamento non riesce. I parametri dell'applicazione si applicano agli aggiornamenti tramite:
- PowerShell
- Visual Studio
- SFCTL
- REST
Gli aggiornamenti dell'applicazione possono essere avviati tramite una delle tre modalità di aggiornamento selezionabili dall'utente. Ogni modalità ha un proprio set di parametri dell'applicazione:
- Monitored
- Unmonitored Auto
- Unmonitored Manual
I parametri obbligatori e facoltativi applicabili sono descritti in ogni sezione come segue.
Parametri di Visual Studio e PowerShell
Gli aggiornamenti dell'applicazione di Service Fabric con PowerShell usano il comando Start-ServiceFabricApplicationUpgrade. Si seleziona la modalità di aggiornamento passando il parametro Monitored, UnmonitoredAuto o UnmonitoredManual a Start-ServiceFabricApplicationUpgrade.
I parametri di aggiornamento delle applicazioni di Service Fabric in Visual Studio vengono impostati tramite la finestra di dialogo di Visual Studio Aggiornamento impostazioni. Si seleziona la modalità di aggiornamento di Visual Studio usando l'elenco a discesa sia su Modalità di aggiornamento che su Monitored, UnmonitoredAuto o UnmonitoredManual . Per altre informazioni, vedere Configurare l'aggiornamento di un'applicazione di Service Fabric in Visual Studio.
Parametri obbligatori
| Parametro | Si applica a | Descrizione |
|---|---|---|
| ApplicationName | PowerShell | Nome dell'applicazione che viene aggiornata. Esempi: fabric:/VisualObjects, fabric:/ClusterMonitor. |
| ApplicationTypeVersion | PowerShell | Versione del tipo di applicazione a cui è destinato l'aggiornamento. |
| FailureAction | PowerShell, Visual Studio | I valori consentiti sono Rollback, Manual, e Invalid. L'azione di compensazione da eseguire quando un aggiornamento di monitoraggio rileva violazioni dei criteri di integrità o dei criteri di monitoraggio. Rollback specifica che l'aggiornamento eseguirà il rollback automaticamente alla versione precedente. Manual indica che l'aggiornamento passerà alla modalità di aggiornamento UnmonitoredManual. Invalid indica che l'azione di errore non è valida. |
| Monitored | PowerShell | Indica che la modalità di aggiornamento viene monitorata. Al termine dell'aggiornamento per un dominio di aggiornamento del cmdlet, se l'integrità del dominio di aggiornamento e il cluster soddisfano i criteri di integrità definiti, Service Fabric consente di aggiornare il dominio di aggiornamento successivo. Se il dominio di aggiornamento o il cluster non riescono a soddisfare i criteri di integrità, l'aggiornamento non riesce, quindi la risorsa Service Fabric esegue il rollback dell'aggiornamento per il dominio di aggiornamento o viene ripristinata la modalità manuale per i criteri specificati. Si tratta della modalità consigliata per gli aggiornamenti dell'applicazione in un ambiente di produzione. |
| UpgradeMode | Visual Studio | I valori consentiti sono Monitored (impostazione predefinita), UnmonitoredAuto o UnmonitoredManual. Vedere i parametri di PowerShell per ogni modalità, in questo articolo, per informazioni dettagliate. |
| UnmonitoredAuto | PowerShell | Indica che la modalità di aggiornamento non viene monitorata automaticamente. Dopo che la risorsa Service Fabric effettua un aggiornamento su un dominio di aggiornamento, Service Fabric consente di aggiornare il dominio di aggiornamento successivo, qualunque sia lo stato di integrità dell'applicazione. Questa modalità non è consigliabile per la produzione ed è utile solo durante lo sviluppo di un'applicazione. |
| UnmonitoredManual | PowerShell | Indica che la modalità di aggiornamento non viene monitorata manualmente. Dopo che la risorsa Service Fabric effettua un aggiornamento su un dominio di aggiornamento, rimane in attesa per poter aggiornare il dominio di aggiornamento successivo con il cmdletResume-ServiceFabricApplicationUpgrade. |
Parametri facoltativi
I criteri di valutazione dell'integrità sono facoltativi. Se all'avvio di un aggiornamento non vengono specificati i criteri di valutazione dell'integrità, Service Fabric usa i criteri di integrità dell'applicazione specificati nel file ApplicationManifest.xml dell'istanza dell'applicazione.
| Parametro | Si applica a | Descrizione |
|---|---|---|
| ApplicationParameter | PowerShell, Visual Studio | Specifica le sostituzioni per i parametri dell'applicazione. I parametri delle applicazioni di PowerShell vengono specificati come coppie nome/valore di tabella hash. Ad esempio, @{"VotingData_MinReplicaSetSize" = "3". "VotingData_PartitionCount" = "1"}. I parametri dell'applicazione di Visual Studio possono essere specificati nella finestra di dialogo Pubblica applicazione di Service Fabric nel campo File di parametri dell'applicazione. |
| Confirm | PowerShell | I valori consentiti sono true e false. Richiede la conferma dell'utente prima di eseguire il cmdlet. |
| ConsiderWarningAsError | PowerShell, Visual Studio | I valori consentiti sono true e false. Il valore predefinito è False. Considerare gli eventi di avviso relativi all'integrità dell'applicazione come errori quando si valuta l'integrità dell'applicazione durante l'aggiornamento. Per impostazione predefinita, Service Fabric non valuta eventi di avviso relativi all'integrità come errori, quindi l'aggiornamento può continuare anche se vengono generati questi eventi. |
| DefaultServiceTypeHealthPolicy | PowerShell, Visual Studio | Specifica i criteri di integrità per il tipo di servizio predefinito da usare per l'aggiornamento monitorato nei formati, MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Ad esempio, 5,10,15 indica i valori seguenti: MaxPercentUnhealthyPartitionsPerService = 5, MaxPercentUnhealthyReplicasPerPartition = 10, MaxPercentUnhealthyServices = 15. |
| Force | PowerShell, Visual Studio | I valori consentiti sono true e false. Indica che il processo di aggiornamento ignora il messaggio di avviso e forza l'aggiornamento anche quando il numero di versione non è stato modificato. Ciò è utile per il test locale ma non è consigliato per l'uso in un ambiente di produzione perché è necessario rimuovere la distribuzione esistente che causa tempi di inattività e perdita potenziale di dati. |
| ForceRestart | PowerShell, Visual Studio | Se si aggiorna un pacchetto di configurazione o di dati senza aggiornare il codice del servizio, il servizio viene riavviato solo se la proprietà ForceRestart è impostata su True. Quando l'aggiornamento è completo, Service Fabric notifica al servizio che è disponibile un nuovo pacchetto di configurazione o di dati. Il servizio è responsabile dell'applicazione delle modifiche. Se necessario, il servizio può riavviarsi. |
| HealthCheckRetryTimeoutSec | PowerShell, Visual Studio | Intervallo di tempo (in secondi) in cui Service Fabric continua a eseguire la valutazione dell'integrità prima di dichiarare l'aggiornamento come non riuscito. Il valore predefinito è 600 secondi. Il calcolo del tempo inizia dopo che viene raggiunto il valore definito da HealthCheckWaitDuration. Nell'ambito di questo intervallo di tempo definito da HealthCheckRetryTimeout, Service Fabric può eseguire più controlli di integrità dell'applicazione. Il valore predefinito è 10 minuti ed è consigliabile personalizzarlo in base all'applicazione. |
| HealthCheckStableDurationSec | PowerShell, Visual Studio | Il periodo (in secondi) per verificare che l'applicazione sia stabile prima di passare al dominio di aggiornamento successivo o di completare l'aggiornamento. Questo intervallo viene usato per evitare che immediatamente dopo il controllo di integrità vengono apportate modifiche all'integrità non rilevate. Il valore predefinito è 120 secondi ed è consigliabile personalizzarlo in base all'applicazione. |
| HealthCheckWaitDurationSec | PowerShell, Visual Studio | Tempo di attesa, in secondi, dopo il completamento dell'aggiornamento nel dominio di aggiornamento prima che Service Fabric valuti l'integrità dell'applicazione. La durata può essere considerata anche come il tempo di esecuzione di un'applicazione prima che venga considerata integra. Se il controllo di integrità ha esito positivo, il processo di aggiornamento passa al dominio di aggiornamento successivo. Se invece il controllo di integrità ha esito negativo, Service Fabric attende UpgradeHealthCheckInterval prima di riprovare a eseguire il controllo di integrità finché non viene raggiunto il valore definito da HealthCheckRetryTimeoutSec. Il valore predefinito e consigliato è 0 secondi. |
| MaxPercentUnhealthyDeployedApplications | PowerShell, Visual Studio | Il valore predefinito e consigliato è 0. Specificare il numero massimo di applicazioni distribuite (vedere la sezione relativa all'integrità) che possono essere non integre prima che l'applicazione venga considerata non integra e l'aggiornamento non riesca. Questo parametro definisce l'integrità dell'applicazione sul nodo e consente di rilevare eventuali problemi durante l'aggiornamento. Normalmente alle repliche dell'applicazione viene applicato un bilanciamento del carico basato sull'altro nodo, in modo che l'applicazione risulti integra e l'aggiornamento possa continuare. Specificando uno stato di integrità MaxPercentUnhealthyDeployedApplications rigoroso, Service Fabric può rilevare rapidamente un problema con il pacchetto dell'applicazione, determinando un aggiornamento con risposta immediata agli errori. |
| MaxPercentUnhealthyServices | PowerShell, Visual Studio | Un parametro a DefaultServiceTypeHealthPolicy e ServiceTypeHealthPolicyMap. Il valore predefinito e consigliato è 0. Specificare il numero massimo di servizi dell'istanza dell'applicazione che possono essere non integri prima che l'applicazione venga considerata non integra e l'aggiornamento non riesca. |
| MaxPercentUnhealthyPartitionsPerService | PowerShell, Visual Studio | Un parametro a DefaultServiceTypeHealthPolicy e ServiceTypeHealthPolicyMap. Il valore predefinito e consigliato è 0. Specificare il numero massimo di partizioni di un servizio che possono essere non integre prima che il servizio venga considerato non integro. |
| MaxPercentUnhealthyReplicasPerPartition | PowerShell, Visual Studio | Un parametro a DefaultServiceTypeHealthPolicy e ServiceTypeHealthPolicyMap. Il valore predefinito e consigliato è 0. Specificare il numero massimo di repliche nella partizione che possono essere non integre prima che la partizione venga considerata non integra. |
| ServiceTypeHealthPolicyMap | PowerShell, Visual Studio | Descrive i criteri di integrità usati per valutare l'integrità dei servizi che appartengono a un tipo di servizio. Accetta un input di tabella hash nel formato seguente: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"} Ad esempio: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" } |
| TimeoutSec | PowerShell , Visual Studio | Specifica il periodo di timeout in secondi per l'operazione. |
| UpgradeDomainTimeoutSec | PowerShell, Visual Studio | Tempo massimo (in secondi) per l'aggiornamento di un singolo dominio di aggiornamento. Se viene raggiunto questo timeout, l'aggiornamento si arresta e procede in base all'impostazione di FailureAction. Il valore predefinito è mai (Infinito) ed è consigliabile personalizzarlo in base all'applicazione. |
| UpgradeReplicaSetCheckTimeoutSec | PowerShell, Visual Studio | Il valore è espresso in secondi. Servizio senza stato: in un singolo dominio di aggiornamento Service Fabric prova a verificare che siano disponibili istanze aggiuntive del servizio. Se il numero di istanze di destinazione è maggiore di uno, Service Fabric attende che sia disponibile più di un'istanza fino al valore di timeout massimo. Questo timeout è specificato dalla proprietà UpgradeReplicaSetCheckTimeoutSec. Se il timeout scade, Service Fabric procede con l'aggiornamento indipendentemente dal numero di istanze del servizio. Se il numero di istanze di destinazione è pari a uno, Service Fabric non attende e procede immediatamente con l'aggiornamento. Servizio con stato: in un singolo dominio di aggiornamento Service Fabric prova a verificare che il set di repliche abbia un quorum. Service Fabric attende che sia disponibile un quorum fino al valore di timeout massimo, (specificato dalla proprietà UpgradeReplicaSetCheckTimeoutsec). Se il timeout scade, Service Fabric procede con l'aggiornamento indipendentemente dal quorum. Il valore di questa impostazione è never (infinito) per il roll forward e 1200 secondi per il rollback. |
| UpgradeTimeoutSec | PowerShell, Visual Studio | Intervallo di timeout, in secondi, che si applica per l'intero aggiornamento. Se viene raggiunto questo timeout, l'aggiornamento si arresta e viene attivata l'azione specificata da FailureAction. Il valore predefinito è mai (Infinito) ed è consigliabile personalizzarlo in base all'applicazione. |
| Whatif | PowerShell | I valori consentiti sono true e false. Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito. |
I criteri MaxPercentUnhealthyServices, MaxPercentUnhealthyPartitionsPerService e MaxPercentUnhealthyReplicasPerPartition possono essere specificati per tipo di servizio per un'istanza dell'applicazione. Impostando questi parametri "per servizio" un'applicazione può contenere tipi di servizi diversi con criteri di valutazione diversi. Ad esempio, un tipo di servizio gateway senza stato può avere un parametro MaxPercentUnhealthyPartitionsPerService diverso da un tipo di servizio motore con stato per una specifica istanza dell'applicazione.
Parametri SFCTL
Gli aggiornamenti dell'applicazione Service Fabric che impiegano l'interfaccia della riga di comando di Service Fabric usano il comando sfctl application upgrade insieme ai parametri obbligatori e facoltativi seguenti.
Parametri obbligatori
| Parametro | Descrizione |
|---|---|
| application-id | ID dell'applicazione in corso di aggiornamento. Si tratta in genere del nome completo dell'applicazione senza lo schema URI "fabric:". A partire dalla versione 6.0, i nomi gerarchici sono delimitati con il carattere "~". Ad esempio, se il nome dell'applicazione è "fabric:/myapp/app1", l'identità dell'applicazione sarà "myapp~app1" nella versione 6.0 e successive e "myapp/app1" nelle versioni precedenti. |
| application-version | Versione del tipo di applicazione a cui è destinato l'aggiornamento. |
| parameters | Elenco con codifica JSON di sostituzioni del parametro dell'applicazione da applicare quando si esegue l'aggiornamento dell'applicazione. |
Parametri facoltativi
| Parametro | Descrizione |
|---|---|
| default-service-health-policy | Specifica con codifica JSON dei criteri di integrità usati per impostazione predefinita per la valutazione dell'integrità di un tipo di servizio. Per impostazione predefinita la mappa è vuota. |
| failure-action | I valori consentiti sono Rollback, Manual, e Invalid. L'azione di compensazione da eseguire quando un aggiornamento di monitoraggio rileva violazioni dei criteri di integrità o dei criteri di monitoraggio. Rollback specifica che l'aggiornamento eseguirà il rollback automaticamente alla versione precedente. Manual indica che l'aggiornamento passerà alla modalità di aggiornamento UnmonitoredManual. Invalid indica che l'azione di errore non è valida. |
| force-restart | Se si aggiorna un pacchetto di configurazione o di dati senza aggiornare il codice del servizio, il servizio viene riavviato solo se la proprietà ForceRestart è impostata su True. Quando l'aggiornamento è completo, Service Fabric notifica al servizio che è disponibile un nuovo pacchetto di configurazione o di dati. Il servizio è responsabile dell'applicazione delle modifiche. Se necessario, il servizio può riavviarsi. |
| health-check-retry-timeout | Tempo disponibile per ripetere la valutazione di integrità se l'applicazione o il cluster non è integro, prima dell'esecuzione di FailureAction. Viene prima interpretato come stringa che rappresenta una durata ISO 8601. Se l'esito è negativo, viene interpretato come numero che rappresenta il numero totale di millisecondi. Valore predefinito: PT0H10M0S. |
| health-check-stable-duration | Tempo di attesa per cui l'applicazione o il cluster devono rimanere integri prima di passare al dominio di aggiornamento successivo. Viene prima interpretato come stringa che rappresenta una durata ISO 8601. Se l'esito è negativo, viene interpretato come numero che rappresenta il numero totale di millisecondi. Valore predefinito: PT0H2M0S. |
| health-check-wait-duration | Tempo di attesa dopo il completamento di un dominio di aggiornamento prima di applicare i criteri di integrità. Viene prima interpretato come stringa che rappresenta una durata ISO 8601. Se l'esito è negativo, viene interpretato come numero che rappresenta il numero totale di millisecondi. Predefinito: 0. |
| max-unhealthy-apps | Il valore predefinito e consigliato è 0. Specificare il numero massimo di applicazioni distribuite (vedere la sezione relativa all'integrità) che possono essere non integre prima che l'applicazione venga considerata non integra e l'aggiornamento non riesca. Questo parametro definisce l'integrità dell'applicazione sul nodo e consente di rilevare eventuali problemi durante l'aggiornamento. Normalmente alle repliche dell'applicazione viene applicato un bilanciamento del carico basato sull'altro nodo, in modo che l'applicazione risulti integra e l'aggiornamento possa continuare. Specificando uno stato di integrità max-unhealthy-apps rigoroso, Service Fabric può rilevare rapidamente un problema del pacchetto dell'applicazione e generare quindi un aggiornamento di mancata riuscita e risposta immediata agli errori. Rappresentato come un numero compreso tra 0 e 100. |
| mode | I valori consentiti sono Monitored, UpgradeMode, UnmonitoredAuto, UnmonitoredManual. Il valore predefinito è UnmonitoredAuto. Vedere la sezione Parametri obbligatori di Visual Studio e PowerShell per la descrizione di questi valori. |
| replica-set-check-timeout | Il valore è espresso in secondi. Servizio senza stato: in un singolo dominio di aggiornamento Service Fabric prova a verificare che siano disponibili istanze aggiuntive del servizio. Se il numero di istanze di destinazione è maggiore di uno, Service Fabric attende che sia disponibile più di un'istanza fino al valore di timeout massimo. Questo timeout viene specificato tramite la proprietà replica-set-check-timeout. Se il timeout scade, Service Fabric procede con l'aggiornamento indipendentemente dal numero di istanze del servizio. Se il numero di istanze di destinazione è pari a uno, Service Fabric non attende e procede immediatamente con l'aggiornamento. Servizio con stato: in un singolo dominio di aggiornamento Service Fabric prova a verificare che il set di repliche abbia un quorum. Service Fabric attende la disponibilità un quorum fino al valore di timeout massimo, specificato dalla proprietà replica-set-check-timeout. Se il timeout scade, Service Fabric procede con l'aggiornamento indipendentemente dal quorum. Il valore di questa impostazione è never (infinito) per il roll forward e 1200 secondi per il rollback. |
| service-health-policy | Mappa con codifica JSON con criteri di integrità del tipo di servizio per ogni nome di tipo di servizio. Per impostazione predefinita la mappa è vuota. Formato JSON dei parametri. Il codice JSON per la parte relativa al valore contiene MaxPercentUnhealthyServices, MaxPercentUnhealthyPartitionsPerService e MaxPercentUnhealthyReplicasPerPartition. Vedere la sezione Parametri facoltativi di Visual Studio e PowerShell per la descrizione di questi parametri. |
| timeout | Specifica il periodo di timeout in secondi per l'operazione. Predefinito: 60. |
| upgrade-domain-timeout | Tempo disponibile per il completamento di ogni dominio di aggiornamento prima dell'esecuzione di FailureAction. Viene prima interpretato come stringa che rappresenta una durata ISO 8601. Se l'esito è negativo, viene interpretato come numero che rappresenta il numero totale di millisecondi. Il valore predefinito è mai (Infinito) ed è consigliabile personalizzarlo in base all'applicazione. Impostazione predefinita: P10675199DT02H48M05.4775807S. |
| upgrade-timeout | Tempo disponibile per il completamento di ogni dominio di aggiornamento prima dell'esecuzione di FailureAction. Viene prima interpretato come stringa che rappresenta una durata ISO 8601. Se l'esito è negativo, viene interpretato come numero che rappresenta il numero totale di millisecondi. Il valore predefinito è mai (Infinito) ed è consigliabile personalizzarlo in base all'applicazione. Impostazione predefinita: P10675199DT02H48M05.4775807S. |
| warning-as-error | I valori consentiti sono true e false. Il valore predefinito è False. Può essere passato come flag. Considerare gli eventi di avviso relativi all'integrità dell'applicazione come errori quando si valuta l'integrità dell'applicazione durante l'aggiornamento. Per impostazione predefinita, Service Fabric non valuta eventi di avviso relativi all'integrità come errori, quindi l'aggiornamento può continuare anche se vengono generati questi eventi. |
Passaggi successivi
Esercitazione sull'aggiornamento di un'applicazione di Service Fabric tramite Visual Studio descrive la procedura di aggiornamento di un'applicazione con Visual Studio.
Aggiornamento di un'applicazione mediante PowerShell descrive la procedura di aggiornamento di un'applicazione tramite PowerShell.
Aggiornamento dell'applicazione descrive la procedura di aggiornamento di un'applicazione con l'interfaccia della riga di comando di Service Fabric.
Aggiornamento dell'applicazione con il plug-in Eclipse per Service Fabric
Rendere compatibili gli aggiornamenti dell'applicazione imparando a usare Serializzazione dei dati.
Informazioni su come usare funzionalità avanzate durante l'aggiornamento dell'applicazione facendo riferimento ad Argomenti avanzati.
Risolvere problemi comuni negli aggiornamenti dell'applicazione facendo riferimento ai passaggi elencati in Risoluzione dei problemi relativi agli aggiornamenti dell'applicazione .