Connecter GitHub

Connectez votre compte ou organisation GitHub à InfraNest pour que vos automatisations réagissent à ce qui se passe dans vos dépôts, et agissent sur GitHub à votre place. Ceci s’adresse à toute personne qui souhaite qu’InfraNest surveille l’activité GitHub ou gère automatiquement les tickets, déploiements et pull requests GitHub.

#Aperçu

• Une fois connecté, InfraNest peut surveiller les push, pull requests, tickets, exécutions de workflows, déploiements, releases et checks, et agir sur GitHub dans le cadre d’une automatisation — par exemple ouvrir un ticket, lancer un workflow, fusionner une pull request ou mettre à jour le statut d’un déploiement.
• GitHub peut aussi être utilisé pour suivre les incidents et constats, à l’image de Jira ou Linear : les comptes connectés peuvent ouvrir un ticket GitHub pour chaque incident et le fermer automatiquement lorsque l’incident se résout.
• Les comptes connectés via l’app peuvent aussi afficher leurs déploiements à côté de vos moniteurs.

#Connecter GitHub

La façon la plus simple et la plus sûre consiste à installer l’app InfraNest Automations sur votre compte ou organisation GitHub.

1. Allez dans Integrations et ouvrez GitHub.
2. Sélectionnez Connect (ou Add account si vous en avez déjà connecté un).
3. Sous Install app, sélectionnez Connect. Une fenêtre GitHub s’ouvre. Choisissez le compte ou l’organisation sur lequel installer l’app, sélectionnez All repositories ou uniquement ceux que vous voulez qu’InfraNest voie, puis confirmez.
4. GitHub peut vous demander de confirmer qu’InfraNest peut vérifier quelles installations votre compte peut utiliser. C’est ainsi qu’InfraNest s’assure que l’installation vous appartient bien avant de la connecter.
5. Vous revenez sur InfraNest et la connexion apparaît sous Accounts.

Vous pouvez connecter plusieurs comptes — par exemple votre compte personnel et une organisation. Chacun apparaît comme sa propre connexion.

NoteInfraNest fonctionne uniquement avec GitHub.com. GitHub Enterprise Server (GitHub auto-hébergé) n’est pas pris en charge.

#Vous n’êtes pas propriétaire de l’organisation GitHub ?

Seul un propriétaire d’une organisation GitHub peut y installer des apps. Si vous êtes membre, GitHub transmet votre demande aux propriétaires de l’organisation, et InfraNest affiche Waiting for approval. Vous n’avez rien d’autre à faire : dès qu’un propriétaire approuve la demande sur GitHub, la connexion apparaît dans l’espace de travail depuis lequel vous avez commencé. Si elle n’apparaît pas après l’approbation, reconnectez-vous depuis InfraNest.

#Installé depuis GitHub ?

Si vous avez installé InfraNest Automations depuis GitHub lui-même (par exemple depuis le GitHub Marketplace), InfraNest vous demande de vous connecter, ou de créer un compte, et de choisir l’espace de travail auquel l’installation appartient. Le lien pour terminer cette étape est valable 30 minutes ; passé ce délai, connectez GitHub depuis InfraNest à la place.

#Impossible d’installer l’app ?

Si vous n’êtes pas autorisé à installer des apps sur votre compte ou organisation GitHub, vous pouvez vous connecter avec un jeton d’accès personnel à la place : choisissez API token plutôt que Install app. Un jeton permet aux automatisations d’agir sur GitHub, mais pas de les déclencher — les déclencheurs GitHub ne fonctionnent qu’avec l’app.

#Choisir ce qu’InfraNest peut voir

Lors de l’installation de l’app, vous décidez à quels dépôts InfraNest a accès. Pour modifier cela plus tard, ouvrez l’app sur GitHub (sous Settings → GitHub Apps → InfraNest Automations de votre compte ou organisation) et ajustez les dépôts sélectionnés.

#Déconnecter GitHub

1. Ouvrez GitHub dans le hub Integrations.
2. Allez dans Connections & settings.
3. Sélectionnez Disconnect.

Cela désinstalle aussi l’app sur GitHub, de sorte qu’InfraNest n’y a plus accès. Si la même installation est partagée avec un autre espace de travail, elle y reste en place. Une connexion établie avec Connect with GitHub voit son accès retiré sur GitHub de la même manière.

