Installation et tokens GitHub App
Installation et tokens GitHub App
Guide pas‑à‑pas pour installer la GitHub App depuis l’interface, récupérer l’accès et valider la configuration
Installez la GitHub App via l’UI, autorisez l’accès aux bons dépôts et vérifiez que DeployIt peut agir sur vos repositories.
Ce que couvre cette page
Installer la GitHub App
Installation depuis l’interface DeployIt en ouvrant la page d’installation GitHub et en choisissant l’organisation/les dépôts.
Récupérer / valider le token d’installation
Vérifications à effectuer après le retour pour s’assurer que DeployIt a bien obtenu l’accès via le token d’installation.
Prérequis & vérifications
Liste des droits nécessaires, tests post‑installation et procédures de dépannage courantes.
Aperçu rapide
Ce guide explique le flux utilisateur : depuis le clic “Install GitHub App” dans DeployIt, le processus côté GitHub (choix du compte/organisation et des dépôts), jusqu’aux vérifications à faire une fois revenu dans DeployIt. Il s’adresse aux personnes en charge de connecter des dépôts (admins d’organisation ou administrateurs de dépôt).
Prérequis (avant de lancer l’installation)
Vérifier votre rôle GitHub
Vous devez être administrateur de l’organisation ou du dépôt ciblé. Sans droits d’administration, l’installation ne pourra pas accorder les permissions nécessaires à DeployIt.
Compte GitHub actif dans le navigateur
Ouvrez le navigateur où vous êtes connecté·e au compte GitHub correct (compte perso ou compte organisationnel). Si vous gérez plusieurs comptes, vérifiez que vous êtes connecté·e avec l’un qui possède les droits requis.
Décidez des dépôts à exposer
Choisissez si vous installez la GitHub App sur “tous les dépôts” d’une organisation ou seulement sur des dépôts sélectionnés. L’installation peut être restreinte au besoin ; pensez aux webhooks et à l’accès en lecture des sources.
Préparer l’accès SSO (si applicable)
Si votre organisation utilise SSO (Single Sign‑On) ou des politiques d’approbation des applications, demandez la validation de l’application auprès de l’administrateur SSO avant d’installer.
Avoir une personne de contact
Prévoyez une personne ayant les droits admin pour gérer l’installation et résoudre les autorisations si l’installation échoue.
Astuce : utilisez le bon compte GitHub
Si vous gérez des organisations et des projets personnels, ouvrez une fenêtre de navigation dédiée au compte administrateur de l’organisation avant de cliquer sur “Install GitHub App”. Cela évite d’installer l’app sur le mauvais compte.
Flux d’installation depuis l’interface DeployIt (pas‑à‑pas)
1. Ouvrez le panneau 'Intégrations' ou 'Repos' dans DeployIt
Naviguez vers la configuration du projet où vous souhaitez connecter les dépôts, puis cherchez le bouton/section “Install GitHub App” ou “Connecter via GitHub App”.
2. Cliquez sur 'Install GitHub App'
Ce bouton ouvre la page officielle d’installation GitHub dans un nouvel onglet / fenêtre.
3. Choisissez où installer (compte personnel vs organisation)
Sur la page GitHub, sélectionnez le compte ou l’organisation cible. Si vous avez plusieurs organisations, choisissez celle qui contient les dépôts à connecter.
4. Sélectionnez les dépôts et permissions
GitHub vous propose d’accorder l’accès à tous les dépôts ou seulement à une sélection. Sélectionnez l’option qui correspond à votre politique de sécurité :
- Pour démarrer rapidement, “Tous les dépôts” est pratique.
- Pour limiter l’accès, sélectionnez explicitement les dépôts nécessaires.
5. Confirmez l’installation
Cliquez sur “Install” / “Authorize” pour finaliser. GitHub pourra demander une seconde confirmation (SSO ou approbation) si votre organisation l’exige.
6. Retournez sur DeployIt (redirection ou bouton 'Revenir')
Après l’installation, GitHub propose souvent un bouton “Return to [your app]”. Si la redirection n’est pas automatique, revenez manuellement à DeployIt — la page de setup doit se charger et afficher le résultat de l’installation.
7. Autorisez la liaison dans DeployIt
De retour dans DeployIt, suivez les instructions affichées (par exemple : confirmation, choix des dépôts à importer dans le projet, ou autoriser la création de webhooks). Confirmez pour finaliser la liaison.
Astuce : choisir les dépôts finement
Si votre organisation suit le principe du moindre privilège, installez l’application sur seulement les dépôts requis, puis ajoutez d’autres dépôts ultérieurement via la page d’administration GitHub si nécessaire.
Pour un dépôt personnel, le flux est identique mais la sélection d’un compte personnel est possible dès l’écran d’installation. Assurez‑vous d’utiliser le compte qui contient les dépôts visés.
:::steps{title=“Étapes spécifiques compte personnel”}
:: ::tab{title=“Installation sur organisation (différences)”} Les organisations peuvent imposer des approbations supplémentaires (SSO, approbation d’applications). Vous devrez peut‑être demander une approbation organisationnelle.
Étapes spécifiques organisation
Choisir l’organisation sur GitHub
Sur l’écran d’installation GitHub, sélectionnez l’organisation cible.
Accepter les politiques d’organisation
Si l’organisation demande une approbation SSO ou organisationnelle, suivez les instructions ou demandez au responsable d’accepter l’application.
Sélectionner les dépôts organisationnels
Choisissez les dépôts (ou “tous les dépôts”). Confirmez l’installation et revenez à DeployIt pour terminer la configuration.
:::
Avant : utilisation d’un token OAuth utilisateur ou token personnel (access tokens) pour accéder aux dépôts.
Après : DeployIt utilise l’installation GitHub App pour gérer l’accès aux dépôts et webhooks sans exposer de token personnel.
Vérifications à effectuer après le retour sur DeployIt
1. Vérifier la liste des dépôts importés
Ouvrez l’onglet Repos du projet : les dépôts que vous avez autorisés doivent apparaître. Si un dépôt manque, revérifiez la sélection pendant l’installation sur GitHub.
2. Contrôler l’état des tokens / statut d’intégration
Dans la vue des tokens ou du statut (souvent indiquée près des dépôts), vérifiez que l’intégration GitHub App est listée comme “installée” ou “connectée”.
3. Lancer un diagnostic ou un test de connexion
Exécutez l’outil de diagnostic (si disponible) ou lancez une synchronisation de test. Un diagnostic réussi signifie que DeployIt a pu obtenir un jeton d’installation utilisable.
4. Vérifier la création de webhooks dans GitHub
Allez dans les paramètres du dépôt sur GitHub > Webhooks : vous devriez voir un webhook pointant vers DeployIt. Cela confirme que DeployIt pourra recevoir les événements push/pull_request.
5. Tester une synchronisation (Branches / Commits)
Demandez une synchronisation manuelle d’un dépôt ou une indexation. Vérifiez que les branches et commits remontent correctement dans DeployIt.
6. Confirmer les permissions (lecture/écriture selon besoin)
Si certaines actions échouent (création de webhook, lecture de fichiers), vérifiez sur GitHub que l’app a bien les scopes/permissions nécessaires pour les opérations envisagées.
Attention — droits administrateur obligatoires
Les installations GitHub App nécessitent que l’utilisateur qui installe soit administrateur de l’organisation ou du dépôt ciblé. Si vous n’avez pas ces droits, l’installation semblera réussir côté GitHub mais DeployIt n’aura pas les permissions attendues (résultant en erreurs lors des diagnostics ou synchronisations).
Que faire si l’installation échoue ou si les dépôts n’apparaissent pas
1. Vérifier le compte GitHub utilisé
Assurez‑vous d’être connecté·e au bon compte GitHub dans le navigateur. Si nécessaire, fermez la session et reconnectez‑vous au compte administrateur.
2. Vérifier les approbations d’organisation / SSO
Si l’organisation impose des approbations, demandez au responsable de l’approuver ou suivez le flux d’approbation affiché dans GitHub.
3. Revenir sur la page d’installation et réinstaller
Désinstallez puis réinstallez l’app en choisissant explicitement les dépôts souhaités. Ensuite, retournez sur DeployIt et déclenchez la liaison à nouveau.
4. Vérifier les webhooks manuellement
Dans les paramètres du dépôt GitHub, vérifiez la présence du webhook DeployIt. S’il manque, recréez‑le depuis DeployIt (si l’option est offerte) ou contactez l’administrateur.
5. Contacter le support DeployIt
Si malgré tout l’intégration ne fonctionne pas, fournissez : le nom de l’organisation, les dépôts concernés, les captures d’écrans des autorisations GitHub et la nature de l’erreur (diagnostics). Le support pourra vous aider à localiser le blocage.
Astuce pour les adresses email privées
Si GitHub ne fournit pas d’adresse email publique lors de l’installation, DeployIt peut créer un compte temporaire lié à votre login. Pour obtenir une adresse email vérifiée, autorisez l’accès aux emails lors du flux OAuth (si proposé) ou mettez à jour votre compte GitHub pour avoir une adresse primaire vérifiée.
Frequently Asked Questions
Récapitulatif rapide
- Assurez‑vous d’être administrateur sur l’organisation/dépôt.
- Depuis DeployIt : cliquer “Install GitHub App” → suivre le flux GitHub → revenir à DeployIt pour valider.
- Vérifier la liste des dépôts, l’existence des webhooks et exécuter un test de synchronisation.
Besoin d’aide ?
Si vous rencontrez des problèmes non résolus par ce guide, collectez : captures d’écran de la page d’installation GitHub, capture des paramètres du dépôt (webhooks & authorizations) et logs d’erreur affichés dans DeployIt. Contactez ensuite l’assistance DeployIt en fournissant ces éléments.
Prêt à installer la GitHub App ?
Cliquez pour lancer le flux d’installation depuis DeployIt. Assurez‑vous d’avoir vos droits d’administrateur et le compte GitHub actif avant de commencer.