Publier et versionner

Ce que déclenche une publication, comment lire un numéro de version, et à quoi sert l'empreinte.

Éditer une configuration ne la déploie pas. Tant que vous n'avez pas publié, vos modifications restent un brouillon que les appareils ignorent.

Ce que fait la publication

Au moment où vous publiez, le portail :

  1. attribue un identifiant permanent à la configuration, s'il s'agit de la première publication — cet identifiant ne changera plus ;
  2. incrémente le numéro de version ;
  3. recalcule l'empreinte de la configuration ;
  4. marque la configuration comme publiée et enregistre la date ;
  5. la rattache au pool de licences que vous avez choisi ;
  6. écrit une entrée d'historique contenant un instantané complet des réglages.

Cette dernière étape compte : l'historique conserve la version, l'empreinte, l'auteur et le contenu exact de chaque publication. Vous pouvez donc toujours répondre à la question « qu'est-ce qui était déployé le mois dernier ? ».

L'empreinte

L'empreinte est un condensé SHA-256 des réglages, calculé avec les clés triées pour que deux configurations identiques donnent toujours la même valeur, quel que soit l'ordre dans lequel les champs ont été saisis.

Elle identifie le contenu exact d'une version : deux versions dont les réglages sont identiques portent la même empreinte, et l'historique la conserve.

À noter · L'appareil n'envoie pas cette empreinte au portail. La conformité que vous voyez dans Licences repose sur une autre comparaison, décrite ci-dessous.

La conformité d'un appareil

À chaque vérification de licence, l'appareil déclare son état réel : kiosque actif, titre, barres système, couleurs, applications autorisées et vidéos autorisées. Le portail compare ces valeurs à la version publiée et signale les écarts réglage par réglage — application manquante ou non autorisée, vidéo manquante ou non autorisée, valeur différente.

À noter · Cette déclaration fait partie des données que l'appareil envoie quand sa licence le permet. Un appareil sous une licence de type distributeur ne l'envoie pas : le portail n'affiche alors aucune conformité pour lui. Voir Lire le tableau de bord analytique.
Astuce · Un écart juste après une publication est normal : l'appareil ne déclare son nouvel état qu'à sa vérification de licence suivante, selon l'intervalle défini par refresh_interval_min (15 minutes au minimum). Un écart qui persiste au-delà de deux ou trois intervalles mérite une vérification.

Supprimer une configuration

La suppression est définitive et emporte l'historique associé. Rien n'empêche actuellement de supprimer une configuration déjà publiée.

Attention · Avant de supprimer, vérifiez qu'aucun pool actif ne pointe dessus. Une configuration supprimée alors qu'elle est en service ne peut pas être restaurée depuis le portail.

This page did not answer your question?

Open a ticket