Aller au contenu

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.

Par Aloïs Oddon, cofondateur de Nextmap. Faits relevés le 16 novembre 2026.

Voir en Markdown

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 :

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

Dans la doc : Dépôt git, Prévisualisations et Variables et secrets.

Prochaines étapes

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.

Branchez votre agent, il s’occupe du reste

À coller dans votre agent

Lis while.sh/agents, puis mets mon appli en ligne avec while.

Copier les instructions

Pas besoin de compte pour essayer : votre appli est en ligne tout de suite. Pour la garder, connectez-vous.

Un projet pour votre entreprise ? Parlez à l’équipe : hello@while.sh