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 graduale. 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 per l'istanza in modo che riceva gli aggiornamenti in precedenza o in un secondo momento rispetto a quello in genere durante un'implementazione degli aggiornamenti. È anche possibile configurare una finestra di manutenzione durante il giorno quando si desidera che l'istanza riceva gli aggiornamenti.

Aggiornare un gruppo

Un gruppo di aggiornamento (detto anche canale di versione) è un 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.

Aggiornare un gruppo	Description
IA Gateway Early (Canale di rilascio GenAI)	Ottiene l'accesso anticipato alle funzionalità e agli aggiornamenti più recenti del gateway di intelligenza artificiale prima di raggiungere altri gruppi di aggiornamento. Combina gli aggiornamenti del servizio mainline più stabili con le funzionalità più recenti specifiche dell'intelligenza artificiale. Riceve altri aggiornamenti del servizio come parte del gruppo di aggiornamento tardivo , consentendo una distribuzione più rapida delle funzionalità correlate all'intelligenza artificiale.
In anticipo	Riceve gli aggiornamenti all'inizio dell'implementazione, per il test e l'accesso anticipato alle nuove funzionalità. Questa opzione non è consigliata per le distribuzioni di produzione.
Predefinita	Riceve gli aggiornamenti come parte del ciclo di distribuzione regolare. Questa opzione è consigliata per la maggior parte dei servizi, incluse le distribuzioni di produzione.
In ritardo	Riceve 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.

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.
• Tutti i gruppi di aggiornamento possono includere funzionalità in anteprima. Le funzionalità di anteprima sono chiaramente indicate nel portale di Azure e nella documentazione.
• Le funzionalità vengono propagate tramite gruppi di aggiornamento in questa sequenza: AI Gateway Early (solo funzionalità di intelligenza artificiale) → Early → Default → Late.

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

Una finestra di manutenzione è un periodo giornaliero di 8 ore quando si desidera 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 al giorno.

Sapere quando le istanze ricevono gli aggiornamenti

Ecco come è possibile ottenere informazioni sugli 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.

• Usare il Registro attività di Azure per monitorare gli aggiornamenti del servizio che avvengono nell'istanza di Gestione API. 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.

Suggerimento

Se l'istanza di Gestione API viene distribuita in più posizioni (aree), la tempistica degli aggiornamenti viene determinata dalla posizione primaria dell'istanza.

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.