> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/learn-the-platform/fr/module-6-machines-virtuelles/04-vm-migration-import.md).

# Migration et import de VM

## Vue d'ensemble

Migrer les charges de travail existantes vers VergeOS est l’une des activités du premier jour les plus courantes lors de nouveaux déploiements. Que vous passiez de VMware vSphere, Microsoft Hyper-V, KVM/QEMU ou même de serveurs bare-metal, VergeOS propose plusieurs chemins d’importation — chacun optimisé pour différents scénarios, nombres de VM et tolérances aux interruptions de service.

Cette page couvre toutes les méthodes de migration prises en charge, les formats de fichiers acceptés par VergeOS, la planification préalable à la migration, l’optimisation après importation et la manière de réexporter les VM hors de la plateforme lorsque cela est nécessaire.

```mermaid
flowchart LR
    subgraph sources["Plateformes sources"]
        VMW["VMware vSphere"]
        HV["Hyper-V"]
        KVM["KVM / QEMU"]
        PM["Machines physiques"]
    end

    subgraph methods["Méthodes d’importation"]
        CONN["Connecteur VMware"]
        FILE["Téléversement de fichier"]
        NAS["Importation de volume NAS"]
        CLONE["Utilitaire de clonage"]
        CIRRUS["Cirrus Data"]
    end

    subgraph vergeos["VergeOS"]
        VM["VM en cours d’exécution"]
    end

    VMW --> CONN
    VMW --> FILE
    HV --> FILE
    KVM --> FILE
    HV --> NAS
    KVM --> NAS
    VMW --> NAS
    PM --> CLONE
    PM --> CIRRUS
    VMW --> CIRRUS

    CONN --> VM
    FILE --> VM
    NAS --> VM
    CLONE --> VM
    CIRRUS --> VM
```

## Méthodes de migration

VergeOS propose cinq chemins d’importation distincts. Le bon choix dépend de votre plateforme source, du nombre de VM et du niveau d’interruption de service que vous pouvez tolérer.

### Connecteur VMware (migration en direct)

Le **Connecteur VMware** est la méthode recommandée pour les environnements VMware de production. Elle crée une connexion API directe à vSphere et effectue des sauvegardes complètes + incrémentales en utilisant le **suivi des blocs modifiés (CBT)**.

**Comment cela fonctionne :**

1. **Créer un service VMware** dans VergeOS — cela établit une connexion à vCenter (ou à un hôte ESXi) à l’aide d’identifiants administrateur, du DNS/IP et du port 443.
2. **Démarrer le service** puis actualiser les VM pour découvrir l’inventaire source.
3. **Créer des planifications de sauvegarde** avec des tâches de sauvegarde complète et différentielle.
4. **Attribuer des planifications aux VM** — des planifications différentes peuvent s’appliquer à différentes VM (par exemple, production vs dev/test).
5. **Exécuter les premières sauvegardes complètes**, puis les sauvegardes incrémentales ne capturent que les blocs modifiés via CBT.
6. **Basculer** une fois que les durées des sauvegardes incrémentales se stabilisent (ce qui indique un changement de données minimal), puis importer les VM depuis les tâches de sauvegarde.

**Principales fonctionnalités :**

* Migration en direct depuis des environnements VMware en cours d’exécution — les VM source restent opérationnelles pendant le transfert
* Prise en charge des sauvegardes incrémentales via le CBT VMware pour une utilisation efficace de la bande passante
* Importation par lot de plusieurs VM simultanément
* Nombre configurable de sauvegardes simultanées (par défaut : 4)
* Planification intégrée pour la sauvegarde et la reprise après sinistre continues des environnements VMware
* Les VM importées peuvent être démarrées directement dans VergeOS à partir des données de sauvegarde

{% hint style="success" %}
**Bonnes pratiques du connecteur VMware**

* Se connecter au **cluster vSphere** plutôt qu’à un hôte ESXi individuel
* Laisser "Activer automatiquement le suivi des modifications par VM" **activé** (par défaut) afin de garantir le bon fonctionnement des sauvegardes différentielles
* Inclure à la fois des tâches de sauvegarde complète et différentielle dans votre planification — sauvegardes complètes hebdomadaires, différentielles les jours intermédiaires
* Utiliser des sauvegardes en provisionnement complet pour la conservation à long terme
  {% endhint %}

