life-noc/docs/deploiement-from-scratch.md
2026-03-13 16:57:50 -04:00

80 lines
2 KiB
Markdown

# Déploiement from scratch Debian 12
Objectif : partir d'une **VM Debian 12 vanille** disposant seulement :
- d'un utilisateur `ansible`
- d'une paire de clés SSH fonctionnelle
- d'un accès réseau aux dépôts Debian et Icinga
et obtenir automatiquement :
- MariaDB
- Icinga 2
- IDO MySQL
- Apache
- Icinga Web 2
- module Business Process
- Life-NOC déployé et généré
## Préparation côté poste de contrôle
Depuis la machine Debian 12 qui lance Ansible :
```bash
cp ansible/inventory.example ansible/inventory
cp ansible/group_vars/all.yml.example ansible/group_vars/all.yml
```
Puis ajuster :
- l'adresse IP ou le FQDN de la cible dans `ansible/inventory`
- les mots de passe dans `ansible/group_vars/all.yml`
- au besoin le nom DNS final via `life_noc_fqdn`
## Lancement
```bash
make bootstrap
```
ou directement :
```bash
ansible-playbook -i ansible/inventory ansible/site.yml
```
## Résultat attendu
À la fin du playbook :
- Icinga 2 est actif
- Icinga Web 2 est servi par Apache
- le backend IDO est branché sur MariaDB
- Life-NOC est généré depuis `domains.yaml`
- la configuration Life-NOC est déployée dans `/etc/icinga2/conf.d/life-noc`
- le plugin mock est installé
- l'utilisateur d'administration Icinga Web 2 existe
## URLs utiles
Selon le vhost Apache de la cible :
- `http://<hote>/icingaweb2`
- `http://<hote>/icingaweb2/monitoring/host/show?host=life-noc`
- `http://<hote>/icingaweb2/monitoring/list/services?host_name=life-noc`
## Identifiants
L'utilisateur initial d'administration est piloté par :
- `life_noc_admin_user`
- `life_noc_admin_password`
## Remarque BPM
Le module Business Process est installé et activé.
Le dépôt déploie en plus l'artefact généré `bpm/life-noc.json` sous :
- `/etc/icingaweb2/modules/businessprocess/processes/life-noc.json`
Cela prépare l'intégration BPM côté dépôt. Selon l'usage exact retenu dans l'interface, l'import ou l'adaptation finale de cet artefact peut être ajusté ensuite sans remettre en cause le bootstrap complet de la plateforme.