---
title: "Déployer depuis GitHub ou GitLab à chaque push, avec while.sh"
url: https://while.sh/fr/guides/garder-github-gitlab/
author: "Aloïs Oddon, cofondateur de Nextmap"
updated: 2026-11-16
---

# Garder GitHub ou GitLab comme dépôt principal, et mettre en ligne à chaque push

Votre code reste sur GitHub ou GitLab. Un push sur la branche par défaut met la production en ligne, chaque demande de fusion ouvre une prévisualisation dont l'adresse arrive en commentaire, et chaque commit reçoit son statut.

## Prérequis

- Une appli sur while.
- Son dépôt sur GitHub ou GitLab, et le droit d'y créer un jeton d'accès.

## Étape 1 : Créez un jeton d'accès

Sur GitHub, créez un jeton à grain fin limité à ce dépôt. Donnez-lui Contents en lecture, et Webhooks, Commit statuses et Pull requests en écriture.

Sur GitLab, créez un jeton avec la portée `api`. Votre compte doit avoir le rôle Maintainer sur le projet.

## Étape 2 : Liez le dépôt

Dans while, ouvrez les réglages de l'appli, à la section Code et budget, puis cliquez sur Lier un dépôt. Choisissez GitHub ou GitLab, collez le dépôt et le jeton. Le dépôt s'écrit `atelier/boutique`, ou se colle tel que vous le copiez depuis GitHub ou GitLab.

Votre agent peut aussi le lier, avec l'outil `link_git_repo` :

> Vous, à votre agent : Lie l'appli à notre dépôt GitHub atelier/boutique.

Il le lie avec le jeton que vous lui donnez. Avec ChatGPT et Codex, le jeton ne passe pas par l'agent : il vous donne le lien du formulaire de while, où vous le collez.

## Ce qui se passe à chaque push

Un push sur la branche par défaut du dépôt, `main` le plus souvent, met la production en ligne. Une autre branche ne la touche pas.

Une demande de fusion ouvre une prévisualisation, `pr-12` sur GitHub ou `mr-12` sur GitLab, construite depuis son dernier commit. Son adresse arrive en commentaire de la demande dès qu'elle répond, et la prévisualisation est retirée quand la demande est fermée ou fusionnée.

Chaque commit reçoit son statut sur GitHub ou GitLab : en construction, en ligne ou en échec, avec le lien vers l'appli.

Quand une mise en ligne doit être validée par une personne, le statut du commit le dit, avec le lien de la demande. Une fois validée, elle part d'elle-même.

Une demande de fusion venue d'un fork ne se construit pas d'elle-même. Une personne du projet qui peut mettre en ligne autorise chaque commit dans while, et la prévisualisation ne reçoit aucun secret du projet.

## Délier le dépôt

Dans les réglages de l'appli, Délier retire le webhook chez GitHub ou GitLab et efface le jeton de while. Un push ne met plus l'appli en ligne.

> Vous, à votre agent : Délie le dépôt GitHub de l'appli.

## L'autre voie : pousser depuis GitHub Actions

Si vous préférez garder la mise en ligne dans votre CI, votre workflow pousse le code vers le dépôt git de l'appli chez while, avec un jeton limité à cette appli.

Dans while, ouvrez la page Agents et cliquez sur Créer un jeton pour une CI. Choisissez l'appli, « Mettre en ligne et lire », et la production comme seul endroit où il agit. Copiez-le : il ne s'affiche qu'une fois.

Dans GitHub, ajoutez-le aux secrets du dépôt sous le nom `WHILE_TOKEN`, puis ajoutez ce workflow :

```yaml titre=".github/workflows/while.yml"
name: while
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - run: git push "https://while:${WHILE_TOKEN}@app.while.sh/git/boutique.git" HEAD:main
        env:
          WHILE_TOKEN: ${{ secrets.WHILE_TOKEN }}
```

Remplacez l'adresse par celle de votre appli, que ses réglages donnent à la ligne Dépôt git. Un push sur `main` chez while met la production en ligne. Le workflow récupère tout l'historique du dépôt : git refuse de pousser un clone sans son historique vers un autre dépôt.

## Prochaines étapes

- [Voir chaque nouvelle version avant la production](/fr/guides/previsualisation-par-branche/)
- [Le dépôt git de chaque appli](/fr/docs/briques/git/)

## Questions

### Faut-il encore pousser vers le dépôt git de while ?

Non. Une fois le dépôt lié, un push sur GitHub ou GitLab suffit.

### Que devient le jeton ?

Il est gardé dans le coffre de while. Il ne se relit jamais, ni dans while ni par votre agent.

### Je lie un autre dépôt. Que devient le premier ?

Il est délié, et son webhook est retiré. Seul le nouveau dépôt met l'appli en ligne.

### Mon GitLab est chez nous. Ça marche ?

Oui, comme un GitHub Enterprise. Collez l'adresse du dépôt, et la forge se reconnaît à son adresse.
