Points de montage

Les points de montage sont le côté client du partage de fichiers sur Stack Harbor PaaS. Là où les exports déclarent ce qu’un conteneur de stockage met à disposition, les points de montage déclarent ce qu’un conteneur client veut consommer — et la plateforme prend en charge le câblage entre les deux.

Un point de montage relie un répertoire local sur le conteneur client à un répertoire distant sur un serveur. Après le montage, le client peut lire et écrire les fichiers distants comme s’ils étaient locaux. La connexion survit aux redémarrages ; la plateforme conserve les entrées de montage avec le conteneur.

Protocoles client

Deux protocoles client sont supportés :

• NFS — disponible sur tous les types de conteneurs. Mature, bien compris, surcoût plus faible. Le choix par défaut.
• GlusterFS Native — disponible uniquement contre un serveur grappe GlusterFS. Sémantiques de réplication et de bascule natives, recommandé quand la performance d’écriture sous charge concurrente ou la sécurité des données prime.

Le sélecteur de protocole n’apparaît dans la fenêtre que lorsque le serveur est une grappe GlusterFS. Pour tout le reste, NFS est la seule option.

Créer un point de montage

1. Cliquez sur Config à côté du conteneur ou palier client. (Monter au niveau palier applique le montage à chaque nœud du palier.)

2. Passez à Mount Points dans le menu de gauche.

3. Cliquez sur Mount dans la barre d’outils.

4. Choisissez le type d’opération :

   • Data Container — le serveur est un nœud du même compte (typiquement un conteneur de stockage partagé).
   • Master Container — le serveur est le nœud maître du palier courant. Sert à partager des données entre les nœuds d’un même palier.
   • External Server — le serveur est hors du compte. Vous fournissez son IP ou son domaine.

5. Renseignez les détails du type choisi :

   • Mount Point — le chemin local sur le client où les données distantes apparaîtront. Si le répertoire n’existe pas, il est créé.
   • NFS Server (Data Container) — choisissez le nœud source dans la liste déroulante.
   • NFS Server (Master Container) — prérempli avec le maître du palier.
   • NFS Server (External Server) — l’IP ou le domaine externe du serveur.
   • Remote Path — le répertoire sur le serveur.
   • Client Type (uniquement si le serveur est GlusterFS) — choisissez NFS ou Gluster Native.
   • Mount to all nodes — activé, applique le montage à chaque nœud du palier, y compris ceux à venir. Auto-activé pour les montages Master Container.
   • Read Only — activé, le client ne peut pas modifier les fichiers distants.

6. Cliquez sur Add.

Si le conteneur de données choisi n’est pas un conteneur de stockage partagé dédié, attendez-vous à un délai unique de quelques minutes la première fois — la plateforme installe le client NFS sur le conteneur source.

Chemins réservés

Le chemin local du point de montage a des restrictions. Il ne peut pas commencer par /proc, /dev, /sys, /run, ni être égal à :

/, /bin, /lib, /lib64, /lib32, /usr, /usr/bin, /usr/sbin, /usr/lib, /usr/lib64

La liste exacte varie selon la région. Choisissez un chemin sous l’arborescence propre à votre application pour rester à l’écart.

Après le montage

Le montage apparaît dans la liste. À partir de là :

• Double-cliquez sur la ligne, ou choisissez Navigate to directory, pour ouvrir le dossier monté dans le gestionnaire de fichiers.
• Unmount retire la connexion. Le répertoire local du point de montage reste mais vide.

Quand vous entrez dans le montage, vous voyez le même contenu que sur le serveur distant. Si le montage est au niveau palier, vous pouvez basculer entre les nœuds via la liste déroulante du menu de gauche — le contenu est identique sur tous.

Permissions d’écriture

Si vous avez accordé lecture/écriture au moment du montage, ce n’est que la moitié de l’histoire. Le dossier côté serveur doit aussi laisser l’utilisateur dans le conteneur client y écrire.

Les piles de conteneurs ont des utilisateurs par défaut différents — root sur certaines, jelastic sur d’autres. Si l’UID/GID dans le client ne correspond pas à l’ownership du dossier côté serveur, les écritures échouent avec EACCES même si la permission NFS est rw.

La correction est côté serveur : connectez-vous en SSH et ajustez l’ownership :

chown {uid}:{gid} {path}

où :

• {uid} — nom d’utilisateur ou ID, depuis /etc/passwd du conteneur client.
• {gid} — nom de groupe ou ID, depuis /etc/group du conteneur client.
• {path} — le répertoire où le client écrit.

La suite

• Exports de stockage — le côté serveur de la même opération, initiée depuis le conteneur de stockage.
• Stockage NFS externe — quand le serveur est hors du compte.
• NFS — notes au niveau protocole, options de montage par défaut et limitations.
• GlusterFS — quand choisir Gluster Native plutôt que NFS comme protocole client.