Disconnect affiche d’abord, dans une boîte de dialogue, ce qui s’arrête, ce qu’InfraNest supprime et ce qu’il conserve. Toute automatisation qui utilisait la connexion est désactivée, afin qu’aucune d’elles n’échoue silencieusement plus tard. Le reste de votre équipe reçoit une notification indiquant qui l’a déconnectée et quelles automatisations ont été désactivées ; comme vous en êtes à l’origine, vous n’en recevez pas. Si GitHub met fin à la connexion de son côté, tout le monde est notifié. Issues for Incidents disparaît avec la connexion, et reconnecter la même installation dans les 30 jours propose de la réactiver telle qu’elle était.

Si quelqu’un désinstalle ou suspend l’app sur GitHub lui-même, InfraNest s’en aperçoit : la connexion s’affiche en échec, avec Removed on the provider's side ou Suspended on the provider's side sous son nom, elle figure sous Needs attention, vous recevez une notification, et les automatisations qui l’utilisent s’arrêtent avec un message expliquant pourquoi. Pour la rétablir, reconnectez GitHub avec le même compte (ou réactivez l’app sur GitHub). Vos automatisations conservent leurs réglages et se remettent à fonctionner immédiatement. Si des dépôts sont retirés de l’app sur GitHub, la connexion liste ceux qu’elle ne peut plus atteindre.

Si GitHub demande à InfraNest de ralentir en raison de sa limite de débit, la connexion figure sous Needs attention comme étant en attente jusqu’à une heure donnée. Il n’y a rien à corriger : cela se résout tout seul, les étapes configurées pour réessayer le font automatiquement, et l’avertissement disparaît une fois la limite réinitialisée.

#Ce qu’InfraNest conserve

InfraNest reçoit un événement de GitHub pour chaque push, ticket, commentaire, pull request, etc. dans les dépôts que vous avez choisis — qu’une automatisation l’utilise ou non.

• Historique des événements — utilisé pour montrer à quelle fréquence une automatisation en brouillon aurait été exécutée. Il conserve le dépôt, le numéro de ticket ou de pull request concerné, qui a effectué l’action et ce qui s’est passé, pendant 45 jours. Il ne conserve pas le texte rédigé par les personnes : les titres de tickets et pull requests, les commentaires, les noms et descriptions de releases sont exclus.
• Historique d’exécution — lorsqu’une automatisation s’exécute réellement, son exécution conserve l’événement complet sur lequel elle s’est déclenchée, texte des commentaires inclus, pendant 90 jours. Seuls les membres dont le rôle permet de modifier les automatisations peuvent le voir. Tous les autres voient qu’une exécution a eu lieu et si elle a fonctionné.

Se déconnecter empêche l’arrivée de nouveaux événements. Ce qu’InfraNest détient déjà est supprimé une fois ces délais de 45 et 90 jours écoulés.

#Au nom de qui

Installé en tant qu’app GitHub, InfraNest crée les tickets et commentaires en tant que infranest[bot], et non au nom du compte personnel de qui que ce soit. Connecté avec un jeton d’accès personnel, il les crée au nom du compte GitHub auquel appartient le jeton. La ligne de la connexion sur la page GitHub indique lequel s’applique.

Dans tous les cas, chaque ticket se termine par Filed from InfraNest by suivi du nom de la personne à l’origine de la demande — ou Filed by InfraNest automatically lorsqu’une automatisation l’a déposé — et une note d’équipe copiée dans le ticket commence par le nom de son auteur. Lorsque la personne dont le jeton est utilisé par une connexion quitte votre espace de travail InfraNest, les propriétaires et administrateurs reçoivent un message ainsi qu’un e-mail avec un lien pour reconnecter GitHub.

#Astuces

TipLes fonctionnalités basées sur les équipes, comme demander une revue à une équipe, ne fonctionnent que si vous connectez une organisation, et non un compte personnel.

#Dépannage

• « We couldn't confirm your access » — vous étiez connecté à GitHub avec un compte qui ne peut pas utiliser cette installation. Connectez-vous à GitHub avec le compte ayant installé l’app, puis reconnectez-vous.
• « Took too long » — relancez la connexion depuis InfraNest.
• Vos identifiants sont stockés de manière sécurisée et ne sont plus jamais affichés.