AI CodeOps

Connecter Gitea

Connectez votre propre serveur Gitea à AI CodeOps avec un token d'accès personnel : l'URL de l'instance, les scopes de token nécessaires et la façon dont les pull requests sont ouvertes pour vous.

AI CodeOps fonctionne avec les serveurs Gitea que vous exploitez. Vous vous connectez avec l'adresse de votre serveur et un token d'accès personnel. Les sessions écrivent ensuite les changements sur une nouvelle branche et ouvrent une pull request sur votre serveur pour revue.

Avant de commencer

  • L'adresse https publique de votre serveur Gitea, par exemple https://gitea.example.com. AI CodeOps s'exécute dans le cloud : il doit donc pouvoir joindre le serveur 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. Il en va de même pour les URL comportant une chaîne de requête ou un #fragment. L'erreur indique : « Use the public https address of your Git server ».
  • Un compte ayant un accès en écriture aux dépôts que vous voulez utiliser.

Créer un token dans Gitea

  1. Dans Gitea, ouvrez Settings → Applications et générez un nouveau token.
  2. Donnez-lui un accès en lecture et écriture à repository (pour cloner, pousser des branches, et créer et fusionner des pull requests) et un accès en lecture à user (pour indiquer quel compte est connecté).
  3. Copiez le token. Gitea 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 Gitea, 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 de votre serveur avant de l'enregistrer. S'il ne peut pas se connecter, le message indique ce qu'il faut corriger : Gitea n'a pas reconnu le token, le token n'est pas autorisé à lire votre compte (le message nomme les scopes à ajouter), ou aucune API Gitea 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 votre propre serveur, utilisez 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 votre 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.

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 Gitea. Pour faire la rotation d'un token, déconnectez-vous et reconnectez-vous avec le nouveau.

Étapes suivantes

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