Add documentation for updating Ubuntu systems via OPS_ANSIBLE

2026-10-14 16:03:11 +02:00
parent 9ba7fce201
commit 77be4512af
1 changed files with 78 additions and 0 deletions
@@ -0,0 +1,78 @@
+# Mise à jour des systèmes Ubuntu via OPS_ANSIBLE
+
+## Prérequis
+
+- La plateforme du client doit être raccordée au SI-OPS conformément à la nouvelle architecture.
+- La TELEML du client doit être configurée pour distribuer les mises à jour via APT-Cacher-NG. Consulter le [manuel de mise à jour Ubuntu via APT-Cacher-NG](https://tfs2k18.systel-sa.com/tfs/Systel/Etudes/_wiki/wikis/Etudes.wiki/1350/-MANUEL-Mise-a-jour-Ubuntu-via-APT-CACHER-utilisation-et-déploiement-MANUEL-).
+- Le DNS des machines Linux de la plateforme doit fonctionner, et une entrée DNS doit exister dans l'Active Directory pour chaque VM.
+
+## 1. Se connecter à l'interface Semaphore
+
+Ouvrir Semaphore à l'adresse suivante :
+
+<https://ansible-semaphore-ops-t1.systel-sa.com/auth/login>
+
+Se connecter avec le compte personnel fourni par l'équipe SSI. En cas d'oubli du mot de passe, demander sa réinitialisation à l'équipe SSI.
+
+Stocker les identifiants de manière sécurisée dans un gestionnaire de mots de passe, par exemple KeePass.
+
+## 2. Accès et permissions
+
+Les comptes utilisateurs ont accès aux menus suivants :
+
+- Tableau de bord
+- Modèles de tâches
+- Inventaire
+- Environnement
+- Magasin de clés
+- Dépôts
+- Équipe
+
+Les utilisateurs peuvent également effectuer les actions suivantes :
+
+- Démarrer des tâches depuis **Modèles de tâches**.
+- Consulter les résultats des tâches et l'historique des actions.
+- Modifier leur identifiant, leur adresse e-mail et leur nom.
+- Recevoir des e-mails.
+- Activer ou désactiver le mode sombre.
+
+## 3. Lancer une mise à jour
+
+1. Dans le menu déroulant situé en haut à gauche, sélectionner le SDIS concerné.
+2. Ouvrir **Modèles de tâches**.
+3. Sélectionner le modèle correspondant à l'environnement visé.
+4. Cliquer sur **BUILD** pour lancer la tâche.
+5. Dans la fenêtre qui s'ouvre, ne cocher aucune option pour exécuter normalement la tâche, puis cliquer sur **BUILD**.
+
+L'option **Dry Run** permet de simuler les actions Ansible sans les appliquer. Elle peut être utilisée pour tester la tâche.
+
+À la fin de l'exécution, le statut de la tâche apparaît : **SUCCESS**, **FAILED** ou **STOPPED**. Un récapitulatif indique également le statut de chaque serveur. Sélectionner une tâche pour consulter le détail de son exécution et les actions effectuées ou non.
+
+## 4. Vérifier les mises à jour
+
+Pour suivre localement l'installation des paquets sur un serveur cible, utiliser la commande suivante :
+
+```bash
+tail -f /var/log/dpkg.log
+```
+
+Dans l'interface Semaphore, un statut **Failed** ou **Unreachable** indique une erreur. Les statuts **OK**, **Changed** ou **Skipped** indiquent que la tâche s'est terminée sans erreur bloquante pour l'action concernée.
+
+Pour obtenir de l'aide, contacter l'équipe SSI.
+
+## 5. Dépannage
+
+Si le contrôle de la tâche signale un verrou sur APT, un processus `apt-get` est probablement en cours sur la machine cliente. Arrêter ce processus avant de relancer la tâche Ansible. Deux méthodes sont possibles :
+
+- Redémarrer la machine concernée.
+- Identifier puis arrêter le processus qui verrouille APT :
+
+```bash
+apt-get update
+```
+
+Noter l'identifiant du processus indiqué par la commande, puis le terminer en remplaçant `XXXXXXXXX` par cet identifiant :
+
+```bash
+kill XXXXXXXXX
+```