Aller au contenu principal

Afficher l'onglet GitLab sur un composant

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

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

Ce que ça affiche, et pour qui​

OùQuoi
Onglet GitLabTrois sous-onglets avec leur compte : Pipelines (Pipeline, Branche, Résultat, Déclencheur, Lancé le), Merge requests (celles ouvertes : Merge request, Auteur, Branche, Mise à jour), Branches (celle par défaut marquée par défaut, les protégées protégée)
Carte Releases GitLab de la Vue d'ensembleLes releases du projet, avec leur tag et leur date. Aucune release pour l'instant. s'il n'y en a pas.

Toute personne qui peut ouvrir le composant les voit. Astrolabe lit GitLab 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 GitLab, clique sur l'interrupteur en haut à droite de la carte (nommé « Activer GitLab »). Il s'allume aussitôt, sans confirmation.

Si la carte dit Configurez d'abord l'intégration GitLab, clique dessus : l'intégration s'ouvre dans Connexions de l'entreprise. Ajoute-la (Ajouter l'intégration GitLab). Le plugin s'allume tout seul quand tu enregistres l'intégration : passe à l'étape 2.

2. 🏷️ Annoter le composant​

Dans le catalog-info.yaml du composant, nomme son projet sous la forme <espace>/<projet>, sous-groupes compris (par exemple mon-groupe/sous-groupe/shop-api) :

apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: shop-api
  annotations:
    gitlab.com/project-slug: mon-groupe/shop-api   # <espace>/<projet> sur GitLab
spec:
  type: service
  lifecycle: production
  owner: group:default/plateforme
L'annotation est la seule source

Astrolabe ne devine jamais le projet à partir de l'adresse d'où le composant a été enregistré. Un composant sans l'annotation n'a pas d'onglet GitLab.

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 GitLab (par exemple https://gitlab.com/mon-groupe/shop-api/-/blob/main/catalog-info.yaml), clique sur Analyser, puis Importer, puis Voir le composant.
  • Tout un groupe : utilise le fournisseur de catalogue GitLab. Voir Importer tes projets GitLab.

✅ Vérifier​

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

✅ C'est tout !

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