{% hint style="warning" %}
**Exigences réseau du connecteur VMware**

Le connecteur communique avec vCenter via **le port 443**, mais les données de disque sont récupérées directement depuis les hôtes ESXi via le protocole NFC sur **le port 902**. Pour que les migrations réussissent, VergeOS a besoin de :

* **Un accès réseau direct à chaque hôte ESXi** — pas seulement à vCenter. Le service VMware atteint vCenter sur 443 pour inventorier les ressources, puis se connecte à l’hôte ESXi individuel hébergeant chaque VM sur 902 pour transférer les données du disque.
* **Port 443** ouvert vers vCenter (ou l’hôte ESXi autonome) et **le port 902** ouvert vers chaque hôte ESXi.
* **Des valeurs MTU identiques** de bout en bout. Des MTU différentes (par exemple, des trames jumbo activées d’un côté mais pas de l’autre) provoquent le blocage, le dépassement de délai ou l’échec des sauvegardes pendant le transfert des données. Vérifiez que la MTU est cohérente dans VergeOS, les commutateurs physiques et les ports vmkernel ESXi.
  {% endhint %}

{% hint style="info" %}
Le service VMware stocke les sauvegardes/instantanés des VM VMware qu’il récupère dans **vSAN (VergeFS)** stockage. Dimensionnez le niveau cible pour les données de sauvegarde complète et incrémentale de chaque VM VMware que vous prévoyez de migrer — cette consommation s’ajoute au stockage que les VM importées et en cours d’exécution utiliseront.
{% endhint %}

### Importer depuis des fichiers téléversés

Pour des VM individuelles ou des environnements multi-plateformes, vous pouvez téléverser directement les fichiers de configuration et de disque des VM vers le vSAN (VergeFS) et les importer.

**Deux approches :**

1. **Importation complète de la configuration** — Téléversez à la fois les fichiers de configuration (VMX, OVF) et les fichiers de disque (VMDK, VHDX, QCOW2), puis sélectionnez "Importer depuis des fichiers" lors de la création d’une nouvelle VM. VergeOS lit le fichier de configuration pour renseigner automatiquement les paramètres de la VM.
2. **Coque de VM + importation du disque** — Créez une VM personnalisée avec les spécifications souhaitées (CPU, RAM, NIC), puis ajoutez des disques en utilisant "Importer un disque" et sélectionnez les fichiers de disque téléversés. C’est utile lorsque le format de configuration source n’est pas directement pris en charge (par exemple, XML Hyper-V).

**Étapes pour une importation complète de la configuration :**

1. Téléversez les fichiers de configuration + disque vers le vSAN via le gestionnaire de fichiers
2. Accédez à **Machines virtuelles → + Nouvelle VM → Importer depuis des fichiers**
3. Sélectionnez le fichier de configuration (`.vmx`, `.ovf`) parmi les fichiers disponibles
4. Personnalisez éventuellement le nom de la VM et la conservation de l’adresse MAC
5. Sélectionnez le niveau de stockage préféré
6. Validez — la VM est créée avec des disques mappés à partir des fichiers de disque

### Importation de volume NAS

Lorsque les fichiers de VM sont stockés sur un stockage accessible en réseau (partages NFS ou CIFS), vous pouvez les importer directement sans les téléverser d’abord vers le vSAN.

L’importation de volume NAS nécessite **VMX ou OVF** des fichiers de configuration ; les autres formats doivent utiliser le téléversement de fichiers.

**Comment cela fonctionne :**

1. Créer ou utiliser un **service NAS** dans VergeOS
2. Créer un **volume distant** pour monter le partage NFS/CIFS externe
3. Accédez à **Machines virtuelles → + Nouvelle VM → Importer depuis un volume**
4. Sélectionnez un ou plusieurs dossiers contenant les fichiers de VM (les VM sont également importées depuis les sous-répertoires des dossiers sélectionnés)
5. Renommez éventuellement la tâche d’importation, activez ou désactivez la conservation de l’adresse MAC et sélectionnez un niveau de stockage préféré
6. Validez et surveillez la progression depuis le **Tâches d’importation** tableau de bord

