Versions de l'agent

Ce que fait la page Versions de l'agent

La page Versions de l'agent tient la liste des versions de l'agent que la plateforme connaît. Une version doit figurer dans cette liste avant qu'un agent puisse la recevoir.

Chaque version porte sa taille, son empreinte SHA-256 et sa signature. L'API vérifie la signature avec ses clés de confiance avant d'enregistrer la version. Le portail ne signe rien : la chaîne de construction de l'agent signe, et l'API contrôle.

Une seule version de la liste est la version de production. C'est la cible de chaque agent qui n'a pas sa propre cible. Vous la choisissez depuis cette page.

Une version révoquée n'est plus envoyée à aucun agent.

Prérequis

• Le rôle Administrateur plateforme, et une session du portail. Voir Écrans de la plateforme.
• Le programme de la nouvelle version déjà publié sur le serveur BaaStide. L'agent le télécharge depuis ce serveur.
• Les valeurs du manifeste de cette version : la version, la taille en octets, l'empreinte SHA-256 et la signature.

Sur une instance installée chez vous, les versions de l'agent arrivent avec la version de la pile. Vous n'avez pas besoin d'aller chercher un manifeste ailleurs.

Les deux états d'une version

État	Ce qu'il veut dire
Disponible	La version peut être la version de production, et un lot peut la viser.
Révoquée	Plus aucun agent ne reçoit cette version.

Ouvrir la liste des versions

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 Versions de l'agent.

La liste donne les versions de la plus récente à la plus ancienne. Elle porte ces colonnes.

Colonne	Ce qu'elle donne
Version	Le numéro de la version. Le badge Production marque la version de production.
État	Disponible ou Révoquée.
Taille	La taille du programme.
SHA-256	L'empreinte du programme.
Ajout	La date de l'ajout, ou la date de la révocation.
Notes	Les notes saisies à l'ajout.

Quand aucune version de production n'est choisie, la page écrit « Aucune version de production n'est choisie : aucune version ne peut être révoquée. Choisissez-en une avec « Passer en production ». »

Ajouter une version

1. Ouvrez la page Versions de l'agent.
2. Cliquez sur Ajouter une version.
3. Saisissez le numéro dans Version, par exemple 1.2.0 ou 1.2.0-rc.1.
4. Saisissez la taille du programme, en octets, dans Taille (octets).
5. Saisissez l'empreinte dans SHA-256. Elle fait 64 caractères hexadécimaux.
6. Saisissez la signature dans Signature (base64). Elle fait 88 caractères.
7. Saisissez une note dans Notes si vous voulez. Ce champ est facultatif.
8. Cliquez sur Ajouter.

Le portail confirme « Version N ajoutée. » La version entre dans la liste à l'état Disponible. Elle n'est pas encore envoyée aux agents : la version de production ne change pas.

Copiez chaque valeur depuis le manifeste de cette version. Une valeur recopiée à la main peut être fausse, et l'API refuse alors la signature.

Passer une version en production

1. Ouvrez la page Versions de l'agent.
2. Allez sur la ligne de la version.
3. Cliquez sur Passer en production.
4. Lisez le message de la fenêtre : « Chaque agent qui suit la production reçoit cette version, au débit du déploiement. Les agents d'un lot ou gelés gardent leur cible. »
5. Cliquez sur Passer N en production.

Le portail confirme « N est maintenant la version de production. » Le badge Production passe sur cette ligne.

La plateforme commence alors à envoyer cette version aux agents en ligne qui la suivent. Elle limite le nombre d'ordres par minute. Voir Déployer les mises à jour.

Le bouton Passer en production n'apparaît pas sur la ligne de la version de production, ni sur la ligne d'une version révoquée.

Révoquer une version

Révoquez une version quand vous ne voulez plus qu'aucun agent la reçoive.

1. Ouvrez la page Versions de l'agent.
2. Allez sur la ligne de la version.
3. Cliquez sur Révoquer.
4. Lisez le message de la fenêtre : « Vous ne pouvez pas annuler cette action. Aucun agent ne recevra plus cette version. Les agents qui la visent suivent de nouveau la production. Les agents déjà dessus y restent jusqu'à la prochaine mise à jour. »
5. Saisissez le numéro de la version dans le champ de confirmation.
6. Cliquez sur Révoquer N.

Le portail confirme « Version N révoquée. » Il donne aussi le nombre d'agents qui suivent de nouveau la version de production.

Les machines qui exécutent cette version reçoivent ensuite la version de production, au rythme du déploiement. Un agent gelé sur cette version perd son gel.

Limites et précautions

• Une révocation est définitive. Aucune page ne rend une version révoquée de nouveau disponible, et vous ne pouvez pas enregistrer de nouveau le même numéro de version. Pour revenir en arrière, publiez une nouvelle version avec un nouveau numéro.
• La version de production ne peut pas être révoquée. Le bouton Révoquer n'apparaît pas sur sa ligne. Passez d'abord une autre version en production.
• Aucune version ne peut être révoquée tant qu'aucune version de production n'est choisie. Le bouton Révoquer n'apparaît alors sur aucune ligne. Choisissez d'abord une version de production : les agents qui visent la version révoquée ont besoin d'une cible.
• Une version déjà enregistrée ne peut pas être modifiée. Le portail écrit « Cette version est déjà enregistrée. » sous le champ Version.
• Une signature qui ne correspond pas au manifeste est refusée. Le portail écrit « L'API a refusé cette signature. Copiez-la de nouveau depuis le manifeste de cette version. » Vérifiez d'abord la version, la taille et l'empreinte : la signature porte sur ces trois valeurs.
• Le numéro d'une version suit la forme 1.2.0, avec un suffixe facultatif comme -rc.1. Il fait 64 caractères au plus.
• Le formulaire du portail enregistre le programme Linux seulement. Une version ajoutée depuis le portail n'est jamais envoyée à un agent Windows. Sur une instance installée chez vous, enregistrez la version avec la commande register-agent-release de l'instance : elle lit les deux manifestes, Linux et Windows.
• Les notes font 2 000 caractères au plus. Elles sont lues par les administrateurs de la plateforme. N'y écrivez aucun secret.
• Passer une version en production lance un déploiement sur tout le parc. Visez d'abord un petit lot d'agents, vérifiez le résultat, puis passez la version en production. Voir Déployer les mises à jour.
• Chaque ajout, chaque passage en production et chaque révocation entre dans le journal de la plateforme. Voir Journal d'audit.
• Cette page ne donne pas la version de chaque machine. Le nombre d'agents par version est sur la page Déploiement. La version d'une machine est sur sa fiche. Voir Mise à jour automatique de l'agent.