Add maintenance procedures for Docker, Ubuntu, Windows, and HYCU
- Created a new document for updating Docker Swarm nodes. - Added a guide for updating Ubuntu via APT-Cacher-NG. - Introduced a procedure for updating Ubuntu OS on client platforms using OPS_ANSIBLE. - Documented the deployment and usage of WSUS On-Prem for Windows updates. - Added a procedure for updating Windows OS via centralized WSUS. - Created a patching procedure using N-Central for Windows systems. - Developed a restoration procedure for HYCU. - Documented the configuration steps for setting up a HYCU server.
This commit is contained in:
Maxime BOURIEAU
@@ -0,0 +1,166 @@
|
||||
# Mise à jour d'Ubuntu via APT-Cacher-NG
|
||||
|
||||
## 1. Déployer le service APT-Cacher-NG
|
||||
|
||||
### 1.1 Flux réseau requis
|
||||
|
||||
Pour mettre à jour les serveurs Linux via le proxy APT, ouvrir les flux suivants.
|
||||
|
||||
**Cas SI-OPS :**
|
||||
|
||||
| Source | Destination | Port |
|
||||
| --- | --- | --- |
|
||||
| `GRP_SERVER_LINUX` | `GRP_TELEML` | `9999` |
|
||||
| `DMZ_TELEM` | `OPS-APT-CACHER` (`172.31.232.6`) | `9999` |
|
||||
|
||||
**Cas TELEML avec OpenVPN :**
|
||||
|
||||
| Source | Destination | Port |
|
||||
| --- | --- | --- |
|
||||
| `GRP_SERVER_LINUX` | `GRP_TELEML` | `9999` |
|
||||
| `DMZ_TELEM` | Internet (`37.58.143.231`) | `49494` |
|
||||
|
||||
Ces règles de pare-feu sont normalement configurées lors du déploiement de la TELEML sur l'infrastructure. Après le déploiement de la TELEML et la mise en place du tunnel OpenVPN vers le SI Systel, vérifier que la règle entre la TELEML et Gothmog autorise le téléchargement des mises à jour.
|
||||
|
||||
### 1.2 Installer et configurer APT-Cacher-NG sur la TELEML
|
||||
|
||||
Le service APT-Cacher-NG doit être installé sur la TELEML. Les modèles TELEML sont généralement déjà configurés. Si le service n'est pas installé, exécuter :
|
||||
|
||||
```bash
|
||||
apt-get install apt-cacher-ng
|
||||
```
|
||||
|
||||
Modifier le fichier `/etc/apt-cacher-ng/acng.conf` avec les paramètres suivants :
|
||||
|
||||
```text
|
||||
CacheDir: /var/cache/apt-cacher-ng #Répertoire Cache
|
||||
LogDir: /var/log/apt-cacher-ng #Répertoire Log
|
||||
#Port:3142
|
||||
PassThroughPattern:.*
|
||||
Port:9999 #Port du Proxy
|
||||
Proxy=172.31.232.6:9999
|
||||
VerboseLog: 1
|
||||
ReportPage: acng-report.html #Page de Gestion Nettoyage du Cache (besoin d’apache)
|
||||
ExTreshold: 4 #jour avant suppression de ficher non référencer
|
||||
```
|
||||
|
||||
## 2. Configurer le proxy sur les machines Linux clientes
|
||||
|
||||
Pour rediriger les requêtes de mise à jour vers la TELEML, modifier le fichier `/etc/apt/apt.conf` :
|
||||
|
||||
```bash
|
||||
nano /etc/apt/apt.conf
|
||||
```
|
||||
|
||||
Le fichier doit contenir les paramètres suivants, en remplaçant `IP-DE-LA-TELEML` par l'adresse IP de la TELEML concernée :
|
||||
|
||||
```text
|
||||
Acquire::http {
|
||||
Proxy "http://IP-DE-LA-TELEML:9999";
|
||||
};
|
||||
```
|
||||
|
||||
## 3. Mettre à jour les machines Linux
|
||||
|
||||
> **Important : effectuer une sauvegarde de la machine avant toute tentative de mise à jour.**
|
||||
|
||||
### 3.1 Précaution pour les machines Swarm/Worker/Manager sous Ubuntu 18.04 ou 20.04
|
||||
|
||||
Avant de lancer les mises à jour sur une machine Swarm/Docker, commenter dans les fichiers du répertoire `/etc/apt` toutes les sources qui ne concernent pas le système Ubuntu, notamment celles de GlusterFS, Docker et Ansible. Les listes de sources doivent uniquement contenir les dépôts du système Ubuntu.
|
||||
|
||||
Sur les machines Swarm, arrêter les services suivants avant toute mise à jour :
|
||||
|
||||
```bash
|
||||
service glusterfs stop
|
||||
service dockerd stop
|
||||
```
|
||||
|
||||
### 3.2 Installer les mises à jour de la version actuelle
|
||||
|
||||
Commencer par installer les dernières mises à jour disponibles pour la version Ubuntu actuellement installée :
|
||||
|
||||
```bash
|
||||
apt-get update
|
||||
sudo apt-get install -y software-properties-common
|
||||
sudo apt-get install update-manager-core
|
||||
sudo apt dist-upgrade --fix-missing
|
||||
```
|
||||
|
||||
Pendant la mise à jour, l'OS peut poser des questions. Lire chaque demande et, lorsque le choix est proposé, conserver de préférence la configuration actuelle (touche **N**), conformément à la consigne de la procédure.
|
||||
|
||||
La mise à jour peut prendre un certain temps, selon la date de la dernière mise à jour. Une fois l'opération terminée, redémarrer la machine si nécessaire.
|
||||
|
||||
### 3.3 Mettre à niveau la version d'Ubuntu
|
||||
|
||||
Les versions Ubuntu citées dans cette procédure sont :
|
||||
|
||||
- Ubuntu 16.04 LTS
|
||||
- Ubuntu 18.04 LTS
|
||||
- Ubuntu 20.04 LTS
|
||||
- Ubuntu 22.04 LTS
|
||||
|
||||
La montée de version se fait par paliers. Par exemple, il n'est pas possible de passer directement d'Ubuntu 18.04 à Ubuntu 22.04.
|
||||
|
||||
Avant de commencer, vérifier la version actuelle :
|
||||
|
||||
```bash
|
||||
cat /etc/lsb-release
|
||||
```
|
||||
|
||||
Vérifier également que le système est configuré pour suivre la branche LTS :
|
||||
|
||||
```bash
|
||||
cat /etc/update-manager/release-upgrades
|
||||
```
|
||||
|
||||
Exécuter ensuite les commandes correspondant au palier voulu.
|
||||
|
||||
**Ubuntu 16.04 vers Ubuntu 18.04 :**
|
||||
|
||||
```bash
|
||||
sudo sed -i 's/xenial/bionic/g' /etc/apt/sources.list
|
||||
sudo apt update && sudo apt -y dist-upgrade
|
||||
```
|
||||
|
||||
**Ubuntu 18.04 vers Ubuntu 20.04 :**
|
||||
|
||||
```bash
|
||||
sudo dpkg --force depends -P lxd; sudo dpkg --force depends -P lxd-client
|
||||
sudo sed -i 's/bionic/focal/g' /etc/apt/sources.list
|
||||
sudo apt update && sudo apt -y dist-upgrade
|
||||
```
|
||||
|
||||
**Ubuntu 20.04 vers Ubuntu 22.04 :**
|
||||
|
||||
```bash
|
||||
sudo sed -i 's/focal/jammy/g' /etc/apt/sources.list
|
||||
sudo apt update && sudo apt -y dist-upgrade
|
||||
```
|
||||
|
||||
**Ubuntu 22.04 vers Ubuntu 24.04 :**
|
||||
|
||||
```bash
|
||||
sudo sed -i 's/jammy/noble/g' /etc/apt/sources.list
|
||||
sudo sed -i 's/jammy/noble/g' /etc/apt/sources.list.d/*.list
|
||||
```
|
||||
|
||||
La montée de version peut prendre plusieurs minutes. Redémarrer la machine à la fin de l'opération. Pendant la mise à niveau, lire attentivement les questions de l'OS et conserver de préférence la configuration actuelle (touche **N**), conformément à la consigne de la procédure.
|
||||
|
||||
## 4. Dépannage
|
||||
|
||||
### Erreurs 500 ou 503 pendant `apt update`
|
||||
|
||||
Si des erreurs 500 ou 503 se produisent pendant `apt update`, vider le cache de la TELEML :
|
||||
|
||||
```bash
|
||||
sudo systemctl stop apt-cacher-ng
|
||||
sudo rm -rf /var/cache/apt/*
|
||||
sudo rm -rf /var/cache/apt-cacher-ng/*
|
||||
sudo systemctl start apt-cacher-ng
|
||||
```
|
||||
|
||||
Puis purger le cache d'APT-Cacher-OPS depuis la page suivante :
|
||||
|
||||
<http://172.31.232.6:9999/acng-report.html>
|
||||
|
||||
Il peut être nécessaire de répéter cette opération plusieurs fois.
|
||||
+78
@@ -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
|
||||
```
|
||||
Reference in New Issue
Block a user