Cette méthode est idéale pour les migrations par lot lorsque les fichiers de VM sont déjà centralisés sur un serveur de fichiers ou une exportation SAN.

### Utilitaire de clonage VergeOS (P2V / V2V)

L’utilitaire de clonage fournit **une migration au niveau des blocs** pour les conversions de physique vers virtuel (P2V) et de virtuel vers virtuel (V2V) depuis n’importe quelle plateforme.

**Comment cela fonctionne :**

1. Téléchargez le `vergeOS-clone.iso` depuis le tableau de bord VergeOS
2. Démarrez la machine source (physique ou virtuelle) depuis l’ISO
3. Configurez le nom de la VM, les paramètres de l’adresse MAC et sélectionnez les disques à inclure
4. L’utilitaire effectue un transfert de données au niveau des blocs vers l’environnement VergeOS
5. Une fois le transfert terminé, démarrez la VM dans VergeOS

Cette approche fonctionne quel que soit l’hyperviseur source et est particulièrement utile pour les serveurs physiques qui ne peuvent pas exporter vers des formats VM standard.

### Intégration Cirrus Data (entreprise)

Pour les migrations d’entreprise à grande échelle nécessitant **un temps d’arrêt quasi nul**, VergeOS s’intègre avec **les produits** Compute Migration et MigrateOps de Cirrus Data. Cette solution tierce prend en charge des migrations complexes multi-plateformes avec une gestion avancée de la bande passante et des services professionnels.

## Formats de fichiers pris en charge

VergeOS prend en charge un large éventail de formats de configuration et de disques de VM :

| Format           | Plateforme source  | Description                                          |
| ---------------- | ------------------ | ---------------------------------------------------- |
| **VMX / VMDK**   | VMware             | Fichiers de configuration et de disque VMware natifs |
| **OVF / OVA**    | VMware, VirtualBox | Format de virtualisation ouvert (standard)           |
| **VHD / VHDX**   | Hyper-V            | Formats de virtualisation Microsoft                  |
| **QCOW / QCOW2** | QEMU, KVM          | Images disque copy-on-write de QEMU                  |
| **VDI**          | VirtualBox         | Images disque VirtualBox                             |
| **IMG / RAW**    | Divers             | Formats d’image disque bruts                         |

## Choisir la bonne méthode

### Connecteur VMware

Environnements VMware de production où les VM source doivent rester en cours d’exécution pendant la migration. Tire parti du CBT pour des transferts incrémentaux efficaces.

### Téléversement de fichier

VM individuelles depuis n’importe quelle plateforme. Contrôle maximal du processus d’importation. Idéal lorsque les VM source peuvent être arrêtées pour l’exportation.

### Importation de volume NAS

Importations par lot depuis le stockage réseau. Fichiers de VM déjà présents sur des partages NFS/CIFS. Aucune étape de téléversement n’est nécessaire.

### Utilitaire de clonage

Migrations de physique vers virtuel (P2V). V2V multiplateforme depuis n’importe quel hyperviseur. Efficacité au niveau des blocs.

## Planification préalable à la migration

### Préparation de l’environnement source

Avant de migrer, préparez l’environnement source :

* **Documentez les spécifications de la VM** — nombre de CPU, RAM, tailles de disque, paramètres réseau, affectations VLAN
* **Supprimez les outils spécifiques à l’hyperviseur** — désinstallez VMware Tools, Hyper-V Integration Services ou des agents équivalents
* **Arrêt propre** pour les importations hors ligne — garantit la cohérence du système de fichiers
* **Vérifiez la connectivité réseau** entre les environnements source et VergeOS (en particulier pour le connecteur VMware et les importations NAS)

### Préparation de l’environnement VergeOS

* **Vérifiez la capacité de stockage** sur les niveaux appropriés pour les disques VM entrants
* **Configurez les segments réseau** pour correspondre aux VLAN de l’environnement source
* **Planifiez les affectations d’adresses IP** et les configurations DNS
* **Vérifiez la compatibilité du système invité** — VergeOS prend en charge Windows, Linux, BSD et d’autres systèmes d’exploitation via KVM

### Remappage réseau

Les VM source sont généralement connectées à des vSwitches VMware, des commutateurs virtuels Hyper-V ou des ponts Linux. Dans VergeOS, ceux-ci correspondent à **réseaux internes**:

