AI CodeOps

Connecter GitHub

Connectez un compte GitHub.com à AI CodeOps avec OAuth ou un token d'accès personnel, les scopes nécessaires et ce que la plateforme fait de vos dépôts.

AI CodeOps travaille sur vos dépôts GitHub par une connexion que vous établissez une fois. Les sessions clonent ensuite le dépôt, écrivent le changement sur une nouvelle branche et ouvrent une pull request pour revue.

Avant de commencer

  • Un compte GitHub.com ayant accès aux dépôts que vous voulez utiliser.
  • GitHub Enterprise Server n'est pas pris en charge. Pour les serveurs Git que vous exploitez vous-même, AI CodeOps prend en charge GitLab, Gitea et Forgejo.

Se connecter avec OAuth

  1. Dans votre espace de travail, ouvrez Configure → Settings et faites défiler jusqu'à Git Providers.
  2. Sur la carte GitHub, choisissez Connect.
  3. GitHub vous demande d'autoriser AI CodeOps. Approuvez, et vous revenez à Settings avec le compte listé sous Connected Accounts.

AI CodeOps demande à GitHub ces scopes OAuth :

ScopePourquoi
repoLire et écrire les dépôts auxquels vous avez accès : cloner, pousser une branche, ouvrir et fusionner des pull requests. Inclut les dépôts privés.
read:userAfficher quel compte GitHub est connecté.
user:emailDemandé avec les scopes de connexion ; AI CodeOps ne lit pas l'adresse par cette connexion.

Si la carte n'a pas de bouton Connect, ou si vous voyez « GitHub sign-in isn't available for this server », l'application OAuth de la plateforme n'est pas disponible. Connectez-vous alors avec un token.

Se connecter avec un token d'accès personnel

Sur la carte GitHub, collez un token dans or access token (no OAuth app) et choisissez Connect with token. AI CodeOps vérifie le token auprès de GitHub avant de l'enregistrer. Un token que GitHub ne reconnaît pas reçoit « GitHub didn't recognise this token » ; un token qui ne peut pas lire votre compte reçoit un message qui nomme les permissions à ajouter.

Le token doit pouvoir lire votre profil utilisateur, lire les dépôts, pousser des branches, et créer et fusionner des pull requests. Sur GitHub, cela signifie :

  • un token classic avec le scope repo, ou
  • un token fine-grained pour les dépôts que vous voulez, avec Contents et Pull requests en lecture et écriture (Metadata en lecture est inclus).

Les tokens d'accès personnels ne sont pas renouvelés. Lorsque le token expire sur GitHub, déconnectez-vous et reconnectez-vous avec un nouveau.

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.
  • Sessions : une session clone le dépôt du projet dans son bac à sable et y écrit le changement.
  • 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'enregistrent pas de webhooks sur vos dépôts, et AI CodeOps ne publie pas de commentaires de revue sur GitHub. 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

  • Les connexions vous appartiennent, pas à l'espace de travail. Chaque membre connecte son propre compte, et les permissions de l'espace de travail déterminent toujours ce qu'il peut faire.
  • Les tokens sont chiffrés au repos (AES-256-GCM) et ne sont jamais écrits dans la configuration Git d'un dépôt.
  • Pour retirer l'accès, choisissez Disconnect à côté du compte. Vous pouvez aussi révoquer l'application ou le token sur GitHub.

Étapes suivantes

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