> 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-3-installation/03-adding-nodes.md). # Ajout de nœuds ## Vue d'ensemble Une fois votre cluster de contrôleur à deux nœuds opérationnel, VergeOS prend en charge trois méthodes pour augmenter la capacité : **nœuds d'extension** (ajoutant à un cluster HCI existant à la fois du calcul et du stockage), **nœuds de stockage seul** (extension de stockage dédiée), et **nœuds de calcul seul** (extension de calcul dédiée). Chaque type de nœud suit un flux de travail simplifié d'installation USB qui détecte automatiquement le système existant sur le core fabric. Cette page couvre les prérequis, les étapes d'installation et les procédures de vérification pour les trois types de nœuds. ## Prérequis Avant d'ajouter un nœud à votre système VergeOS, assurez-vous que les conditions suivantes sont remplies : | Exigence | Détail | | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Cluster opérationnel à 2 nœuds** | Les nœuds de contrôleur principal et secondaire du [Guide d'installation](/learn-the-platform/fr/module-3-installation/02-controller-installation.md) doivent être entièrement installés et en bon état | | **Préparation du réseau** | Les VLAN, les attributions physiques des NIC et le câblage du core fabric doivent correspondre à la configuration documentée lors de la configuration initiale | | **Matériel identique** | Les nœuds d'extension et de stockage seul doivent avoir des spécifications matérielles identiques (CPU, stockage, NIC, RAM) à celles des nœuds existants du cluster cible | | **Installateur USB** | Support d'installation VergeOS correspondant à la version exécutée sur votre cluster existant | | **Cluster créé dans l'interface** | Si vous ajoutez un **nouveau type de cluster** (stockage seul ou calcul seul) pour la première fois, créez le cluster dans l'interface VergeOS **avant** de démarrer l'installateur | {% hint style="warning" %} **Créez les clusters avant d'installer les nœuds** Si c'est le premier nœud de stockage seul ou de calcul seul que vous ajoutez, vous **devez** créer d'abord le cluster correspondant dans l'interface VergeOS : 1. Accédez à **Système → Clusters** 2. Cliquez sur **Nouveau cluster** 3. Définissez le rôle du cluster à l'aide des interrupteurs indépendants **Calcul** et **Stockage** — ce ne sont pas un seul choix soit/ou. Activez **Stockage** uniquement (Calcul désactivé) pour un cluster de stockage seul, ou **Calcul** uniquement (Stockage désactivé) pour un cluster de calcul seul. (Un cluster HCI a *les deux* activés.) 4. Enregistrez la configuration du cluster L'installateur ne peut pas ajouter un nœud à un cluster qui n'existe pas encore. {% endhint %} ## Comparaison des types de nœuds Comprendre les différences entre les types de nœuds vous aide à choisir la bonne stratégie d'extension : ```mermaid flowchart TD A["Besoin d'augmenter la capacité ?"] --> B{"Quelle ressource\nest le goulot d'étranglement ?"} B -->|"À la fois le calcul\net le stockage"| C["Nœud d'extension\n(extension HCI)"] B -->|"Stockage seul"| D["Nœud de stockage seul\n(stockage dédié)"] B -->|"Calcul seul"| E["Nœud de calcul seul\n(calcul dédié)"] C --> F["Type d'installateur : Scale-Out\nvSAN : Oui\nExécute des VM : Oui"] D --> G["Type d'installateur : Scale-Out\nvSAN : Oui\nExécute des VM : Non"] E --> H["Type d'installateur : Calcul uniquement\nvSAN : Non\nExécute des VM : Oui"] style C fill:#e3f2fd,stroke:#1565c0 style D fill:#e8f5e9,stroke:#2e7d32 style E fill:#fff3e0,stroke:#e65100 ``` | Fonctionnalité | Scale-Out | Stockage seul | Calcul seul | | ---------------------------------------------- | ------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | **Sélection de l'installateur** | "Scale-Out" | "Scale-Out" | "Calcul uniquement" | | **Participation à vSAN** | Oui — disques ajoutés aux niveaux existants | Oui — disques ajoutés aux niveaux existants | Non — s'installe sans configurer le stockage local (les nœuds de calcul seul amorcés en PXE n'ont pas besoin de lecteur de démarrage local) | | **Exécute des charges de travail VM** | Oui | Non | Oui | | **Nécessite la création préalable du cluster** | Non (rejoint un cluster HCI existant) | Oui (s'il s'agit du premier nœud de stockage) | Oui (s'il s'agit du premier nœud de calcul) | | **Cas d'utilisation typique** | Croissance HCI équilibrée | Extension de stockage UCI | Extension de calcul GPU/ML/VDI | ## Installation d'un nœud d'extension Les nœuds d'extension sont le moyen le plus simple d'agrandir un cluster HCI. Ils ajoutent proportionnellement à la fois de la capacité de calcul et de stockage, en utilisant un matériel identique à celui des nœuds de contrôleur existants. ### Étapes d'installation 1. **Démarrez depuis l'installateur USB VergeOS** * Insérez l'installateur USB dans le serveur désigné comme nœud d'extension * Redémarrez et sélectionnez la clé USB comme périphérique de démarrage dans le menu de démarrage BIOS/UEFI 2. **Sélectionnez le type de nœud → "Scale-Out"** * Lorsque l'installateur affiche le menu de type de nœud, sélectionnez **Scale-Out** * Cela indique à l'installateur de rejoindre un cluster existant avec les rôles de calcul et de stockage 3. **Saisissez les identifiants administrateur** * Fournissez le nom d'utilisateur et le mot de passe administrateur créés lors de l'installation du contrôleur principal * Ces identifiants authentifient le nouveau nœud auprès du système existant 4. **Détection automatique du réseau** * L'installateur détecte automatiquement la configuration du core fabric en écoutant les paquets UDP provenant des nœuds existants * Vérifiez que les NIC détectées correspondent à votre schéma de câblage documenté > **Astuce :** L'installateur peut vous demander d'identifier quelle NIC est utilisée pour le **Externe** réseau s'il ne peut pas la détecter automatiquement. Ayez votre documentation de correspondance NIC-vers-port à portée de main. 5. **Sélection du cluster** (si plusieurs clusters existent) * Si votre système comporte plus d'un cluster, l'installateur vous demande de sélectionner le cluster que ce nœud doit rejoindre * Sélectionnez dans le cluster cible le nœud dont le matériel ressemble le plus à celui de ce nouveau nœud 6. **Configuration des disques vSAN** * L'installateur affiche les disques détectés et les affectations de niveau proposées * Confirmez que les niveaux de stockage correspondent à la configuration du cluster existant — **l'homogénéité est essentielle** * Examinez et finalisez la sélection des disques 7. **Terminer l'installation** * L'installateur formate les lecteurs, installe VergeOS et intègre le nœud au cluster * Le nœud redémarre automatiquement lorsque l'installation est terminée * Retirez le support d'installation USB lorsque vous y êtes invité 8. **Vérifiez dans l'interface** * Connectez-vous à l'interface Web VergeOS * Accédez à **Infrastructure → Nœuds** et confirmez que le nouveau nœud apparaît avec un état opérationnel * Vérifiez **Système → vSAN** pour vérifier que les nouveaux disques sont intégrés et que les niveaux sont sains {% hint style="info" %} Après l'intégration du nœud, vSAN redistribuera les données pour inclure les nouveaux disques. L'état des niveaux peut afficher **jaune** pendant la phase de reconstruction — c'est normal. Attendez que tous les niveaux reviennent au **vert** avant d'ajouter un autre nœud ou d'effectuer une maintenance. {% endhint %} ## Installation d'un nœud de stockage seul Les nœuds de stockage seul augmentent la capacité vSAN sans ajouter de ressources de calcul. Ils sont utilisés dans les architectures UCI (Unified Compute Infrastructure) où le stockage et le calcul évoluent indépendamment. ### Préinstallation : créer un cluster de stockage Si c'est votre **premier** nœud de stockage seul, créez le cluster de stockage dans l'interface : 1. Accédez à **Système → Clusters** 2. Cliquez sur **Nouveau cluster** 3. Activez l' **Stockage** interrupteur et laissez **Calcul** désactivé 4. Enregistrez la configuration ### Étapes d'installation L'installation du nœud de stockage seul utilise la **même option d'installateur "Scale-Out"** qu'un nœud d'extension classique. La différence clé est que le nœud rejoint un cluster de stockage seul au lieu d'un cluster HCI. 1. **Démarrez depuis l'installateur USB** — identique à l'extension 2. **Sélectionnez le type de nœud → "Scale-Out"** — l'installateur utilise "Scale-Out" pour les nœuds HCI et de stockage seul 3. **Saisissez les identifiants administrateur** — authentifiez-vous auprès du système existant 4. **Détection automatique du réseau** — vérifiez les affectations des NIC 5. **Sélection du cluster** — sélectionnez le **cluster de stockage** que vous avez créé dans l'interface ; sélectionnez le nœud auquel ce nouveau nœud ressemble le plus 6. **Configuration des disques vSAN** — confirmez que les affectations de niveaux correspondent à la configuration prévue du cluster de stockage 7. **Terminer l'installation** — les lecteurs sont formatés, VergeOS est installé et le nœud redémarre 8. **Vérifiez dans l'interface** — confirmez que le nœud apparaît sous le bon cluster de stockage sur la page Nœuds {% hint style="success" %} Comme les nœuds de stockage seul utilisent l'option d'installateur "Scale-Out", le facteur différenciant est le **cluster que vous sélectionnez** à l'étape 5. Le type de cluster (stockage seul) détermine le rôle du nœud dans le système. {% endhint %} ## Installation d'un nœud de calcul seul Les nœuds de calcul seul fournissent des ressources supplémentaires en CPU, RAM et éventuellement GPU sans participer au stockage vSAN. Ils sont idéaux pour les charges de travail qui nécessitent une forte puissance de traitement — apprentissage automatique, rendu, VDI ou analyse de données. ### Préinstallation : créer un cluster de calcul Si c'est votre **premier** nœud de calcul seul, créez le cluster de calcul dans l'interface : 1. Accédez à **Système → Clusters** 2. Cliquez sur **Nouveau cluster** 3. Activez l' **Calcul** interrupteur et laissez **Stockage** désactivé 4. Enregistrez la configuration ### Étapes d'installation 1. **Démarrez depuis l'installateur USB** — identique aux autres types de nœuds 2. **Sélectionnez le type de nœud → "Calcul uniquement"** — il s'agit d'une option d'installateur distincte, différente de "Scale-Out" 3. **Saisissez les identifiants administrateur** — authentifiez-vous auprès du système existant 4. **Détection automatique du réseau** — vérifiez les affectations des NIC 5. **Sélection du cluster** (facultatif) — si vous y êtes invité, sélectionnez le **cluster de calcul** et le nœud auquel ce nouveau nœud ressemble le plus 6. **Terminer l'installation** — l'installateur configure les paramètres réseau et **installe sans configurer le stockage local**. Les nœuds de calcul seul peuvent également être amorcés en PXE, auquel cas aucun lecteur de démarrage local n'est requis. Le nœud redémarre automatiquement. 7. **Vérifiez dans l'interface** — confirmez que le nœud apparaît sous le bon cluster de calcul sur la page Nœuds {% hint style="info" %} Les nœuds de calcul seul n'ont **aucune étape de configuration des disques vSAN**. Ils accèdent au stockage via le core fabric depuis les nœuds des clusters HCI ou de stockage seul. C'est la principale différence avec les installations d'extension et de stockage seul. {% endhint %} ## Bonnes pratiques pour l'ordre d'installation Lors du déploiement d'un système multi-cluster (architecture UCI), suivez l'ordre recommandé suivant : ```mermaid flowchart LR A["1. Nœuds de contrôleur\n(Cluster 1)"] --> B["2. Nœuds de stockage\n(Cluster 2)"] B --> C["3. Nœuds de calcul\n(Cluster 3)"] style A fill:#e3f2fd,stroke:#1565c0 style B fill:#e8f5e9,stroke:#2e7d32 style C fill:#fff3e0,stroke:#e65100 ``` 1. **Installez d'abord les nœuds de contrôleur** — ils constituent le cluster fondamental avec le stockage des métadonnées de niveau 0 2. **Ajoutez ensuite les nœuds de stockage** — garantit que la capacité de stockage vSAN est disponible avant que les nœuds de calcul n'en aient besoin 3. **Ajoutez les nœuds de calcul en dernier** — ils peuvent accéder immédiatement au stockage via le core fabric Au sein d'un cluster quelconque, **ajoutez les nœuds séquentiellement** — attendez que chaque nœud termine son installation et apparaisse en bon état dans l'interface avant de commencer le suivant. Cela évite le chevauchement des opérations de redistribution/reconstruction vSAN à mesure que chaque nouveau nœud rejoint le cluster. ## Dépannage Si des problèmes surviennent pendant l'installation d'un nœud : | Action | Commande | Description | | ------------------------------ | ---------------------- | ---------------------------------------------------------------- | | **Annuler l'installateur** | Appuyez sur `Échap` | Passe à une invite de commandes | | **Reprendre l'installation** | `yb-install` | Reprend là où l'installateur s'était arrêté | | **Redémarrer depuis le début** | `yb-install --restart` | Réinitialise et redémarre l'ensemble du processus d'installation | ### Problèmes courants **Le nœud n'apparaît pas dans l'interface après le redémarrage :** * Vérifiez la connectivité réseau — assurez-vous que les NIC du core fabric sont correctement câblées * Vérifiez que la version de l'installateur USB correspond à la version de VergeOS exécutée sur les contrôleurs * Consultez les journaux d'installation du nœud via la console **Un niveau vSAN reste jaune pendant une période prolongée :** * C'est normal pendant la redistribution des données — surveillez la progression dans **Système → vSAN** * Assurez-vous qu'il y a une bande passante suffisante entre les nœuds sur le core fabric * Contactez le support VergeOS si la reconstruction se bloque au-delà des délais prévus **L'installateur ne peut pas détecter automatiquement le réseau :** * Vérifiez que les ports des commutateurs du core fabric sont correctement configurés (trames jumbo, STP désactivé) * Vérifiez que le câblage physique correspond à la correspondance NIC-vers-port documentée * Essayez une configuration réseau manuelle si la détection automatique échoue à plusieurs reprises **« Aucun cluster disponible » lors de la sélection du cluster :** * Assurez-vous d'avoir créé le cluster cible (Stockage ou Calcul) dans l'interface avant de démarrer l'installateur * Vérifiez que le type de cluster correspond au type de nœud de l'installateur ## Liste de vérification Après avoir ajouté un nœud, confirmez les points suivants : * [ ] Le nœud apparaît sur la **Infrastructure → Nœuds** page avec un état opérationnel * [ ] Le nœud affiche la bonne affectation de cluster * [ ] Pour les nœuds d'extension/de stockage : **Système → vSAN** affiche tous les nouveaux disques avec les affectations de niveau correctes * [ ] Pour les nœuds d'extension/de stockage : les niveaux vSAN reviennent à **vert** l'état (sain) une fois la reconstruction terminée * [ ] Connectivité du core fabric confirmée : **Diagnostics du nœud → Configuration du fabric** indique `confirmé : vrai` pour tous les chemins * [ ] Aucun événement d'erreur dans le journal système lié au nouveau nœud {% hint style="info" %} **Passerelle VMware** Vous venez de VMware ? VergeOS utilise un seul installateur USB qui détecte automatiquement le core fabric et s'authentifie avec des identifiants administrateur — les rôles contrôleur, extension, stockage seul et calcul seul sont tous des sélections de menu, sans étape de préconfiguration par hôte du côté de VergeOS. {% endhint %} {% hint style="info" %} **Passerelle Nutanix** Vous venez de Nutanix ? VergeOS n'a pas de CVM — le service de stockage est un démon OS intégré — et les rôles extension, stockage seul et calcul seul sont des rôles de nœuds de premier ordre, sélectionnés via l'option d'installation et le cluster cible ; un seul installateur USB couvre les trois. {% endhint %} ## Points clés | Concept | Résumé | | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | **Trois types de nœuds** | Extension (HCI), stockage seul et calcul seul — chacun avec un rôle spécifique | | **Installateur unique** | Un seul support d'installation USB gère tous les types de nœuds via la sélection dans le menu | | **Détection automatique** | Les nœuds découvrent automatiquement le système sur le core fabric | | **Création préalable du cluster** | Les clusters de stockage et de calcul doivent être créés dans l'interface avant d'ajouter le premier nœud de ce type | | **Installation séquentielle** | Ajoutez les nœuds un par un au sein d'un cluster pour éviter le chevauchement des opérations de redistribution/reconstruction vSAN | | **Le stockage avant le calcul** | Dans les déploiements UCI, ajoutez les nœuds de stockage avant les nœuds de calcul | | **Reconstruction vSAN** | Après l'ajout de nœuds contribuant au stockage, attendez que les niveaux vSAN redeviennent verts avant de continuer | ## Étapes suivantes Une fois vos nœuds ajoutés et vérifiés, passez à la vérification post-installation pour confirmer l'état général du système : [**Vérification post-installation →**](/learn-the-platform/fr/module-3-installation/04-post-install-verification.md) --- # 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-3-installation/03-adding-nodes.md?ask=&goal= ``` `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.