| Prochaine révision | Révision précédente |
| technique:adminsys:secu:services_updates [2021/02/08 16:59] – créée rdelaage | technique:adminsys:secu:services_updates [2022/05/24 21:01] (Version actuelle) – ppom |
|---|
| ### Fréquence des vérifications | ### Fréquence des vérifications |
| |
| C'est un [[https://gitlab.utc.fr/picasoft/projets/dockerfiles/-/tree/master/pica-notify-update|service dédié]] dans un conteneur dédié qui fait tourner le bot. Le service utilise [[https://github.com/aptible/supercronic|supercronic]] pour vérifier régulièrement les sources, l'intervalle de vérification est paramétrable par la variable d'environnement ''CRON_UPDATE'', il s'agit d'une chaîne de caractères au [[https://fr.wikipedia.org/wiki/Cron#Notation|format cron]] qui représente la fréquence de répétition de la tâche. | C'est un [[https://gitlab.utc.fr/picasoft/projets/services/updates-notifier|service dédié]] dans un conteneur dédié qui fait tourner le bot. Le service utilise [[https://github.com/aptible/supercronic|supercronic]] pour vérifier régulièrement les sources, l'intervalle de vérification est paramétrable par la variable d'environnement ''CRON_UPDATE'', il s'agit d'une chaîne de caractères au [[https://fr.wikipedia.org/wiki/Cron#Notation|format cron]] qui représente la fréquence de répétition de la tâche. |
| |
| ### Compte bot | ### Compte bot |
| |
| Les sources que le bot utilise pour récupérer les versions sont renseignées dans le fichier ''feeds.json'', il s'agit d'une liste d'objets contenant tous quatre éléments : | Les sources que le bot utilise pour récupérer les versions sont renseignées dans le fichier ''feeds.json'', il s'agit d'une liste d'objets contenant tous quatre éléments : |
| * ''id'': un entier utilisé pour conserver les versions déjà explorées dans la base de données, il doit toujours être incrémenté, même si un ancien id n'est plus utilisé il vaut mieux ne pas le recycler | |
| * ''na | * ''id'' : un entier utilisé pour conserver les versions déjà explorées dans la base de données, il est unique et constant, il doit toujours être incrémenté, même si un ancien id n'est plus utilisé il vaut mieux ne pas le recycler |
| | * ''name'' : une chaîne de caractères qui correspond au nom du service qui sera affiché dans le message sur Mattermost, il peut être modifié voire même dupliqué si besoin sans problème |
| | * ''type'' : le type de la source au choix parmi ''github'' quand on utilise l'API GitHub, ''gitlab'' pour l'API GitLab, ''gitea'' pour l'API Gitea ou ''rss'' quand on renseigne l'adresse d'un flux Atom 2005 |
| | * ''url'' : il peut s'agir soit de l'endpoint de l'API qui fourni les données au bot ou de l'adresse du flux Atom 2005 |
| | |
| | Pour trouver les adresses des API on peut regarder [[https://docs.github.com/en/rest/reference/repos#list-releases|cette page]] pour GitHub, [[https://docs.gitlab.com/ee/api/releases/#list-releases|celle-ci]] pour GitLab ou bien [[https://try.gitea.io/api/swagger#/repository/repoListReleases|celle-là]] pour Gitea. |
| | |
| | <bootnote>Les développeurs des logiciels n'utilisent parfois pas ou pas bien les fonctionnalités de releases des forges, dans ces cas là l'utilisation des API n'est pas optimale, on préfèrera donc utiliser les flux Atom qui sont disponible dans GitHub (en regardant les sources de la page et en cherchant atom) ou GitLab</bootnote> |