Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’APPLIQUE À : Essentiel | Standard | Premium
Cet article explique comment configurer les paramètres de mise à jour de service (préversion) dans votre instance Gestion des API. Azure applique régulièrement les mises à jour de service automatiquement aux instances gestion des API à l’aide d’une approche de déploiement par phases. Ces mises à jour incluent de nouvelles fonctionnalités, des améliorations de sécurité et des améliorations de fiabilité.
Vous ne pouvez pas contrôler exactement quand Azure met à jour chaque instance gestion des API, mais dans certains niveaux de service, vous pouvez choisir un groupe de mises à jour pour votre instance afin qu’elle reçoive des mises à jour antérieures ou ultérieures qu’elle ne le ferait généralement lors d’un déploiement de mise à jour. Vous pouvez également configurer une fenêtre de maintenance pendant la journée lorsque vous souhaitez que votre instance reçoive des mises à jour.
Mettre à jour un groupe
Un groupe de mises à jour (également appelé canal de mise en production) est un ensemble d’instances qui reçoivent les mises à jour du service Gestion des API pendant un déploiement de production, ce qui peut prendre plusieurs jours à plusieurs semaines.
| Mettre à jour un groupe | Descriptif |
|---|---|
| AI Gateway Early (canal de diffusion GenAI) | Obtient un accès anticipé aux dernières fonctionnalités et mises à jour de la passerelle IA avant d’atteindre d’autres groupes de mises à jour. Combine les mises à jour de service mainline les plus stables avec les fonctionnalités les plus récentes spécifiques à l’IA. Reçoit d’autres mises à jour de service dans le cadre du groupe de mises à jour tardives , ce qui permet un déploiement plus rapide des fonctionnalités liées à l’IA. |
| Précoce | Reçoit les mises à jour dès le lancement, pour le test et l’accès anticipé aux nouvelles fonctionnalités. Cette option n’est pas recommandée pour les déploiements de production. |
| Par défaut | Reçoit les mises à jour dans le cadre du déploiement de la version régulière. Cette option est recommandée pour la plupart des services, y compris les déploiements de production. |
| Tard | Reçoit les mises à jour ultérieures aux groupes précédents, généralement semaines après le lancement initial. Cette option est recommandée uniquement pour les déploiements stratégiques. |
Remarque
- Azure déploie toutes les mises à jour à l’aide d’une infrastructure de pratiques de déploiement sécurisées (SDP). Les mises à jour publiées tôt dans un déploiement peuvent être moins stables et remplacées ultérieurement par des versions stables. Toutes les instances sont finalement mises à jour vers les builds de version les plus stables.
- Tous les groupes de mises à jour peuvent inclure des fonctionnalités en préversion. Les fonctionnalités en préversion sont clairement notées dans le portail Azure et la documentation.
- Les fonctionnalités se propagent à travers les groupes de mises à jour dans cette séquence : AI Gateway Early (uniquement fonctionnalités IA) → Précoce → Par défaut → Tardif.
Par exemple, vous pouvez ajouter une instance de test au groupe de mises à jour anticipées . Cette instance reçoit les mises à jour avant vos instances de production, que vous avez placées dans le groupe de mises à jour par défaut ou tardive . Vous pouvez surveiller l’instance de test pour tous les problèmes causés par les mises à jour avant qu’elles atteignent vos instances de production. En savoir plus sur les déploiements canary avec Gestion des API
Fenêtre de maintenance
Une fenêtre de maintenance est une période quotidienne de 8 heures lorsque vous souhaitez que votre instance reçoive des mises à jour. Par défaut, la fenêtre de maintenance est de 10 h à 6 h dans le fuseau horaire de l’instance.
Les interruptions de service sont rares lors d’une mise à jour, mais vous pouvez réduire les risques en sélectionnant des heures d’utilisation faible du service. Par exemple, pour les instances de production, définissez une fenêtre de maintenance pendant les soirées de la semaine et les matins du week-end.
Configurer les paramètres de mise à jour de service
- Connectez-vous au portail Azure et accédez à votre instance Gestion des API.
- Dans le menu de gauche, sélectionnez Déploiement + infrastructure>Paramètres de mise à jour du service.
- Sous Groupe De mise à jour, passez en revue le paramètre actuel et sélectionnez Modifier pour le modifier.
- Dans la fenêtre Maintenance, passez en revue les paramètres actuels et sélectionnez Modifier pour les modifier. Pour chaque jour, vous pouvez sélectionner la fenêtre par défaut, une autre fenêtre standard ou une fenêtre personnalisée par jour.
Savoir quand vos instances reçoivent des mises à jour
Voici comment vous pouvez en savoir plus sur les mises à jour de service attendues ou en cours.
Les mises à jour de Gestion des API sont annoncées sur le référentiel GitHub Gestion des API. S’abonner pour recevoir des notifications de ce référentiel pour savoir quand les déploiements de mises à jour commencent.
Utilisez le journal d’activité Azure pour surveiller les mises à jour de service qui se produisent dans votre instance Gestion des API. L’événement « Maintenance planifiée » est émis lorsqu’une mise à jour commence.
Pour recevoir automatiquement des notifications, configurez une alerte sur le journal d’activité.
Par défaut, les mises à jour sont déployées dans les régions selon les phases suivantes : les régions Azure EUAP, suivies du Centre-Ouest des États-Unis, puis des autres régions dans plusieurs phases ultérieures. L’ordre des régions mises à jour au cours des phases de déploiement ultérieures diffère d’un service à l’autre. Vous pouvez attendre au moins 24 heures entre chaque phase du déploiement en production.
Dans une région, les instances Gestion des API du niveau Premium reçoivent des mises à jour plusieurs heures après celles d’autres niveaux de service.
Conseil / Astuce
Si votre instance Gestion des API est déployée sur plusieurs emplacements (régions), le timing des mises à jour est déterminé par l’emplacement Principal de l’instance.
Stratégies de déploiement de contrôle de validité
Vous pouvez utiliser une instance Gestion des API affectée à un groupe de mises à jour spécifique (si cette option est disponible) ou déployée dans une région Azure spécifique en tant que déploiement canary qui reçoit des mises à jour antérieures à vos instances de production.
Ajouter une instance au groupe de mises à jour anticipées : utilisez une instance Gestion des API dans le groupe de mises à jour anticipées pour valider les mises à jour au début d’un déploiement de production. Cette instance est en fait votre déploiement Canary.
Déployer dans la région canary : si vous avez accès à une région Azure EUAP, utilisez une instance là-bas pour valider les mises à jour dès qu’elles sont publiées dans le pipeline de production. En savoir plus sur le processus de demande d’accès aux régions Azure.
Remarque
En raison des contraintes de capacité dans les régions EUAP, il se peut que vous ne puissiez pas mettre à l’échelle les instances Gestion des API conformément à vos besoins.
Déployer dans une région pilote : utilisez une instance dans le centre-ouest des États-Unis pour simuler votre environnement de production, ou utilisez-la en production pour le trafic API non critique. Bien que cette région reçoive les mises à jour après les régions EUAP, un déploiement à cet emplacement est plus susceptible d’identifier les régressions spécifiques à la configuration de votre service.
Déployer des instances en double dans une région - Si votre charge de travail de production est une instance de niveau Premium dans une région spécifique, envisagez de déployer une instance configurée de manière similaire dans un niveau inférieur qui reçoit les mises à jour plus tôt. Par exemple, configurez une instance de préproduction dans le niveau Développeur pour valider les mises à jour.
Contenu connexe
- Découvrez comment surveiller votre instance Gestion des API.
- Découvrez les autres options disponibles pour observer votre instance Gestion des API.