Voir la source de WSL backup restore image

'''backup/restore image WSL2'''
-----

== 📋 Vérifier les distributions installées ==

Liste les distributions et leur version WSL (1 ou 2) :

<syntaxhighlight lang="powershell">wsl -l -v</syntaxhighlight>
Exemple de sortie :

<pre>  NAME      STATE           VERSION
* Debian    Running         2
  Ubuntu    Stopped         2</pre>
<blockquote>L’astérisque <code>*</code> indique la distro par défaut pour <code>wsl</code> (si tu ne passes pas <code>-d &lt;name&gt;</code>).
</blockquote>

-----

== 🧯 Arrêter proprement avant un backup ==

Pour un export fiable, il est recommandé d’arrêter la distribution :

<syntaxhighlight lang="powershell">wsl --terminate debian</syntaxhighlight>
<blockquote><code>--terminate</code> ferme toutes les sessions de la distro.<br />
Tu peux vérifier que c’est bien stoppé avec <code>wsl -l -v</code>.
</blockquote>

-----

== 💾 Backup (export) ==

Format recommandé (tar) :

<syntaxhighlight lang="powershell">wsl --export debian D:\Backups\debian_backup_2025-01-08.tar</syntaxhighlight>
* <code>debian</code> = nom de la distribution (depuis <code>wsl -l -v</code>)
* <code>D:\Backups\...tar</code> = fichier d’archive créé (rootfs + metadata)

<blockquote>Tu peux compresser le <code>.tar</code> après coup (7zip), mais '''l’import attend un <code>.tar</code>''' (ou <code>.vhdx</code> si tu importes via VHDX, voir plus bas Astuces).
</blockquote>

-----

== 🔁 Restore (import) dans une '''nouvelle''' distro ==

Si tu veux restaurer '''sans toucher''' la distro existante, importe sous un nouveau nom :

<syntaxhighlight lang="powershell">wsl --import debian_restored D:\WSL\debian_restored D:\Backups\debian_backup_2025-01-08.tar</syntaxhighlight>
* <code>debian_restored</code> = nom de la '''nouvelle''' distro WSL
* <code>D:\WSL\debian_restored</code> = dossier où WSL stocke le VHDX
* <code>D:\Backups\debian_backup_2025-01-08.tar</code> = backup réalisé plus haut

Ensuite, force en WSL2 si nécessaire :

<syntaxhighlight lang="powershell">wsl --set-version debian_restored 2</syntaxhighlight>

-----

== 🗑️ Restore '''par-dessus''' une distro existante (même nom) ==

<blockquote>⚠️ '''Destructif''' : supprime totalement la distribution et son disque.
</blockquote>
# Arrête la distro :

<syntaxhighlight lang="powershell">wsl --terminate debian</syntaxhighlight>
<ol start="2" style="list-style-type: decimal;">
<li>'''Supprime''' la distro :</li></ol>

<syntaxhighlight lang="powershell">wsl --unregister debian</syntaxhighlight>
<ol start="3" style="list-style-type: decimal;">
<li>Réimporte '''avec le même nom''' :</li></ol>

<syntaxhighlight lang="powershell">wsl --import debian D:\WSL\debian D:\Backups\debian_backup_2025-01-08.tar
wsl --set-version debian 2</syntaxhighlight>

-----

== 👤 Définir l’utilisateur par défaut après import ==

Selon la distribution, l’import crée parfois un environnement où l’utilisateur par défaut est <code>root</code>.<br />
Tu peux fixer un utilisateur par défaut via '''wsl.conf''' :

Dans la distro importée :

<syntaxhighlight lang="bash">sudo nano /etc/wsl.conf</syntaxhighlight>
Ajoute (ou modifie) :

<syntaxhighlight lang="ini">[user]
default=john</syntaxhighlight>
Puis '''redémarre''' la distro :

<syntaxhighlight lang="powershell">wsl --terminate debian_restored</syntaxhighlight>
<blockquote>Pour certaines distros (Ubuntu de Microsoft Store), il existe aussi une commande spécifique :<br />
<code>ubuntu config --default-user &lt;user&gt;</code> (ne s’applique pas aux imports génériques).
</blockquote>

