Une mise à jour du micrologiciel qui fait défaillir des appareils doit en faire défaillir le moins possible. Un déploiement par vagues envoie d’abord un paquet à un petit groupe, vérifie le résultat, attend, puis seulement passe à des groupes plus grands. Il s’arrête automatiquement lorsqu’une vague se passe moins bien que ce que vous avez autorisé. Cette page explique comment le configurer et le suivre. Les bases des paquets et des affectations sont décrites dans Mises à jour du micrologiciel (OTA).
Quand utiliser les vagues
Les vagues s’appliquent à une affectation à Tous les appareils d’un profil ou à Certains appareils (une liste d’appareils). Une affectation à Un appareil est envoyée immédiatement. Vous devez disposer de l’autorisation d’affecter du micrologiciel (administrateurs).
Configurer un déploiement
- Ouvrez le paquet dans Micrologiciel et sélectionnez Affecter (ou utilisez l’onglet Micrologiciel d’un profil).
- Choisissez Tous les appareils d’un profil ou Certains appareils, puis sélectionnez les cibles.
- Activez Envoyer par vagues (« Une première petite vague d’appareils en ligne, puis des vagues plus grandes. Le déploiement s’arrête automatiquement lorsqu’une vague se passe moins bien que ce que vous avez autorisé. »).
- Conservez Utiliser le plan habituel, ou modifiez les vagues (voir ci-dessous).
- Sélectionnez Vérifier. Ce qui se passe affiche le nombre d’appareils et « En vagues : … » avec la taille de chaque vague.
- Sélectionnez Affecter et confirmez.
Le plan habituel
| Vague | Taille | Attente après réussite |
|---|---|---|
| 1 | 1 % des appareils, au moins 1 et au plus 10 (la sentinelle) | 30 minutes |
| 2 | 10 % | 30 minutes |
| 3 | 50 % | 15 minutes |
| 4 | le reste | — |
Chaque vague du plan habituel exige qu’au moins 90 % de ses appareils terminés soient mis à jour, se met en pause au-delà de 5 % d’échecs, et se ferme au plus tard après 240 minutes.
Vos propres vagues
Dans Vagues, « Les tailles sont comptées sur les appareils qui seront mis à jour. La dernière vague prend tous les appareils restants. » Pour chaque vague :
| Champ | Signification | Plage |
|---|---|---|
| Taille exprimée en | Nombre d’appareils ou Part des appareils (%) | Une taille supérieure à 0 ; une part d’au plus 100 % |
| Attente après réussite (minutes) | Le temps d’observation avant le démarrage de la vague suivante | 0 à 10 080 (7 jours) |
| Au moins mis à jour (%) | Le seuil de succès sur les appareils terminés de la vague | 0 à 100 |
| Au plus en échec (%) | Le seuil d’échec | 0 à 100 |
| Au plus en échec (appareils) | Plafond absolu facultatif. « Laissez vide pour ne compter que la part. » | — |
| Fermer après (minutes) | Durée pendant laquelle la vague reste ouverte. « Les appareils encore hors ligne ou en attente à ce moment-là sont reportés et ne comptent pas comme des échecs. » | 5 à 43 200 |
Ajouter une vague et Supprimer la vague n modifient la liste ; Le reste marque la dernière vague. Un déploiement comporte au plus 20 vagues.
Répartition des appareils dans les vagues
- L’ordre des appareils est stable pour un déploiement : un appareil ne passe pas d’une vague à l’autre lorsque vous consultez à nouveau la liste.
- Les appareils en ligne passent en premier, de sorte que la vague sentinelle donne rapidement des résultats.
- Un appareil d’une vague ultérieure ne reçoit rien (aucun attribut
fw_*) tant que sa vague n’a pas démarré. Sur sa page, il affiche En attente de la vague n.
Pendant l’exécution d’un déploiement
La page du paquet affiche le Déploiement par vagues : chaque vague avec son État (Non démarrée, En cours de mise à jour, Réussie, en attente, Réussie, En pause, Non envoyée), ses Appareils et sa Progression (« mis à jour sur prévus mis à jour, en échec en échec »), ainsi que le seuil actuel (« Maintenant : … en échec (… %), … % des mises à jour terminées. »). « Cette vague se ferme … au plus tard » et « La vague suivante démarre … » indiquent les horaires.
Le statut du déploiement est En cours, En pause, Terminé ou Interrompu.
Pause automatique
Le déploiement se met automatiquement en pause lorsqu’une vague :
| Motif | Affiché comme |
|---|---|
| présente plus d’échecs que permis | trop d’appareils en échec |
| se ferme avec moins d’appareils mis à jour que requis | trop peu d’appareils mis à jour |
| se ferme sans aucun appareil terminé | aucun appareil terminé à temps |
« Les appareils qui ont déjà commencé terminent leur mise à jour ; aucun autre appareil ne la reçoit tant que quelqu’un ne reprend pas le déploiement. » Vos administrateurs reçoivent une notification dans l’application (« paquet : le déploiement est en pause »).
Pause, Reprendre, Interrompre
| Action | Effet |
|---|---|
| Pause | « Aucun autre appareil ne reçoit la mise à jour tant que vous ne reprenez pas. Les appareils qui ont déjà commencé terminent leur mise à jour ; une mise à jour ne peut pas être arrêtée en toute sécurité à mi-parcours. » |
| Reprendre | « Le déploiement se poursuit avec la vague n. » Après une pause automatique : « La reprise prend en compte ce qui s’est passé jusque-là : seuls les nouveaux échecs comptent pour le seuil, et une vague arrêtée à sa fin compte comme réussie. » |
| Interrompre | « Son affectation est supprimée. Les appareils qui n’ont pas commencé l’installation ne reçoivent pas cette mise à jour ; les appareils couverts par une autre affectation passent à celle-ci. Cette action est irréversible. » |
Un déploiement prend aussi fin lorsque le paquet est révoqué, lorsque son affectation est supprimée, ou lorsqu’une affectation plus récente le remplace.
Notifications, audit et webhooks
| Événement | Webhook | Notification dans l’application |
|---|---|---|
| Une vague a réussi | ota.rollout.wave_completed | « Assez d’appareils de la vague n ont été mis à jour. La vague suivante démarre après son temps d’attente. » |
| Mis en pause | ota.rollout.paused | oui |
| Repris | ota.rollout.resumed | — |
| Terminé | ota.rollout.completed | « Les n vagues ont toutes réussi. Les appareils hors ligne se mettent à jour à leur retour. » |
| Interrompu | ota.rollout.aborted | — |
Chaque pause, reprise et interruption est consignée dans le journal d’audit avec l’auteur de l’action.
Conseils
- Avant un déploiement, testez le paquet sur quelques appareils que vous pouvez atteindre physiquement, avec des affectations Un appareil.
- Laissez un temps d’observation suffisamment long pour que les problèmes apparaissent : un appareil qui redémarre en boucle a besoin de temps pour échouer.
- Les appareils sur des liaisons facturées au volume peuvent attendre (En attente) au lieu de se mettre à jour ; ils sont reportés et ne comptent pas comme des échecs à la fermeture de la vague.