Swap degli slot di distribuzione

  • 6 minuti

È possibile scambiare gli slot di distribuzione nella relativa pagina dell'app e nella pagina Panoramica. Prima di scambiare un'app da uno slot di distribuzione nell'ambiente di produzione, assicurarsi che l'ambiente di produzione sia lo slot di destinazione e che tutte le impostazioni nello slot di origine siano configurate esattamente come si vogliono avere nell'ambiente di produzione.

Scambiare manualmente gli slot di distribuzione

Per scambiare gli slot di distribuzione:

  1. Passare alla pagina Slot di distribuzione dell'app e selezionare Scambia. La finestra di dialogo Scambia mostra le impostazioni negli slot di origine e di destinazione selezionati che verranno modificate.

  2. Selezionare gli slot desiderati in Origine e Destinazione. In genere lo slot di destinazione è lo slot di produzione. Selezionare anche le schede Modifiche dell'origine e Modifiche della destinazione e verificare che le modifiche di configurazione siano quelle previste. Al termine è possibile scambiare gli slot immediatamente selezionando Scambia.

    Per verificare il funzionamento dello slot di destinazione con le nuove impostazioni prima di eseguire effettivamente lo scambio, invece di selezionare Scambia seguire le istruzioni in Scambio con anteprima.

  3. Una volta completate queste operazioni, chiudere la finestra di dialogo selezionando Chiudi.

Scambio con anteprima (scambio in più fasi)

Prima di passare all'ambiente di produzione come slot di destinazione, verificare che l'app venga eseguita con le impostazioni scambiate. Anche lo slot di origine viene riscaldato prima del completamento dello scambio, operazione consigliabile per le applicazioni cruciali.

Quando si esegue uno scambio con anteprima, il Servizio app di Azure esegue la stessa operazione di scambio, ma viene sospesa dopo il primo passaggio. Questo consente di verificare il risultato nello slot di staging prima di completare lo scambio.

Se si annulla lo scambio, il servizio app riapplica gli elementi di configurazione allo slot di origine.

Per eseguire lo scambio con anteprima:

  1. Seguire i passaggi precedenti in Scambia slot di distribuzione, ma selezionare la casella di controllo Esegui scambio con anteprima. La finestra di dialogo illustra come cambia la configurazione nello slot di origine nella fase 1 e come cambiano gli slot di origine e di destinazione nella fase 2.

  2. Quando si è pronti per avviare lo scambio, selezionare Avvia scambio.

    Al termine della fase 1, viene visualizzata una notifica nella finestra di dialogo. Visualizzare in anteprima lo scambio nello slot di origine passando a https://<app_name>-<source-slot-name>.azurewebsites.net.

  3. Quando si è pronti per completare lo scambio in sospeso, selezionare Completa scambio in Azione di scambio e selezionare Completa scambio.

    Per annullare uno scambio in sospeso, selezionare Annulla scambio.

  4. Una volta completate queste operazioni, chiudere la finestra di dialogo selezionando Chiudi.

Configurare lo scambio automatico

Lo scambio automatico semplifica gli scenari di Azure DevOps Services nei quali si vuole distribuire l'app in modo continuativo senza avvio a freddo e senza tempi di inattività per i clienti dell'app. Con lo scambio automatico di uno slot in produzione ogni volta che si esegue il push delle modifiche di codice in tale slot, il Servizio app scambia automaticamente l'app in produzione dopo il riscaldamento nello slot di origine.

Nota

Lo scambio automatico non è attualmente supportato nelle app Web in Linux e App Web per contenitori.

Per configurare lo scambio automatico:

  1. Passare alla pagina delle risorse dell'app e selezionare lo slot di distribuzione da configurare per lo scambio automatico. L'impostazione si trova nella pagina Configurazione > Impostazioni generali.

  2. Impostare Scambio automatico abilitato su Attiva. Selezionare quindi lo slot di destinazione desiderato per Scambio automatico slot di distribuzione e selezionare Salva sulla barra dei comandi.

  3. Eseguire un push del codice allo slot di origine. Lo scambio automatico viene eseguito dopo pochi minuti e l'aggiornamento si riflette nell'URL dello slot di destinazione.

Specificare il riscaldamento personalizzato

Alcune app potrebbero richiedere azioni preliminari personalizzate prima dello scambio. L'elemento di configurazione applicationInitialization in web.config consente di specificare le azioni di inizializzazione personalizzate. L'operazione di scambio attende il completamento del riscaldamento personalizzato prima dello scambio con lo slot di destinazione. Di seguito è riportato un frammento di web.config di esempio.

<system.webServer>
    <applicationInitialization>
        <add initializationPage="/" hostName="[app hostname]" />
        <add initializationPage="/Home/About" hostName="[app hostname]" />
    </applicationInitialization>
</system.webServer>

Per altre informazioni sulla personalizzazione dell'elemento applicationInitialization, vedere Errori di scambio di slot di distribuzione più comuni e come risolverli.

È anche possibile personalizzare il comportamento preliminare con una o entrambe le impostazioni dell'app seguenti:

  • WEBSITE_SWAP_WARMUP_PING_PATH: percorso di cui effettuare il ping per preparare il sito allo scambio. Aggiungere questa impostazione dell'app specificando un percorso personalizzato che inizi con una barra come valore. Un esempio è /statuscheck. Il valore predefinito è /.
  • WEBSITE_SWAP_WARMUP_PING_STATUSES: codici di risposta HTTP validi per l'operazione di preparazione. Aggiungere questa impostazione dell'app con un elenco di codici HTTP separati da virgole. Un esempio è 200,202. Se il codice di stato restituito non è presente nell'elenco, l'operazione preliminare di preparazione e l'operazione di scambio vengono arrestate. Per impostazione predefinita, sono validi tutti i codici di risposta.
  • WEBSITE_WARMUP_PATH: percorso relativo nel sito di cui deve essere eseguito il ping ogni volta che il sito viene riavviato (non solo durante gli scambi di slot). I valori di esempio includono /statuscheck o il percorso radice, /.

Eseguire il rollback e monitorare uno scambio

Se si verificano errori nello slot di destinazione (ad esempio, lo slot di produzione) dopo uno scambio di slot, ripristinare gli slot allo stato precedente scambiandoli immediatamente.

Se l'operazione di scambio richiede molto tempo per il completamento, è possibile ottenere informazioni sull'operazione di scambio nel log attività.

  1. Nella pagina delle risorse dell'app nel portale selezionare Log attività nel riquadro a sinistra.

  2. Un'operazione di scambio è riportata nella query di log come Swap Web App Slots. È possibile espandere la voce e selezionare una sotto-operazione o un errore per visualizzare i dettagli.