Ajouter les cartes GitHub à ton tableau de bord

Les cartes GitHub du Tableau de bord montrent ce que voit ton propre compte GitHub. Elles demandent ton propre jeton, connecté une fois — depuis la carte elle-même.

Les cartes

Clé	Ce qu'elle montre (description à l'écran)
Workflows	GitHub Actions workflow runs with status and run number
Workflows détaillés	Workflow runs with individual job details, stages, and duration
Pull requests	Les pull requests de chaque dépôt GitHub du catalogue que votre jeton lit, avec l'auteur, les relecteurs, le statut et votre rôle (filtrez dessus pour les vôtres)
Releases	La dernière version publiée de chaque dépôt GitHub du catalogue que votre jeton peut lire

Une carte sans rien à afficher dit Rien à afficher et, dessous, ce qui la remplirait :

Carte	Ce qu'elle dit
Pull requests	Aucune pull request ouverte dans les dépôts GitHub nommés par les composants du catalogue (annotation github.com/project-slug) que votre jeton peut lire.
Workflows et Workflows détaillés	Aucune exécution de workflow récente dans les dépôts GitHub des composants dont vous êtes propriétaire (annotation github.com/project-slug).
Releases	Aucune version publiée dans les dépôts GitHub nommés par les composants du catalogue (annotation github.com/project-slug) que votre jeton peut lire.

Clique sur En savoir plus sous la phrase pour revenir à cette page.

➕ Ajouter une carte

1. Dans la barre latérale, clique sur Tableau de bord, puis sur l'onglet du tableau voulu.

2. Clique sur Ajouter une carte, en haut de la page.

3. Dans Ajouter une carte, choisis la Source github, puis une Clé.

4. Laisse Organisations vide, ou lis Quels dépôts ? plus bas.

5. Saisis un Nom de la carte, puis clique sur Ajouter. Sur un tableau en modification, clique ensuite sur Enregistrer.

La source github manque ?

Elle n'est proposée qu'une fois que l'administrateur a ajouté l'intégration GitHub.

🔗 Connecter ton compte GitHub

La première fois, la carte affiche Votre compte GitHub n'est pas connecté. (« Cette carte montre ce que voit votre propre compte GitHub. Le jeton saisi dans l'administration ne sert qu'aux onglets des entités, au catalogue et à Compass : connectez votre propre compte GitHub, ici ou dans Mon compte › Mes comptes. »)

1. Dans la carte, clique sur Connecter mon compte GitHub. La fenêtre Connecter mon compte GitHub s'ouvre sur le tableau de bord. Elle dit où créer le jeton, avec quels droits (repo et read:org), et mène à la page des jetons de ton GitHub.

2. Remplis :

   • Nom d'utilisateur : ton identifiant GitHub, par exemple octocat. Astrolabe te reconnaît par lui dans les événements GitHub.
   • Jeton : un jeton de ton propre compte GitHub. Voir Créer un jeton GitHub.

3. Clique sur Tester la connexion. Le formulaire dit La connexion fonctionne : l'outil a accepté votre jeton.

4. Clique sur Enregistrer. La fenêtre se ferme et toutes les cartes GitHub de ton tableau de bord se relisent : elles montrent ce que voit ton compte GitHub.

Ton jeton est aussi listé dans Mon compte › Mes comptes, où tu le changes ou le retires.

✅ C'est tout !

Ce que montre chaque carte

Chaque ligne a un point de couleur pour son statut ; en haut à droite, la carte nomme les statuts qu'elle contient. La flèche au bout d'une ligne ouvre l'élément sur GitHub.

Workflows

Colonne	Ce qu'elle contient
Ressource	Le dépôt
Titre	Le workflow
Auteur	Qui a lancé le run
Date	Quand le run a été mis à jour pour la dernière fois

Une ligne par workflow de chaque dépôt : son dernier run, gardé seulement s'il a tourné dans les deux dernières heures ou s'il a échoué dans la dernière journée. Une carte sans run de ce genre dit Rien à afficher et la phrase ci-dessus.

