Déployer les mises à jour

Ce que fait la page Déploiement

La page Déploiement règle la façon dont les agents reçoivent leur version.

Chaque agent a une cible. C'est sa propre cible quand vous lui en donnez une, sinon la version de production. La plateforme envoie un ordre de mise à jour à chaque agent en ligne dont la version diffère de sa cible. Elle limite le nombre d'ordres par minute, pour toute la plateforme, et elle n'envoie jamais un ordre pendant une tâche.

Sur cette page, vous réglez le rythme, vous arrêtez le déploiement, vous donnez une cible à un lot d'agents, et vous agissez sur un seul agent.

Vous ne choisissez pas la version de production ici. Elle se choisit sur la page Versions de l'agent.

Prérequis

• Le rôle Administrateur plateforme, et une session du portail. Voir Écrans de la plateforme.
• Au moins une version à l'état Disponible. Voir Versions de l'agent.
• Pour cibler un client ou des agents, leurs identifiants. L'identifiant d'un client est dans l'adresse de sa page, après /clients/. L'identifiant d'un agent est dans l'adresse de sa page, après /endpoints/.

Le déroulement d'une mise à jour sur une machine est décrit dans Mise à jour automatique de l'agent.

Lire l'état du déploiement

1. Connectez-vous au portail.
2. Dans la barre du haut, cliquez sur Plateforme.
3. Dans le menu des pages de la plateforme, cliquez sur Déploiement.

Le badge à côté du titre donne En cours ou Arrêté. La page porte quatre cartes.

Carte	Ce qu'elle donne
Version de production	La version de production, la date de son dernier changement et le rythme du déploiement.
Agents par version	Le nombre d'agents par version annoncée, la version la plus répandue en premier.
Lot	Le formulaire qui donne une cible à un groupe d'agents.
Un agent	Les actions sur un seul agent : geler, relancer, suivre la production.

La carte Agents par version compte les agents non supprimés. La ligne Jamais connecté compte les agents qui n'ont pas encore annoncé de version.

Régler le rythme du déploiement

Le rythme est le nombre d'ordres de mise à jour envoyés par minute, pour toute la plateforme.

1. Ouvrez la page Déploiement.
2. Allez à la carte Version de production.
3. Saisissez le nombre dans Ordres de mise à jour par minute.
4. Cliquez sur Enregistrer le rythme.

Le portail confirme « Rythme du déploiement enregistré : N ordres de mise à jour par minute. »

Le champ accepte un nombre entier de 1 à 1 000. La valeur de départ est 20.

Un rythme bas étale le déploiement. Il limite aussi la charge du serveur et du réseau : chaque agent mis à jour télécharge son programme depuis le serveur BaaStide.

Arrêter et reprendre le déploiement

Arrêtez le déploiement dès que vous voyez des échecs de mise à jour sur plusieurs machines.

1. Ouvrez la page Déploiement.
2. Cliquez sur Arrêter le déploiement, en haut à droite.
3. Lisez le message : « Aucun agent ne reçoit de nouvelle version tant que vous ne reprenez pas. Les agents gardent la version qu'ils exécutent, et leurs cibles restent. »
4. Cliquez sur Arrêter le déploiement.

Le portail confirme « Déploiement arrêté. » Le badge passe à Arrêté.

Pour reprendre :

1. Cliquez sur Reprendre le déploiement.
2. Lisez le message. Il donne la version de production et le rythme.
3. Cliquez sur Reprendre le déploiement.

Le portail confirme « Déploiement repris. »

Un arrêt coupe l'envoi des ordres suivants. Il ne coupe pas une mise à jour déjà commencée sur une machine.

Viser une version sur un lot d'agents

Un lot donne sa propre cible à un groupe d'agents. Ces agents reçoivent la version avant le reste du parc.

1. Ouvrez la page Déploiement.
2. Allez à la carte Lot.
3. Choisissez la version dans Version cible. La liste donne les versions disponibles.
4. Choisissez le groupe dans Agents.
5. Remplissez le champ du groupe choisi.
6. Cliquez sur Vérifier le lot.
7. Lisez le résumé de la fenêtre. Il nomme le groupe et la version.
8. Cliquez sur Viser N.

Le portail confirme « N agents ont changé de cible. »

Les quatre groupes :

Groupe	Ce qu'il prend
Une part du parc	La part saisie, de 1 à 100 %. Seulement les agents qui suivent la production. Le champ Dans le MSP (facultatif) limite la part aux agents d'un seul MSP.
Un MSP	Tous les agents du MSP, agents gelés compris.
Un client	Tous les agents du client, agents gelés compris.
Agents listés	Les agents dont vous saisissez l'identifiant, un par ligne. 1 000 au plus.

