Système de fichiers distribué CephFS

Objectif

Ce guide fournit des instructions détaillées pour créer, gérer et monter un système de fichiers CephFS destiné à vos services OVHcloud. Il couvre l'intégralité du processus de configuration via l'API OVHcloud, afin de vous permettre d'intégrer efficacement CephFS à votre environnement cloud.

Prérequis

• Disposer d'une solution Cloud Disk Array

Accès à l'espace client OVHcloud

• Lien direct : Cloud Disk Array
• Pour accéder à vos services : Bare Metal Cloud > Cloud Disk Array > Sélectionnez votre service

Qu'est-ce que CephFS ?

CephFS est un système de fichiers distribué, conforme à la norme POSIX et bâti sur Ceph. Pour utiliser CephFS, vous avez besoin d'un client qui le prend en charge : les distributions Linux modernes incluent le pilote CephFS par défaut.

Vous pouvez activer et gérer CephFS sur votre Cloud Disk Array (CDA) via l'API OVHcloud. Une fois activé, CephFS fonctionne comme un système de fichiers privé et dédié à votre usage. Vous pouvez utiliser RBD et CephFS simultanément, mais notez qu'ils partagent le même matériel sous-jacent.

En pratique

Activer CephFS

Actuellement, un seul système de fichiers peut être activé, et il doit être nommé fs-default.

La première étape consiste à lister vos instances CephFS existantes. Ici, serviceName correspond au fsid de votre cluster :

Par défaut, cette requête renvoie une liste vide. Pour créer votre premier système de fichiers, vous devez l'activer :

Votre CephFS devrait être disponible en quelques minutes. Vous pouvez vérifier son état directement sur votre cluster en exécutant :

sudo ceph --id [USERID] fs ls

Le résultat doit ressembler à ceci :

name: fs-default, metadata pool: cephfs.fs-default.meta, data pools: [cephfs.fs-default.data ]

Si vous souhaitez obtenir davantage de détails sur votre CephFS, exécutez :

sudo ceph --id [USERID] fs get fs-default

Le résultat doit ressembler à ceci :

Filesystem 'fs-default' (1)
fs_name fs-default
epoch   16
flags   33 allow_snaps allow_multimds_snaps allow_standby_replay
created 2025-08-19T10:53:19.756188+0000
modified    2025-08-19T11:01:14.983793+0000
tableserver 0
root    0
session_timeout 60
session_autoclose   300
max_file_size   1099511627776
required_client_features    {}
last_failure    0
last_failure_osd_epoch  926
compat  compat={},rocompat={},incompat={1=base v0.20,2=client writeable ranges,3=default file layouts on dirs,4=dir inode in separate object,5=mds uses versioned encoding,6=dirfrag is stored in omap,7=mds uses inline data,8=no anchor table,9=file layout v2,10=snaprealm v2}
max_mds 1
in  0
up  {}
failed  0
damaged
stopped
data_pools  [5]
metadata_pool   6
inline_data disabled
balancer   
standby_count_wanted    2

Désactiver et supprimer CephFS

Lorsque votre système de fichiers n'est plus nécessaire, vous pouvez le supprimer en deux étapes :

• Désactiver votre système de fichiers - Cette opération bloque l'accès à CephFS, mais vos données restent intactes. Si besoin, vous pouvez le réactiver ultérieurement.

• Purger les données du système de fichiers – Cette opération supprime définitivement toutes les données et ne peut être effectuée que sur un système de fichiers désactivé.

Gestion des accès à CephFS

Pour gérer l'accès à CephFS, les mêmes règles d'ACL IP que celles utilisées pour votre CDA s'appliquent. En revanche, pour écrire dans CephFS, vous devez créer un utilisateur dédié. Vous pouvez suivre ce guide.

Accordez ensuite à cet utilisateur les droits de lecture et d'écriture sur les pools de données et de métadonnées de CephFS :

• cephfs.fs-default.data
• cephfs.fs-default.meta

Pour plus de détails, consultez ce guide.

Monter CephFS sur votre hôte

Installez le paquet ceph-common, qui fournit le binaire /sbin/mount.ceph. Le nom du paquet peut varier selon votre distribution Linux.

Dans l'exemple ci-dessous, nous utilisons un système basé sur Debian :

sudo apt install --no-install-recommends ceph-common

Configurez ensuite votre client pour qu'il se connecte au cluster CDA, en modifiant (ou en créant) le fichier /etc/ceph/ceph.conf.

1. Créez le répertoire de configuration de Ceph :

sudo mkdir -p /etc/ceph

2. Créez et modifiez le fichier ceph.conf :

sudo nano /etc/ceph/ceph.conf

3. Ajoutez la section [global] avec les adresses IP publiques de vos moniteurs. Vous trouverez ces adresses IP sur la page principale de votre Cloud Disk Array, dans l'espace client OVHcloud.

[global]

#Specific fsid   
fsid = aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

#Force use secure protocol
ms_client_mode = secure

#Force the messenger v2 protocol
ms_bind_msgr2 = true

# Use the PUBLIC IPs provided for your Cloud Disk Array
mon_host =A.B.X.Y:6789,A.B.X.Y:6789,A.B.X.Y:6789

Le FSID correspond au nom de service de votre CDA. Les adresses IP des hôtes moniteurs peuvent être récupérées à l'aide de l'appel API suivant :

4. Enregistrez et fermez le fichier.

Vous aurez également besoin d'un second fichier contenant la clé de l'utilisateur qui se connecte au cluster. Récupérez la clé de l'utilisateur à l'aide de l'appel API suivant :

Créez ensuite un fichier de secret pour cet utilisateur :

1. Créez un fichier nommé /etc/ceph/[USERID].secret

sudo nano /etc/ceph/[USERID].secret

2. Ajoutez la clé de l'utilisateur dans le fichier, au format approprié :

YOUR_SECRET_KEY_FOR_USER

3. Appliquez des permissions strictes sur le fichier de secret afin de garantir la sécurité :

sudo chmod 600 /etc/ceph/[USERID].secret

Vous pouvez enfin monter votre système de fichiers :

mkdir /mnt/cephfs
mount -t ceph -o name=[USERID],secretfile=/etc/ceph/[USERID].secret :/ /mnt/cephfs/

Aller plus loin

Rendez-vous sur notre chaîne Discord dédiée : https://discord.gg/ovhcloud. Posez des questions, fournissez des commentaires et interagissez directement avec l'équipe qui construit nos services de stockage et de sauvegarde.

• Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

• Échangez avec notre communauté d'utilisateurs.