Podłącz usługę kodu źródłowego

Daj agentowi dostęp do kontekstu repozytorium, problemu i pull requestów do śledztw. Może odczytać ostatnie zmiany, znaleźć powiązane problemy i otworzyć problem lub pull request w odpowiednim repozytorium lub projekcie, gdy dane dane poświadczenia na to pozwalają.

Ten samouczek obejmuje GitHub, Azure DevOps i GitLab. Połączenia z kodem źródłowym korzystają ze strony Code Access (Builder > Code Access), a nie kreatora zarządzanego łącznika. Ten artykuł skupia się na szczegółach kodu źródłowego: jak każda usługa uwierzytelnia się i jak weryfikować połączenie.

Wymagania wstępne

• Działający agent SRE i dostęp do sre.azure.com.
• Uprawnienia do konfiguracji agenta.
• Konto w usłudze z dostępem do repozytoriów lub projektów, które agent powinien przeczytać.

W przypadku usług powiadomień zobacz Connect a notification service.

Złącza kodu źródłowego

Złącze	Usługa	Authentication	Typowe użycie
GitHub	GitHub i GitHub Enterprise Cloud	Aplikacja GitHub przynieś własną (OAuth i PAT również wspierane dla github.com)	Czytaj repozytoria, problemy i pull requesty w różnych projektach i organizacjach; Tworzenie problemów lub pull requestów z zatwierdzeniem
Azure DevOps	Azure DevOps	Zarządzana tożsamość (obsługiwane także OAuth i PAT)	Czytanie repozytoriów i pull requestów między projektami; Tworz pull requesty lub zadania z zatwierdzeniem
GitLab	GitLab	Osobisty token dostępu (PAT)	Czytaj repozytoria, problemy i prośby o połączenie; Tworz problemy i komentarze z aprobatą

GitHub i Azure DevOps prezentują opcje uwierzytelniania jako przyciski radiowe. GitLab używa osobistego tokena dostępu.

Krok 1: Dostęp do kodu otwartego

1. Przejdź do sre.azure.com i wybierz agenta.
2. W lewym pasku bocznym rozwiń Builder, a następnie wybierz Code Access.
3. Wybierz zakładkę dla swojej usługi (GitHub, Azure DevOps lub GitLab).
4. Wybierz pozycję Dodaj repozytorium.

Krok 2: Uwierzytelnij się

Okno dialogowe Dodaj repozytoria otwiera się trzystopniowym czarodziejem: Wybierz platformę → Uwierzytelnij → Dodaj repozytoria. Po każdym kroku wybierz pozycję Dalej. Ostatni krok to przycisk Zapisz.

GitHub

Użyj aplikacji Bring your own GitHub dla GitHub Enterprise Cloud lub do ograniczenia dostępu przez organizację lub instalację.

1. W sekcji Metody logowania wybierz Pobierz własną aplikację GitHub.
2. Wypełnij pola ustawień aplikacji wyświetlane przez kreatora.
3. Wybierz Dalej.

GitHub Enterprise Cloud (.ghe.com) wymaga połączenia z aplikacją GitHub. Dla github.com obsługiwane są także Twoje konto (OAuth, jeśli jest skonfigurowane dla twojego środowiska) lub osobisty token dostępu, choć opcja GitHub App jest preferowana w scenariuszach produkcyjnych, aby umożliwić bardziej szczegółowe uprawnienia i widoczność audytu.

Po połączeniu agent może przeszukiwać repozytoria, problemy i pull requesty w różnych projektach i organizacjach, do których Twoja aplikacja lub konto ma dostęp.

Azure DevOps

Używaj Managed Identity do użytku produkcyjnego, co pozwala uniknąć długotrwałych poświadczeń.

1. W sekcji Metody logowania wybierz Tożsamość zarządzaną.
2. Wypełnij pola wyświetlane przez kreatora i upewnij się, że zarządzana tożsamość agenta ma dostęp do projektów i repozytoriów Azure DevOps, których agent potrzebuje.
3. Wybierz Dalej.

