# 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
```