Cette page s'applique à Apigee, mais pas à Apigee hybrid.
Consultez
la documentation d'Apigee Edge.
Cette section présente la maintenance d'Apigee.
Pour obtenir des instructions sur la planification des intervalles de maintenance, consultez Gérer les intervalles de maintenance des instances Apigee.
Présentation
Apigee effectue régulièrement des mises à jour pour s'assurer que le service est fiable, performant, sécurisé et à jour. La plupart de ces mises à jour sont effectuées sans impact notable. Ces mises à jour sont appelées "maintenance".
La maintenance se divise généralement en plusieurs catégories :
- Fonctionnalités Apigee : pour lancer certaines fonctionnalités, Apigee nécessite une mise à jour de maintenance.
- Amélioration des performances : offre les meilleures performances et la meilleure fiabilité possibles.
- Correctifs et mises à jour de sécurité : nous surveillons en permanence les nouvelles failles de sécurité identifiées dans notre pile logicielle. Une fois qu'elles sont détectées, nous corrigeons le système pour vous protéger des nouveaux risques.
Impact de la maintenance
En règle générale, la maintenance d'Apigee est entièrement transparente. Toutefois, pendant la maintenance d'Apigee, vous ne pourrez pas effectuer certaines activités, telles que :
- Créer des instances
- Associer un environnement à une instance
- Créer un rattachement de point de terminaison
- Certaines activités de scaling
Paramètres de maintenance
Apigee vous permet de configurer la maintenance pour qu'elle ait lieu au moment le plus opportun pour votre application. Pour ce faire, configurez des intervalles de maintenance.
Vous pouvez configurer les options suivantes pour les instances Apigee :
- Intervalle de maintenance : jour de la semaine et heure auxquels Apigee planifie le début de la maintenance.
- Ordre des mises à jour : définit l'ordre dans lequel les instances sont mises à jour par rapport aux autres instances de la même région. L'ordre des mises à jour peut être défini sur "Semaine 1" ou "Semaine 2". Les instances de la semaine 2 sont mises à jour une semaine après les instances de la semaine 1 avec le même intervalle de maintenance dans la même région. Vous définissez l'ordre des mises à jour lorsque vous configurez un intervalle de maintenance.
Remarque : "Semaine 1" et "Semaine 2" font référence aux phases de déploiement et aux délais de notification (une semaine contre deux semaines). Elles ne font pas référence à la première ou à la deuxième semaine civile du mois. Par exemple, un déploiement de la "Semaine 2" ne se produit pas nécessairement au cours de la deuxième semaine d'un mois civil. Il a lieu une semaine après le déploiement de la "Semaine 1" pour cette version spécifique.
Apigee planifie le début de la maintenance à l'heure de début spécifiée que vous avez configurée. En raison des différentes configurations client, Apigee ne peut pas estimer précisément la durée de la maintenance. Toutefois, elle dure généralement plusieurs heures.
Si un intervalle de maintenance est configuré pour une ressource, la future maintenance automatique est planifiée pour respecter ces préférences. Si aucun intervalle de maintenance n'est spécifié pour votre ressource, la maintenance peut commencer à tout moment.
Apigee s'efforcera de respecter les intervalles de maintenance. Toutefois, pour maintenir la compatibilité et la sécurité de notre parc, nous devrons parfois mettre à jour votre instance en dehors de vos heures préférées.
Fréquence et stabilité du déploiement
Apigee ne déploie pas toutes les versions de l'environnement d'exécution sur les instances avec des intervalles de maintenance. Les mises à jour sont généralement regroupées et déployées uniquement lorsqu'une version est jugée très stable sur l'ensemble du parc. Par conséquent, vos instances peuvent ignorer plusieurs numéros de version entre les mises à jour. Les nouveaux déploiements d'intervalles de maintenance sont annoncés dans les notes de version d'Apigee.
Intervalles de gel et d'exclusion
Apigee n'est actuellement pas compatible avec les intervalles de gel ou d'exclusion de maintenance définis par le client. Une fois qu'un déploiement est planifié, il se poursuit conformément à l'intervalle configuré et aux paramètres d'ordre des mises à jour. La modification ou l'effacement de vos paramètres de maintenance après la planification d'un événement de maintenance n'annule ni ne reporte l'événement planifié.
Bonnes pratiques concernant les intervalles de maintenance
Nous vous recommandons de définir des intervalles de maintenance sur vos instances de production, et de ne pas en définir sur vos instances hors production. En effet, voici l'ordre général des événements autour d'une mise à jour de maintenance :
- Tout d'abord, Apigee met à jour toutes vos instances qui ne disposent pas d'intervalles de maintenance.
- Ensuite, Apigee planifie les mises à jour pour toutes vos instances qui disposent d'intervalles de maintenance. Ces mises à jour ont un délai d'au moins une semaine (pour l'ordre de mise à jour de la semaine 1) ou deux semaines (pour l'ordre de mise à jour de la semaine 2).
- Si vous avez choisi de recevoir des communications sur les événements de maintenance Apigee à venir, Apigee vous envoie un e-mail de notification concernant la maintenance planifiée.
- Apigee effectue les mises à jour de maintenance aux heures planifiées.
Par conséquent, une notification de maintenance à venir signifie également que les mêmes mises à jour ont déjà été appliquées à toutes vos instances sans intervalle de maintenance défini. Si vous laissez vos instances hors production sans intervalles de maintenance, vous pouvez alors garantir qu'elles recevront les mises à jour du système en premier, et vous pouvez utiliser les notifications de maintenance à venir comme une invite à tester ou à prévisualiser les mises à jour dans un environnement hors production.
Exemple de maintenance
Supposons que vous travaillez pour un site marchand en tant que développeur responsable d'un service de panier d'achat, et que vous disposez d'une instance Apigee pour un environnement de production. Vous souhaitez que la maintenance commence au moment où votre instance gère la plus faible quantité de trafic, soit vers minuit le dimanche.
Dans ce cas, vous définissez les paramètres de maintenance de votre instance de production sur :
- Intervalle de maintenance : dimanche à partir de 00h00 UTC
- Ordre des mises à jour : semaine 2
Les paramètres de maintenance d'une instance dans votre environnement de préproduction sont similaires, à l'exception de l'ordre de mise à jour défini sur "Semaine 1". Enfin, aucune instance de votre environnement de développement ne dispose d'un intervalle de maintenance configuré. Cela vous permet de mettre en œuvre des tests de validation opérationnels sur la nouvelle version associée à la maintenance, dans votre environnement de développement et de préproduction, et au minimum sept jours avant son déploiement en production. Si un problème survient dans l'environnement de développement ou de préproduction, vous avez le temps de le diagnostiquer et de le résoudre afin que votre environnement de production ne soit pas affecté.
Notifications de maintenance à venir
Vous pouvez recevoir un e-mail de notification concernant la maintenance à venir au moins une semaine (pour la semaine 1) ou deux semaines (pour la semaine 2) avant le début de la maintenance planifiée. Si vous souhaitez définir un filtre de messagerie pour les notifications, le titre de l'e-mail est "Opérations de maintenance à venir pour votre ressource Apigee [nom-de-votre-ressource]".
Par défaut, les notifications de maintenance ne sont pas envoyées. Si vous souhaitez recevoir une notification pour une maintenance à venir, vous devez effectuer toutes les opérations suivantes :
- Définissez un intervalle de maintenance.
- Activez les notifications de maintenance.
- Effectuez ces deux opérations au moins sept jours (pour la semaine 1) ou 14 jours (pour la semaine 2) avant le début de l'événement de maintenance planifié. Sinon, vous ne vous êtes pas inscrit aux notifications suffisamment tôt pour que le système vous envoie une notification de maintenance à venir.
Les notifications par e-mail sont envoyées à l'adresse e-mail associée à votre compte Google. Il n'est pas possible de configurer un alias d'adresse e-mail personnalisé (par exemple, un alias d'adresse e-mail d'équipe), ni de s'abonner à une autre adresse e-mail que la vôtre.
Lorsque vous vous abonnez, vous activez les notifications de maintenance pour toutes les ressources Apigee qui disposent d'intervalles de maintenance dans un projet donné. Vous recevez une notification par ressource.
Questions fréquentes
Voici quelques questions fréquentes à propos de la règle de maintenance d'Apigee :
Quelles bonnes pratiques dois-je suivre pour mettre à jour la maintenance planifiée de manière fluide ?
Nous vous recommandons d'effectuer les actions suivantes pour mettre à jour la maintenance de manière fluide :
- Définissez votre intervalle de maintenance sur une heure qui garantit que la maintenance n'est pas appliquée aux heures de pointe d'utilisation d'Apigee.
- Activez les notifications de maintenance pour être averti par e-mail au moins sept jours (pour la semaine 1) ou 14 jours (pour la semaine 2) avant le début de la mise à jour de maintenance planifiée.
- Utilisez différents intervalles de maintenance non chevauchants pour chaque ressource. Cela signifie que si une interruption se produit pendant la période de maintenance, vous pouvez toujours utiliser le produit avec les ressources non affectées.
Pourquoi mes paramètres de maintenance ont-ils été ignorés ?
Apigee s'efforcera de respecter les intervalles de maintenance et l'ordre des mises à jour. Toutefois, pour maintenir la compatibilité et la sécurité de notre parc, nous devrons parfois mettre à jour votre instance en dehors de vos heures préférées. Vous ne serez pas averti à l'avance si cela se produit, mais des journaux de mise à jour de l'instance seront toujours générés pour l'instance.