Twoje konto (OAuth) i uwierzytelnianie osobistego tokena dostępu również są obsługiwane, ale najlepiej sprawdzają się w rozwoju, testowaniu lub sytuacjach, gdy nie można użyć zarządzanej tożsamości. Używaj najwęższej tożsamości lub tokena, który może odczytać projekty i repozytoria potrzebne agentowi.

Po połączeniu agent może przeszukiwać repozytoria, czytać pull requesty i przeglądać zadania w ramach Twoich projektów.

GitLab

1. Wprowadź token dostępu osobistego GitLab (PAT).
2. Wybierz Dalej.

Daj PAT-owi tylko zakres potrzebny agentowi do uzyskania dostępu do repozytorium, wydania i połączenia.

Po połączeniu agent może odczytywać repozytoria, problemy i żądania łączenia w ramach projektów, do których token ma dostęp.

Usługa widzi tożsamość, która autoryzowała połączenie. Problemy, komentarze i działania pull requestów tworzone przez agenta pojawiają się pod tym kontem.

Krok 3: Dodaj repozytoria

Krok Dodaj repozytoria pokazuje tabelę, w której określasz, które repozytoria indeksuje agent. Każdy wiersz to jedno repozytorium.

1. Jeśli twoja usługa jest Azure DevOps, najpierw wybierz project z rozwijanego menu Azure DevOps Project. Kolumna URL repozytoria wypełnia repozytoria w tym projekcie.

2. W kolumnie URL repozytorium wybierz repozytorium z rozwijanego menu lub wpisz bezpośrednio URL. Dla GitHub i GitLab rozwijane menu wymienia repozytoria, do których dostęp mają twoje dane uwierzytelniające. Dla Azure DevOps lista repozytoria w wybranym projekcie.

3. W kolumnie Display name wpisz krótką nazwę, której agent używa do odniesienia do repozytorium.

4. Opcjonalnie wypełnij kolumnę Opis , aby uzyskać więcej kontekstu na temat treści repozytorium.

5. Jeśli twoja usługa to Azure DevOps, a repozytorium jest bardzo duże, włącz opcję Zdalny. Agent korzysta z wyszukiwania opartego na AI na zdalnej kopii zamiast klonować ją lokalnie. Repozytoria są klonowane z limitem dysków 100 GB; włączenie Remote eliminuje to ograniczenie.

6. Aby dodać kolejne repozytorium, wybierz Dodaj i wypełnij kolejny wiersz.

7. Gdy tabela jest kompletna, wybierz Zapisz.

Krok 4: Zweryfikowaj scenariusz

1. Otwórz czat ze swoim agentem.

2. Zadaj pytanie do przeczytania, takie jak:

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

3. Sprawdź kartę narzędzi, aby zobaczyć, jak agent wyszukuje usługę i zwraca wyniki oparte na Twoich danych.

Gdy pojawiają się wyniki odnoszące się do twojego repozytorium, połączenie działa od początku do końca.

Troubleshooting

Problem	Cause	Napraw.
Wyszukiwanie nie zwraca żadnych wyników	Konto nie ma dostępu do projektu ani repozytorium	Potwierdź, że konto połączenia widzi projekt lub repozytorium, a potem spróbuj ponownie.
Create kończy się błędem uprawnień	Token lub konto nie ma zakresu zapisu	Nadaj wymagany zakres tokenowi lub kontu albo użyj poświadczeń mających dostęp do zapisu.
GitHub Enterprise Cloud odrzuca połączenie	GitHub Enterprise Cloud wymaga połączenia z aplikacją GitHub	Na stronie dostępu do kodu rozłącz połączenie GitHub, wybierz Dodaj repozytorium, wybierz GitHub, wpisz swój .ghe.com host i wybierz Bring your own GitHub App jako metodę uwierzytelniania.

Treści powiązane

• Połącz usługę powiadomień
• Podłącz źródło telemetrii
• Ustaw zarządzane złącze