# 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.

Source: https://aicodeops.dev/fr/docs/git/gitlab

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é](https://aicodeops.dev/fr/docs/quality-gates), 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

- [Créez un projet](https://aicodeops.dev/fr/docs/projects) à partir d'un dépôt GitLab.
- [Lancez votre première session](https://aicodeops.dev/fr/docs/sessions).
- Vous utilisez aussi Gitea ou Forgejo ? Consultez [Connecter Gitea](https://aicodeops.dev/fr/docs/git/gitea) et [Connecter Forgejo](https://aicodeops.dev/fr/docs/git/forgejo).