| Concept source                      | Équivalent VergeOS    |
| ----------------------------------- | --------------------- |
| vSwitch / dvSwitch VMware           | Réseau interne        |
| Commutateur virtuel Hyper-V         | Réseau interne        |
| Pont Linux                          | Réseau interne        |
| Groupe de ports avec étiquette VLAN | Réseau interne + VLAN |

Après l’importation, vous connecterez le ou les NIC de chaque VM au réseau interne VergeOS approprié. Si vous conservez les adresses MAC pendant l’importation, les réservations DHCP sont automatiquement conservées.

## Optimisation après importation

### Installer les pilotes VirtIO

VirtIO offre les meilleures performances disque et réseau dans VergeOS. Après avoir importé une VM :

* **Windows :** Téléchargez et installez l’ISO des outils invités `virtio-win` . Montez-la comme lecteur CD-ROM virtuel, puis installez les pilotes.
* **Linux :** La plupart des distributions modernes incluent les pilotes VirtIO nativement — aucune installation supplémentaire n’est nécessaire.

{% hint style="success" %}
**Contournement d’un problème de démarrage**

Si une VM ne démarre pas après l’importation, remplacez l’interface de disque de **VirtIO-SCSI** vers **SATA** ou **IDE**. Une fois le système démarré, installez les pilotes VirtIO, puis revenez à VirtIO-SCSI pour des performances optimales.
{% endhint %}

### Mappage du matériel virtuel

Les VM importées peuvent nécessiter des ajustements pour s’aligner sur le matériel virtuel de VergeOS :

* **Interfaces de disque** — passez d’IDE/SATA à VirtIO-SCSI après l’installation des pilotes
* **Modèle de NIC** — VirtIO-net offre le meilleur débit
* **Adaptateur d’affichage** — QXL ou VGA pour l’accès à la console
* **EFI vs. BIOS** — assurez-vous que le type de firmware correspond à la configuration de la VM source
* **Secure Boot** — pris en charge pour les VM basées sur l’UEFI ; vérifiez que le paramètre correspond à la source

### Étapes supplémentaires

1. **Vérifiez la connectivité réseau** et les affectations IP
2. **Mettez à jour les réservations DNS et DHCP** selon les besoins
3. **Installez l’agent invité QEMU** pour un meilleur suivi, un arrêt gracieux et des instantanés cohérents
4. **Configurez les politiques de sauvegarde** en utilisant les instantanés natifs de VergeOS
5. **Testez le fonctionnement de l’application** de bout en bout avant de mettre hors service les VM source

## Exportation de VM depuis VergeOS

VergeOS prend en charge deux mécanismes d’exportation pour la portabilité et l’intégration de sauvegardes tierces.

### Téléchargement direct du disque

Les disques de VM individuels peuvent être téléchargés au **.raw** format directement depuis l’interface utilisateur VergeOS :

1. Accédez au tableau de bord de la VM → **Disques**
2. Sélectionnez le disque → **Télécharger**
3. Le disque se télécharge sous la forme d’un `.raw` fichier, compatible avec la plupart des hyperviseurs
4. Convertissez vers le format de destination (`.qcow2`, `.vmdk`, etc.) à l’aide d’outils comme `qemu-img convert`

### Volume d’exportation de VM (basé sur NAS)

Pour les exportations automatisées et planifiées de plusieurs VM, VergeOS fournit un **volume d’exportation de VM** dédié dans le service NAS :

1. **Activez "Autoriser l’exportation"** sur chaque VM que vous souhaitez inclure
2. **Créez un volume NAS** avec le type de système de fichiers défini sur **Verge.io VM Export**
3. Choisissez le format de configuration d’exportation :
   * **Machine virtuelle Verge.io (.ybvm)** — format natif VergeOS basé sur JSON
   * **Open Virtualization Format (.ovf)** — standard du secteur, compatible avec les plateformes tierces
4. **Lancez l’exportation** manuellement ou planifiez-la via le moteur de tâches
5. **Accédez aux données exportées** via des partages CIFS ou NFS, ou synchronisez-les vers un stockage externe à l’aide de synchronisations de volume

