Aller au contenu

Aller au sommaire de la doc

Dépôt git

Votre code reste sur GitHub ou GitLab, ou vit dans le dépôt git de l’appli chez while. Chaque push met en ligne : la branche principale en production, une demande de fusion ou une autre branche en prévisualisation.

Mis à jour le 21 novembre 2026.

Voir en Markdown

Mise en production à chaque git push depuis GitHub ou GitLab : le code poussé dans l’appli, la branche principale en production

Vous, à votre IA : Lie l’appli à notre dépôt GitHub, pour mettre en ligne à chaque push.

Quand vous en servir

Servez-vous-en pour mettre en ligne à chaque push, sans rien lancer d’autre : depuis votre dépôt GitHub ou GitLab, qui reste votre dépôt principal, ou depuis le dépôt git de l’appli chez while.

Comment ça marche

Votre code peut rester sur GitHub ou GitLab. Une personne lie le dépôt dans les réglages de l’appli (Code et budget › Lier un dépôt), ou votre agent avec link_git_repo { forge, repo, token }. Le jeton de la forge lit le dépôt, pose des statuts, commente et gère les webhooks : sur GitLab, la portée « api » ; sur GitHub, un jeton à grain fin avec Contents en lecture, et Commit statuses, Pull requests et Webhooks en écriture. Il va au coffre de while. Un GitLab auto-hébergé se donne par base_url.

Une fois le dépôt lié, un push sur sa branche par défaut met la production en ligne, et les autres branches ne mettent rien en ligne. Chaque demande de fusion ouvre une prévisualisation (pr-<n> sur GitHub, mr-<n> sur GitLab), dont while écrit l’adresse en commentaire, et que la fermeture de la demande détruit. Chaque construction pose son statut sur le commit.

Si la mise en ligne doit rester dans votre CI, comme GitHub Actions, votre workflow met l’appli en ligne avec un jeton du projet. Une personne le crée dans while, page Agents › Créer un jeton pour une CI (l’appli, « Mettre en ligne et lire », « La production seulement ») ; un agent branché par un jeton le crée avec create_token { project, name, environments: ["production"] }. Gardez-le dans les secrets du dépôt, sous WHILE_TOKEN. Après actions/checkout, une étape envoie les sources, ici pour le projet planning :

L'étape de la CI
tar -czf - --exclude=.git . | curl -sS --fail-with-body -X POST \
  -H "Authorization: Bearer $WHILE_TOKEN" \
  -H 'content-type: application/gzip' \
  --data-binary @- \
  https://app.while.sh/v1/projects/planning/environments/production/deploy

Une CI qui construit elle-même son image l’envoie à la même adresse, en JSON : { image, digest }.

Chaque projet a aussi son dépôt git chez while, à l’adresse https://app.while.sh/git/<projet>.git, que donnent aussi les réglages de l’appli. Un jeton while y sert de mot de passe ; un agent branché par OAuth demande à get_git_credentials un identifiant valable une heure. Un push sur main met la production en ligne, et un push sur une autre branche crée une prévisualisation.

Ce qu’il faut savoir

Une demande venue d’un fork attend qu’une personne du projet autorise chaque commit dans while, et ne reçoit aucun secret du projet.

Délier, par le bouton des réglages ou avec link_git_repo { unlink: true }, retire la liaison et son webhook.

Les outils MCP de votre agent

Votre agent s’en occupe avec les outils link_git_repo, create_token et get_git_credentials.

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