Aller au contenu principal

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'UtilisationSolution Recommandée
Bases de données SQLiteVolume Persistant
Uploads de fichiersVolume Persistant
Cache applicatif sur disqueVolume Persistant
Fichiers de modèles MLVolume Persistant
Bases de données relationnellesPostgreSQL Managé ou MariaDB
Cache clé-valeurValkey Managé
Stockage objet (S3)Service S3 externe
Stockage partagé entre réplicasVolumes Partagés (RWX)
Quand NE PAS Utiliser les Volumes

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 :

ContrainteRaison
Limité à 1 réplicaLes 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éploiementsL'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éduiteKubernetes ne supporte pas la réduction des PersistentVolumeClaims
Maximum 5 volumesLimite par conteneur
Pas de Mise à Jour Sans Interruption

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​

  1. Naviguez vers Conteneurs → Créer Conteneur
  2. Dans la section Ressources & Scaling, cliquez sur Add Volume
  3. 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
  4. Ajoutez d'autres volumes si nécessaire (jusqu'à 5)
  5. Complétez le reste du formulaire et créez le conteneur

Sur un Conteneur Existant​

  1. Allez dans votre conteneur → Edit
  2. Dans la section Ressources & Scaling, ajoutez, modifiez ou supprimez des volumes
  3. Cliquez sur Save
Détachement, pas suppression

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​

ChampTypeRequisDescription
namestringOuiNom unique du volume (alphanumérique minuscule + tirets, max 63 caractères)
mountPathstringOuiChemin absolu dans le conteneur (ex : /data)
sizeInMBintegerOuiTaille du volume en mégaoctets. Min : 1024 (1 Go), Max : 102400
storageClassstringNonstandard (5K IOPS) ou performance (15K IOPS). Par défaut : standard

Classes de Stockage​

Classe de StockageIOPSCas d'Utilisation
Standard5KCharges générales, stockage de fichiers, caches
Performance15KBases de données (SQLite), applications à haut débit
Choisir une Classe de Stockage

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 :

  1. Allez dans votre conteneur → Edit
  2. Augmentez le curseur de taille du volume
  3. Cliquez sur Save

Le volume est agrandi sans perte de données. Le conteneur redémarre pour appliquer le changement.

La Taille Ne Peut Pas Être Réduite

Une fois un volume créé, sa taille ne peut qu'augmenter.

Ajouter un Volume à un Conteneur Existant​

  1. Allez dans votre conteneur → Edit
  2. Cliquez sur Add Volume dans la section Ressources & Scaling
  3. Configurez le nouveau volume (nom, chemin de montage, taille, classe de stockage)
  4. Cliquez sur Save

Détacher un Volume​

  1. Allez dans votre conteneur → Edit
  2. Cliquez sur le bouton de retrait du volume à détacher
  3. Confirmez le détachement
  4. 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é​

  1. Allez dans Volumes et cliquez sur le volume détaché
  2. Cliquez sur Delete
  3. Confirmez la suppression
Perte de Données

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'UtilisationSolution
Partager des données entre plusieurs conteneursVolume Partagé
Partager des données entre conteneurs et jobsVolume Partagé
Stockage persistant pour un seul conteneurVolume Bloc
Stockage de base de donnéesPostgreSQL Managé ou MariaDB

Créer un volume partagé​

  1. Naviguez vers Volumes dans la barre latérale du projet
  2. Cliquez sur Create Shared Volume
  3. Configurez le volume :
    • Name : Alphanumérique minuscule avec tirets (max 60 caractères)
    • Size : De 1 Go à 1 To
    • Description : Description optionnelle
  4. 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 :

  1. Modifiez un conteneur (ou créez un job/cronjob)
  2. Dans la section Volumes, cliquez sur Add Shared Volume
  3. Sélectionnez le nom du volume et définissez le Mount Path
  4. Activez optionnellement le mode Read Only
  5. Sauvegardez
Montages multiples

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é​

  1. Allez à la page de détails du volume partagé
  2. Cliquez sur Resize
  3. Entrez la nouvelle taille (doit être plus grande que la taille actuelle)
  4. Cliquez sur Confirm
Agrandissement seulement

Les volumes partagés ne peuvent être que agrandis, jamais réduits.

Supprimer un volume partagé​

  1. Allez à la page de détails du volume partagé
  2. Cliquez sur Delete
  3. Confirmez la suppression
Impossible de supprimer les volumes montés

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.

Utilisez un nouveau nom

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é​

ChampTypeRequisDescription
namestringOuiNom du volume (alphanumérique minuscule + tirets, max 60 caractères)
sizeInMBintegerOuiTaille du volume en mégaoctets. Min : 1024 (1 Go), Max : 1048576 (1 To)
descriptionstringNonDescription optionnelle (max 256 caractères)

Spécification SharedVolumeMount​

ChampTypeRequisDescription
volumeNamestringOuiNom d'un volume partagé existant dans le projet
mountPathstringOuiChemin de montage absolu dans le conteneur
readOnlybooleanNonMonter 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​

  1. 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)
  2. Ouvrez l'onglet Snapshots
Volumes détachés

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​

  1. Ouvrez la page de détail du volume → onglet Snapshots
  2. Cliquez sur Create Snapshot
  3. Le snapshot apparaît dans la liste avec le statut Pending
  4. Une fois terminé, le statut passe à Ready

Statuts des snapshots​

StatutDescription
PendingLe snapshot est en cours de création
ReadyLe snapshot est terminé et disponible pour la restauration
ErrorLa création du snapshot a échoué

Types de snapshots​

TypeDescription
ManualCréé à la demande par un utilisateur
ScheduledCréé automatiquement par une planification de snapshots

Configurer une planification de snapshots​

Automatisez la création de snapshots avec une planification basée sur cron :

  1. Sur la page de détail du volume → onglet Snapshots, cliquez sur Configure Schedule (ou Configure si une planification existe déjà)
  2. Définissez l'expression Cron (format standard à 5 champs, ex : 0 2 * * * pour tous les jours à 2h00 UTC)
  3. Définissez le Retention Count — nombre maximum de snapshots planifiés à conserver (par défaut : 10)
  4. Définissez le Retention Days — âge maximum des snapshots en jours (par défaut : 30)
  5. 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.

Intervalle minimum

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​

Interruption pendant la restauration

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

  1. Dépliez le volume et cliquez sur le bouton de restauration d'un snapshot Ready
  2. Vérifiez l'avertissement concernant l'interruption
  3. Cliquez sur Restore pour confirmer

Le processus de restauration :

  1. Arrête le conteneur (y compris l'autoscaling)
  2. Attend la terminaison de tous les pods
  3. Supprime le PersistentVolumeClaim actuel
  4. 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
  5. Attend que le nouveau PVC passe à l'état Bound
  6. Redémarre le conteneur uniquement s'il était actif avant la restauration

Supprimer un snapshot​

  1. Cliquez sur le bouton de suppression sur la ligne du snapshot
  2. Confirmez la suppression
attention

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 GID incompatible 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)

Sujets Connexes​