Chaque exportation crée un dossier horodaté avec des instantanés de VM. Un dossier "current" pointe toujours vers la dernière exportation, offrant un chemin stable pour les outils de sauvegarde externes.

{% hint style="info" %}
**Vous venez de VMware ou de Nutanix ?**

Les deux chemins de migration sont intégrés à la plateforme — aucun appareil séparé, aucun convertisseur tiers.
{% endhint %}

| Source         | Chemin                                                                                          | Remarques                                                                                                                                                                                                                         |
| -------------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| VMware vSphere | **Connecteur VMware** — migration par API directe avec sauvegardes incrémentales basées sur CBT | VergeOS gère la migration VMware de manière native via le connecteur VMware intégré — aucun convertisseur séparé, appareil de réplication ou outil V2V tiers n’est requis.                                                        |
| Nutanix AHV    | **Téléversement de fichier ou importation de volume NAS**                                       | Une fois vos VM exportées dans un format pris en charge (QCOW2, OVF, etc.), VergeOS les importe nativement via le téléversement de fichiers ou l’importation de volume NAS — aucun appareil de migration séparé n’est nécessaire. |
| Chemin retour  | **volume d’exportation de VM** produisant OVF                                                   | Dossier "current" stable pour les outils de sauvegarde externes ou pour renvoyer les VM vers vSphere.                                                                                                                             |

## Dépannage des problèmes courants

| Symptôme                                                                           | Cause probable                                         | Résolution                                                                                                                                                             |
| ---------------------------------------------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La VM ne démarre pas après l’importation                                           | Pilotes VirtIO manquants                               | Passez l’interface de disque à SATA/IDE, démarrez, installez les pilotes VirtIO, puis revenez en arrière                                                               |
| Windows « Périphérique de démarrage inaccessible »                                 | Incompatibilité du contrôleur de disque                | Passez de VirtIO-SCSI à SATA, installez les pilotes, puis revenez à la configuration initiale                                                                          |
| Aucune connectivité réseau                                                         | Pilote NIC ou mappage réseau                           | Vérifiez que les pilotes VirtIO-net sont installés ; contrôlez que la NIC est connectée au bon réseau interne                                                          |
| Performances disque lentes                                                         | Utilisation de l’interface IDE/SATA                    | Installez les pilotes VirtIO et passez à VirtIO-SCSI                                                                                                                   |
| Échec du démarrage EFI                                                             | Incompatibilité du type de firmware                    | Assurez-vous que la VM est réglée sur UEFI si la source utilisait EFI ; vérifiez les paramètres Secure Boot                                                            |
| Le connecteur VMware affiche « Erreur »                                            | Problème de connexion ou d’identifiants                | Vérifiez l’IP/DNS de vCenter, **le port 443** l’accès, les identifiants administrateur et les paramètres du certificat SSL                                             |
| L’importation/sauvegarde VMware échoue ou se bloque pendant le transfert du disque | Aucun accès direct aux hôtes ESXi sur le port 902      | Assurez-vous que VergeOS dispose d’un **accès réseau direct à chaque hôte ESXi** (pas seulement à vCenter) via **le port 902** (NFC), en plus du port 443 vers vCenter |
| Les sauvegardes VMware sont lentes, expirent ou se déconnectent                    | Incompatibilité de MTU entre VergeOS et les hôtes ESXi | Correspondance **Valeurs MTU** de bout en bout (VergeOS, commutateurs physiques et ports vmkernel ESXi) ; une incompatibilité de trames jumbo est une cause fréquente  |

## Résumé

VergeOS simplifie la migration des charges de travail grâce à cinq chemins d’import distincts couvrant chaque plateforme source et chaque scénario de migration. VMware Connector gère les migrations de production en direct avec un minimum de temps d’arrêt, les importations de fichiers offrent une flexibilité maximale pour les environnements mixtes, les importations de volumes NAS permettent des opérations par lots, l’utilitaire Clone gère les conversions P2V, et l’intégration Cirrus Data prend en charge les projets à l’échelle de l’entreprise. Combiné à une prise en charge étendue des formats de fichiers et au volume d’exportation de VM pour la portabilité sortante, VergeOS garantit que la mobilité des charges de travail n’est jamais un obstacle à l’adoption.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/learn-the-platform/fr/module-6-machines-virtuelles/04-vm-migration-import.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
