Skip to content

Fonctionnement d'un bucket

Déclaration et instances par environnement, hébergement OVHcloud, régions, compte d'accès dédié et les six identifiants fournis à vos services.

ConceptDeveloper

This page has not been translated yet and is shown in French.

Un bucket Wakastart est un espace de stockage objet compatible S3, propre à un environnement de votre application. Wakastart le crée chez OVHcloud, lui associe un compte d'accès dédié et transmet ses identifiants à vos services par liaison de variables.

Définition

Comme une base de données, un bucket existe à deux niveaux :

  • la déclaration, dans l'architecture de l'application, porte un nom, un identifiant court et une région par défaut ;
  • l'instance, dans un environnement, est le bucket réel. Chaque environnement a le sien : les fichiers de dev ne sont jamais mélangés à ceux de prod.

Un bucket n'est pas un disque monté dans vos conteneurs : votre code y lit et y écrit par l'API S3, avec un SDK.

Comment ça marche

Hébergement et région

Les buckets créés depuis la console sont hébergés sur OVHcloud Object Storage, dans la région choisie à la déclaration : Gravelines (GRA) par défaut, Strasbourg (SBG), Beauharnois (BHS) ou Varsovie (WAW). Le point d'accès S3 dépend de la région, par exemple https://s3.gra.io.cloud.ovh.net.

Compte d'accès dédié

Pour chaque bucket, Wakastart crée un utilisateur OVHcloud et une clé d'accès S3. Ce compte peut :

  • lister le contenu du bucket et en connaître la région ;
  • lire, écrire et supprimer des objets ;
  • gérer les envois en plusieurs parties (multipart).

Il ne peut ni créer d'autre bucket, ni lister les buckets du projet, ni supprimer le bucket lui-même. Une fuite de ces identifiants n'expose donc que ce bucket.

Les six identifiants

ChampContenuExemple
endpointpoint d'accès S3https://s3.gra.io.cloud.ovh.net
regioncode de régiongra
bucketnom réel du bucketà lire dans la variable
access_key_ididentifiant de la clé d'accèsà lire dans la variable
secret_access_keyclé secrètejamais affichée
s3_urlURL au format s3://<bucket>s3://<bucket>

Quand le bucket est Prêt, ces champs apparaissent dans l'onglet Configuration de l'environnement, filtre Stockage, sous des clés <IDENTIFIANT>_<CHAMP> en majuscules. Pour un bucket d'identifiant court docs : DOCS_ENDPOINT, DOCS_REGION, DOCS_BUCKET, DOCS_ACCESS_KEY_ID, DOCS_SECRET_ACCESS_KEY, DOCS_S3_URL. Les entrées …_SECRET_ACCESS_KEY et …_S3_URL sont sensibles.

Lisez toujours le nom du bucket dans …_BUCKET plutôt que de le recopier depuis la console : c'est la valeur que reçoit votre conteneur.

Statuts

CodeLibelléSignification
PENDINGEn attentedemande enregistrée
PROVISIONINGProvisionnementcréation du bucket et du compte d'accès
READYPrêtbucket utilisable, identifiants disponibles, explorateur actif
FAILEDErreurcréation échouée ; Wakastart réessaie
DESTROYINGSuppressionsuppression en cours
DESTROYEDSupprimébucket supprimé

Exemples

  • Une application qui reçoit des pièces jointes : un bucket docs déclaré avec la création automatique, donc présent dans dev, staging et prod. Le back relie S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_ACCESS_KEY_ID et S3_SECRET_ACCESS_KEY aux entrées DOCS_….
  • Des exports lourds séparés des documents : un second bucket exports, avec son propre compte d'accès, que seul le service de génération d'exports consomme.

Pour aller plus loin