Connexion de repositories Git
Ce que vous allez apprendre
Dans cette page vous allez apprendre à connecter des repositories Git à DeployIt (via OAuth ou GitHub App), lister et supprimer des repos liés à un projet, afficher les branches et tester l’accès. Vous verrez aussi comment DeployIt crée automatiquement des webhooks pour les push/PR et quels outils de diagnostic et de gestion des tokens sont disponibles. Cette page est destinée aux utilisateurs non techniques — les explications sont simples et étape par étape.
Connexion de repositories Git
OAuth, GitHub App, webhooks et diagnostics
Connectez vos dépôts, testez l’accès et laissez DeployIt gérer les webhooks et les tokens.
Capacités principales
Connexion simple
Ajoutez un repo via OAuth (GitHub/GitLab) ou installez la GitHub App. Le flux guide chaque étape.
Webhooks automatiques
DeployIt crée automatiquement un webhook sécurisé (avec secret) pour recevoir push et pull requests.
Diagnostics & tokens
Outils intégrés pour diagnostiquer permissions, vérifier webhooks et détecter tokens proches d’expiration.
Lister & supprimer
Voir rapidement tous les repos connectés à un projet et les supprimer proprement (webhook supprimé).
Afficher branches
Parcourez les branches du repo directement depuis DeployIt et testez l’accès en un clic.
Processus sécurisé
Webhooks signés et gestion des tokens côté client/serveur pour garder vos accès sûrs.
1 — Connecter un repository (OAuth ou GitHub App)
Ouvrir le formulaire de repository
Depuis la page de votre projet, allez dans l’onglet “Repos” puis cliquez sur “Ajouter un repository” ou “Connect repository”.
Choisir le fournisseur
Sélectionnez GitHub ou GitLab. Pour GitHub, vous pouvez choisir OAuth ou “Install GitHub App”.
Suivre le flux d'authentification
Un nouvel onglet s’ouvrira : suivez les instructions du fournisseur pour autoriser DeployIt. DeployIt extrait ensuite les informations nécessaires (tokens) automatiquement depuis le callback. Remarque technique (gérée pour vous) : le client utilise useGitProviderTokens.extractTokensFromQuery pour récupérer les tokens depuis les paramètres de l’URL.
Sélectionner le repository
Dans l’interface, choisissez le dépôt(s) que vous voulez connecter à ce projet et confirmez.
Création et préparation
DeployIt prépare les données du repository (useGitProviderTokens.prepareRepositoryData) et crée l’entrée. Le processus peut être traité en tâche de fond (workers/actions/addRepositoryAction.ts).
Choisir GitHub App ou OAuth
Si vous gérez plusieurs dépôts d’une organisation, la GitHub App est souvent plus simple : elle permet de lister les repositories accessibles et fournit des tokens d’installation gérés côté serveur. OAuth est pratique pour des comptes individuels.
2 — Webhook : création automatique et vérification
Créer le webhook
Depuis la vue du repository dans DeployIt, cliquez sur “Create webhook” si ce n’est pas déjà fait. DeployIt va créer le webhook côté fournisseur et générer un webhookSecret sécurisé si nécessaire.
Vérifier la présence du webhook
Utilisez l’option “Diagnostics” (voir plus bas) pour vérifier que le webhook existe et est correctement configuré côté GitHub/GitLab.
Signature et sécurité
Le webhook créé est signé avec le secret généré afin que DeployIt puisse vérifier l’authenticité des événements reçus.
Évitez les webhooks en double
Ne créez pas manuellement plusieurs webhooks pour le même but : cela peut générer des exécutions en double. Utilisez l’outil “Check webhook” de DeployIt pour voir l’état réel avant d’ajouter un webhook manuel.
3 — Lister et supprimer des repositories liés à un projet
Lister les repositories
Dans votre projet, onglet “Repos” → vous verrez la liste des dépôts connectés avec leur statut (webhook installé, dernier diagnostic).
Supprimer un repository
Cliquez sur le repository → option “Supprimer”. DeployIt supprime l’entrée et déclenche la suppression du webhook côté fournisseur.
Suppression côté fournisseur
La suppression est propagée au fournisseur Git (GitHub/GitLab) pour enlever le webhook associé. Vous pouvez vérifier via la page des webhooks du dépôt fournisseur si nécessaire.
Suppression propre
Si vous prévoyez de reconnecter le dépôt plus tard, attendez la confirmation de suppression avant de recréer : cela évite les conflits de webhook.
4 — Afficher les branches et tester l'accès
Afficher les branches
Ouvrez la vue du repository et cliquez sur “Branches”. DeployIt liste les branches visibles avec la branche par défaut mise en évidence.
Tester l'accès
Cliquez sur “Test access” ou lancez un “Diagnostic” pour valider que DeployIt peut lire les branches et accéder au repo.
Résoudre les erreurs d'accès
Si le test échoue, lancez le diagnostic pour voir quelles permissions manquent ou si le webhook est absent. DeployIt affiche des messages clairs pour indiquer la cause.
Diagnostic et gestion des tokens
Diagnostic d'accès
Depuis la page du repository, cliquez sur “Diagnostics” : vous verrez l’état des permissions, la présence du webhook et les erreurs détectées.
Tokens et expiration
DeployIt détecte les tokens proches de l’expiration côté client avec useGitProviderTokens.isTokenExpiringSoon et proposera une ré-authentification ou un rafraîchissement.
Rafraîchir / obtenir tokens
Pour GitLab, DeployIt peut tenter un rafraîchissement automatique (gitlabAuth.refreshGitLabToken). Pour GitHub App, le backend obtient un installation token via getGitHubInstallationToken.
Tokens expirés = erreurs d'accès
Si un token expire, les diagnostics montreront des erreurs d’autorisation. Relancez le flux d’authentification ou utilisez la fonction de rafraîchissement indiquée dans le diagnostic.
Ne vous en faites pas pour les détails techniques
Vous verrez parfois des noms techniques (ex. useGitProviderTokens.prepareRepositoryData). Ce sont des processus internes : l’important pour vous est que DeployIt gère l’extraction des tokens depuis le callback, prépare les données et détecte les tokens qui expirent bientôt.
- Checklist rapide avant de connecter un repo :
- Vérifiez que vous avez accès au dépôt (droits en lecture).
- Autorisez DeployIt lors du flux OAuth / GitHub App.
- Revenez à DeployIt pour sélectionner le repo.
- Que faire si un test échoue :
- Ouvrir Diagnostics → lire l’erreur.
- Si token expiré → reconnectez-vous.
- Si webhook manquant → cliquer sur “Create webhook”.
- Contacter le support si l’erreur persiste.
À propos des tâches en arrière-plan
L’ajout d’un repository peut être traité asynchronement (worker). Si l’ajout prend quelques secondes, patience : une tâche en arrière-plan (workers/actions/addRepositoryAction.ts) termine la configuration et vous notifie dans l’interface.
Problèmes fréquents et comment les éviter
Fenêtre d'autorisation fermée trop vite
Si vous fermez l’onglet d’autorisation avant la redirection finale, DeployIt ne recevra pas le token. Relancez l’ajout du repository et complétez le flux d’autorisation.
Installer la GitHub App pour les organisations
Pour gérer proprement les accès d’une organisation, demandez à un administrateur d’installer la GitHub App au niveau organisationnel : DeployIt pourra lister et connecter les repositories autorisés sans re-authentification individuelle.
Besoin d'aide ?
Si un diagnostic indique des problèmes que vous ne comprenez pas, consultez la page dédiée aux diagnostics et tokens pour des instructions pas à pas.
Questions fréquentes
Étape suivante
Vous êtes prêt(e) à connecter vos premiers dépôts. Ensuite, passez à la page suivante pour apprendre comment DeployIt indexe le code et permet la recherche RAG.
Page suivante : Indexation & recherche RAG
Apprenez comment DeployIt indexe vos repositories pour rendre votre code consultable et utilisable par les agents.