Aller au contenu

Aller au sommaire de la doc

Services web

Votre appli, construite depuis ses sources et servie en HTTPS. while reconnaît Node.js, Python ou Go, joue vos tests et garde chaque version.

Mis à jour le 21 novembre 2026.

Voir en Markdown

Mettre une appli Node.js, Python, Go ou un Dockerfile en production : le code construit, testé et servi en HTTPS

Vous, à votre IA : Mets mon appli en ligne avec while.

Ce que votre agent écrit

Votre agent l’écrit dans while.yaml, à la racine de votre appli :

while.yaml
apiVersion: while/v1
project: my-app
services:
  - name: web
    title: Lecture des ventes
    port: 3000
    health: { path: /health }
    build:
      args: { VITE_TITRE: Ventes }
      secrets: [NPM_TOKEN]

Ce que reçoit votre appli

Votre appli reçoit ces variables d’environnement à chaque mise en ligne :

VariableCe qu’elle contient
PORTLe port sur lequel votre appli écoute, celui de while.yaml.
HOSTL’adresse d’écoute, 0.0.0.0.
WHILE_RELEASEL’identifiant de la version en ligne.

Quand vous en servir

Servez-vous-en pour tout ce qui répond à des requêtes HTTP : un site, une API, une appli pour des personnes.

Comment ça marche

while construit votre appli depuis ses sources et la sert en HTTPS. Il reconnaît Node.js, Python ou Go et écrit le Dockerfile, ou prend le vôtre, puis joue vos tests et fige l’image de chaque version.

Ce qu’il faut savoir

Un projet a jusqu’à 10 services. Un service non public (public: false) n’a pas d’adresse sur Internet.

build.args passe à la construction des valeurs qui ne sont pas secrètes (—build-arg), et refuse un nom qui ressemble à un secret (TOKEN, KEY, SECRET, PASSWORD). Les secrets de construction, comme NPM_TOKEN pour un registre npm privé, se nomment dans build.secrets. Leur valeur se pose à part, avec set_env { build: true } (8 caractères au moins), jamais dans while.yaml. Un secret déjà posé pour l’appli passe à la construction, ou l’inverse, avec set_env { move: "NOM", build: true } ou dans les réglages de l’appli, sans que sa valeur repasse par vous.

Un secret de construction est monté le temps d’un RUN dans /run/secrets/<NOM>, jamais dans l’image, et masqué au journal. Une construction ne lit jamais les secrets de l’appli, et l’appli ne reçoit jamais ceux de la construction. Chaque environnement a les siens, et une prévisualisation venue d’un fork n’en reçoit aucun. Toute construction de l’environnement les lit, avant même la validation d’une mise en production : donnez un jeton en lecture seule.

Pour un registre npm privé, un .npmrc à la racine du service lit la variable (//npm.acme.fr/:_authToken=${NPM_TOKEN}, ou ${NPM_TOKEN:-} dans .yarnrc.yml), et le Dockerfile généré ne la donne qu’à l’installation. Avec votre propre Dockerfile, écrivez RUN --mount=type=secret,id=NPM_TOKEN NPM_TOKEN=$(cat /run/secrets/NPM_TOKEN) npm ci, et ne copiez jamais /run/secrets/<NOM> dans l’image. Après la construction, while cherche la valeur des secrets dans les dossiers de l’appli (/app, /srv, /opt, /home, /usr/local…) : s’il la trouve, la construction échoue avec le Dockerfile généré, et continue avec un avertissement au journal avec le vôtre.

Une appli Node démarrée directement par node (scripts.start : node server.js) n’a ni npm, ni npx, ni yarn dans son image. Lancez un binaire de dépendance par ./node_modules/.bin/<nom>, par exemple command: [./node_modules/.bin/prisma, migrate, deploy] ; une commande du while.yaml qui appelle npm, npx ou yarn les garde. De même, une appli Python n’a ni pip, ni setuptools, ni wheel dans son image, sauf si une commande du while.yaml appelle pip.

Prix

Ces prix sont les mêmes dans toutes les offres, hors taxes :

RessourcePrixDétail
Processeur et mémoire17 € par vCPU et par mois, 8,50 € par Gio et par moisapplis à la consommation, caches à la réservation

Les outils MCP de votre agent

Votre agent s’en occupe avec les outils deploy_app, get_app_status et set_env.

Guides

Donnez la phrase à votre IA, elle s’occupe du reste

À donner à votre IA

Lis while.sh/agents et aide-moi à démarrer avec while.

Copier la phrase

En 3 minutes, sans inscription, l’outil a son adresse. Pour le garder, créez votre compte.

Pour un projet d’entreprise, écrivez à l’équipe de while : hello@while.sh