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.

Voir en MarkdownOuvrir dans ClaudeOuvrir dans ChatGPT

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

Attacher un volume#

  1. 1

    Ouvrez Paramètres

    Sur la page du service, ouvrez l’onglet Paramètres et trouvez Volumes persistants.

  2. 2

    Ajouter un volume

    Cliquez sur « Ajouter un volume », saisissez un chemin de montage absolu (par exemple /data) et un nom facultatif, 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://api.gheima.ma/v1/services/{id}/volumes \
  -H "Authorization: Bearer $GHEIMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"uploads","mountPath":"/data"}'
Renvoie l’id du nouveau volume. Pour le détacher, envoyez DELETE à la même URL suivie de /{volumeId}.

Détacher un volume#

Détacher retire le montage au prochain déploiement. Un volume détaché ne peut pas être rattaché, et ses données sont définitivement supprimées 7 jours après le détachement. Si le service n’a pas été redéployé d’ici là, la suppression attend qu’il le soit. Copiez ce que vous voulez garder avant de détacher le volume.

Les volumes sont locaux au nœud. La plateforme épingle un service qui a des volumes au nœud où il tourne, pour que ses disques le suivent d’un déploiement à l’autre. Les volumes ne sont ni partagés entre services ni sauvegardés automatiquement. Si vous avez besoin d’une durabilité au-delà d’un seul nœud, copiez ce qui compte vers le stockage objet.

Limites & règles#

  • Un service ne peut avoir qu’un volume par chemin de montage. Attacher un second volume au même chemin est refusé.
  • Le chemin de montage doit être absolu et normalisé, sans segment vide, « . » ou « .. ». Chaque segment n’accepte que des lettres, des chiffres, « . », « _ » et « - ». Le chemin ne peut pas être / ni se trouver sous /bin, /boot, /dev, /etc, /lib, /proc, /root, /sbin, /sys ou /usr.
  • Les points de montage sont limités à 512 caractères.
  • Le nombre maximal de volumes sur votre compte dépend de votre plan.

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