Set-OPS-Public/docs/migration-tenant.md

# Migrer un tenant d'un hébergeur à un autre

> **Recette d'exploitation.** Elle décrit la séquence, les états et les gardes ; elle ne
> décrit pas encore un outil, parce que la séquence doit être éprouvée avant d'être figée
> dans du code. Complète `docs/multi-instances.md` (la fédération) et
> `docs/frontiere-opnsense.md` §2 (qui possède quoi).

## 1. Pourquoi ce document existe

Un **hébergeur** possède le matériel et sert plusieurs **tenants** ; il a en général son
propre tenant par défaut. Un tenant doit pouvoir partir chez un autre hébergeur — sans quoi
la souveraineté qu'on lui promet n'est qu'un mot : **une organisation qui ne peut pas partir
est captive, quelle que soit la licence du logiciel.**

La migration est donc une fonctionnalité de premier plan, pas un cas limite.

## 2. Le modèle : le transfert de nom de domaine

La procédure reprend celle des registraires, qui résout depuis trente ans exactement les
mêmes problèmes. Trois propriétés valent d'être empruntées.

**Le mandat appartient au client.** Le code d'autorisation est remis au titulaire, qui le
donne au registraire entrant. Transposé : ni l'hébergeur sortant ni l'entrant ne peut
déplacer un tenant de sa propre initiative. Un hébergeur ne « cède » pas un client ; un
autre ne le « réclame » pas.

**Le verrou par défaut.** Un domaine est verrouillé ; le déverrouiller est un geste
explicite. Un tenant l'est aussi : pas de migration silencieuse.

**Deux actes délibérés, chez deux parties**, et une trace de qui a libéré et qui a reçu.

### Là où l'analogie casse, et par quoi on la remplace

| Le monde des domaines | Set-OPS | Substitution |
|---|---|---|
| un **registre** central arbitre | rien de central, par construction | le mandat est **signé** par le tenant, vérifié contre une clé publique inscrite dans son plan — donc versionnée et publique |
| le domaine ne porte **aucune donnée** | boîtes, dépôts, bases | un **gel** + un instantané restic ; c'est là qu'est le vrai risque |
| fenêtre d'objection | — | fenêtre de **réversibilité** : le sortant ne détruit rien avant confirmation |

Un secret partagé ne suffirait pas : transmis à l'hébergeur entrant, il ne lui prouve rien —
il pourrait venir du sortant. Une signature, si. C'est plus solide que l'original, et sans
tiers de confiance.

## 3. La règle qui commande tout l'ordre

> **Le receveur doit être prouvé prêt avant que quoi que ce soit ne gèle.**

Construire chez l'entrant pendant que le sortant sert normalement ramène l'interruption au
seul rattrapage final. Geler d'abord et construire ensuite coûterait des heures d'arrêt pour
une opération qui n'en vaut que quelques minutes.

Cette règle n'est pas un conseil : c'est une **garde de transition** — l'état `gelé` est
inaccessible tant que l'état `préparé` n'est pas prouvé.

## 4. Les états d'un tenant

| État | Ce qui est vrai | Comment on en sort |
|---|---|---|
| **verrouillé** | régime normal, aucune migration en cours | un mandat signé apparaît |
| **mandaté** | le tenant a signé ; l'entrant peut commencer | l'entrant a construit |
| **préparé** | l'entrant est déployé, restauré (données tièdes) et **prouvé** — mais **pas public** | *garde : preuves vertes chez l'entrant* |
| **gelé** | le sortant est en lecture seule ; capture du delta | delta restauré chez l'entrant |
| **basculé** | le DNS public pointe l'entrant, qui sert ; **le sortant reste gelé** | l'entrant confirme le service |
| **libéré** | le sortant a **révoqué** ses accès ; horloge de rétention lancée | fin de rétention |
| **purgé** | le sortant a détruit sa copie | — |

