Configurare le impostazioni di aggiornamento del servizio per le istanze di Gestione API

SI APPLICA A: Basic | Standard | Premium

Questo articolo illustra come configurare le impostazioni di aggiornamento del servizio (anteprima) nell'istanza di Gestione API. Azure applica periodicamente gli aggiornamenti del servizio alle istanze di Gestione API, usando un approccio di implementazione in più fasi. Questi aggiornamenti includono nuove funzionalità, miglioramenti della sicurezza e miglioramenti dell'affidabilità.

Non è possibile controllare esattamente quando Azure aggiorna ogni istanza di Gestione API, ma in selezionare i livelli di servizio è possibile scegliere un gruppo di aggiornamento (detto anche canale di versione) per l'istanza in modo che riceva gli aggiornamenti in precedenza o versioni successive rispetto a quanto in genere sarebbe durante un'implementazione degli aggiornamenti. È anche possibile configurare una finestra di manutenzione durante il giorno quando si desidera che l'istanza riceva gli aggiornamenti.

• Gruppo di aggiornamento : set di istanze che ricevono gli aggiornamenti del servizio Gestione API durante un'implementazione di produzione, che può richiedere da diversi giorni a diverse settimane per il completamento.

  Scegliere tra:

  • Early - Ricevi aggiornamenti anticipati nel rollout, per testare e avere accesso anticipato alle nuove funzionalità. Questa opzione non è consigliata per le distribuzioni di produzione.
  • Impostazione predefinita - ricevere gli aggiornamenti come parte del normale rilascio delle versioni. Questa opzione è consigliata per la maggior parte dei servizi, incluse le distribuzioni di produzione.
  • Ritardo : ricevere gli aggiornamenti in un secondo momento rispetto ai gruppi precedenti, in genere settimane dopo l'implementazione iniziale. Questa opzione è consigliata solo per le distribuzioni cruciali.
  • Ai Gateway Early (Canale di rilascio GenAI): ottenere l'accesso anticipato alle funzionalità e agli aggiornamenti più recenti del gateway di intelligenza artificiale prima di raggiungere altri gruppi di aggiornamento. Ricevi altri aggiornamenti del servizio come parte del gruppo di distribuzione ritardato.

  Annotazioni

  Azure distribuisce tutti gli aggiornamenti usando un framework SDP (Safe Deployment Practices). Gli aggiornamenti rilasciati all'inizio di un'implementazione potrebbero essere meno stabili e sostituiti in seguito da versioni stabili. Tutte le istanze vengono infine aggiornate alle build di versione più stabili.

  Ad esempio, è possibile aggiungere un'istanza di test al gruppo di aggiornamento anticipato . Questa istanza riceve gli aggiornamenti prima delle istanze di produzione, che hai inserito nel gruppo di aggiornamento predefinito o nel gruppo di aggiornamento tardivo. È possibile monitorare l'istanza di test per eventuali problemi causati dagli aggiornamenti prima che raggiungano le istanze di produzione. Scopri di più sulle distribuzioni di tipo canary con Gestione API

• Finestra di manutenzione : periodo giornaliero di 8 ore quando si vuole che l'istanza riceva gli aggiornamenti. Per impostazione predefinita, la finestra di manutenzione è dalle 10 alle 18:00 nel fuso orario dell'istanza.

  Le interruzioni del servizio sono rare durante un aggiornamento, ma è consigliabile ridurre i rischi selezionando i tempi di utilizzo ridotto del servizio. Ad esempio, per le istanze di produzione, impostare una finestra di manutenzione durante la sera della settimana e le mattine del fine settimana.

Configurare le impostazioni di aggiornamento del servizio

1. Accedere al portale di Azure e passare all'istanza di Gestione API.
2. Nel menu a sinistra selezionare Distribuzione e infrastruttura> Impostazionidi aggiornamento del servizio.
3. In Gruppo di aggiornamento esaminare l'impostazione corrente e selezionare Modifica per modificarla.
4. Nella finestra Manutenzione esaminare le impostazioni correnti e selezionare Modifica per modificarle. Per ogni giorno è possibile selezionare la finestra predefinita, una finestra standard diversa o una finestra personalizzata per giorno.

Scopri quando le tue istanze ricevono aggiornamenti

Ecco come conoscere gli aggiornamenti del servizio previsti o in corso.

• Gli aggiornamenti di Gestione API vengono annunciati nel repository GitHub di Gestione API. Sottoscrivere per ricevere notifiche da questo repository per sapere quando iniziano le implementazioni degli aggiornamenti.

• Monitorare gli aggiornamenti del servizio che si verificano nell'istanza di Gestione API usando il log attività di Azure. L'evento "Manutenzione pianificata" viene generato all'inizio di un aggiornamento.

  

  Per ricevere automaticamente le notifiche, configurare un avviso nel log attività.

• Per impostazione predefinita, gli aggiornamenti vengono eseguiti nelle aree nelle fasi seguenti: Aree EUAP di Azure, seguite da Stati Uniti centro-occidentali, seguite dalle aree rimanenti in diverse fasi successive. La sequenza di aree aggiornate nelle fasi di distribuzione successive differisce dal servizio al servizio. È possibile prevedere almeno 24 ore tra ogni fase dell'implementazione di produzione.

• All'interno di un'area, le istanze di Gestione API nel livello Premium ricevono gli aggiornamenti diverse ore dopo quelli in altri livelli di servizio.

Strategie di distribuzione "Canary"

È possibile usare un'istanza di Gestione API assegnata a un gruppo di aggiornamento specifico (se tale opzione è disponibile) o distribuita in un'area di Azure specifica come distribuzione canary che riceve aggiornamenti precedenti alle istanze di produzione.

• Aggiungere un'istanza al gruppo di aggiornamento anticipato : usare un'istanza di Gestione API nel gruppo di aggiornamento anticipato per convalidare gli aggiornamenti nelle fasi iniziali di un'implementazione di produzione. Questa istanza funge effettivamente da distribuzione canary.

• Distribuire nell'area canary : se si ha accesso a un'area EUAP di Azure, usare un'istanza per convalidare gli aggiornamenti non appena vengono rilasciati alla pipeline di produzione. Informazioni sul processo di richiesta di accesso all'area di Azure.

  Annotazioni

  A causa dei vincoli di capacità nelle aree EUAP, potrebbe non essere possibile ridimensionare le istanze di Gestione API in base alle esigenze.

• Distribuire nell'area pilota : usare un'istanza negli Stati Uniti centro-occidentali per simulare l'ambiente di produzione o usarla nell'ambiente di produzione per il traffico api non critico. Anche se questa area riceve gli aggiornamenti dopo le aree EUAP, è più probabile che una distribuzione identifichi regressioni specifiche della configurazione del servizio.

• Distribuire istanze duplicate in un'area : se il carico di lavoro di produzione è un'istanza di livello Premium in un'area specifica, valutare la possibilità di distribuire un'istanza configurata in modo analogo in un livello inferiore che riceve gli aggiornamenti in precedenza. Ad esempio, configurare un'istanza di preproduzione nel livello Developer per convalidare gli aggiornamenti.

Contenuti correlati

• Informazioni su come monitorare l'istanza di Gestione API.
• Scopri altre opzioni per osservare l'istanza di Gestione API.