- Accueil
- Documentation
- Connecter Forgejo
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.
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.localou.internalsont 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 : 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
- Dans Forgejo, ouvrez Settings → Applications et générez un nouveau token d'accès.
- 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é).
- Copiez le token maintenant. Forgejo ne l'affiche qu'une fois.
Connecter le token
- Dans votre espace de travail, ouvrez Configure → Settings et faites défiler jusqu'à Git Providers.
- Sur la carte Forgejo, saisissez l'Instance URL. Elle est obligatoire.
- 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é, 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 à partir d'un dépôt Forgejo.
- Lancez votre première session.
- Dépannage