La réversibilité vit entre **préparé** et **libéré** : tant que le sortant n'a pas révoqué,
on rentre. Elle vient gratuitement du fait que tout l'adressage dérive d'un seul chiffre.

## 5. La séquence

### Étape 0 — le mandat (chez le tenant)

L'organisation signe une déclaration nommant l'hébergeur entrant. L'entrant la vérifie contre
la clé publique du plan. **Sans mandat vérifié, rien ne commence.**

### Étape 1 — préparer le terrain (chez le sortant, sans interruption)

**Abaisser le TTL** des enregistrements publics du tenant. C'est le geste qu'on oublie
systématiquement, et il conditionne tout : posé à l'étape 6, la bascule traînera des heures
quoi qu'on fasse ; posé maintenant, elle prendra le temps du nouveau TTL.

Vérifier que les sauvegardes du tenant sont saines et récentes — la migration s'appuie
entièrement dessus (`serveur_backup` / `client_backup`).

### Étape 2 — construire chez l'entrant (sans interruption)

1. **Choisir un index libre** dans la fédération de l'entrant (`make instances` le montre ;
   la preuve **P21** refuse une collision). S'il diffère de l'ancien, *tout* l'adressage
   change — IP, VLAN, VMID — et c'est **une seule ligne à changer**, puis `make instancier`.
2. **Vérifier que la fabric de l'entrant porte le tenant** : plage VLAN disponible, lien de
   transit présent, zones du plan couvertes (`make underlay`, preuve **P23**).
3. **Créer et déployer** la flotte du tenant chez l'entrant.
4. **Restaurer** depuis un instantané restic *tiède* — les données auront quelques jours ;
   c'est voulu, le rattrapage viendra à l'étape 5.

Pendant tout ce temps, le sortant sert normalement. Personne ne voit rien.

### Étape 3 — prouver l'entrant, sans le rendre public

Faire passer la batterie de preuves et la recette **contre les adresses de l'entrant**, pas
par le DNS public.

C'est le point délicat de toute la procédure : le tenant tourne alors **aux deux endroits**,
mais un seul doit servir. Si l'entrant répondait publiquement, le courrier arriverait des deux
côtés et l'identité se dédoublerait. Il faut donc un chemin de vérification qui ne dépende pas
du DNS public — résolution locale, `/etc/hosts` du poste de vérification, ou vues DNS
séparées. **Ce chemin est un prérequis de cette étape** : sans lui, pas de vérification, donc
pas de garde, donc pas de gel.

### Étape 4 — geler (chez le sortant)

*Garde : l'étape 3 est verte.*

Le tenant passe en lecture seule. L'interruption commence **ici**, et seulement ici.

### Étape 5 — rattraper le delta

Instantané restic incrémental, restauré chez l'entrant. Court, parce que le gros est déjà
passé à l'étape 2.

### Étape 6 — basculer

Le DNS public pointe l'adresse publique de l'entrant. Le TTL abaissé à l'étape 1 fait son
office. L'interruption se termine à la propagation.

**Le sortant reste gelé.** Le dégeler maintenant créerait deux copies vivantes du même tenant :
un courriel livré chez l'un, un fichier déposé chez l'autre, et plus aucune vérité. Il ne
dégèle qu'en cas de retour arrière (§6), jamais « au cas où ».

### Étape 7 — confirmer (chez l'entrant)

Le service répond publiquement, les preuves passent, le tenant valide. **C'est ce qui autorise
l'étape 8, rien d'autre.**

### Étape 8 — libérer (chez le sortant)

**Révoquer, pas transmettre.** La voûte voyage avec le dépôt, chiffrée, mais son mot de passe
est celui de l'opérateur sortant. Migrer proprement ne consiste pas à le communiquer : c'est
**re-cléer chez l'entrant** — nouveau mot de passe de voûte, rotation des secrets applicatifs,
révocation des certificats et des clés SSH émis par le sortant.

