---
title: "Déployer depuis GitHub, GitLab ou git : la doc de while.sh"
url: https://while.sh/fr/docs/briques/git/
updated: 2026-11-21
---

# 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.

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

```bash titre="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

- [Voir chaque nouvelle version avant la production, comme un environnement de recette (2026)](/fr/guides/previsualisation-par-branche/)
- [Garder GitHub ou GitLab comme dépôt principal, et mettre en production à chaque push (2026)](/fr/guides/garder-github-gitlab/)
