Connectez un service de code source

Donnez à votre agent accès au contexte des dépôts, des issues et des pull requests pour les enquêtes. Il peut lire les changements récents, identifier les problèmes connexes, et ouvrir un problème ou une pull request dans le bon dépôt ou projet lorsque l’identifiant que vous fournissez le permet.

Ce tutoriel couvre GitHub, Azure DevOps et GitLab. Les connexions code source utilisent la page d’accès au code (Builder > Code Access), et non l’assistant du connecteur géré. Cet article se concentre sur les détails du code source : comment chaque service s’authentifie et comment valider la connexion.

Prerequisites

  • Un agent SRE en cours de fonctionnement et un accès à sre.azure.com.
  • Permission de configurer l’agent.
  • Un compte sur le service ayant accès aux dépôts ou projets que l’agent doit lire.

Pour les services de notification, voir Connecter un service de notification.

Connecteurs de code source

Connecteur Service Authentication Utilisation classique
GitHub GitHub et GitHub Enterprise Cloud Apportez votre propre application GitHub (OAuth et PAT également pris en charge pour github.com) Lire les dépôts, les numéros et les pull requests à travers les projets et organisations ; Créer des problèmes ou pull requests avec approbation
Azure DevOps Azure DevOps Identité gérée (OAuth et PAT également pris en charge) Lire les dépôts et pull requests entre les projets ; Créez des pull requests ou des éléments de travail avec approbation
GitLab GitLab Jeton d’accès personnel (PAT) Lire les dépôts, les numéros et les demandes de fusion ; Créez des problèmes et des commentaires avec approbation

GitHub et Azure DevOps présentent les choix d’authentification sous forme de boutons op. GitLab utilise un jeton d’accès personnel.

Étape 1 : Accès au code ouvert

  1. Accédez à sre.azure.com et sélectionnez votre agent.
  2. Dans la barre latérale de gauche, développez Constructeur, puis sélectionnez Accès au code.
  3. Sélectionnez l’onglet de votre service (GitHub, Azure DevOps ou GitLab).
  4. Sélectionnez Ajouter un référentiel.

Étape 2 : Authentifier

La boîte de dialogue Ajouter des dépôts s’ouvre sur un assistant en trois étapes : Choisissez une plateforme → Authentifier → Ajouter des dépôts. Sélectionnez Suivant après chaque étape. La dernière étape comporte un bouton Sauvegarder .

Utilisez Bring your own GitHub App pour GitHub Enterprise Cloud ou pour limiter l’accès par organisation ou installation.

  1. Dans la section Méthodes de connexion, choisissez Apporter votre propre application GitHub.
  2. Remplissez les champs de configuration de l’application affichés par l’assistant.
  3. Sélectionnez Suivant.

GitHub Enterprise Cloud (.ghe.com) nécessite une connexion GitHub App. Pour github.com, Votre compte (OAuth, s’il est configuré pour votre environnement) ou un jeton d’accès personnel sont également pris en charge, bien que l’option GitHub App soit préférée pour les scénarios de production afin de permettre des permissions plus granulaires et une visibilité d’audit.

Après la connexion, l’agent peut rechercher dans les dépôts, les issues et les pull requests entre les projets et organisations auxquels votre application ou compte a accès.

Le service voit l’identité qui a autorisé la connexion. Les problèmes, commentaires et activités de pull requests créés par l’agent apparaissent sous ce compte.

Étape 3 : Ajouter des dépôts

L’étape Ajouter des dépôts montre un tableau où vous spécifiez quels dépôts l’agent indexe. Chaque ligne est un dépôt.

  1. Si votre service est Azure DevOps, sélectionnez d’abord un project dans le menu déroulant Azure DevOps Project. La colonne URL du dépôt se remplit de dépôts dans ce projet.

  2. Dans la colonne URL du dépôt , sélectionnez un dépôt dans le menu déroulant ou tapez directement une URL. Pour GitHub et GitLab, les déplacements déroulants listent les dépôts auxquels vos identifiants peuvent accéder. Pour Azure DevOps, il liste les dépôts dans le projet sélectionné.

  3. Dans la colonne Nom d’affichage , saisissez un nom court utilisé par l’agent pour désigner le référentiel.

  4. Éventuellement, remplissez la colonne Description pour donner à l’agent plus de contexte sur ce que contient le dépôt.

  5. Si votre service est Azure DevOps et que le dépôt est très grand, activez la case Remote. L’agent utilise une recherche alimentée par IA sur la copie distante au lieu de la cloner localement. Les dépôts sont clonés avec une limite disque de 100 Go ; activer Remote évite cette contrainte.

  6. Pour ajouter un autre dépôt, sélectionnez Ajouter et remplissez la ligne suivante.

  7. Lorsque la table est terminée, sélectionnez Sauvegarder.

Étape 4 : Valider avec un scénario

  1. Ouvre un chat avec ton agent.

  2. Posez une question lue, par exemple :

    List the open issues in the payments repository from the last week.

  3. Vérifiez la fiche d’outils pour voir l’agent, rechercher le service et retourner des résultats fondés sur vos données.

Lorsque des résultats apparaissent en référence à votre dépôt, la connexion fonctionne de bout en bout.

Résolution des problèmes

Problème Cause Réparer
La recherche ne retourne aucun résultat Le compte n’a pas accès au projet ou au dépôt Confirme que le compte de connexion peut voir le projet ou le dépôt, puis réessaie.
Créer échoue à cause d’une erreur de permission Le jeton ou le compte n’a pas de portée d’écriture Accordez la portée requise au jeton ou au compte, ou utilisez des identifiants ayant un accès en écriture.
GitHub Enterprise Cloud rejette la connexion GitHub Enterprise Cloud nécessite une connexion GitHub App Sur la page Code Access, déconnectez la connexion GitHub, sélectionnez Ajouter un dépôt, choisissez GitHub, entrez votre .ghe.com hôte, et sélectionnez Apporter votre propre application GitHub comme méthode d’authentification.

Contenu connexe

  • Last updated on