Stocker les fichiers de votre appli dans un bucket S3, depuis votre agent IA

Prérequis

• Une appli Node.js, Python ou Go.
• Un agent IA qui travaille dans un terminal : Claude Code, Codex, Cursor ou Gemini CLI.

Étape 1 : Donnez ces instructions à votre agent

Ouvrez votre agent dans le dossier de votre appli, et collez-lui ces instructions :

Connecte-toi à while avec mon compte (while.sh/agents), puis mets mon appli en ligne.

Votre agent ajoute lui-même le serveur MCP de while. S’il vous le demande, relancez-le. Au premier appel à while, une page s’ouvre dans votre navigateur. Dans Claude Code, si elle ne s’ouvre pas, tapez /mcp, choisissez while, puis Authenticate. Sur cette page, choisissez « Une nouvelle appli », puis cliquez sur Autoriser.

Étape 2 : Ouvrez votre appli

Votre agent vous donne l’adresse de votre appli, par exemple https://mon-appli.while.cloud, en HTTPS.

Ce que fait votre agent

Il ajoute deux lignes à while.yaml :

apiVersion: while/v1
project: mon-appli
services:
  - name: web
    port: 3000
    health:
      path: /health
buckets:
  - name: uploads

Le nom du bucket arrive à votre appli dans S3_BUCKET_UPLOADS, l’adresse du stockage dans S3_ENDPOINT et sa région dans S3_REGION. Sa clé arrive là où le SDK d’AWS la cherche de lui-même¹ :

import { S3Client } from '@aws-sdk/client-s3';

const s3 = new S3Client({
  endpoint: process.env.S3_ENDPOINT,
  region: process.env.S3_REGION,
  forcePathStyle: true,
});

Récupérer un fichier effacé par erreur

Le bucket garde l’ancien contenu d’un fichier remplacé ou effacé pendant 30 jours, et votre agent le remet en place.

Garder la clé du bucket secrète

Votre agent ne la voit jamais : elle n’arrive qu’à votre appli, dans ses variables.

Ajouter une base de données

Votre agent déclare la base dans while.yaml, et son adresse arrive à votre code dans DATABASE_URL. Elle est sauvegardée chaque jour, et revient à un instant précis si besoin.

Réserver votre appli à vos collègues

Votre agent ajoute deux lignes au service :

    access: internal
    email_domains: [acme.fr]

Une fois votre Google Workspace ou Microsoft 365 relié à while, avec l’offre Pro, vos collègues l’ouvrent avec leur compte habituel, et votre code reçoit leur nom et leur adresse électronique, sans page de connexion à écrire.

Revenir à la version d’avant

Dans les 30 minutes qui suivent une mise en ligne, la version d’avant revient en une seconde. Ensuite, en quelques secondes. Une fois la version d’avant revenue, votre agent lit ce qui a cassé dans les journaux de while, corrige et remet en ligne.

Dans la doc : Stockage objet (S3), Bases PostgreSQL, Cache Valkey (Redis), Accès interne, Domaine personnalisé et Versions et retour arrière.

Prochaines étapes

• Mettre en ligne une API Node.js et sa base PostgreSQL
• Ajouter un cache compatible Redis
• Comparer les hébergeurs qui ont un serveur MCP