Vue d'ensemble de l'Object Storage
Des buckets S3 managés depuis le tableau de bord, accessibles avec les clients et SDK S3 standards.
SailOps Object Storage fournit à chaque projet des buckets derrière un endpoint S3 compatible. Chargez, téléchargez et gérez vos objets avec n'importe quel outil compatible S3 — AWS CLI, Boto3, le SDK AWS, le client MinIO, ou toute bibliothèque parlant S3.
Fonctionnalités principales
- API compatible S3 — Adressage path-style, uploads multipart, versioning, règles de cycle de vie
- Contrôle de visibilité — Les buckets sont privés par défaut ; activez optionnellement la lecture publique pour que quiconque possédant l'URL d'un objet puisse le télécharger
- Règles d'accès par bucket — Autorisations S3 granulaires liées à des utilisateurs de service
- Utilisateurs et clés — Créez des identités dédiées avec des clés d'accès limitées (jusqu'à deux clés actives par utilisateur)
- Navigateur d'objets — Listez, chargez, téléchargez et supprimez des objets depuis le tableau de bord
- Versioning — Activez ou suspendez le versioning par bucket ; une fois activé, il ne peut être que suspendu
- Règles de cycle de vie — Définissez la rétention des objets courants, des versions précédentes et des uploads multipart incomplets
- Suivi de l'utilisation — Facturation métrée par bucket pour le stockage, les lectures, les écritures et les téléchargements
- Tags de ressource — Organisez vos buckets avec des tags clé-valeur personnalisés
Disponibilité
L'Object Storage nécessite un compte de facturation activé. Il est indisponible pendant l'essai gratuit.
Créer un bucket
- Ouvrez Object Storage dans la barre latérale
- Cliquez sur Create bucket
- Entrez un nom de bucket (3 à 63 lettres minuscules, chiffres ou tirets ; permanent et unique sur l'endpoint)
- Cliquez sur Create bucket
Le bucket démarre en mode privé avec le versioning désactivé. Les uploads multipart incomplets sont nettoyés après sept jours par défaut ; les objets complétés n'expirent pas.
Détails de connexion
Chaque bucket expose des détails de connexion S3 standards :
| Propriété | Valeur |
|---|---|
| Endpoint S3 | Affiché sur la page du bucket |
| Région de signature | Affichée sur la page du bucket |
| Adressage | Path-style (forcePathStyle: true dans votre SDK) |
| Authentification | Clé d'accès et clé secrète d'un utilisateur de service |
Démarrage rapide avec l'AWS CLI
aws --endpoint-url <endpoint> --region <region> s3 ls s3://<bucket-name>/
Remplacez <endpoint>, <region> et <bucket-name> par les valeurs affichées sur la page du bucket.
Utilisateurs de service et clés
Les utilisateurs de service sont des identités S3 limitées à votre projet. Chaque utilisateur peut détenir jusqu'à deux clés actives, permettant une rotation sans interruption.
- Ouvrez Object Storage → Users & keys
- Cliquez sur Create user et entrez un nom
- Une fois l'utilisateur provisionné, cliquez sur Create key
- Sauvegardez la clé d'accès et la clé secrète — la clé secrète n'est affichée qu'une seule fois
Pour la rotation des identifiants : créez une clé de remplacement, mettez à jour vos applications, puis révoquez l'ancienne clé.
Les utilisateurs peuvent être suspendus (toutes leurs clés cessent de fonctionner) ou supprimés (toutes les clés sont définitivement révoquées).
Chaque carte utilisateur affiche également un résumé Bucket access listant chaque bucket accessible par l'utilisateur, le périmètre de chaque règle (bucket entier ou préfixe) et le niveau de permission. Les utilisateurs sans règle d'accès affichent un avertissement — leurs clés ne peuvent atteindre aucun bucket tant qu'une règle n'est pas ajoutée depuis l'onglet Access du bucket.
Règles d'accès
L'accès est contrôlé par bucket dans l'onglet Access. Chaque règle lie un utilisateur de service à un ensemble d'actions S3 sur le bucket entier ou un préfixe :
| Action | Description |
|---|---|
s3:GetObject | Lire les objets |
s3:GetObjectVersion | Lire les versions précédentes |
s3:PutObject | Écrire des objets |
s3:DeleteObject | Supprimer la version courante |
s3:DeleteObjectVersion | Effacer définitivement une version spécifique |
s3:AbortMultipartUpload | Abandonner un upload multipart incomplet |
s3:ListMultipartUploadParts | Lister les parties d'un upload multipart incomplet |
Chaque règle contrôle également si l'utilisateur peut lister les objets et les versions dans le périmètre défini. Le listing des uploads multipart n'est disponible que pour les règles couvrant le bucket entier — les règles limitées à un préfixe ne peuvent pas inclure cette permission. Tout utilisateur ayant une règle sur le bucket peut vérifier qu'il existe (HeadBucket S3), comme le font des outils tels que rclone au démarrage. Cela ne permet pas à un utilisateur limité à un préfixe de lister les objets hors de ce préfixe, mais avec le paramètre read-stats la réponse indique le nombre total d'objets et le volume du bucket.
Paramètres du bucket
Visibilité
| Mode | Comportement |
|---|---|
| Private | L'accès nécessite une clé S3 autorisée ou une URL signée. C'est le mode par défaut pour les nouveaux buckets. |
| Public read | Quiconque possédant l'URL d'un objet peut le lire. Le listing, les versions précédentes et les écritures restent protégés. Les lectures et téléchargements sont comptabilisés dans l'utilisation du bucket. |
Pour activer la lecture publique :
- Ouvrez l'onglet Settings du bucket
- Sous Visibility, sélectionnez Public read
- Cliquez sur Save changes
- Confirmez dans la boîte de dialogue que les objets courants seront lisibles publiquement
Vous pouvez revenir en mode privé à tout moment sans confirmation. Un bandeau d'avertissement s'affiche tant que les modifications sont en cours d'application.
Lorsqu'un bucket est en mode public-read et prêt, un bouton Copy public URL apparaît à côté de chaque objet dans le navigateur.
Activer la lecture publique rend chaque objet courant du bucket téléchargeable par quiconque connaît son URL. Les téléchargements sont facturés au propriétaire du bucket.
Versioning
| État | Signification |
|---|---|
| Disabled | État initial d'un nouveau bucket uniquement |
| Enabled | Chaque écriture crée une nouvelle version ; les suppressions créent un marqueur de suppression |
| Suspended | Les nouvelles écritures remplacent la version courante ; les versions existantes sont conservées |
Une fois activé, le versioning ne peut pas être désactivé — seulement suspendu.
Cycle de vie
- Uploads multipart incomplets — Abandonnés après un nombre configurable de jours (1–365)
- Rétention des objets courants — Les objets courants expirent après un nombre de jours (0 = conserver indéfiniment)
- Rétention des versions précédentes — Les versions précédentes sont supprimées définitivement après un nombre de jours (0 = conserver indéfiniment)
Navigateur d'objets
L'onglet Objects permet de parcourir, charger et télécharger des objets depuis le tableau de bord :
- Recherchez par préfixe et naviguez dans les dossiers
- Activez Include versions pour voir toutes les versions et les marqueurs de suppression
- Chargez un fichier directement depuis le navigateur
- Téléchargez ou supprimez des objets et versions individuels
Connexions
Vous pouvez connecter un bucket à des conteneurs et des jobs pour que SailOps injecte automatiquement les credentials et paramètres S3 dans la charge de travail. Chaque connexion crée une identité S3 dédiée, limitée au bucket, avec sa propre paire de clés d'accès.
Créer une connexion depuis la page du bucket
- Ouvrez le bucket et accédez à l'onglet Connections
- Cliquez sur Create connection
- Sélectionnez la charge de travail (conteneur ou job planifié) à connecter
- Saisissez un Alias (par défaut
AWS) - Choisissez le niveau d'accès (
readonly,readwriteoufull) - Cliquez sur Create Connection
Vous pouvez également créer des connexions Object Storage depuis l'onglet Connections d'un conteneur ou d'un job en sélectionnant Object Storage comme type cible.
Variables d'environnement injectées
| Variable (préfixée par l'alias) | Description |
|---|---|
ACCESS_KEY_ID | Clé d'accès S3 pour cette connexion |
SECRET_ACCESS_KEY | Clé secrète S3 pour cette connexion |
ENDPOINT_URL | URL de l'endpoint S3 |
ENDPOINT_URL_S3 | URL de l'endpoint S3 (spécifique au SDK) |
REGION | Région de signature S3 |
DEFAULT_REGION | Région de signature S3 (spécifique au SDK) |
BUCKET_NAME | Nom du bucket cible |
S3_FORCE_PATH_STYLE | Toujours true |
Utilisez AWS comme alias pour que les SDK AWS standards récupèrent automatiquement les credentials — AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_ENDPOINT_URL_S3, AWS_DEFAULT_REGION.
Niveaux d'accès
| Niveau | Permissions |
|---|---|
| readonly | Lecture des objets, des versions précédentes et des listings |
| readwrite | Lecture, chargement et suppression d'objets |
| full | Lecture, écriture et suppression définitive de versions individuelles |
Le niveau full autorise la suppression définitive de versions. Les paramètres du bucket, les politiques et l'administration des utilisateurs ne sont jamais accordés via les connexions.
Cycle de vie
- Les conteneurs redémarrent lorsque les variables de connexion changent ; les jobs planifiés utilisent les nouvelles valeurs à leur prochaine exécution.
- Supprimer une connexion révoque ses credentials S3 et retire les variables injectées. Le bucket et ses objets sont conservés.
- Supprimer un bucket déconnecte automatiquement toutes les charges de travail connectées.
Suppression d'un bucket
Deux options sont disponibles dans l'onglet Settings :
- Delete empty bucket — Supprime le bucket uniquement s'il ne contient aucun objet, version ou upload incomplet
- Purge bucket — Supprime définitivement le bucket et tout son contenu, y compris les versions précédentes. Nécessite de taper le nom du bucket pour confirmer.
Les deux boîtes de confirmation affichent un résumé d'impact listant les utilisateurs de service qui perdront leur accès et les charges de travail connectées dont les credentials seront révoqués. Vérifiez cette liste avant de confirmer.
Facturation
L'Object Storage utilise une facturation métrée avec quatre dimensions :
| Dimension | Unité | Description |
|---|---|---|
| Stockage | Gio-mois | Volume moyen pondéré dans le temps, versions incluses |
| Écritures et listings | Requêtes | Opérations PUT, POST, DELETE et list |
| Lectures et HEAD | Requêtes | Opérations GET et HEAD |
| Téléchargements | Gio | Octets sortants (même tarif depuis le réseau interne SailOps et Internet) |
Consultez l'utilisation et les coûts par bucket dans l'onglet Usage & costs du bucket, ou la répartition par projet depuis Object Storage → Usage & costs.