Workflows détaillés

Colonne	Ce qu'elle contient
Ressource	Le dépôt
Titre	Le job
Clé	Le numéro du run, comme #1
Date	Quand le run a été mis à jour pour la dernière fois
Durée	La durée du job, - tant qu'il n'est pas fini
Statut	queued, success, etc.
Étapes	Les étapes du job

Les mêmes runs que Workflows, une ligne par job.

Pull requests

Colonne	Ce qu'elle contient
Ressource	Le dépôt
Clé	Le numéro de la pull request, comme #44
Titre	La pull request
Auteur	Qui l'a ouverte
Assignés	À qui elle est assignée, - si personne
Relecteurs	Qui doit la relire, - si personne
Mon rôle	Ce que tu es dessus : Auteur, Relecture demandée, Assigné ou Aucun
Date	La date de la pull request

Les pull requests de chaque dépôt du catalogue que ton jeton peut lire, quel qu'en soit l'auteur : les ouvertes, et celles fermées dans les 7 derniers jours. Le haut à droite de la carte nomme les états présents, open et closed. Le tableau montre 5 lignes par page ; Afficher 10 résultats en affiche 10, et le compte (par exemple 1-5 sur 83) suit le filtre.

Si GitHub contient trop de pull requests pour toutes les lire, la carte dit Liste tronquée : trop d'éléments à lire, seuls les plus récents sont affichés. au-dessus du tableau.

Ne garder que tes pull requests

La carte liste tout ce que ton jeton lit. Pour garder les tiennes, filtre la colonne Mon rôle et enregistre le filtre avec la carte :

1. Sur Mes tableaux de bord, ouvre l'onglet du tableau.

2. Sur la carte, clique sur more, puis sur Modifier, puis ouvre l'onglet Filtres.

3. Sous mon rôle, clique sur la croix de Aucun (Retirer le filtre Aucun). Il ne reste que les pull requests où tu es impliqué : ici Auteur.

4. Clique sur Enregistrer dans la fenêtre.

Le filtre est enregistré avec la carte. Pour tout revoir, ouvre l'onglet Filtres et clique sur Réinitialiser sous mon rôle. Voir aussi Modifier ou retirer une carte.

Releases

Colonne	Ce qu'elle contient
Ressource	Le dépôt
Clé	Le tag de la release
Date	Quand elle a été publiée

La dernière release publiée de chaque dépôt. Un dépôt sans aucune release n'a pas de ligne.

Quels dépôts ?

Les cartes ne montrent que les dépôts que nomme un composant du catalogue avec github.com/project-slug. Un dépôt que le catalogue ne connaît pas n'apparaît jamais.

Le champ organizations (« GitHub organizations to show, comma-separated (e.g. acme). Empty: the ones the catalog imports. ») choisit les organisations. Laissé vide, la carte couvre les organisations du fournisseur de catalogue GitHub. Pour montrer un composant enregistré à la main depuis une autre organisation, écris cette organisation dans le champ, par exemple acme.

Les états dans Mon compte › Mes comptes

État	Ce que ça veut dire
Connectée	Ton jeton marche
Non connectée	Tu n'as pas enregistré de jeton
Jeton refusé	GitHub refuse le jeton enregistré. Survole les mots pour la raison, ou clique sur Configurer.
Non vérifiée	GitHub n'a pas pu être joint pour vérifier

🔔 Notifications

Tu choisis ce que tu reçois dans Mon compte › Notifications. Sous GitHub, l'écran liste When a workflow fails (marqué CRITIQUE), When a PR is opened, When a PR is closed, When a PR is edited, When a PR review is requested, When a PR is approved, When changes are requested on a PR, When a PR is reviewed with comments et When a workflow is cancelled.

Pour que GitHub les envoie, l'administrateur pose un secret dans Administration › Connexions de l'entreprise › Webhooks › GitHub › Configurer (Secret du webhook, puis Enregistrer). Cette étape, et l'arrivée des notifications, n'ont pas été vérifiées sur une instance.

La suite : FAQ GitHub.