# 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.

Source: https://gheima.ma/fr/docs/persistent-volumes

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. **Ouvrez Paramètres** — Sur la page du service, ouvrez l’onglet Paramètres et trouvez Volumes persistants.
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. **Redéployer pour appliquer** — Le montage prend effet au prochain déploiement. Cliquez sur « Déployer » quand vous êtes prêt.

### Via la CLI

```bash
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

```bash
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.

> Note: 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.

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

---

All docs: https://gheima.ma/fr/docs.md