Connecter un service à un bucket
Reliez les variables d'un service aux identifiants d'un bucket, puis lisez et écrivez des fichiers avec le SDK S3 d'AWS.
- Accès requis
- Profil Infra (droit « Infra Client »)
- Durée
- 10 min
Votre code accède au bucket par l'API S3. Il lui faut cinq valeurs : le point d'accès, la région, le nom du bucket, l'identifiant de la clé d'accès et sa clé secrète. Ce guide les relie aux variables de votre service, puis montre un envoi et une lecture de fichier en TypeScript.
Avant de commencer
- Le bucket est Prêt dans l'environnement : voir Provisionner un bucket.
- La définition du service déclare les variables attendues, par exemple
S3_ENDPOINT,S3_REGION,S3_BUCKET,S3_ACCESS_KEY_IDetS3_SECRET_ACCESS_KEY. Voir Variables et secrets. - Le service est déployé dans l'environnement.
Relier les variables
Ouvrir la configuration du service
- Dans l'environnement, ouvrez l'onglet Services et cliquez sur le service.
- Cliquez sur l'onglet Configuration du service (N).
Choisir les entrées du bucket
Pour chaque variable, ouvrez la liste Choisir une valeur... et sélectionnez l'entrée correspondante du bucket, ici d'identifiant court docs :
| Variable du service | Entrée à choisir |
|---|---|
S3_ENDPOINT | DOCS_ENDPOINT |
S3_REGION | DOCS_REGION |
S3_BUCKET | DOCS_BUCKET |
S3_ACCESS_KEY_ID | DOCS_ACCESS_KEY_ID |
S3_SECRET_ACCESS_KEY | DOCS_SECRET_ACCESS_KEY |
Enregistrer
Cliquez sur Enregistrer la configuration.
Le message Configuration enregistrée s'affiche et le service est redéployé.
Répétez la liaison dans chaque environnement : chacun a son propre bucket et ses propres identifiants.
Lire et écrire des fichiers
Installez le client S3 du SDK AWS :
npm install @aws-sdk/client-s3Puis, dans votre service :
import { S3Client, PutObjectCommand, ListObjectsV2Command } from "@aws-sdk/client-s3";
const s3 = new S3Client({
endpoint: process.env.S3_ENDPOINT,
region: process.env.S3_REGION,
credentials: {
accessKeyId: process.env.S3_ACCESS_KEY_ID!,
secretAccessKey: process.env.S3_SECRET_ACCESS_KEY!,
},
});
const Bucket = process.env.S3_BUCKET!;
await s3.send(
new PutObjectCommand({
Bucket,
Key: "factures/2026/facture-0001.pdf",
Body: Buffer.from("%PDF-1.7 exemple"),
ContentType: "application/pdf",
}),
);
const listing = await s3.send(new ListObjectsV2Command({ Bucket, Prefix: "factures/" }));
console.log(listing.Contents?.map((o) => ({ key: o.Key, size: o.Size })));Résultat attendu dans les logs du service :
[ { key: 'factures/2026/facture-0001.pdf', size: 16 } ]Note
Le compte d'accès n'a de droits que sur ce bucket. Une commande qui vise un autre bucket, liste les buckets du projet ou supprime le bucket est refusée avec une erreur AccessDenied.
Vérifier le résultat
- Dans l'onglet Storage de l'environnement, cliquez sur Explorer sur la ligne du bucket.
- Ouvrez le dossier
factures/, puis2026/: le fichierfacture-0001.pdfapparaît avec sa taille.