Configurare l'aggiornamento di un'applicazione di Infrastruttura di servizi in Visual Studio

Articolo
06/01/2023

Gli strumenti di Visual Studio per Service Fabric di Azure forniscono supporto per l'aggiornamento per la pubblicazione nei cluster locali o remoti. Esistono tre scenari in cui è consigliabile eseguire l'aggiornamento dell'applicazione a una versione più recente anziché sostituirla durante il test e il debug:

I dati dell'applicazione non vengono persi durante l'aggiornamento.
Si garantisce una disponibilità elevata continua per evitare ogni tipo di interruzione del servizio durante l'aggiornamento in presenza di sufficienti istanze del servizio distribuite nei domini di aggiornamento.
Durante l'aggiornamento, possono essere eseguiti test in un'applicazione.

Parametri necessari per l'aggiornamento

È possibile scegliere tra due tipi di distribuzione: normale o aggiornata. Una distribuzione regolare cancella qualsiasi informazione di distribuzioni precedenti e i dati nel cluster, mentre una distribuzione di un aggiornamento li conserva. Quando si aggiorna un'applicazione di Infrastruttura di servizi in Visual Studio, è necessario fornire parametri di aggiornamento dell’applicazione e criteri per il controllo dell’integrità. I parametri di aggiornamento dell'applicazione consentono di controllare l'aggiornamento, mentre i criteri di controllo dell'integrità determinano se l'aggiornamento è avvenuto correttamente. Vedere l'articolo relativo all' aggiornamento di un'applicazione di Service Fabric e i parametri di aggiornamento per ulteriori dettagli.

Sono disponibili tre modalità di aggiornamento: Monitored, UnmonitoredAuto e UnmonitoredManual.

Un aggiornamento Monitored consente di automatizzare l'aggiornamento e il controllo dell'integrità dell'applicazione.
Un aggiornamento UnmonitoredAuto consente di automatizzare l'aggiornamento, ma ignorando il controllo dell'integrità dell'applicazione.
Quando si esegue un aggiornamento UnmonitoredManual è necessario aggiornare manualmente ogni dominio di aggiornamento.

Ogni modalità di aggiornamento richiede diversi set di parametri. Vedere Parametri di aggiornamento di un'applicazione per conoscere le opzioni di aggiornamento disponibili.

Aggiornamento di un'applicazione di Infrastruttura di servizi in Visual Studio

Se si utilizzano gli strumenti di Service Fabric di Visual Studio per aggiornare un'applicazione di Service Fabric, è possibile specificare un processo di pubblicazione come aggiornamento anziché distribuzione normale selezionando la casella di controllo Aggiorna applicazione .

Per configurare i parametri di aggiornamento

Fare clic sul pulsante Impostazioni accanto alla casella di controllo. La finestra di dialogo Edit Upgrade Parameters verrà visualizzata. La finestra di dialogo Edit Upgrade Parameters supporta le modalità di aggiornamento Monitored, UnmonitoredAuto e UnmonitoredManual.
Selezionare la modalità di aggiornamento che si desidera usare, quindi compilare la griglia dei parametri.

Ogni parametro ha valori predefiniti. Il parametro facoltativo DefaultServiceTypeHealthPolicy accetta un input di tabella hash. Di seguito è riportato un esempio del formato di input di tabella hash per DefaultServiceTypeHealthPolicy:
```
@{ ConsiderWarningAsError = "false"; MaxPercentUnhealthyDeployedApplications = 0; MaxPercentUnhealthyServices = 0; MaxPercentUnhealthyPartitionsPerService = 0; MaxPercentUnhealthyReplicasPerPartition = 0 }
```
ServiceTypeHealthPolicyMap è un altro parametro facoltativo che accetta un input di tabella hash nel formato seguente:
```
@ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}
```
Ecco un esempio reale:
```
@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }
```
Se si seleziona la modalità di aggiornamento UnmonitoredManual, è necessario avviare manualmente una console di PowerShell per continuare il processo di aggiornamento e completarlo. Fare riferimento a Aggiornamento di un'applicazione di infrastruttura di servizi: argomenti avanzati per scoprire come funziona l'aggiornamento manuale.

Aggiornare un'applicazione con PowerShell

È possibile utilizzare i cmdlet PowerShell per aggiornare un'applicazione di Infrastruttura di servizi. Per informazioni dettagliate, vedere Esercitazione sull'aggiornamento di un'applicazione di Service Fabric tramite Visual Studio e Start-ServiceFabricApplicationUpgrade.

Specificare un criterio di controllo dell'integrità nel file manifesto dell'applicazione

Ogni servizio in un'applicazione di Infrastruttura di servizi può disporre di propri parametri di criteri di integrità che sostituiscono i valori predefiniti. È possibile fornire questi valori di parametro nel file manifesto dell'applicazione.

Nell'esempio seguente viene illustrato come applicare un criterio di controllo di integrità univoco per ogni servizio nel manifesto dell'applicazione.

<Policies>
    <HealthPolicy ConsiderWarningAsError="false" MaxPercentUnhealthyDeployedApplications="20">
        <DefaultServiceTypeHealthPolicy MaxPercentUnhealthyServices="20"               
                MaxPercentUnhealthyPartitionsPerService="20"
                MaxPercentUnhealthyReplicasPerPartition="20" />
        <ServiceTypeHealthPolicy ServiceTypeName="ServiceTypeName1"
                MaxPercentUnhealthyServices="20"
                MaxPercentUnhealthyPartitionsPerService="20"
                MaxPercentUnhealthyReplicasPerPartition="20" />      
    </HealthPolicy>
</Policies>

Passaggi successivi

Per altre informazioni sull'aggiornamento di un'applicazione, vedere l'argomento su come aggiornare un'applicazione con Visual Studio.

Condividi tramite