Pour la même version cible, une part du parc garde les mêmes agents quand vous l'augmentez. Un lot de 10 % vers la version N, puis un lot de 30 % vers la version N, garde les agents des premiers 10 % et en ajoute d'autres. Une autre version cible donne une autre part du parc.

Pour rendre leur cible à ces agents, choisissez Suivre la production dans Version cible, reprenez le même groupe, puis cliquez sur Suivre la production. Ce retour ne marche pas avec le groupe Une part du parc : utilisez un MSP, un client ou la liste des agents.

Geler un agent

Un agent gelé reste sur la version qu'il exécute. Gelez une machine sensible le temps d'un déploiement.

1. Ouvrez la page Déploiement.
2. Allez à la carte Un agent.
3. Saisissez l'identifiant de l'agent dans ID de l'agent.
4. Cliquez sur Geler.
5. Lisez le message : « L'agent reste sur la version qu'il exécute. Il ne reçoit aucune mise à jour tant que vous ne le renvoyez pas vers la production. »
6. Cliquez sur Geler.

La carte affiche alors la version de l'agent, sa cible et la version qu'il a refusée.

Le gel prend la version que l'agent exécute comme cible. Cette version doit être enregistrée et disponible. Sinon le portail écrit « La version de cet agent n'est pas une version connue. », ou « Cette version existe déjà, n'est pas disponible ou est la version de production. » pour une version révoquée.

Relancer une mise à jour refusée

Une machine revenue à sa version précédente ne reçoit plus cette version. Relancez la mise à jour quand la cause de l'échec est corrigée.

1. Ouvrez la carte Un agent.
2. Saisissez l'identifiant de l'agent.
3. Cliquez sur Relancer la mise à jour.
4. Lisez le message : « L'agent peut recevoir de nouveau la version qu'il a refusée. Il la reçoit au rythme du déploiement. »
5. Cliquez sur Relancer la mise à jour.

Le champ Version refusée de la carte passe à « Aucune ». La plateforme enverra de nouveau la version à cette machine.

Lisez d'abord la tâche en échec sur la fiche de la machine. Elle donne la cause et le message de l'agent. Voir Mise à jour automatique de l'agent.

Renvoyer un agent vers la production

1. Ouvrez la carte Un agent.
2. Saisissez l'identifiant de l'agent.
3. Cliquez sur Suivre la production.
4. Lisez le message : « L'agent abandonne sa propre cible et reçoit la version de production au rythme du déploiement. »
5. Cliquez sur Suivre la production.

Cette action retire aussi un gel.

Limites et précautions

• Un agent hors ligne ne reçoit pas d'ordre. Il le reçoit à sa prochaine connexion.
• Un agent qui n'a jamais annoncé sa version ne reçoit pas d'ordre.
• La plateforme n'envoie jamais un ordre pendant une tâche de la machine, ni pendant une session de restauration ouverte. Une sauvegarde et une restauration ne sont jamais coupées par une mise à jour.
• Après une tentative sans refus, la plateforme attend 15 minutes avant d'envoyer un autre ordre à la même machine.
• Un ordre sans réponse de l'agent en 5 minutes donne une tâche Échouée. Un ordre accepté sans résultat en 1 heure donne aussi une tâche Échouée.
• Un agent Windows ne reçoit une version que si elle porte un programme Windows. Sinon il attend la version suivante. Voir Versions de l'agent.
• Un agent d'un autre système ou d'une autre architecture ne reçoit aucune mise à jour.
• Un lot Une part du parc demande une version cible. Il ne prend pas les agents qui ont déjà leur propre cible, ni les agents gelés.
• Un lot sur un MSP ou sur un client remplace la cible de tous ses agents, gels compris.
• Une version révoquée n'est plus une cible. Les agents qui la visaient suivent de nouveau la version de production.
• Le rythme compte les ordres envoyés dans la dernière minute sur toute la plateforme. Un rythme haut sur un grand parc charge le serveur qui sert les programmes.
• Chaque changement du rythme, chaque arrêt et chaque lot entrent dans le journal de la plateforme. Chaque changement de cible d'un agent (lot, gel, retour à la production) et chaque relance entrent dans le journal d'audit du MSP de l'agent. Voir Journal d'audit.
• Cette page ne donne pas l'état d'une mise à jour sur une machine. Ouvrez la fiche de la machine, onglet Activité. Voir Mise à jour automatique de l'agent.
• Un agent qui reste sous la version minimale de la plateforme ne peut plus sauvegarder ni restaurer. Voir Agent trop ancien.