-----

== 🧭 Chemins utiles (accès croisé Windows ⇄ Linux) ==

* '''Depuis Windows vers Linux''' : <code>\\wsl$\Debian\home\john</code>
* '''Depuis Linux vers Windows''' : <code>cd /mnt/c/Users/&lt;username&gt;/Downloads</code>

<blockquote>Évite de travailler sur des projets '''Linux''' directement dans <code>/mnt/c/...</code> (performances et permissions). Préfère un dossier dans <code>~/</code> côté Linux.
</blockquote>

-----

== 🧪 Démarrer/Tester une distro restaurée ==

Démarrer un shell sur la distro importée :

<syntaxhighlight lang="powershell">wsl -d debian_restored</syntaxhighlight>
Vérifier systemd (si tu l’utilises) :

<syntaxhighlight lang="bash">systemctl --version</syntaxhighlight>
<blockquote>Si systemd n’est pas actif, vérifie <code>wsl.conf</code> côté Windows (fichier <code>%userprofile%\.wslconfig</code>) ou côté distro <code>/etc/wsl.conf</code> :
</blockquote>
<syntaxhighlight lang="ini">[boot]
systemd=true</syntaxhighlight>
Puis redémarre WSL :

<syntaxhighlight lang="powershell">wsl --shutdown</syntaxhighlight>

-----

== ⚙️ Paramètres WSL côté Windows (optionnel) ==

Fichier : <code>%UserProfile%\.wslconfig</code><br />
Exemple minimal :

<syntaxhighlight lang="ini">[wsl2]
memory=8GB
processors=4
localhostForwarding=true</syntaxhighlight>
<blockquote>Ajuste pour limiter l’usage RAM/CPU de WSL2.
</blockquote>

-----

== 🧠 Astuces &amp; bonnes pratiques ==

* '''Nommer et dater''' tes backups : <code>debian_backup_YYYY-MM-DD.tar</code>
* '''Arrêter la distro''' avant export : <code>wsl --terminate &lt;name&gt;</code>
* '''Stockage''' : utilise un disque '''NTFS''' local (évite les lecteurs réseau pour l’import/export).
* '''Vérifier la version''' après import : <code>wsl -l -v</code> puis <code>wsl --set-version &lt;name&gt; 2</code>
* '''Import VHDX''' (scénario avancé) : si tu disposes d’un VHDX, tu peux créer une distro avec : <code>powershell     wsl --import &lt;name&gt; &lt;install_path&gt; &lt;rootfs.tar&gt;</code> &gt; WSL crée lui-même le VHDX à partir du <code>.tar</code>. L’import direct d’un VHDX se fait plutôt via '''montage manuel''' ou outils Hyper-V, ce n’est pas l’usage standard recommandé par WSL.
* '''Sauvegarde avant upgrade''' : exporte toujours avant de modifier la distro ou faire un <code>dist-upgrade</code>.
* '''Restauration sur une autre machine''' : assure-toi de la même version WSL (Windows 10/11 à jour) et vérifie <code>wsl --status</code>.


-----

== 🧾 Résumé minimal à mettre dans ta doc ==

'''Lister et arrêter''' :

<syntaxhighlight lang="powershell">wsl -l -v
wsl --terminate debian</syntaxhighlight>
'''Backup''' :

<syntaxhighlight lang="powershell">wsl --export debian D:\Backups\debian_backup.tar</syntaxhighlight>
'''Restore (nouvelle distro)''' :

<syntaxhighlight lang="powershell">wsl --import debian_restored D:\WSL\debian_restored D:\Backups\debian_backup.tar
wsl --set-version debian_restored 2</syntaxhighlight>
'''Restore sur le même nom (destructif)''' :

<syntaxhighlight lang="powershell">wsl --terminate debian
wsl --unregister debian
wsl --import debian D:\WSL\debian D:\Backups\debian_backup.tar
wsl --set-version debian 2</syntaxhighlight>
'''Utilisateur par défaut''' :

<syntaxhighlight lang="ini"># /etc/wsl.conf
[user]
default=john</syntaxhighlight>

-----

[[Catégorie:WSL2]]