NFS pour ISO, templates et disques qcow2¶

Day 1 · DéployerNiveau 2 · OpérerProcédureRédigé · à valider en lab

Ajoutez un partage NFS comme stockage partagé du cluster pour y centraliser ISO, templates de conteneurs et, si besoin, des disques de VM en qcow2. Le stockage est déclaré une fois au niveau Datacenter et monté automatiquement par chaque nœud sous /mnt/pve/<id>.

Exemple utilisé : NAS 10.20.0.20, export /export/pve-iso pour les ISO (stockage nfs-iso) et /export/pve-vm pour des disques (stockage nfs-vm).

Avant de toucher la prod

L'export autorise toutes les IP des nœuds pve01, pve02, pve03 en lecture-écriture, avec no_root_squash (Proxmox écrit en root).
Le NAS est joignable depuis un réseau de stockage dédié, pas par le VLAN des VM : ping -c3 10.20.0.20 depuis chaque nœud.
La version NFS supportée par le NAS est connue (NFSv3, 4.1 ou 4.2).
L'identifiant du stockage est choisi définitivement : le renommer plus tard oblige à modifier la configuration de chaque VM.
Pour des disques de VM : le NAS est redondé (double contrôleur, alimentation). Sinon, limitez NFS aux ISO et templates.

Étapes¶

1. Vérifier l'export depuis un nœud¶

pvesm scan nfs 10.20.0.20
# /export/pve-iso 10.20.0.0/24
# /export/pve-vm  10.20.0.0/24

2. Déclarer le stockage¶

GUICLI

Datacenter → Storage → Add → NFS.
ID : nfs-iso ; Server : 10.20.0.20 ; Export : choisir /export/pve-iso dans la liste.
Content : ISO image, Container template (et Snippets si vous utilisez cloud-init personnalisé).
Nodes : laisser All sauf exception.
Onglet Advanced (si affiché) : NFS Version 4.2 si le NAS la supporte.
Répéter pour nfs-vm avec Content : Disk image.

pvesm add nfs nfs-iso --server 10.20.0.20 --export /export/pve-iso \
    --content iso,vztmpl --options vers=4.2

pvesm add nfs nfs-vm --server 10.20.0.20 --export /export/pve-vm \
    --content images --options vers=4.2

Résultat dans /etc/pve/storage.cfg :

nfs: nfs-iso
        export /export/pve-iso
        path /mnt/pve/nfs-iso
        server 10.20.0.20
        content iso,vztmpl
        options vers=4.2

3. Créer ou déplacer un disque en qcow2¶

Sur NFS, choisissez le format qcow2 : il apporte snapshots et clones liés. Le format raw est possible mais sans snapshot.

GUICLI

VM 101 → Hardware → disque → Disk Action → Move Storage → cible nfs-vm, Format QEMU image format (qcow2). Cochez Delete source seulement après vérification.

qm disk move 101 scsi0 nfs-vm --format qcow2
# ajouter --delete 1 pour supprimer la source une fois la copie terminée

4. Options à connaître¶

Option	Effet	Quand l'utiliser
`options vers=4.2`	Force la version NFS	Toujours fixer la version, pour éviter une négociation différente selon les nœuds
`options soft`	Abandon après 3 tentatives	Uniquement pour du contenu en lecture seule (ISO). Jamais pour des disques de VM
`preallocation off\\|metadata\\|falloc\\|full`	Préallocation des images raw/qcow2	`metadata` (défaut pour qcow2) convient dans la plupart des cas
`content-dirs`	Change l'arborescence (`template/iso`, `images`…)	Partage existant à structure imposée
`nodes pve01,pve02`	Limite les nœuds qui montent le stockage	NAS non accessible depuis un site

Vérifications

pvesm status | grep nfs
# nfs-iso   nfs   active   2147483648   ...
findmnt /mnt/pve/nfs-iso
# TARGET            SOURCE                      FSTYPE OPTIONS
# /mnt/pve/nfs-iso  10.20.0.20:/export/pve-iso  nfs4   rw,...,vers=4.2,...
ls /mnt/pve/nfs-iso/template/iso/

Dans la GUI, le stockage apparaît avec une icône active sous chaque nœud. Téléversez une ISO depuis un nœud et vérifiez qu'elle est visible depuis les autres.

Rollback

Retirer le stockage ne supprime pas les données du NAS : pvesm remove nfs-iso (ou Datacenter → Storage → Remove). Vérifiez d'abord qu'aucune VM ne référence le stockage : grep -r nfs-vm /etc/pve/qemu-server/. Le montage est retiré automatiquement ; sinon umount /mnt/pve/nfs-iso.

Pièges vus en support

root_squash actif sur le NAS : erreurs Permission denied à la création de disque ou au téléversement d'ISO.
Une ISO montée dans le lecteur CD d'une VM bloque la migration si le stockage n'est pas disponible sur le nœud cible, et un NAS indisponible bloque le démarrage de la VM. Éjectez les ISO après installation.
Option soft sur des disques de VM : en cas de coupure, des écritures sont abandonnées et le système de fichiers invité peut être corrompu.
Sauvegardes vzdump sur le même NAS que les disques de VM : une seule panne fait tout perdre. La sauvegarde de référence reste PBS.
Point de montage /mnt/pve/nfs-iso rempli localement quand le NFS n'était pas monté : le disque système se remplit.

Quand ouvrir un ticket iTop

Stockage inactive sur un seul nœud alors que le NAS répond : P3. Stockage inactive sur tous les nœuds avec des disques de VM dessus : P1, suivez Perte d'accès à la baie. Joindre pvesm status, findmnt -t nfs,nfs4, journalctl -b | grep -i nfs | tail -50.

Ouvrir un ticket iTop