# Composer le runbook

Décider des gestes de chaque machine avant de lancer la vague.

## Trois phases autour de la bascule

Le runbook est la liste des étapes que chaque machine traverse. C'est le premier onglet de la page d'une vague, **Runbook**. L'encadré **Comment se déroule la migration, et à quoi sert le runbook** le résume en une frise :

| Phase | Quand | Exemples |
|---|---|---|
| **A · Avant l'arrêt de la source** | La source tourne encore | Relever les réglages réseau, installer les pilotes VirtIO sous Windows, retirer les outils VMware en dernier, feu vert du responsable applicatif, sauvegarde vérifiée |
| **Bascule** | Naoshift arrête la source, la destination importe ses disques | La source n'est jamais supprimée |
| **B · Avant le premier démarrage** | La machine est importée, éteinte | Matériel de la destination adapté à l'invité, gestes hors ligne sur son disque |
| **C · Après le premier démarrage** | La machine tourne sur la destination | Agent invité qui répond, réglages réseau réappliqués, outils de la destination, contrôle final |

Naoshift propose les étapes que demande l'inventaire de chaque machine, chacune avec sa raison : système, cartes réseau, destination. Il ne décide jamais d'après le nom d'une plateforme.

## Qui fait chaque étape

Chaque étape porte un badge :

- **Naoshift contrôle** : Naoshift lit ce qu'il sait déjà, sans rien toucher ;
- **Naoshift** : Naoshift le fait, et en garde la preuve ;
- **Dans l'invité** : l'étape s'exécute dans la machine, avec son compte ;
- **Vous** : vous le faites, puis vous le cochez.

## Les étapes

1. Dans l'assistant, l'étape **Runbook** montre déjà ce que Naoshift proposera, phase par phase. Quand une étape est la vôtre, ou s'exécute dans l'invité, l'assistant recommande **Préparer d'abord le runbook, lancer plus tard**.
2. Sur la page de la vague, relisez les étapes proposées. Gardez, retirez, réordonnez dans une phase, ou ajoutez une étape manuelle avec **Ajouter une étape**.
3. Rendez une étape bloquante si la migration doit attendre qu'elle soit cochée, facultative sinon.
4. Si des étapes s'exécutent dans les invités, renseignez le compte sous **Compte dans les invités de la source**.
5. La carte **Ce qu'il reste à faire**, en haut de la page, dit ce qui manque encore. Quand plus rien ne manque, lancez la vague : le runbook est figé à cet instant, et chaque machine part avec sa propre liste.

## Le compte dans les invités

Les étapes de la phase A qui s'exécutent dans l'invité demandent un compte administrateur, ou `root` (ou `sudo` sans mot de passe) sous Linux. Posez-le pour toute la vague, ou pour une machine. Il est chiffré, n'est plus jamais affiché ni écrit dans un journal, et il est effacé à la fin de la vague.

L'accès passe par SSH depuis votre collecteur. Le mot de passe ne part que vers une empreinte de serveur épinglée : la première étape lancée sans empreinte est refusée, et donne l'empreinte à épingler. La voie VMware Guest Operations est proposée, mais pas encore éprouvée.

Après le premier démarrage, les gestes passent par l'agent invité de la destination, quand elle en a un. Ce qui leur manque s'affiche sous **Ce qui manque au runbook**.

> Vers Proxmox VE, certains gestes se font **hors ligne**, sur le disque de la machine importée, sans aucun compte dans l'invité. Quand votre installation le permet, l'écran les propose à la place des gestes équivalents dans l'invité.

## Pendant la vague

La grille **Machines et phases** montre où en est chaque machine, phase par phase. Une case **Vous attend** signale une étape manuelle bloquante à cocher : **Effectuée** ou **Échec**, avec un commentaire si elle a échoué. Une étape bloquante qui échoue avant l'arrêt arrête la migration sans rien avoir touché.

**Déroger** à une étape bloquante demande un administrateur de la société et un motif, gardé dans le journal. **Dispenser** une machine d'une étape aussi.

### Le runbook dit qu'il manque quelque chose

La liste **Ce qui manque au runbook** dit quoi, et qui le lève : Naoshift, vous dans cette vague, ou un administrateur de la société.

### Une étape utile n'est pas disponible

Sous **Pertinentes aussi, pas encore disponibles**, l'écran liste ce qui serait utile sans être encore proposé. En attendant, faites-le à la main, et ajoutez-le comme étape manuelle.

### Faut-il un runbook pour migrer ?

Non. Sans geste, la machine est importée telle quelle, et démarre le plus souvent. Le runbook rend la bascule prévisible : réseau, pilotes, accords, sauvegarde.
