Donner à un composant son propriétaire GitLab

Chaque composant nomme son propriétaire dans son catalog-info.yaml. Avec tes groupes GitLab importés, ce peut être un vrai groupe GitLab.

Il te faut d'abord l'import de tes groupes GitLab.

✏️ Écrire le propriétaire

Dans le catalog-info.yaml du composant, dans GitLab, écris le groupe dans spec.owner, avec le préfixe group:gitlab/ :

apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: payment-api
spec:
  type: service
  lifecycle: production
  owner: group:gitlab/paiement-api

À la collecte suivante, la page du composant montre le groupe sous PROPRIÉTAIRE, dans À propos.

Construire le nom du groupe

Un séparateur par niveau du chemin GitLab. Lequel dépend du champ Groupe du fournisseur.

Champ Groupe	Groupe GitLab	À écrire
acme	acme/paiement/api	group:gitlab/paiement-api
acme	acme/paiement/api/v2	group:gitlab/paiement-api-v2
Vide	acme/paiement/api	group:gitlab/acme.paiement.api
Vide	acme/paiement/api/v2	group:gitlab/acme.paiement.api.v2

Avec un groupe renseigné, le nom part sous lui, avec un - par niveau. Avec Groupe vide, c'est le chemin complet, avec un . par niveau.

Avec Groupe vide, un chemin qui contient un « . » est écarté

Un . ne doit jamais remplacer autre chose qu'un /. Sinon deux groupes différents pourraient porter le même nom, et l'un prendrait les composants de l'autre.

🔎 Trouver le nom exact

Un doute ? Copie-le depuis le catalogue.

1. Ouvre Catalogue, puis l'onglet Groups.

2. Clique sur le groupe. La liste montre son nom GitLab (api), pas le nom à écrire.

3. Dans la carte du groupe, copie la ligne au-dessus de Entity Ref, par exemple group:gitlab/paiement-api.

4. Colle-la telle quelle dans owner.

La même page montre le Parent Group, les composants que le groupe possède (Ownership) et ses membres.

✅ C'est tout !

Quelque chose ne colle pas ? Lis les questions fréquentes et les problèmes courants.