> 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

Apprenez à étendre un système VergeOS en ajoutant des nœuds scale-out, stockage seul et calcul seul à votre cluster à l’aide de l’installateur USB.

## Vue d’ensemble

Une fois votre cluster de contrôleurs à deux nœuds opérationnel, VergeOS prend en charge trois méthodes pour étendre la capacité : **nœuds d’extension horizontale** (ajoutent à la fois du calcul et du stockage à un cluster HCI existant), **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é via l’installateur USB qui détecte automatiquement le système existant sur le fabric principal.

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 :

| Prérequis                          | Détail                                                                                                                                                                                                                                                                                                         |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cluster opérationnel à 2 nœuds** | Les nœuds contrôleurs principal et secondaire du [Guide d’installation](https://docs.verge.io/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, l’affectation physique des NIC et le câblage du fabric principal doivent correspondre à la configuration documentée lors de la configuration initiale                                                                                                                                                |
| **Matériel correspondant**         | Les nœuds scale-out et de stockage seul doivent avoir des spécifications matérielles identiques (CPU, stockage, NIC, RAM) à celles des nœuds existants dans le cluster cible. Pour ajouter un matériel différent, comme une génération de serveur plus récente, créez un nouveau cluster dans le même système. |
| **Installateur USB**               | Support d’installation VergeOS correspondant à la version exécutée sur votre cluster existant                                                                                                                                                                                                                  |
| **Cluster créé dans l’interface**  | Si vous ajoutez pour la première fois un **nouveau type de cluster** (stockage seul ou calcul seul), créez le cluster dans l’interface VergeOS **avant** de démarrer l’installateur                                                                                                                            |

{% hint style="info" %}
**Système vs cluster**

Dans VergeOS, un cluster est un groupe de nœuds ayant les mêmes caractéristiques matérielles. Un système VergeOS unique peut contenir plusieurs clusters, chacun optimisé pour un profil de charge de travail ou de matériel différent. Cela diffère de certaines plateformes HCI, où « cluster » désigne l’ensemble de l’environnement. Pour plus de détails, consultez [Vue d’ensemble des clusters](https://docs.verge.io/run-the-platform/fr/administration-systeme/clusters-overview.md).
{% endhint %}

{% hint style="warning" %}
**Créer des clusters avant d’installer des 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** — il ne s’agit pas d’un choix unique l’un ou l’autre. 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’étendre la capacité ?"] --> B{"Quelle ressource\nest le goulot d’étranglement ?"}
    B -->|"Calcul\net stockage"| C["Nœud scale-out\n(extension HCI)"]
    B -->|"Stockage uniquement"| D["Nœud de stockage seul\n(stockage dédié)"]
    B -->|"Calcul uniquement"| 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 : Compute Only\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"                                 | "Compute Only"                                                                                                                               |
| **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 par 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 (si c’est le premier nœud de stockage)  | Oui (si c’est le 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 scale-out

Les nœuds scale-out sont la manière la plus simple d’étendre un cluster HCI. Ils ajoutent proportionnellement des capacités de calcul et de stockage, à l’aide d’un matériel identique à celui des nœuds contrôleurs existants.

### Étapes d’installation

1. **Démarrez à partir de l’installateur USB VergeOS**
   * Insérez l’installateur USB dans le serveur désigné comme nœud scale-out
   * Redémarrez et sélectionnez le lecteur 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 du 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 d’administration**
   * Fournissez le nom d’utilisateur et le mot de passe d’administration 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 fabric principal en écoutant les paquets UDP provenant des nœuds existants

   * Vérifiez que les NIC détectées correspondent à votre plan de câblage documenté

   > **Astuce :** L’installateur peut vous demander d’identifier quelle NIC est utilisée pour le réseau **Externe** 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 possède 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 auquel ce nouveau nœud ressemble le plus sur le plan matériel
6. **Configuration des disques vSAN**
   * L’installateur affiche les disques détectés et les affectations de niveaux proposées
   * Confirmez que les niveaux de stockage correspondent à la configuration existante du cluster — **l’uniformité est essentielle**
   * Vérifiez 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 USB de l’installateur lorsque cela vous est demandé
8. **Vérifier 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 statut 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’ajout du nœud, vSAN redistribuera les données pour inclure les nouveaux disques. L’état du niveau peut passer au **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 étendent 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 le 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 le **Stockage** interrupteur et laissez **Calcul** désactivé
4. Enregistrez la configuration

### Étapes d’installation

L’installation d’un nœud de stockage seul utilise la **même option d’installateur "Scale-Out"** qu’un nœud scale-out standard. La différence principale est que le nœud rejoint un cluster de stockage seul au lieu d’un cluster HCI.

1. **Démarrage depuis l’installateur USB** — identique au scale-out
2. **Sélectionnez le type de nœud → "Scale-Out"** — l’installateur utilise "Scale-Out" pour les nœuds HCI comme pour les nœuds de stockage seul
3. **Saisissez les identifiants d’administration** — authentifiez-vous auprès du système existant
4. **Détection automatique du réseau** — vérifiez l’affectation 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érifier dans l’interface** — confirmez que le nœud apparaît sous le bon cluster de stockage dans la page Nœuds

{% hint style="success" %}
Comme les nœuds de stockage seul utilisent l’option d’installateur "Scale-Out", la différence réside dans 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, en option, GPU, sans participer au stockage vSAN. Ils sont idéaux pour les charges de travail qui nécessitent une grande puissance de traitement — apprentissage automatique, rendu, VDI ou analyse de données.

### Préinstallation : créer le 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 le **Calcul** interrupteur et laissez **Stockage** désactivé
4. Enregistrez la configuration

### Étapes d’installation

1. **Démarrage depuis l’installateur USB** — identique aux autres types de nœuds
2. **Sélectionnez le type de nœud → "Compute Only"** — il s’agit d’une option d’installateur distincte, différente de "Scale-Out"
3. **Saisissez les identifiants d’administration** — authentifiez-vous auprès du système existant
4. **Détection automatique du réseau** — vérifiez l’affectation des NIC
5. **Sélection du cluster** (facultatif) — si demandé, 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 par PXE, auquel cas aucun lecteur de démarrage local n’est nécessaire. Le nœud redémarre automatiquement.
7. **Vérifier dans l’interface** — confirmez que le nœud apparaît sous le bon cluster de calcul dans la page Nœuds

{% hint style="info" %}
Les nœuds de calcul seul n’ont **aucune étape de configuration de disque vSAN**. Ils accèdent au stockage via le fabric principal à partir des nœuds des clusters HCI ou de stockage seul. C’est la principale différence avec les installations scale-out et de stockage seul.
{% endhint %}

## Bonnes pratiques d’ordre d’installation

Lors du déploiement d’un système multi-clusters (architecture UCI), suivez l’ordre recommandé suivant :

```mermaid
flowchart LR
    A["1. Nœuds contrôleurs\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 contrôleurs** — ils constituent le cluster fondation avec le stockage de métadonnées de niveau 0
2. **Ajoutez ensuite les nœuds de stockage** — cela garantit que la capacité de stockage vSAN est disponible avant que les nœuds de calcul en aient besoin
3. **Ajoutez les nœuds de calcul en dernier** — ils peuvent accéder immédiatement au stockage via le fabric principal

Au sein de n’importe quel cluster, **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 que les opérations de redistribution/reconstruction vSAN se chevauchent à 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 `Esc`      | Passe à une invite de commandes                                  |
| **Reprendre l’installation**    | `yb-install`           | Reprend là où l’installateur s’est arrêté                        |
| **Recommencer 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 fabric principal 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

**Le 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’une bande passante suffisante est disponible entre les nœuds sur le fabric principal
* Contactez le support VergeOS si la reconstruction se bloque au-delà des délais attendus

**L’installateur ne peut pas détecter automatiquement le réseau :**

* Vérifiez que les ports du commutateur du fabric principal sont configurés correctement (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 l’ajout d’un nœud, vérifiez les points suivants :

* [ ] Le nœud apparaît sur la **Infrastructure → Nœuds** page avec un statut opérationnel
* [ ] Le nœud affiche la bonne affectation de cluster
* [ ] Pour les nœuds scale-out/de stockage : **Système → vSAN** affiche tous les nouveaux disques avec les affectations de niveaux correctes
* [ ] Pour les nœuds scale-out/de stockage : les niveaux vSAN reviennent à **vert** (état sain) une fois la reconstruction terminée
* [ ] Connectivité du fabric principal confirmée : **Diagnostics du nœud → Configuration du fabric** indique `confirmé : true` 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 fabric principal et s’authentifie avec les identifiants d’administration — les rôles contrôleur, scale-out, 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 intégré au système d’exploitation — et scale-out, stockage seul et calcul seul sont des rôles de nœud de premier ordre, sélectionnés via l’option de l’installateur et le cluster cible ; un seul installateur USB couvre les trois.
{% endhint %}

## Points clés

| Concept                           | Résumé                                                                                                                        |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Trois types de nœuds**          | Scale-out (HCI), stockage seul et calcul seul — chacun avec un rôle spécifique                                                |
| **Installateur unique**           | Un seul support d’installation USB prend en charge tous les types de nœuds via la sélection de menu                           |
| **Détection automatique**         | Les nœuds détectent automatiquement le système sur le fabric principal                                                        |
| **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 dans un cluster pour éviter le chevauchement des opérations de redistribution/reconstruction vSAN |
| **Le stockage avant le calcul**   | Dans les déploiements UCI, ajoutez d’abord les nœuds de stockage, puis les nœuds de calcul                                    |
| **Reconstruction vSAN**           | Après l’ajout de nœuds apportant du stockage, attendez que les niveaux vSAN redeviennent verts avant de poursuivre            |

## É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 →**](https://docs.verge.io/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/learn-the-platform/fr/module-3-installation/03-adding-nodes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
