# Connecter Forgejo

> Connectez un serveur Forgejo, comme Codeberg ou votre propre instance, à AI CodeOps avec un token d'accès personnel, et voyez ce que la plateforme fait de vos dépôts.

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

AI CodeOps fonctionne avec les serveurs Forgejo, que vous exploitiez le vôtre ou que vous utilisiez une instance publique. Vous vous connectez avec l'adresse du serveur et un token d'accès personnel. Les sessions écrivent ensuite les changements sur une nouvelle branche et ouvrent une pull request pour revue.

## Avant de commencer

- L'adresse **https** publique du serveur, par exemple `https://forgejo.example.com`. AI CodeOps s'exécute dans le cloud et doit pouvoir le joindre par Internet.
- Les adresses situées sur des réseaux privés, `localhost`, les adresses link-local et les noms en `.local` ou `.internal` sont refusés, de même que les URL comportant une chaîne de requête ou un `#fragment`.
- Un compte ayant un accès en écriture aux dépôts que vous voulez utiliser.
- Sur Codeberg (`https://codeberg.org`), lisez d'abord ses [Terms of Use](https://codeberg.org/Codeberg/org/src/branch/main/TermsOfUse.md) : elles n'autorisent pas les projets qui consistent principalement en du code écrit par des outils d'IA générative.

## Créer un token dans Forgejo

1. Dans Forgejo, ouvrez **Settings → Applications** et générez un nouveau token d'accès.
2. Accordez la lecture et l'écriture sur **repository** (cloner, pousser des branches, créer et fusionner des pull requests) et la lecture sur **user** (indiquer quel compte est connecté).
3. Copiez le token maintenant. Forgejo ne l'affiche qu'une fois.

## Connecter le token

1. Dans votre espace de travail, ouvrez **Configure → Settings** et faites défiler jusqu'à **Git Providers**.
2. Sur la carte **Forgejo**, saisissez l'**Instance URL**. Elle est obligatoire.
3. Collez le token dans **or access token** et choisissez **Connect with token**.

AI CodeOps vérifie le token auprès du serveur avant de l'enregistrer. S'il ne peut pas se connecter, le message indique ce qu'il faut corriger : Forgejo n'a pas reconnu le token, le token n'est pas autorisé à lire votre compte (le message nomme les scopes à ajouter), ou aucune API Forgejo n'a répondu à l'adresse.

## OAuth

**Connect via OAuth** ne fonctionne que pour le seul serveur Gitea ou Forgejo sur lequel l'application OAuth de la plateforme est enregistrée : la carte ne le propose donc que pour ce serveur. Pour tout autre serveur, utilisez plutôt un token.

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

- **Parcourir :** **Develop → Repositories** liste les dépôts que le compte peut voir, avec leurs branches, leurs fichiers et leurs pull requests.
- **Branches et pull 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 pull request vers la branche par défaut du projet. Les commits ont pour auteur « AI CodeOps ».
- **Fusion :** une pull 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'installent pas de webhooks sur le serveur, et AI CodeOps ne commente pas les pull requests. Un dépôt que vous connectez sous **Build & Test → Builds** fait exception : il reçoit un webhook, afin qu'un push ou une pull request puisse lancer un build, et un statut de commit avec le résultat de chaque build. AI CodeOps ne lit pas non plus les résultats de Forgejo Actions ; les tests s'exécutent dans le bac à sable de la session.

## 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.
- Le token est chiffré au repos (AES-256-GCM) et n'est écrit dans la configuration Git d'aucun dépôt.
- Pour retirer l'accès, choisissez **Disconnect**, ou supprimez le token dans Forgejo. Pour en faire la rotation, déconnectez-vous et reconnectez-vous.

## Étapes suivantes

- [Créez un projet](https://aicodeops.dev/fr/docs/projects) à partir d'un dépôt Forgejo.
- [Lancez votre première session](https://aicodeops.dev/fr/docs/sessions).
- [Dépannage](https://aicodeops.dev/fr/docs/troubleshooting)
