Aller au contenu principal

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​

  1. Ouvrez Object Storage dans la barre latérale
  2. Cliquez sur Create bucket
  3. Entrez un nom de bucket (3 à 63 lettres minuscules, chiffres ou tirets ; permanent et unique sur l'endpoint)
  4. 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 S3Affiché sur la page du bucket
Région de signatureAffichée sur la page du bucket
AdressagePath-style (forcePathStyle: true dans votre SDK)
AuthentificationClé 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.

  1. Ouvrez Object Storage → Users & keys
  2. Cliquez sur Create user et entrez un nom
  3. Une fois l'utilisateur provisionné, cliquez sur Create key
  4. 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 :

ActionDescription
s3:GetObjectLire les objets
s3:GetObjectVersionLire les versions précédentes
s3:PutObjectÉcrire des objets
s3:DeleteObjectSupprimer la version courante
s3:DeleteObjectVersionEffacer définitivement une version spécifique
s3:AbortMultipartUploadAbandonner un upload multipart incomplet
s3:ListMultipartUploadPartsLister 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é​

ModeComportement
PrivateL'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 readQuiconque 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 :

  1. Ouvrez l'onglet Settings du bucket
  2. Sous Visibility, sélectionnez Public read
  3. Cliquez sur Save changes
  4. 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.

attention

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​

ÉtatSignification
DisabledÉtat initial d'un nouveau bucket uniquement
EnabledChaque écriture crée une nouvelle version ; les suppressions créent un marqueur de suppression
SuspendedLes 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)

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​

  1. Ouvrez le bucket et accédez à l'onglet Connections
  2. Cliquez sur Create connection
  3. Sélectionnez la charge de travail (conteneur ou job planifié) à connecter
  4. Saisissez un Alias (par défaut AWS)
  5. Choisissez le niveau d'accès (readonly, readwrite ou full)
  6. 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_IDClé d'accès S3 pour cette connexion
SECRET_ACCESS_KEYClé secrète S3 pour cette connexion
ENDPOINT_URLURL de l'endpoint S3
ENDPOINT_URL_S3URL de l'endpoint S3 (spécifique au SDK)
REGIONRégion de signature S3
DEFAULT_REGIONRégion de signature S3 (spécifique au SDK)
BUCKET_NAMENom du bucket cible
S3_FORCE_PATH_STYLEToujours true
astuce

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​

NiveauPermissions
readonlyLecture des objets, des versions précédentes et des listings
readwriteLecture, chargement et suppression d'objets
fullLecture, écriture et suppression définitive de versions individuelles
attention

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 :

DimensionUnitéDescription
StockageGio-moisVolume moyen pondéré dans le temps, versions incluses
Écritures et listingsRequêtesOpérations PUT, POST, DELETE et list
Lectures et HEADRequêtesOpérations GET et HEAD
TéléchargementsGioOctets 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.

Sujets Connexes​