Importer tes projets GitLab

Astrolabe lit le fichier catalog-info.yaml de tes projets GitLab et les ajoute au catalogue.

Tu le règles une fois, en administrateur. Ensuite, le catalogue se remplit tout seul toutes les 30 minutes.

Avant de commencer

Le catalogue lit GitLab avec le jeton de l'intégration GitLab. Ajoute-la d'abord : voir GitLab › Ajouter l'intégration GitLab.

Le jeton a besoin des droits read_api et read_repository.

🔧 Régler le fournisseur GitLab

1. Dans la barre latérale, en bas, clique sur Administration.

2. Sous PLATEFORME, clique sur Catalogue. L'onglet Fournisseurs s'ouvre.

3. Sur la carte GitLab, clique sur Configurer.

4. Dans Hôte, choisis ton GitLab dans la liste. C'est l'hôte de ton intégration.

5. Dans Groupe, écris le groupe à lire, comme dans https://<hôte>/<groupe>. Ses sous-groupes viennent avec.

   Ce champ fait aussi le nom de tes équipes

   Les équipes importées sont nommées par leur chemin sous ce groupe : avec acme, le groupe acme/paiement/api devient paiement-api. C'est ce nom que les composants écrivent dans owner. Choisis donc le groupe le plus haut de ton entreprise. Voir Donner son propriétaire GitLab à un composant.

6. Clique sur Installer.

La fenêtre de rechargement s'affiche le temps que l'instance redémarre. Puis la page revient.

Chaque champ a son ?

Passe sur le ? à côté d'un champ pour voir ce qu'il attend, avec un exemple.

✏️ Changer le groupe plus tard

1. Ouvre Administration › Catalogue, puis Configurer sur la carte GitLab.

2. Dans Groupe, tape le nouveau groupe. Dès qu'il diffère de celui qui est enregistré, un avertissement s'affiche sous le champ, par exemple avec acme enregistré et acme/paiement tapé :

   Les équipes déjà importées seront renommées, et le propriétaire (owner) des composants qui les citent ne sera plus trouvé tant que vous ne l'aurez pas mis à jour. Exemple : acme/paiement/api s'appelait paiement-api et deviendra api.

3. Clique sur Mettre à jour.

4. Dans chaque catalog-info.yaml, écris le nouveau nom de l'équipe dans owner. Voir Donner son propriétaire GitLab à un composant.

Retape le groupe enregistré : l'avertissement disparaît.

Les autres champs

Champ	Ce qu'il fait
Uniquement les projets dont je suis membre	Seulement les projets de l'utilisateur du jeton. Conseillé sur gitlab.com.
Branches	Les branches à lire, une par ligne : clique sur Ajouter Branches, tape master, clique encore sur Ajouter Branches, tape backstage. Vide : la branche par défaut de chaque projet. Pas de / dans un nom. Retirer enlève une branche.
Fichier de catalogue	Le fichier à lire à la racine de chaque projet. Par défaut : catalog-info.yaml.
Expression régulière des projets	Seulement les projets dont le nom correspond, par exemple ^team-.*.
Ignorer les dépôts issus d'un fork	Laisse de côté les projets forkés.
Importer les groupes GitLab et leurs membres	Importe aussi tes groupes. Voir Importer tes groupes GitLab.
Dépôts exclus	Les projets à laisser de côté, un chemin par ligne, par exemple acme/sandbox.
Sujets	Seulement les projets qui portent l'un de ces sujets GitLab, un par ligne.
Inclure les dépôts archivés	Importe aussi les projets archivés.
Branche de repli	La branche à lire quand le fichier de catalogue n'est pas sur la branche par défaut d'un projet.
Utiliser la recherche GitLab	Trouve les projets par la recherche de GitLab au lieu de lister tous ceux du périmètre.

▶️ Lancer la collecte maintenant

Tu ne veux pas attendre 30 minutes ?

1. Sur Administration › Catalogue, trouve le tableau Collecte du catalogue.

2. Sur la ligne GitLab, dans la colonne Actions, clique sur le bouton lecture (Lancer la collecte GitLab maintenant ; quand tu importes aussi les groupes, c'est Lancer la collecte des projets GitLab maintenant).

3. Ne recharge pas la page. État passe à En cours, puis à Terminé. Détail dit combien de fichiers ont été trouvés, par exemple 3 fichiers de catalogue trouvés. Le play de la ligne GitLab ne lance que cette ligne : voir Lancer une collecte du catalogue maintenant.

La ligne GitLab (groupes et utilisateurs), juste au-dessus, apparaît quand tu as coché Importer les groupes GitLab et leurs membres. Son Détail dit ce qui est entré, par exemple 3 groupes et 1 utilisateur importés.

Tes composants sont maintenant dans Catalogue.

✅ C'est tout !

Pour donner à chaque composant un vrai groupe GitLab comme propriétaire, lis Importer tes groupes GitLab.