AI CodeOps

Connecter GitLab

Connectez GitLab.com ou une instance GitLab auto-gérée à AI CodeOps avec OAuth ou un token d'accès personnel, et voyez comment les merge requests sont ouvertes pour vous.

AI CodeOps fonctionne avec GitLab.com et avec les instances GitLab auto-gérées. Connectez un compte une fois ; les sessions écrivent ensuite les changements sur une nouvelle branche et ouvrent une merge request pour revue.

Avant de commencer

  • Un compte GitLab ayant au moins l'accès Developer aux projets que vous voulez utiliser, afin qu'il puisse pousser des branches et ouvrir des merge requests.
  • Pour une instance auto-gérée : son adresse https publique, par exemple https://gitlab.example.com. La plateforme doit pouvoir la joindre par Internet. Les adresses situées sur des réseaux privés, localhost et les noms en .local ou .internal sont refusés.

Se connecter avec OAuth

  1. Dans votre espace de travail, ouvrez Configure → Settings et faites défiler jusqu'à Git Providers.
  2. Sur la carte GitLab, laissez Instance URL (blank for gitlab.com) vide pour GitLab.com.
  3. Choisissez Connect via OAuth et approuvez la demande sur GitLab.

AI CodeOps demande les scopes api et read_user. api lui permet de lire les dépôts, de pousser des branches et de créer et fusionner des merge requests ; read_user indique quel compte est connecté.

OAuth ne fonctionne qu'avec le serveur GitLab sur lequel l'application OAuth de la plateforme est enregistrée (GitLab.com par défaut). La carte ne le propose que pour ce serveur. Pour toute autre instance, utilisez un token.

Se connecter avec un token d'accès personnel

C'est la voie habituelle pour une instance auto-gérée.

  1. Dans GitLab, créez un token d'accès personnel (User settings → Access tokens) avec le scope api. Un token d'accès de projet ou de groupe fonctionne aussi s'il a api et le rôle Developer ou supérieur.
  2. Sur la carte GitLab dans AI CodeOps, saisissez votre Instance URL (ou laissez le champ vide pour GitLab.com).
  3. Collez le token dans or access token et choisissez Connect with token.

AI CodeOps vérifie le token auprès de votre instance avant de l'enregistrer. S'il ne peut pas se connecter, le message indique ce qu'il faut corriger : GitLab n'a pas reconnu le token, le token n'a pas le scope api, ou aucune API GitLab n'a répondu à l'adresse. Les tokens ne sont pas renouvelés : lorsque l'un d'eux expire dans GitLab, déconnectez-vous et reconnectez-vous avec un nouveau.

Ce qu'AI CodeOps fait du dépôt

  • Parcourir : Develop → Repositories liste vos projets avec leurs branches, leurs fichiers et leurs merge requests.
  • Branches et merge requests : lorsqu'un changement est approuvé et franchit ses barrières qualité, AI CodeOps pousse une branche nommée codeops/run-<id> et ouvre une merge request vers la branche par défaut du projet. Les commits ont pour auteur « AI CodeOps ».
  • Fusion : une merge request ouverte par la console peut être fusionnée depuis la console. La barrière de livraison s'exécute d'abord de nouveau.

Les sessions n'enregistrent pas de webhooks sur vos projets, et AI CodeOps ne commente pas les merge requests. Un projet que vous connectez sous Build & Test → Builds fait exception : il reçoit un webhook, afin qu'un push ou une merge request puisse lancer un build, et un statut de commit avec le résultat de chaque build.

Votre token et votre accès

  • Une connexion vous appartient, pas à l'espace de travail. Les rôles de l'espace de travail déterminent toujours ce que chaque membre peut faire.
  • Les tokens sont chiffrés au repos (AES-256-GCM). Les tokens OAuth sont renouvelés avant leur expiration.
  • Pour retirer l'accès, choisissez Disconnect à côté du compte, ou révoquez le token dans GitLab.

Étapes suivantes

Cette page vous a-t-elle été utile ?