Volumes Persistants
Stockez des données qui persistent entre les redémarrages et redéploiements de conteneurs.
Par défaut, les conteneurs sur SailOps utilisent un stockage éphémère — les données sont perdues lorsque le conteneur redémarre. Les Volumes Persistants vous permettent d'attacher un stockage durable à un conteneur pour que les fichiers soient préservés entre les redémarrages, redéploiements et mises à jour. Vous pouvez attacher jusqu'à 5 volumes par conteneur, chacun avec son propre chemin de montage, sa taille et sa classe de stockage.
Quand Utiliser les Volumes Persistants
| Cas d'Utilisation | Solution Recommandée |
|---|---|
| Bases de données SQLite | Volume Persistant |
| Uploads de fichiers | Volume Persistant |
| Cache applicatif sur disque | Volume Persistant |
| Fichiers de modèles ML | Volume Persistant |
| Bases de données relationnelles | PostgreSQL Managé ou MariaDB |
| Cache clé-valeur | Valkey Managé |
| Stockage objet (S3) | Service S3 externe |
| Stockage partagé entre réplicas | Volumes Partagés (RWX) |
Si votre application a besoin d'une vraie base de données, utilisez PostgreSQL Managé ou MariaDB. Les bases de données managées offrent des sauvegardes automatiques, la haute disponibilité et le connection pooling.
Limitations Importantes
Attacher un ou plusieurs volumes persistants à un conteneur impose les contraintes suivantes :
| Contrainte | Raison |
|---|---|
| Limité à 1 réplica | Les volumes ne peuvent être montés que par un seul pod à la fois (ReadWriteOnce) |
| Autoscaling désactivé | Le scaling horizontal est incompatible avec des volumes single-instance |
| Brève interruption lors des redéploiements | L'ancienne instance doit s'arrêter avant que la nouvelle ne démarre (stratégie Recreate) |
| La taille des volumes ne peut pas être réduite | Kubernetes ne supporte pas la réduction des PersistentVolumeClaims |
| Maximum 5 volumes | Limite par conteneur |
Contrairement aux conteneurs standard qui utilisent des mises à jour progressives, les conteneurs avec des volumes persistants subissent une brève interruption (généralement 10–30 secondes) lors des redéploiements.
Configurer les Volumes
Lors de la Création du Conteneur
- Naviguez vers Conteneurs → Créer Conteneur
- Dans la section Ressources & Scaling, cliquez sur Add Volume
- Configurez chaque volume :
- Name : Un identifiant unique pour le volume (minuscules, tirets autorisés, ex :
data,uploads,cache) - Mount Path : Chemin absolu dans le conteneur (ex :
/data,/app/uploads) - Storage Class : Standard (5K IOPS) ou Performance (15K IOPS)
- Size : Taille du volume de 1 Go à 100 Go
- Name : Un identifiant unique pour le volume (minuscules, tirets autorisés, ex :
- Ajoutez d'autres volumes si nécessaire (jusqu'à 5)
- Complétez le reste du formulaire et créez le conteneur
Sur un Conteneur Existant
- Allez dans votre conteneur → Edit
- Dans la section Ressources & Scaling, ajoutez, modifiez ou supprimez des volumes
- Cliquez sur Save
Retirer un volume du formulaire du conteneur le détache : le conteneur ne le monte plus, mais les données sont conservées. Le volume reste listé dans la section Volumes avec le badge Detached et continue d'être facturé. Pour le supprimer définitivement, ouvrez sa page de détail et cliquez sur Delete.
Via l'API Publique
Créer un conteneur avec plusieurs volumes :
curl -X POST \
-H "X-Api-Key: $SAILOPS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "my-app",
"spec": {
"computeClass": "standard",
"image": "myapp:latest",
"resources": {"cpu": 500, "memory": 512},
"volumes": [
{
"name": "data",
"mountPath": "/data",
"sizeInMB": 2048,
"storageClass": "standard"
},
{
"name": "uploads",
"mountPath": "/app/uploads",
"sizeInMB": 10240,
"storageClass": "performance"
}
]
}
}' \
https://app.sailops.io/api/public/api/v1/containers
Pour les volumes partagés, consultez la section Volumes Partagés pour des exemples d'API.
Spécification du Volume
| Champ | Type | Requis | Description |
|---|---|---|---|
name | string | Oui | Nom unique du volume (alphanumérique minuscule + tirets, max 63 caractères) |
mountPath | string | Oui | Chemin absolu dans le conteneur (ex : /data) |
sizeInMB | integer | Oui | Taille du volume en mégaoctets. Min : 1024 (1 Go), Max : 102400 |
storageClass | string | Non | standard (5K IOPS) ou performance (15K IOPS). Par défaut : standard |
Classes de Stockage
| Classe de Stockage | IOPS | Cas d'Utilisation |
|---|---|---|
| Standard | 5K | Charges générales, stockage de fichiers, caches |
| Performance | 15K | Bases de données (SQLite), applications à haut débit |
Commencez avec Standard pour la plupart des charges de travail. Passez à Performance pour un I/O disque élevé (bases de données embarquées, logging intensif, écritures fréquentes).
Gestion des Volumes
Agrandir un Volume
Vous pouvez augmenter la taille d'un volume existant à tout moment :
- Allez dans votre conteneur → Edit
- Augmentez le curseur de taille du volume
- Cliquez sur Save
Le volume est agrandi sans perte de données. Le conteneur redémarre pour appliquer le changement.
Une fois un volume créé, sa taille ne peut qu'augmenter.
Ajouter un Volume à un Conteneur Existant
- Allez dans votre conteneur → Edit
- Cliquez sur Add Volume dans la section Ressources & Scaling
- Configurez le nouveau volume (nom, chemin de montage, taille, classe de stockage)
- Cliquez sur Save
Détacher un Volume
- Allez dans votre conteneur → Edit
- Cliquez sur le bouton de retrait du volume à détacher
- Confirmez le détachement
- Cliquez sur Save
Le volume est détaché du conteneur mais ses données sont préservées. Il apparaît dans la liste Volumes avec un badge Detached et reste facturé. Pour le rattacher, ajoutez un volume portant le même nom dans le formulaire du conteneur.
Supprimer un Volume Détaché
- Allez dans Volumes et cliquez sur le volume détaché
- Cliquez sur Delete
- Confirmez la suppression
La suppression d'un volume détaché le retire définitivement, ainsi que sa planification de snapshots et tous ses snapshots, de SailOps. Un nouveau volume portant le même nom sera vide.
Cycle de Vie du Volume
Comportements clés :
- Arrêt/Démarrage : Tous les volumes persistent lorsque le conteneur est arrêté
- Redéploiement : Brève interruption — l'ancien pod s'arrête, le nouveau démarre avec tous les volumes remontés
- Détachement : Les données sont conservées ; le volume reste listé et facturé jusqu'à suppression explicite
- Suppression d'un volume détaché : Le volume, ses snapshots et sa planification sont définitivement supprimés
- Suppression du conteneur : Tous les volumes et leurs données sont définitivement supprimés
- Suspension du projet : Les volumes persistent pendant la suspension du projet
Exemples de Configuration
Application Web avec Base de Données et Uploads
{
"volumes": [
{ "name": "db", "mountPath": "/app/data", "sizeInMB": 1024, "storageClass": "performance" },
{ "name": "uploads", "mountPath": "/app/uploads", "sizeInMB": 10240, "storageClass": "standard" }
]
}
WordPress avec Thèmes et Uploads
{
"volumes": [
{ "name": "uploads", "mountPath": "/var/www/html/wp-content/uploads", "sizeInMB": 20480, "storageClass": "standard" },
{ "name": "themes", "mountPath": "/var/www/html/wp-content/themes", "sizeInMB": 1024, "storageClass": "standard" }
]
}
Bonnes Pratiques
Nommez vos Volumes de Manière Significative
Utilisez des noms descriptifs comme data, uploads, cache, logs — ils apparaissent dans l'interface et sont utilisés dans le nommage des PVC.
Choisir le Bon Chemin de Montage
- Utilisez des répertoires dédiés (ex :
/data,/app/storage) - Évitez les répertoires système (
/etc,/proc,/sys,/bin, etc.) - Assurez-vous que votre application a les permissions d'écriture sur le chemin de montage
Mixer les Classes de Stockage
Utilisez Performance pour les volumes à fort I/O (bases de données) et Standard pour le stockage en volume (uploads, caches) afin d'optimiser les coûts.
Sauvegarder les Données Importantes
- Utilisez les Snapshots de Volume pour des sauvegardes ponctuelles
- Configurez des planifications de snapshots automatiques pour les données critiques
- Avant de supprimer un volume, créez un snapshot ou exportez les données importantes
Volumes Partagés (RWX)
Les volumes partagés fournissent un stockage ReadWriteMany (RWX) que plusieurs conteneurs, jobs et cronjobs peuvent monter simultanément. Contrairement aux volumes bloc (qui sont liés à un seul conteneur), les volumes partagés sont gérés indépendamment et persistent indépendamment du cycle de vie de toute charge de travail.
Quand utiliser les volumes partagés
| Cas d'Utilisation | Solution |
|---|---|
| Partager des données entre plusieurs conteneurs | Volume Partagé |
| Partager des données entre conteneurs et jobs | Volume Partagé |
| Stockage persistant pour un seul conteneur | Volume Bloc |
| Stockage de base de données | PostgreSQL Managé ou MariaDB |
Créer un volume partagé
- Naviguez vers Volumes dans la barre latérale du projet
- Cliquez sur Create Shared Volume
- Configurez le volume :
- Name : Alphanumérique minuscule avec tirets (max 60 caractères)
- Size : De 1 Go à 1 To
- Description : Description optionnelle
- Cliquez sur Create
Le volume est provisionné de manière asynchrone. Son statut passe de Pending à Ready une fois le provisionnement terminé.
Monter un volume partagé
Les volumes partagés peuvent être montés sur des conteneurs, jobs et cronjobs :
- Modifiez un conteneur (ou créez un job/cronjob)
- Dans la section Volumes, cliquez sur Add Shared Volume
- Sélectionnez le nom du volume et définissez le Mount Path
- Activez optionnellement le mode Read Only
- Sauvegardez
Un volume partagé peut être monté par plusieurs charges de travail en même temps. Toutes les charges de travail voient les mêmes données.
Redimensionner un volume partagé
- Allez à la page de détails du volume partagé
- Cliquez sur Resize
- Entrez la nouvelle taille (doit être plus grande que la taille actuelle)
- Cliquez sur Confirm
Les volumes partagés ne peuvent être que agrandis, jamais réduits.
Supprimer un volume partagé
- Allez à la page de détails du volume partagé
- Cliquez sur Delete
- Confirmez la suppression
Un volume partagé ne peut pas être supprimé tant qu'il est encore monté par un conteneur, job ou cronjob. Démontez-le d'abord de toutes les charges de travail.
Sauvegarder et restaurer un volume partagé
Ouvrez la page de détail du volume partagé, puis utilisez l'onglet Snapshots pour créer un snapshot manuel ou configurer une planification automatique. Restaurer un snapshot prêt ne remplace ni n'arrête le volume source : SailOps crée un volume partagé distinct sous le nouveau nom choisi.
Le volume restauré apparaît d'abord avec le statut Pending. Son provisionnement est enregistré et repris automatiquement : fermer la page ou perdre la connexion de la requête ne l'annule pas. Le nom cible reste réservé pendant cette opération et ce volume ne peut pas être supprimé tant que la restauration n'est pas terminée ou abandonnée de manière sûre. Attendez le statut Ready avant de le monter dans une charge de travail.
Le nom cible ne doit pas être déjà utilisé par un autre volume partagé ou par une restauration en cours. SailOps n'écrase jamais un volume portant le même nom.
Via l'API Publique
Créer un volume partagé :
curl -X POST \
-H "X-Api-Key: $SAILOPS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "shared-data",
"sizeInMB": 10240,
"description": "Données partagées entre workers"
}' \
https://app.sailops.io/api/public/api/v1/shared-volumes
Le monter sur un conteneur :
curl -X PATCH \
-H "X-Api-Key: $SAILOPS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "myapp:latest",
"sharedVolumeMounts": [
{
"volumeName": "shared-data",
"mountPath": "/mnt/shared"
}
]
}' \
https://app.sailops.io/api/public/api/v1/containers/my-worker
Spécification du volume partagé
| Champ | Type | Requis | Description |
|---|---|---|---|
name | string | Oui | Nom du volume (alphanumérique minuscule + tirets, max 60 caractères) |
sizeInMB | integer | Oui | Taille du volume en mégaoctets. Min : 1024 (1 Go), Max : 1048576 (1 To) |
description | string | Non | Description optionnelle (max 256 caractères) |
Spécification SharedVolumeMount
| Champ | Type | Requis | Description |
|---|---|---|---|
volumeName | string | Oui | Nom d'un volume partagé existant dans le projet |
mountPath | string | Oui | Chemin de montage absolu dans le conteneur |
readOnly | boolean | Non | Monter en lecture seule. Par défaut : false |
Snapshots de Volume
Les Snapshots de Volume vous permettent de créer des sauvegardes ponctuelles de vos volumes persistants. Vous pouvez créer des snapshots manuellement, configurer des planifications automatiques et restaurer un volume à un état précédent.
Accéder aux snapshots de volume
- Accédez à la page de détail du volume (cliquez sur le nom du volume dans la liste Volumes ou dans l'onglet Volumes du conteneur)
- Ouvrez l'onglet Snapshots
Un volume bloc détaché affiche toujours ses snapshots existants et permet de les supprimer, mais vous ne pouvez pas créer de nouveaux snapshots ni restaurer tant que le volume n'est pas rattaché à son conteneur.
Créer un snapshot manuel
- Ouvrez la page de détail du volume → onglet Snapshots
- Cliquez sur Create Snapshot
- Le snapshot apparaît dans la liste avec le statut Pending
- Une fois terminé, le statut passe à Ready
Statuts des snapshots
| Statut | Description |
|---|---|
| Pending | Le snapshot est en cours de création |
| Ready | Le snapshot est terminé et disponible pour la restauration |
| Error | La création du snapshot a échoué |
Types de snapshots
| Type | Description |
|---|---|
| Manual | Créé à la demande par un utilisateur |
| Scheduled | Créé automatiquement par une planification de snapshots |
Configurer une planification de snapshots
Automatisez la création de snapshots avec une planification basée sur cron :
- Sur la page de détail du volume → onglet Snapshots, cliquez sur Configure Schedule (ou Configure si une planification existe déjà)
- Définissez l'expression Cron (format standard à 5 champs, ex :
0 2 * * *pour tous les jours à 2h00 UTC) - Définissez le Retention Count — nombre maximum de snapshots planifiés à conserver (par défaut : 10)
- Définissez le Retention Days — âge maximum des snapshots en jours (par défaut : 30)
- Cliquez sur Save Schedule
La tâche de rétention retire les entrées de snapshot de SailOps. La classe de
snapshot des volumes bloc utilise actuellement la politique fournisseur
Retain : le contenu sous-jacent peut donc subsister jusqu'à son nettoyage par
l'infrastructure.
L'intervalle de planification doit être d'au moins 1 heure entre les snapshots.
Pour désactiver une planification existante, cliquez sur Disable sur la carte de planification.
Restaurer à partir d'un snapshot
La restauration à partir d'un snapshot provoque une interruption temporaire. Un conteneur actif est arrêté, le volume est remplacé par les données du snapshot, puis le conteneur n'est redémarré qu'une fois le nouveau volume prêt. Un conteneur déjà arrêté reste arrêté.
- Dépliez le volume et cliquez sur le bouton de restauration d'un snapshot Ready
- Vérifiez l'avertissement concernant l'interruption
- Cliquez sur Restore pour confirmer
Le processus de restauration :
- Arrête le conteneur (y compris l'autoscaling)
- Attend la terminaison de tous les pods
- Supprime le PersistentVolumeClaim actuel
- Crée un nouveau PVC à partir du snapshot en conservant son mode d'accès, sa classe de stockage, son contrat de taille et les métadonnées utilisateur
- Attend que le nouveau PVC passe à l'état Bound
- Redémarre le conteneur uniquement s'il était actif avant la restauration
Supprimer un snapshot
- Cliquez sur le bouton de suppression sur la ligne du snapshot
- Confirmez la suppression
La suppression retire de SailOps l'entrée restaurable et ne peut pas être
annulée depuis le produit. Comme la classe fournisseur utilise Retain, le
snapshot sous-jacent peut toujours exister et nécessiter un nettoyage par
l'infrastructure.
Détails d'un snapshot
Cliquez sur le bouton d'information d'un snapshot pour consulter :
- Snapshot ID — identifiant unique
- Status — état actuel (Pending, Ready, Error)
- Type — Manual ou Scheduled
- Created / Ready At — dates de demande et de disponibilité CSI
- Size — taille de restauration publiée par le driver CSI
- Description / Created By — métadonnées lorsqu'elles ont été fournies
- Restorable / Error — possibilité de restaurer et erreur CSI éventuelle
- Volume — le nom du volume
Dépannage
Conteneur Bloqué en Pending Après Ajout d'un Volume
- Le volume est peut-être en cours de provisionnement (30–60 secondes)
- Vérifiez l'onglet Événements pour des erreurs liées au stockage
- Assurez-vous que la taille est dans les limites (1 Go – 100 Go par volume)
Permission Refusée sur le Chemin de Montage
SailOps définit automatiquement un groupe de système de fichiers (fsGroup 1000) sur les pods avec des volumes persistants afin que les images non-root puissent écrire sur leurs volumes quel que soit l'UID utilisé. Si vous rencontrez encore des problèmes de permissions :
- Vérifiez que votre application écrit dans le chemin de montage configuré, et non dans un répertoire parent hors du volume
- Vérifiez que l'image ne redéfinit pas le groupe avec un
GIDincompatible dans son entrypoint
Données Non Persistantes
- Vérifiez que votre application écrit dans le chemin de montage configuré
- Vérifiez que le volume est toujours attaché dans les détails du conteneur
- Assurez-vous que les écritures vont dans le chemin du volume, pas dans
/tmp(qui est éphémère)