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 sert à la vérification de conformité : l'appareil annonce l'empreinte de la configuration qu'il applique réellement, et le portail la compare à celle de la version publiée. Si les deux diffèrent, l'appareil n'a pas encore pris la dernière version — soit il ne s'est pas rafraîchi, soit la configuration ne lui est pas parvenue.

Astuce · Un écart d'empreinte juste après une publication est normal : l'appareil revérifie selon l'intervalle défini par refresh_interval_min. 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.

Cette page n'a pas répondu à votre question ?

Ouvrir un ticket