C'est l'équivalent du re-verrouillage chez le nouveau registraire. Sans lui, l'ancien
hébergeur garde **à vie** l'accès aux secrets d'un client parti, et aucune procédure ne
rattrape ça après coup.

Puis rétention — durée convenue — avant purge.

## 6. Le retour arrière

La réversibilité n'est pas uniforme : elle change de nature à la bascule. Trois régimes, trois
réponses différentes — et il faut les avoir décidées avant, pas à trois heures du matin.

### Avant le gel — sans conséquence

Les étapes 2 et 3 échouent chez l'entrant. Le sortant n'a jamais cessé de servir et ignore
tout de l'affaire. On corrige ou on jette la construction, on recommence. Aucun utilisateur
n'a rien vu.

C'est précisément ce que la règle du §3 achète : **tout ce qui peut échouer sans coût échoue
avant le gel.**

### Pendant le gel, avant la bascule — dégeler, et c'est tout

Le rattrapage du delta échoue, ou une vérification de dernière minute déraille. L'entrant ne
sert pas encore : rien n'y a été écrit qui compte.

On dégèle le sortant. L'interruption aura duré le temps du gel — quelques minutes. La
construction chez l'entrant reste debout pour un nouvel essai.

### Après la bascule — ce n'est plus un retour, c'est une migration inverse

Dès que l'entrant sert, les utilisateurs y écrivent : courriels reçus, fichiers déposés,
commits poussés. **Ces données n'existent nulle part ailleurs.** Repointer simplement le DNS
vers le sortant les perdrait — et silencieusement, ce qui est pire.

Le retour arrière devient donc une migration dans l'autre sens, avec la même mécanique :
geler l'entrant, capturer le delta, le restaurer chez le sortant, repointer le DNS, dégeler le
sortant. C'est faisable — c'est le même outillage — mais ça se prépare, ça ne s'improvise pas.

Bonne nouvelle : le sortant est **encore gelé** (étape 6), donc il n'a pas divergé de son côté.
Le delta est à sens unique, et la fusion n'a pas lieu d'être.

### Ce qui en découle

**Les critères de confirmation se définissent avant l'étape 6, pas pendant l'étape 7.** La
bascule est le moment où le coût d'un échec change d'ordre de grandeur ; décider *ensuite* ce
qui compte comme « ça marche » revient à se donner raison après coup.

**Deux points de non-retour**, à ne pas confondre :

| Point | Ce qu'on perd | Ce qu'il reste |
|---|---|---|
| **la bascule** (étape 6) | le retour gratuit | le retour par migration inverse |
| **la purge** (fin de rétention) | la copie du sortant | rien — c'est le vrai point de non-retour |

Entre `libéré` et `purgé`, revenir reste possible mais coûte un second re-clétage : le sortant
a révoqué ses accès, il faudrait les rétablir.

## 7. Ce que la migration ne déplace pas

- **La fabric** : l'underlay appartient à l'hébergeur. Le tenant en change, il n'en emporte
  pas.
- **La frontière** : l'entrant a la sienne. Ses règles pour le tenant se **régénèrent** —
  `make devis-opnsense` est déjà multi-tenant.
- **L'index** : c'est une coordonnée locale à une fédération, pas une propriété du tenant.

## 8. Ce qui reste à trancher

- **Le format du mandat** et l'emplacement de la clé publique du tenant dans son plan.
- **Le chemin de vérification hors DNS public** (étape 3) — le plus structurant.
- **La durée de rétention** avant purge, et qui l'atteste.
- **Les critères de confirmation** de l'étape 7, à fixer par écrit avant la première bascule
  (§6) — c'est ce qui décide si un retour arrière s'impose.
- **L'outillage** : un `devis-migration` dériverait l'index retenu, l'adressage résultant et
  la compatibilité de fabric, et refuserait sur un point bloquant — dans l'idiome du dépôt :
  dériver un plan, le prouver, laisser l'humain l'appliquer. À écrire **après** avoir joué la
  séquence au moins une fois.