Aller au contenu

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.

GuideDéveloppeur
Accès requis
Profil Infra (droit « Infra Client »)
Durée
10 min
Voir en Markdown

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_ID et S3_SECRET_ACCESS_KEY. Voir Variables et secrets.
  • Le service est déployé dans l'environnement.

Relier les variables

Ouvrir la configuration du service

  1. Dans l'environnement, ouvrez l'onglet Services et cliquez sur le service.
  2. 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 serviceEntrée à choisir
S3_ENDPOINTDOCS_ENDPOINT
S3_REGIONDOCS_REGION
S3_BUCKETDOCS_BUCKET
S3_ACCESS_KEY_IDDOCS_ACCESS_KEY_ID
S3_SECRET_ACCESS_KEYDOCS_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 :

Bash
npm install @aws-sdk/client-s3

Puis, dans votre service :

TypeScript
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 :

Texte
[ { 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

  1. Dans l'onglet Storage de l'environnement, cliquez sur Explorer sur la ligne du bucket.
  2. Ouvrez le dossier factures/, puis 2026/ : le fichier facture-0001.pdf apparaît avec sa taille.

Voir aussi