Jlarvers le 14 octobre 2026 à 11:14

2026-10-14T11:14:27Z

Jlarvers : /* Architecture */

2026-10-14T06:28:09Z

Architecture

← Version précédente		Version du 14 octobre 2026 à 06:28
Ligne 56 :		Ligne 56 :

	=== Serveurs surveillés ===		=== Serveurs surveillés ===

			La supervision des mises à jour est centralisée sur '''Saturne3'''.

			Elle concerne les principaux serveurs de l'infrastructure AJLSM.

	{\| class="wikitable"		{\| class="wikitable"
	! Serveur		! Serveur
	~~! Système~~
	~~! Accès depuis Saturne3~~
	! Fonction		! Fonction
			! Mode de supervision
	\|-		\|-
	\| Saturne3		\| '''Saturne3'''
	~~\| Debian 13 / Proxmox VE 9~~		\| Hyperviseur principal et serveur de supervision
	~~\| Local~~		\| Exécution locale
	\| Hyperviseur principal et supervision
	\|-		\|-
	\| Beotos3		\| '''Beotos3'''
	\| ~~Debian 13 / Proxmox VE 9~~		\| Hyperviseur et serveur de sauvegarde
	~~\| root@192.168.123.104~~		\| Connexion SSH
	\| ~~Serveur de sauvegarde~~
	\|-		\|-
	\| Eole3		\| '''Eole3'''
	~~\| Ubuntu 24.04 LTS~~
	~~\| root@192.168.123.202~~
	\| Serveur de données et d'images		\| Serveur de données et d'images
			\| Connexion SSH
	\|-		\|-
	\| PBS100		\| '''PBS100'''
	\| ~~Debian 13 /~~ Proxmox Backup Server 4		\| Serveur Proxmox Backup Server
	~~\| root@51.178.245.43~~		\| Connexion SSH
	\| ~~Serveur PBS~~
	\|}		\|}

			Les serveurs distants sont interrogés depuis Saturne3
			au moyen de connexions SSH utilisant une authentification par clé.

			Les adresses de connexion et la liste des serveurs surveillés
			sont définies dans le script :

			<syntaxhighlight lang="bash">
			/usr/local/sbin/supervision_updates.sh
			</syntaxhighlight>

			'''Les versions des systèmes, les dates des dernières maintenances,
			l'état des serveurs et les opérations à prévoir sont documentés
			dans la page :'''

			[[Maintenance et mises à jour de l'infrastructure AJLSM]]

			Cette dernière constitue la référence pour le suivi opérationnel
			et l'historique des interventions.

	Les connexions SSH utilisent une authentification par clé.		Les connexions SSH utilisent une authentification par clé.

Jlarvers le 14 octobre 2026 à 06:24

2026-10-14T06:24:38Z

← Version précédente		Version du 14 octobre 2026 à 06:24
Ligne 35 :		Ligne 35 :
	les mises à jour disponibles sur les principaux serveurs de l'infrastructure.		les mises à jour disponibles sur les principaux serveurs de l'infrastructure.

	'''~~Documentation technique~~ :''' [[Maintenance_et_mises_à_jour_de_l'infrastructure_AJLSM]]		Chaque mise à jour fait l'objet d'un suivi décrit dans la '''documentation suivante :''' [[Maintenance_et_mises_à_jour_de_l'infrastructure_AJLSM]]

	Le dispositif est centralisé sur '''Saturne3'''.		Le dispositif est centralisé sur '''Saturne3'''.

Jlarvers : /* Supervision des mises à jour de l'infrastructure AJLSM */

2026-10-14T06:22:37Z

Supervision des mises à jour de l'infrastructure AJLSM

← Version précédente		Version du 14 octobre 2026 à 06:22
Ligne 34 :		Ligne 34 :
	La supervision des mises à jour AJLSM permet de surveiller quotidiennement		La supervision des mises à jour AJLSM permet de surveiller quotidiennement
	les mises à jour disponibles sur les principaux serveurs de l'infrastructure.		les mises à jour disponibles sur les principaux serveurs de l'infrastructure.

			'''Documentation technique :''' [[Maintenance_et_mises_à_jour_de_l'infrastructure_AJLSM]]

	Le dispositif est centralisé sur '''Saturne3'''.		Le dispositif est centralisé sur '''Saturne3'''.

Jlarvers : Page créée avec « = Supervision des mises à jour de l'infrastructure AJLSM = {| class="wikitable" ! Élément ! Information |- | Serveur de supervision | Saturne3 |- | Systèmes surveill... »

2026-10-14T06:20:31Z

Page créée avec « = Supervision des mises à jour de l'infrastructure AJLSM = {| class="wikitable" ! Élément ! Information |- | Serveur de supervision | Saturne3 |- | Systèmes surveill... »

Nouvelle page

= Supervision des mises à jour de l'infrastructure AJLSM =

{| class="wikitable"
! Élément
! Information
|-
| Serveur de supervision
| Saturne3
|-
| Systèmes surveillés
| Saturne3, Beotos3, Eole3, PBS100
|-
| Mise en service
| 13 octobre 2026
|-
| Contrôle quotidien
| 6 h
|-
| Rapport hebdomadaire
| Lundi à 7 h
|-
| Installation automatique
| Aucune
|-
| Redémarrage automatique
| Aucun
|-
| Notifications
| Courriel hebdomadaire
|}

== Objectif ==

La supervision des mises à jour AJLSM permet de surveiller quotidiennement
les mises à jour disponibles sur les principaux serveurs de l'infrastructure.

Le dispositif est centralisé sur '''Saturne3'''.

Il permet :

* D'actualiser les index APT des serveurs.
* D'identifier les mises à jour disponibles.
* De distinguer les mises à jour de sécurité Debian/Ubuntu des autres mises à jour lorsque cette distinction est possible.
* De détecter les erreurs d'accès SSH et les échecs des commandes APT.
* De conserver les incidents rencontrés entre deux rapports.
* D'envoyer un rapport hebdomadaire récapitulatif.

'''Aucun paquet n'est installé automatiquement par ces scripts.'''

Les mises à jour et les éventuels redémarrages restent des opérations
de maintenance manuelles.

== Architecture ==

=== Serveurs surveillés ===

{| class="wikitable"
! Serveur
! Système
! Accès depuis Saturne3
! Fonction
|-
| Saturne3
| Debian 13 / Proxmox VE 9
| Local
| Hyperviseur principal et supervision
|-
| Beotos3
| Debian 13 / Proxmox VE 9
| root@192.168.123.104
| Serveur de sauvegarde
|-
| Eole3
| Ubuntu 24.04 LTS
| root@192.168.123.202
| Serveur de données et d'images
|-
| PBS100
| Debian 13 / Proxmox Backup Server 4
| root@51.178.245.43
| Serveur PBS
|}

Les connexions SSH utilisent une authentification par clé.

Le mode BatchMode=yes empêche les demandes interactives de mot de passe.

Le contrôle StrictHostKeyChecking=yes impose la vérification
des clés SSH des serveurs distants.

=== Principe de fonctionnement ===

Le mécanisme comporte deux opérations distinctes :

# Une collecte quotidienne des informations APT.
# Un rapport hebdomadaire envoyé par courriel.

Les opérations sont ordonnancées par systemd.

Les contrôles quotidiens sont silencieux : ils n'envoient pas
de courriel directement.

Les anomalies sont enregistrées dans un journal d'incidents
et reprises dans le rapport hebdomadaire.

== Scripts ==

=== Emplacement ===

Les scripts sont installés sur Saturne3 dans :

<syntaxhighlight lang="text">
/usr/local/sbin/
</syntaxhighlight>

{| class="wikitable"
! Fichier
! Fonction
|-
| supervision_updates.sh
| Orchestration des contrôles quotidiens
|-
| supervision_updates_collect.py
| Analyse et classification des mises à jour APT
|-
| supervision_rapport.sh
| Production et envoi du rapport hebdomadaire
|}

=== supervision_updates.sh ===

Ce script assure la supervision quotidienne des quatre serveurs.

Pour chaque serveur :

# Actualisation des index APT avec apt-get update.
# Vérification du résultat de l'actualisation.
# Exécution du collecteur Python.
# Enregistrement des mises à jour disponibles.
# Enregistrement des incidents éventuels.

Le script utilise des délais maximaux d'exécution afin d'éviter
qu'un serveur indisponible bloque indéfiniment la supervision.

Les erreurs d'accès SSH et les erreurs APT sont enregistrées.

Les informations sont écrites dans :

<syntaxhighlight lang="text">
/var/log/supervision-updates.log
/var/lib/supervision-updates/dernier-rapport.txt
</syntaxhighlight>

Le fichier dernier-rapport.txt contient le résultat
de la dernière exécution.

Le journal supervision-updates.log conserve l'historique.

=== supervision_updates_collect.py ===

Le collecteur Python utilise la bibliothèque python-apt.

Il examine les paquets installés et leurs versions candidates.

Pour chaque mise à jour disponible, il indique :

* Le nom du paquet.
* La version installée.
* La version candidate.

Les mises à jour sont réparties en deux catégories :

'''Sécurité Debian/Ubuntu'''

Versions candidates provenant des dépôts de sécurité Debian
ou Ubuntu.

'''Autres mises à jour'''

Versions candidates provenant des autres dépôts, notamment Proxmox.

Exemple de présentation :

<syntaxhighlight lang="text">
ATTENTION : 3 mise(s) a jour APT disponible(s)

Securite Debian/Ubuntu : 1
exemple-paquet : 1.0 -> 1.1

Autres mises a jour (dont Proxmox) : 2
exemple-proxmox : 2.0 -> 2.1
exemple-debian : 3.0 -> 3.1
</syntaxhighlight>

'''Limite importante :'''

Une mise à jour classée parmi les autres mises à jour peut
également contenir un correctif de sécurité.

La classification repose sur la provenance APT de la version candidate.

Elle ne constitue pas une analyse exhaustive des vulnérabilités.

Le dispositif ne réalise pas de classification automatique des CVE
selon leur gravité.

Les correctifs Ubuntu Pro ESM ne font pas l'objet d'un suivi spécifique.

=== supervision_rapport.sh ===

Le script produit le rapport hebdomadaire.

Il vérifie notamment :

* La présence du rapport quotidien.
* Son ancienneté, limitée à 25 heures.
* La présence des quatre serveurs dans le rapport.
* L'absence d'erreurs dans la dernière collecte.
* L'existence de mises à jour disponibles.
* Les incidents enregistrés depuis le précédent rapport.

Le rapport est transmis à Postfix avec :

<syntaxhighlight lang="text">
/usr/sbin/sendmail
</syntaxhighlight>

Expéditeur :

<syntaxhighlight lang="text">
root@saturne3.ajlsm.com
</syntaxhighlight>

Destinataire :

<syntaxhighlight lang="text">
arvers@ajlsm.com
</syntaxhighlight>

=== Classification des rapports ===

{| class="wikitable"
! Niveau
! Critère
! Objet du courriel
|-
| OK
| Aucun paquet à mettre à jour et aucune anomalie
| [AJLSM][OK] Maintenance hebdo
|-
| ACTION
| Mises à jour disponibles
| [AJLSM][ACTION] Maintenance hebdo
|-
| ERREUR
| Rapport absent, incomplet, ancien ou incident enregistré
| [AJLSM][ERREUR] Maintenance hebdo
|}

Le script ne produit pas d'alerte immédiate de type CRITIQUE.

== Ordonnancement systemd ==

=== Fichiers installés ===

<syntaxhighlight lang="text">
/etc/systemd/system/supervision-updates.service
/etc/systemd/system/supervision-updates.timer

/etc/systemd/system/supervision-rapport.service
/etc/systemd/system/supervision-rapport.timer
</syntaxhighlight>

=== Contrôle quotidien ===

Service :

<syntaxhighlight lang="ini">
[Unit]
Description=Supervision quotidienne des mises a jour AJLSM
Wants=network-online.target
After=network-online.target

[Service]
Type=oneshot
User=root
ExecStart=/usr/local/sbin/supervision_updates.sh
</syntaxhighlight>

Timer :

<syntaxhighlight lang="ini">
[Unit]
Description=Verification quotidienne des mises a jour AJLSM

[Timer]
OnCalendar=*-*-* 06:00:00
Persistent=true

[Install]
WantedBy=timers.target
</syntaxhighlight>

=== Rapport hebdomadaire ===

Service :

<syntaxhighlight lang="ini">
[Unit]
Description=Rapport hebdomadaire des mises a jour AJLSM
Wants=network-online.target
After=network-online.target

[Service]
Type=oneshot
User=root
ExecStart=/usr/local/sbin/supervision_rapport.sh
</syntaxhighlight>

Timer :

<syntaxhighlight lang="ini">
[Unit]
Description=Envoi hebdomadaire du rapport de supervision AJLSM

[Timer]
OnCalendar=Mon *-*-* 07:00:00
Persistent=true

[Install]
WantedBy=timers.target
</syntaxhighlight>

'''Remarque :'''

Les configurations ci-dessus décrivent le fonctionnement attendu.
Les fichiers présents sur Saturne3 restent la référence
pour leur contenu exact.

=== Activation des timers ===

Après installation ou modification des unités :

<syntaxhighlight lang="bash">
systemctl daemon-reload

systemctl enable --now supervision-updates.timer
systemctl enable --now supervision-rapport.timer
</syntaxhighlight>

=== Vérification ===

<syntaxhighlight lang="bash">
systemctl list-timers --all | grep supervision
</syntaxhighlight>

Vérifier l'activation :

<syntaxhighlight lang="bash">
systemctl is-enabled supervision-updates.timer
systemctl is-enabled supervision-rapport.timer
</syntaxhighlight>

Vérifier l'état :

<syntaxhighlight lang="bash">
systemctl status supervision-updates.timer
systemctl status supervision-rapport.timer
</syntaxhighlight>

== Journaux et fichiers d'état ==

=== Fichiers utilisés ===

{| class="wikitable"
! Fichier
! Fonction
|-
| /var/log/supervision-updates.log
| Historique des contrôles quotidiens
|-
| /var/lib/supervision-updates/dernier-rapport.txt
| Résultat de la dernière collecte
|-
| /var/lib/supervision-updates/incidents.log
| Incidents non encore archivés
|-
| /var/lib/supervision-updates/incidents-archives.log
| Historique des incidents transmis
|-
| /var/lib/supervision-updates/derniere-position
| Position de lecture dans le journal d'incidents
|}

Les fichiers de supervision sont gérés par root.

Les journaux et fichiers d'état doivent conserver
des permissions restrictives.

=== Gestion des incidents ===

Lorsqu'un contrôle échoue, le script quotidien ajoute
une entrée dans incidents.log.

Chaque entrée contient :

* La date et l'heure.
* Le serveur concerné.
* La description de l'erreur.

Le rapport hebdomadaire reprend les incidents qui n'ont pas
encore été transmis.

Un mécanisme de positionnement en octets permet de ne pas
renvoyer les mêmes incidents lors des rapports suivants.

Seules les lignes complètes sont traitées.

Après acceptation du courriel par Postfix :

# Les incidents transmis sont archivés.
# La position de lecture est mise à jour.
# Le journal actif est purgé lorsque toutes ses lignes ont été traitées.

Un verrou commun protège le journal contre les écritures
simultanées pendant la préparation du rapport.

=== Verrous ===

<syntaxhighlight lang="text">
/run/supervision-updates.lock
/run/supervision-rapport.lock
/run/supervision-incidents.lock
</syntaxhighlight>

Les verrous sont gérés avec flock.

Ils empêchent les exécutions concurrentes susceptibles
de provoquer des incohérences.

== Rotation des journaux ==

=== Journal quotidien ===

Configuration :

<syntaxhighlight lang="text">
/etc/logrotate.d/supervision-updates
</syntaxhighlight>

Contenu :

<syntaxhighlight lang="text">
/var/log/supervision-updates.log {
weekly
maxsize 10M
rotate 12
compress
delaycompress
missingok
notifempty
create 0600 root root
}
</syntaxhighlight>

=== Archives des incidents ===

Configuration :

<syntaxhighlight lang="text">
/etc/logrotate.d/supervision-incidents
</syntaxhighlight>

Contenu :

<syntaxhighlight lang="text">
/var/lib/supervision-updates/incidents-archives.log {
weekly
rotate 12
compress
missingok
notifempty
create 0600 root root
}
</syntaxhighlight>

Le journal actif incidents.log n'est pas soumis à logrotate.

Il est géré directement par le script hebdomadaire.

=== Vérification de logrotate ===

<syntaxhighlight lang="bash">
logrotate -d /etc/logrotate.d/supervision-updates
logrotate -d /etc/logrotate.d/supervision-incidents
</syntaxhighlight>

L'option -d permet une simulation sans rotation effective.

== Exploitation courante ==

=== Consulter le dernier rapport ===

<syntaxhighlight lang="bash">
cat /var/lib/supervision-updates/dernier-rapport.txt
</syntaxhighlight>

=== Consulter les derniers contrôles ===

<syntaxhighlight lang="bash">
tail -100 /var/log/supervision-updates.log
</syntaxhighlight>

=== Consulter les incidents ===

<syntaxhighlight lang="bash">
cat /var/lib/supervision-updates/incidents.log
</syntaxhighlight>

=== Consulter les archives ===

<syntaxhighlight lang="bash">
cat /var/lib/supervision-updates/incidents-archives.log
</syntaxhighlight>

=== Vérifier les exécutions systemd ===

<syntaxhighlight lang="bash">
journalctl -u supervision-updates.service --no-pager -n 100

journalctl -u supervision-rapport.service --no-pager -n 100
</syntaxhighlight>

=== Lancer manuellement une collecte ===

<syntaxhighlight lang="bash">
systemctl start supervision-updates.service
</syntaxhighlight>

Cette opération actualise les index APT et collecte
les informations des quatre serveurs.

Elle n'installe aucun paquet.

=== Lancer manuellement un rapport ===

<syntaxhighlight lang="bash">
systemctl start supervision-rapport.service
</syntaxhighlight>

'''Attention :'''

Cette commande déclenche un véritable envoi de courriel.

Elle doit être utilisée uniquement lorsqu'un nouvel envoi
est souhaité.

== Diagnostic ==

=== Absence de rapport quotidien ===

Vérifier :

<syntaxhighlight lang="bash">
systemctl status supervision-updates.timer
systemctl status supervision-updates.service

journalctl -u supervision-updates.service --no-pager -n 100
</syntaxhighlight>

=== Erreur SSH ===

Tester depuis Saturne3 :

<syntaxhighlight lang="bash">
ssh -o BatchMode=yes root@192.168.123.104 true
ssh -o BatchMode=yes root@192.168.123.202 true
ssh -o BatchMode=yes root@51.178.245.43 true
</syntaxhighlight>

=== Erreur APT ===

Vérifier sur le serveur concerné :

<syntaxhighlight lang="bash">
apt-get update
apt list --upgradable
</syntaxhighlight>

Ces commandes ne déclenchent aucune installation.

=== Vérification des scripts ===

<syntaxhighlight lang="bash">
bash -n /usr/local/sbin/supervision_updates.sh

bash -n /usr/local/sbin/supervision_rapport.sh

python3 -m py_compile \
/usr/local/sbin/supervision_updates_collect.py
</syntaxhighlight>

== Sauvegarde et gestion des versions ==

Les scripts et fichiers de configuration doivent être conservés
dans le dépôt SVN des outils de maintenance AJLSM.

=== Fichiers à versionner ===

<syntaxhighlight lang="text">
supervision_updates.sh
supervision_updates_collect.py
supervision_rapport.sh

supervision-updates.service
supervision-updates.timer

supervision-rapport.service
supervision-rapport.timer

supervision-updates
supervision-incidents
</syntaxhighlight>

Les deux derniers fichiers correspondent aux configurations logrotate.

La documentation MediaWiki doit également être exportée
et conservée dans SVN.

Les fichiers d'état et les journaux ne doivent pas être versionnés.

=== Fichiers à exclure de SVN ===

<syntaxhighlight lang="text">
*.bak
*.bak-*
*.log
*.log.*
__pycache__/
dernier-rapport.txt
derniere-position
</syntaxhighlight>

Les archives d'incidents ne doivent pas être déposées dans SVN.

== Maintenance du dispositif ==

En cas de modification des scripts :

# Conserver une copie de la version précédente.
# Modifier le script concerné.
# Vérifier sa syntaxe.
# Tester son fonctionnement.
# Mettre à jour la documentation.
# Enregistrer la nouvelle version dans SVN.

En cas de modification des unités systemd :

<syntaxhighlight lang="bash">
systemctl daemon-reload
</syntaxhighlight>

Vérifier ensuite les timers.

== Références ==

* [[Maintenance et mises à jour de l'infrastructure AJLSM]]
* Documentation Debian APT.
* Documentation systemd.
* Documentation Proxmox VE.
* Documentation Ubuntu.

Supervision des mises à jour de l'infrastructure AJLSM - Historique des versions

Jlarvers le 14 octobre 2026 à 11:14

Jlarvers : /* Architecture */

Jlarvers le 14 octobre 2026 à 06:24

Jlarvers : /* Supervision des mises à jour de l'infrastructure AJLSM */

Jlarvers : Page créée avec « = Supervision des mises à jour de l'infrastructure AJLSM = {| class="wikitable" ! Élément ! Information |- | Serveur de supervision | Saturne3 |- | Systèmes surveill... »

Jlarvers : /* Architecture */

Jlarvers : /* Supervision des mises à jour de l'infrastructure AJLSM */

Jlarvers : Page créée avec « = Supervision des mises à jour de l'infrastructure AJLSM = {| class="wikitable" ! Élément ! Information |- | Serveur de supervision | Saturne3 |- | Systèmes surveill... »