Aller au contenu principal

Afficher l'onglet GitHub sur un composant

Chaque composant annoté reçoit un onglet GitHub et une carte Releases GitHub sur sa Vue d'ensemble.

Deux étapes : allumer le plugin, annoter le composant.

Ce que ça affiche, et pour qui​

OùQuoi
Onglet GitHubTrois sous-onglets avec leur compte : Pipelines (Workflow, Branche, Résultat, Lancé par, Lancé le), Pull requests (Pull request, Auteur, Branche, Mise à jour), Branches (celle par défaut marquée par défaut, les protégées protégée)
Carte Releases GitHub de la Vue d'ensembleLes dernières releases du dépôt, avec leur tag, leur titre et leur date

Le sous-onglet Pipelines liste les derniers runs de workflow, quel que soit celui qui les a lancés. Toute personne qui peut ouvrir le composant voit tout cela. Astrolabe lit GitHub avec le jeton de l'administrateur, le même pour tout le monde.

1. 🔌 Allumer le plugin​

  1. Dans Administration, sous PLATEFORME, clique sur Plugins.

  2. Sur la carte GitHub, clique sur l'interrupteur en haut à droite de la carte (nommé « Activer GitHub »). Il s'allume aussitôt, sans confirmation.

2. 🏷️ Annoter le composant​

Dans le catalog-info.yaml du composant, nomme son dépôt sous la forme <propriétaire>/<dépôt> :

apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: shop-api
  annotations:
    github.com/project-slug: acme/shop-api   # <propriétaire>/<dépôt> sur GitHub
spec:
  type: service
  lifecycle: production
  owner: group:default/plateforme

3. 📥 Mettre le composant au catalogue​

  • Un composant : dans la barre latérale, clique sur Catalogue, puis sur Enregistrer un composant existant en haut à droite. Colle l'adresse du fichier catalog-info.yaml sur GitHub (par exemple https://github.com/acme/shop-api/blob/main/catalog-info.yaml), clique sur Analyser, puis Importer, puis Voir le composant.
  • Toute une organisation : utilise le fournisseur de catalogue GitHub. Voir Importer tes dépôts GitHub.

✅ Vérifier​

Ouvre le composant. L'onglet GitHub est après Documentation. La Vue d'ensemble affiche une carte Releases GitHub.

✅ C'est tout !

La suite : Ajouter les cartes GitHub à ton tableau de bord.