Verbind een broncode-service

Geef je agent toegang tot repository-, issue- en pull request-context voor onderzoeken. Het kan recente wijzigingen lezen, gerelateerde problemen vinden en een issue of pull request openen in de juiste repository of project wanneer de door jou verstrekte credential dat toestaat.

Deze tutorial behandelt GitHub, Azure DevOps en GitLab. Broncodeverbindingen gebruiken de Code Access-pagina (Builder > Code Access), niet de managed connector-wizard. Dit artikel richt zich op details van broncode: hoe elke dienst authenticeert en hoe de verbinding gevalideerd kan worden.

Prerequisites

• Een actieve SRE-agent en toegang tot sre.azure.com.
• Toestemming om de agent te configureren.
• Een account op de dienst met toegang tot de repositories of projecten die de agent moet lezen.

Voor notificatiediensten, zie Connect a notification service.

Broncode-connectoren

Connector	Dienst	Authentication	Typisch gebruik
GitHub	GitHub en GitHub Enterprise Cloud	Bring-your-own GitHub App (OAuth en PAT worden ook ondersteund voor github.com)	Lees repositories, kwesties en pull-verzoeken tussen projecten en organisaties; Maak issues of pull requests aan met goedkeuring
Azure DevOps	Azure DevOps	Beheerde identiteit (OAuth en PAT worden ook ondersteund)	Lees repositories en pull requests over projecten; Maak pull requests of werkitems aan met goedkeuring
GitLab	GitLab	Persoonlijk toegangstoken (PAT)	Lees repositories, kwesties en samenvoegverzoeken; Maak problemen en opmerkingen met goedkeuring

GitHub en Azure DevOps presenteren authenticatieopties als radioknoppen. GitLab gebruikt een persoonlijke toegangstoken.

Stap 1: Open Code Toegang

1. Ga naar sre.azure.com en selecteer uw agent.
2. Vouw in de linkerzijbalk Builder uit en selecteer vervolgens Code Access.
3. Selecteer het tabblad voor jouw dienst (GitHub, Azure DevOps of GitLab).
4. Selecteer Opslagplaats toevoegen.

Stap 2: Authenticatie

Het dialoog Repositories toevoegen opent met een driestapswizard: Kies een platform → Authenticate → Add repositories. Selecteer Volgende na elke stap. De laatste stap heeft een opslaan-knop .

GitHub

Gebruik Bring your own GitHub App voor GitHub Enterprise Cloud of om toegang per organisatie of installatie te beperken.

1. Kies onder Aanmeldmethoden voor 'Breng je eigen GitHub-app.
2. Voltooi de app-instellingen die door de wizard worden aangegeven.
3. Kies Volgende.

GitHub Enterprise Cloud (.ghe.com) vereist een GitHub App-verbinding. Voor github.com worden ook je account (OAuth, indien geconfigureerd voor je omgeving) of een persoonlijke toegangstoken ondersteund, hoewel de GitHub App-optie de voorkeur heeft voor productiescenario's om meer gedetailleerde rechten en auditzichtbaarheid mogelijk te maken.

Na het verbinden kan de agent repositories, issues en pull requests doorzoeken bij projecten en organisaties waar je app of account toegang toe heeft.

Azure DevOps

Gebruik Managed Identity voor productiegebruik, wat langdurige inloggegevens vermijdt.

1. Kies onder AanmeldmethodenBeheerde identiteit.
2. Vul de velden in die door de wizard worden weergegeven en zorg ervoor dat de beheerde identiteit van de agent toegang heeft tot de Azure DevOps-projecten en repositories die de agent nodig heeft.
3. Kies Volgende.

Je account (OAuth) en authenticatie van persoonlijke toegangstokens worden ook ondersteund, maar ze zijn het beste geschikt voor ontwikkeling, testen of situaties waarin beheerde identiteit niet gebruikt kan worden. Gebruik de smalste identiteit of token die de projecten en repositories kan lezen die de agent nodig heeft.

Na het verbinden kan de agent repositories doorzoeken, pull requests lezen en werkitems in je projecten inspecteren.

GitLab

1. Hier komt een GitLab persoonlijke toegangstoken (PAT) in beeld.
2. Kies Volgende.

Verleen de PAT alleen de scopes die de agent nodig heeft voor toegang tot repository-, issue- en merge-verzoeken.

Na het verbinden kan de agent repositories, issues en merge-verzoeken lezen binnen projecten waar het token toegang toe heeft.

De dienst ziet de identiteit die de verbinding autoriseerde. Problemen, opmerkingen en pull request-activiteiten die de agent aanmaakt verschijnen onder dat account.

Stap 3: Voeg repositories toe

De stap 'Add repositories' toont een tabel waarin je aangeeft welke repositories de agent indexeert. Elke rij is één repository.

1. Als je dienst Azure DevOps is, selecteer dan eerst een project uit het Azure DevOps Project keuzemenu. De kolom Repository URL wordt gevuld met repositories in dat project.

2. Selecteer in de kolom Repository URL een repository uit het dropdown of typ direct een URL. Voor GitHub en GitLab staan in de dropdown-lijst repositories waar je inloggegevens toegang toe hebben. Voor Azure DevOps worden repositories weergegeven in het geselecteerde project.

3. In de kolom Weergavenaam voer je een korte naam in die de agent gebruikt om naar de repository te verwijzen.

4. Vul optioneel de kolom Beschrijving in om de agent meer context te geven over wat de repository bevat.

5. Als je dienst Azure DevOps is en de repository erg groot is, zet dan het Remote-vinkje in. De agent gebruikt AI-gestuurde zoekopdracht op de externe kopie in plaats van deze lokaal te klonen. Repositories worden gekloond met een schijflimiet van 100 GB; Het inschakelen van Remote voorkomt die beperking.

6. Om een extra repository toe te voegen, selecteer je Toevoegen en vul je de volgende rij in.

7. Wanneer de tabel klaar is, selecteer je Opslaan.

Stap 4: Valideer met een scenario

1. Begin een chat met je makelaar.

2. Stel een gelezen vraag, zoals:

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

3. Controleer de toolcard om te zien dat de agent de dienst doorzoekt en resultaten teruggeeft die op jouw gegevens zijn gebaseerd.

Wanneer er resultaten verschijnen die naar je repository verwijzen, werkt de verbinding van eind tot eind.

Troubleshooting

Probleem	Cause	Repareren
Zoeken retourneert geen resultaten	Het account heeft geen toegang tot het project of de repository	Bevestig dat het verbindingsaccount het project of de repository kan zien, en probeer het dan opnieuw.
Create faalt met een permissiefout	De token of het account heeft geen schrijfscope	Geef de token of het account de vereiste scope toe, of gebruik inloggegevens die schrijftoegang hebben.
GitHub Enterprise Cloud weigert de verbinding	GitHub Enterprise Cloud vereist een GitHub App-verbinding	Op de Code Access-pagina verbreek je de GitHub-verbinding, selecteer je repository toevoegen, kies je GitHub, voer je host .ghe.com in en kies je 'Breng je eigen GitHub-app als authenticatiemethode.

Verwante onderwerpen

• Verbind een notificatiedienst
• Verbind een telemetriebron
• Stel een beheerde connector in