Pourquoi un script pour changer les VMID ?

Proxmox VE est une solution de virtualisation open-source largement adoptée, utilisée pour gérer efficacement des infrastructures virtuelles complexes. Lorsqu’on gère plusieurs dizaines ou centaines de machines virtuelles (VM) et de conteneurs LXC, il arrive régulièrement que l’on souhaite changer l’identifiant numérique (VMID) attribué à une VM ou un conteneur, que ce soit pour réorganiser l’infrastructure, éviter des conflits d’identifiants, ou appliquer de nouvelles conventions de nommage.

Changer manuellement un VMID nécessite de modifier plusieurs références : fichiers de configuration Proxmox, volumes de stockage (LVM, fichiers locaux, NFS, CIFS, etc.), snapshots, sauvegardes, règles de firewall et ACL. L’opération manuelle est donc longue et sujette aux erreurs.

Solutions existantes et leurs limites

Plusieurs guides et tutoriels abordent la question :

• Le wiki officiel Proxmox propose des méthodes pour déplacer des disques entre machines.
• Des articles spécialisés, comme celui de Samuel Kadolph, détaillent le renommage de VM sous ZFS.
• Des blogs techniques (BR Consulting, Bobcares) proposent des procédures manuelles génériques.

Ces guides restent cependant centrés sur un stockage spécifique (LVM, ZFS, directory, etc.) et ne couvrent pas toujours l’ensemble des cas. Pour l’utilisateur, jongler entre plusieurs méthodes peut s’avérer complexe et risqué.

Une solution interactive : Proxmox VMID Updater

J’ai développé sur mon temps libre un script intéractif open-source pour sécuriser et automatiser entièrement la migration de VMID, quel que soit le type de stockage utilisé.

Projet public sur : github.com/sannier3/proxmox-vmid-updater

Ce que le script prend en charge aujourd’hui

• Vérification cluster-wide de l’ancien et du nouveau VMID
• Arrêt sécurisé de la VM/LXC (avec confirmation)
• Renommage des fichiers de configuration Proxmox (.conf)
• Renommage des volumes LVM
• Renommage des volumes basés sur fichiers et répertoires (Directory, NFS, CIFS, GlusterFS)
• Mise à jour des snapshots, vmstate, sauvegardes et jobs VZDUMP/replication
• Mise à jour des règles de firewall et des ACL
• Journalisation horodatée vers la console et vers rename-vmid.sh.log

Fonctionnement simplifié et interactif

Grâce à dialog, l’utilisateur :

• Saisit l’ancien et le nouveau VMID
• Visualise un résumé complet des opérations prévues
• Confirme explicitement avant toute modification

Précautions et sécurité

• Ne modifie jamais l’intégrité des données
• Ne transmet aucune information hors des nœuds Proxmox
• Utilise uniquement les API/CLI Proxmox (pvesh, qm, pct) et commandes Linux natives
• Gestion propre des interruptions : annulation et déverrouillage automatiques

Utilisation

Utilisez la commande ci-dessous directement sur votre terminal en root. Si vous avez un cluster, il faut utiliser le script sur le noeud où est situé la vmid à changer.

bash -c "$(curl -fsSL https://raw.githubusercontent.com/sannier3/proxmox-vmid-updater/main/rename-vmid.sh)"

Ce qui est prévu dans les futures versions

• Support complet des datasets et snapshots ZFS
• Intégration des scripts Hook et Cloud-Init
• Vérification automatique du quorum (optionnelle)
• Mise à jour automatique des règles de firewall contenant le VMID
• Amélioration du verrouillage/déverrouillage des VM et LXC

Un projet collaboratif et ouvert aux retours

Proxmox VMID Updater est développé en open-source, sans garantie absolue malgré des tests rigoureux. Tout retour, signalement de bug ou demande d’amélioration est le bienvenu :

Ouverture d’un ticket sur GitHub

Conclusion

Ce script vise à simplifier et sécuriser une opération complexe, tout en offrant une interface claire et interactive. Il peut vous faire gagner un temps précieux et réduire les risques d’erreur. Néanmoins, assurez-vous de bien comprendre chaque étape avant l’exécution : utilisation à vos risques et périls.