Playbooks de Service
Les playbooks de service déploient et configurent l'infrastructure OmniCore. Situés dans le répertoire services/.
Hiérarchie des Playbooks
Les playbooks sont structurés de manière hiérarchique pour permettre des déploiements rapides et ciblés :
all.yml
├── setup_users.yml
├── apt_cache.yml
├── dns.yml
├── common.yml
├── license_server.yml
├── monitoring.yml
│ └── grafana.yml
├── epc.yml
│ ├── common.yml
│ ├── omnimme.yml
│ ├── omnisgwc.yml
│ ├── omnipgwc.yml
│ ├── upf.yml
│ ├── omnihss.yml
│ └── omnidra.yml
├── ims.yml
│ ├── pcscf.yml
│ ├── icscf.yml
│ ├── scscf.yml
│ ├── as.yml
│ ├── omnimessage.yml
│ ├── smsc.yml
│ └── omnisep.yml
├── omniepdg.yml
├── omniss7.yml
├── ocs.yml
├── crm.yml
├── ran_monitor.yml
└── health_check.yml
Exécutez uniquement ce dont vous avez besoin. Déployer un seul composant (par exemple, omnimme.yml) prend quelques secondes. Exécuter all.yml sur 50 hôtes prend plus de temps mais gère tout. Utilisez --limit pour restreindre davantage la portée.
Référence Rapide
Playbooks de Niveau Supérieur
| Playbook | Portée | Description |
|---|---|---|
all.yml | Réseau complet | Déploiement complet : utilisateurs, DNS, surveillance, EPC, IMS, OCS, CRM |
epc.yml | Noyau de Paquet | MME, SGW-C, PGW-C, UPF, HSS, DRA |
ims.yml | Voix/IMS | P/I/S-CSCF, Serveur d'Application, XCAP, Messagerie |
ocs.yml | Facturation | CGrateS, cluster KeyDB, synchronisation OCS |
monitoring.yml | Observabilité | Prometheus, Grafana, exportateurs, HOMER |
Playbooks d'Infrastructure
| Playbook | Description |
|---|---|
common.yml | Configuration de base du système d'exploitation, paquets, NTP, agents de journalisation |
setup_users.yml | Comptes utilisateurs locaux et clés SSH |
dns.yml | Déploiement du serveur DNS |
license_server.yml | Serveur de licence OmniCore |
netplan.yml | Configuration de l'interface réseau |
firewall.yml | Règles iptables/nftables |
apt_cache.yml | Miroir APT local (si activé) |
Composants EPC
| Playbook | Composant | Description |
|---|---|---|
omnimme.yml | OmniMME | Entité de Gestion de Mobilité (4G) |
omnisgwc.yml | OmniSGW-C | Plan de Contrôle de la Passerelle de Service |
omnipgwc.yml | OmniPGW-C | Plan de Contrôle de la Passerelle PDN |
upf.yml / omniupf.yml | OmniUPF | Fonction de Plan Utilisateur (SGW-U/PGW-U combiné) |
omnihss.yml / hss.yml | OmniHSS | Serveur d'Abonnés à Domicile |
omnidra.yml | OmniDRA | Agent de Routage Diameter |
omnitwag.yml | OmniTWAG | Passerelle d'Accès Sans Fil de Confiance |
omniepdg.yml | OmniEPDG | Passerelle de Données de Paquet Évoluée (Appels WiFi) |
gtp_proxy.yml | Proxy GTP | Proxy de trafic GTP |
Composants IMS
| Playbook | Composant | Description |
|---|---|---|
pcscf.yml | P-CSCF | Fonction de Contrôle de Session d'Appel Proxy |
icscf.yml | I-CSCF | CSCF Interrogateur |
scscf.yml | S-CSCF | CSCF de Service |
as.yml | OmniTAS | Serveur d'Application de Téléphonie |
omnisep.yml | OmniSEP | XCAP, Serveur de Droit, BSF, Messagerie Visuelle |
omnimessage.yml | OmniMessage | Contrôleur SMS-sur-IP |
smsc.yml | SMSC | Centre de Service de Messages Courts |
Services de Support
| Playbook | Description |
|---|---|
ocs.yml | Système de Facturation en Ligne (CGrateS + KeyDB) |
crm.yml | Portail de gestion des clients |
omniss7.yml | Passerelle SS7/SIGTRAN |
homer.yml | Capture de paquets SIP/Diameter |
grafana.yml | Tableaux de bord Grafana et alertes |
promtail.yml | Envoi de journaux à Loki |
ran_monitor.yml | Intégration de surveillance RAN |
Provisionnement de VM
| Playbook | Description |
|---|---|
proxmox.yml | Créer des VM sur Proxmox VE |
proxmox_lxc.yml | Créer des conteneurs LXC (lab/test) |
proxmox_delete.yml | Supprimer des VM/LXC Proxmox |
Opérations
| Playbook | Description |
|---|---|
backup.yml | Sauvegarder les bases de données et les configurations |
reboot.yml | Redémarrage contrôlé des hôtes |
shutdown.yml | Arrêt en douceur |
apt_update.yml | Mettre à jour les paquets |
apt_refresh_metadata.yml | Rafraîchir les métadonnées du cache APT |
speedtest.yml | Test de débit réseau |
Playbooks de Restauration
| Playbook | Description |
|---|---|
restore_applicationserver.yml | Restaurer OmniTAS à partir de la sauvegarde |
restore_omnimessage_controller.yml | Restaurer OmniMessage à partir de la sauvegarde |
restore_smsc.yml | Restaurer SMSC à partir de la sauvegarde |
Utilisation
Déployer Tout
ansible-playbook -i hosts/customer/host_files/production.yml services/all.yml
Déployer un Sous-Système Spécifique
# Juste le noyau de paquet
ansible-playbook -i hosts/customer/host_files/production.yml services/epc.yml
# Juste IMS/voix
ansible-playbook -i hosts/customer/host_files/production.yml services/ims.yml
Déployer un Composant Unique
# Mettre à jour uniquement le MME
ansible-playbook -i hosts/customer/host_files/production.yml services/omnimme.yml
# Mettre à jour uniquement la surveillance
ansible-playbook -i hosts/customer/host_files/production.yml services/monitoring.yml
Limiter à des Hôtes Spécifiques
# Exécuter all.yml mais seulement sur un hôte
ansible-playbook -i hosts/customer/host_files/production.yml services/all.yml --limit mme01
# Exécuter sur plusieurs hôtes spécifiques
ansible-playbook -i hosts/customer/host_files/production.yml services/all.yml --limit "mme01,hss01"
# Exécuter sur un groupe
ansible-playbook -i hosts/customer/host_files/production.yml services/all.yml --limit mme
Documentation Connexe
- Architecture de Déploiement - Flux de travail global de déploiement
- Configuration du Fichier Hosts - Définir l'infrastructure
- Configuration des Variables de Groupe - Personnalisation
- Playbooks Utilitaires - Outils opérationnels (vérification de l'état, restauration, etc.)
- Surveillance & Observabilité - Grafana, Prometheus, alertes