Volumes persistants

Attachez un disque durable à un service pour que les données écrites sur un point de montage survivent aux redémarrages et redéploiements.

Un volume persistant est un disque durable attaché à un service sur un point de montage. Les fichiers que votre app y écrit survivent aux redémarrages, redéploiements et réordonnancements — contrairement au reste du système de fichiers du service, réinitialisé à chaque déploiement.

Attacher un volume#

  1. 1

    Ouvrir Réglages

    Sur la page du service, ouvrez l’onglet Réglages et trouvez Volumes.

  2. 2

    Nouveau volume

    Cliquez sur « Nouveau volume », saisissez un point de montage absolu (ex. /data) et un nom optionnel, puis enregistrez.

  3. 3

    Redéployer pour appliquer

    Le montage prend effet au prochain déploiement — cliquez sur « Déployer » quand vous êtes prêt.

Via la CLI#

Shell
gheima volumes add my-app /data --name uploads
gheima volumes list my-app
Attachez et listez les volumes d’un service (par id, nom ou slug).

Via l’API#

Shell
curl -X POST https://gheima.ma/api/v1/services/{id}/volumes \
  -H "Authorization: Bearer $GHEIMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"uploads","mountPath":"/data"}'
Retourne l’id du nouveau volume ; DELETE sur /volumes/{volumeId} pour le détacher.

Détacher un volume#

Détacher retire le montage au prochain déploiement. Le disque sous-jacent est conservé, pas supprimé, pour qu’un détachement accidentel ne détruise pas de données.

Les volumes sont locaux au nœud : la plateforme épingle un service ayant des volumes au nœud où il est planifié, pour que ses disques le suivent à chaque déploiement. Ils ne sont ni partagés entre services ni sauvegardés automatiquement — copiez ce qui compte vers le stockage d’objets si vous avez besoin d’une durabilité au-delà du nœud.

Limites & règles#

  • Un seul volume par point de montage et par service — attacher un second volume au même chemin est refusé.
  • Le point de montage doit être absolu, normalisé (pas de segments « . » ou « .. »), et ne peut pas cibler un répertoire système réservé (/etc, /bin, /usr, etc.).
  • Les points de montage sont limités à 512 caractères.
  • Le nombre maximal de volumes sur votre compte dépend de votre offre.

✦ Votre service dispose d’un stockage durable, par nœud, pour les uploads, caches ou toute donnée qui doit survivre à un déploiement.