50 lines
3.4 KiB
Markdown
50 lines
3.4 KiB
Markdown
|
# Runbook — Labs et stacks Heat (étape 10)
|
||
|
|
|
||
|
|
## Où sont les choses
|
||
|
|
|
||
|
|
| Élément | Emplacement |
|
||
|
|
|---|---|
|
||
|
|
| Source éditoriale des labs | `paillasse-contenus/` (dépôt de contenu, pas de code) |
|
||
|
|
| Copie de travail lue par le portail | `labs/` à la racine de ce dépôt → synchronisée vers `/opt/labs` sur le serveur |
|
||
|
|
| Lecture d'un `lab.yaml` | `portail/app/Services/Labs/DefinitionLab.php` |
|
||
|
|
| Traduction lab → gabarit Heat | `portail/app/Services/OpenStack/GenerateurTemplateHeat.php` |
|
||
|
|
| Authentification OpenStack partagée | `portail/app/Services/OpenStack/KeystoneAuth.php` (mot de passe, pas application credential — voir [ADR 0002](../adr/0002-mot-de-passe-pour-heat.md)) |
|
||
|
|
| Appels Heat | `portail/app/Services/OpenStack/HeatClient.php` |
|
||
|
|
| Création de stack (à l'admission) | `portail/app/Jobs/CreerStackLab.php` |
|
||
|
|
| Suppression de stack (à l'expiration ou à la fin) | `portail/app/Jobs/SupprimerStackLab.php` |
|
||
|
|
| Expiration automatique | commande `labs:expirer-sessions` (`portail/app/Console/Commands/ExpirerSessionsLab.php`), planifiée chaque minute (`routes/console.php` + cron `www-data` sur le serveur) |
|
||
|
|
| Worker qui exécute les jobs | service systemd `portail-worker` (`queue:work`) |
|
||
|
|
|
||
|
|
## Ajouter un nouveau lab
|
||
|
|
|
||
|
|
1. Le lab existe déjà en tant que contenu dans `paillasse-contenus/{id}/lab.yaml`, avec un format `reseaux: [{nom, cidr}]` et `machines: [{nom, image, flavor, reseaux: [...]}]` (l'ordre des réseaux d'une machine décide de l'ordre des interfaces : la première listée sera `ens3`, la suivante `ens4`, etc.).
|
||
|
|
2. Copier (ou faire relire) ce `lab.yaml` dans `labs/{id}/lab.yaml` de ce dépôt.
|
||
|
|
3. Vérifier que les images et flavors nommés existent déjà dans OpenStack (`openstack image list`, `openstack flavor list`).
|
||
|
|
4. Déployer (`ansible-playbook portail.yml`) : la tâche `04-labs.yml` synchronise `labs/` vers `/opt/labs` sur le serveur.
|
||
|
|
5. Tester : admettre un élève de test sur ce lab, vérifier que la stack passe en `CREATE_COMPLETE` et que chaque terminal s'ouvre.
|
||
|
|
|
||
|
|
## Déclencher l'expiration manuellement
|
||
|
|
|
||
|
|
```
|
||
|
|
ssh paillasse "cd /var/www/portail && sudo -u www-data HOME=/tmp php8.3 artisan labs:expirer-sessions"
|
||
|
|
```
|
||
|
|
|
||
|
|
## Inspecter une stack en cours sur le serveur
|
||
|
|
|
||
|
|
```
|
||
|
|
sudo -i
|
||
|
|
export PATH=/opt/kolla-venv/bin:$PATH
|
||
|
|
export OS_CLIENT_CONFIG_FILE=/etc/kolla/clouds-paillasse.yaml
|
||
|
|
export OS_CLOUD=paillasse-service
|
||
|
|
openstack stack list
|
||
|
|
openstack stack show lab-session-{id}
|
||
|
|
openstack server list
|
||
|
|
```
|
||
|
|
|
||
|
|
## Pièges rencontrés
|
||
|
|
|
||
|
|
- **Heat refuse de créer une stack avec une application credential** (`Delegated tokens cannot manage trusts`) : Heat a besoin de créer un trust Keystone, qu'un jeton déjà délégué ne peut jamais déléguer à son tour. Le compte `paillasse-service` s'authentifie par mot de passe pour cette raison — voir [ADR 0002](../adr/0002-mot-de-passe-pour-heat.md). Ne jamais revenir à une application credential pour ce compte.
|
||
|
|
- **Après un déploiement de code, le worker doit redémarrer** (`notify: redémarrer le worker de file` sur la tâche de synchronisation) : un `queue:work` déjà lancé garde l'ancien code en mémoire tant qu'il n'est pas relancé.
|
||
|
|
- `sudo -u www-data php artisan ...` échoue sans `HOME=/tmp` (« Writing to directory /var/www/.config/psysh is not allowed ») : `www-data` n'a pas de `$HOME` inscriptible sur ce serveur.
|
||
|
|
- Une stack Heat appartient à une session de lab (un élève, une tentative), jamais à une classe : ne pas chercher à réutiliser une stack entre deux élèves ou deux tentatives.
|