소스 코드 서비스 연결

에이전트에게 조사를 위한 저장소, 이슈, 풀 리퀘스트 컨텍스트에 대한 접근 권한을 주세요. 최근 변경 사항을 읽고, 관련 문제를 찾으며, 제공한 자격 증명이 허용할 때 적절한 저장소나 프로젝트에서 이슈나 풀 요청을 열 수 있습니다.

이 튜토리얼은 GitHub, Azure DevOps, GitLab을 다룹니다. 소스 코드 연결은 관리 커넥터 마법사가 아닌 Code Access 페이지(빌더 > 코드 접근)를 사용합니다. 이 글은 소스 코드 세부 사항에 초점을 맞추고 각 서비스가 어떻게 인증하고 연결을 검증하는지에 관한 것입니다.

사전 요구 사항

  • 실행 중인 SRE 에이전트와 sre.azure.com 접근 권한.
  • 에이전트 설정 권한.
  • 서비스 내 저장소나 프로젝트에 접근할 수 있는 계정이 있어야 합니다.

알림 서비스에 대해서는 '알림 서비스 연결'을 참조하세요.

소스 코드 커넥터

커넥터 서비스 Authentication 일반적인 용도
GitHub GitHub 및 GitHub 엔터프라이즈 클라우드 직접 가져오는 GitHub 앱 (OAuth와 PAT도 github.com 지원) 프로젝트와 조직 간의 저장소, 이슈, 풀 리퀘스트를 읽고; 승인 후 이슈나 풀 리퀘스트를 생성하세요
Azure DevOps Azure DevOps 관리형 신원 (OAuth 및 PAT 지원도 함) 프로젝트 전반에 걸쳐 저장소와 풀 리퀘스트를 읽고; 승인을 받아 풀 리퀘스트나 작업 항목을 생성하세요
GitLab GitLab PAT(개인용 액세스 토큰) 저장소, 이슈, 병합 요청을 읽으세요; 호의와 의견을 만들어 승인하세요

GitHub and Azure DevOps は認証 옵션을 선택지로 선택지로 제공합니다. GitLab은 개인 액세스 토큰을 사용합니다.

1단계: 코드 접근 개방

  1. sre.azure.com 이동하여 에이전트를 선택합니다.
  2. 왼쪽 사이드바에서 빌더를 열고 코드 접근을 선택하세요.
  3. 서비스 탭(GitHub, Azure DevOps, 또는 GitLab)을 선택하세요.
  4. 리포지토리 추가를 선택합니다.

2단계: 인증

저장소 추가 대화상자는 3단계 마법사로 시작됩니다: 플랫폼 선택 → 인증 → 저장소 추가. 각 단계 후에 다음을 선택합니다. 마지막 단계에는 저장 버튼이 있습니다.

GitHub 엔터프라이즈 클라우드에서 Bring your own GitHub 앱을 사용하거나, 조직 또는 설치별로 접근 범위를 넓히세요.

  1. 로그인 방법 항목에서 '나만의 GitHub 앱 가져오기'를 선택하세요.
  2. 마법사가 표시한 앱 설정 필드를 완료하세요.
  3. 다음을 선택합니다.

GitHub Enterprise Cloud (.ghe.com)는 GitHub 앱 연결이 필요합니다. github.com 경우, 귀하의 계정(환경에 맞게 설정된 경우 OAuth)이나 개인 액세스 토큰도 지원되지만, 운영 환경에서는 GitHub 앱 옵션이 더 세밀한 권한과 감사 가시성을 위해 선호됩니다.

연결 후, 에이전트는 앱이나 계정에 접근할 수 있는 프로젝트와 조직 간 저장소, 이슈, 풀 리퀘스트를 검색할 수 있습니다.

서비스는 연결을 승인한 신원을 확인합니다. 에이전트가 생성한 문제, 댓글, 풀 리퀘스트 활동이 해당 계정에 표시됩니다.

3단계: 저장소 추가

저장소 추가(Add repositories) 단계에서는 에이전트가 어떤 저장소를 인덱싱하는지 지정하는 표가 표시됩니다. 각 행은 하나의 저장소입니다.

  1. 서비스가 Azure DevOps 있다면 먼저 Azure DevOps Project 드롭다운에서 project을 선택하세요. 저장소 URL 열은 해당 프로젝트의 저장소를 채웁니다.

  2. 저장소 URL 열에서 드롭다운에서 저장소를 선택하거나 URL을 직접 입력하세요. GitHub과 GitLab의 경우, 드롭다운에 자격 증명이 접근할 수 있는 저장소가 나열되어 있습니다. Azure DevOps의 경우, 선택한 프로젝트 내 저장소를 나열합니다.

  3. 디스플레이 이름 열에 에이전트가 저장소를 참조할 때 사용하는 짧은 이름을 입력하세요.

  4. 선택적으로 설명 열을 채워 에이전트가 저장소에 무엇이 포함되어 있는지 더 많은 맥락을 제공할 수 있습니다.

  5. 만약 귀하의 서비스가 Azure DevOps이고 저장소가 매우 크다면, 원격 체크박스를 활성화하세요. 에이전트는 로컬 복제 대신 AI 기반 검색 기능을 원격 복사본에 적용합니다. 저장소는 100GB 디스크 제한으로 복제됩니다; 원격 모드를 활성화하면 그 제약을 피할 수 있습니다.

  6. 다른 저장소를 추가하려면 추가 를 선택하고 다음 행을 채우세요.

  7. 테이블이 완성되면 저장을 선택하세요.

4단계: 시나리오로 검증하기

  1. 에이전트와 채팅을 시작하세요.

  2. 다음과 같은 읽기 질문을 해보세요:

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

  3. 도구 카드를 확인해 상담원이 서비스를 검색하고 귀하의 데이터에 기반한 결과를 반환하는지 확인하세요.

저장소를 참조하는 결과가 나타나면, 연결이 끝에서 끝까지 작동합니다.

Troubleshooting

문제 Cause 수정
검색은 결과를 반환하지 않습니다. 계정은 프로젝트나 저장소에 접근할 수 없습니다 연결 계정이 프로젝트나 저장소를 볼 수 있는지 확인한 후 다시 시도하세요.
Create 실패 시 권한 오류가 발생합니다 토큰이나 계정에 쓰기 범위가 없습니다 토큰이나 계정에 필요한 범위를 부여하거나, 쓰기 권한이 있는 자격 증명을 사용하세요.
GitHub Enterprise Cloud가 연결을 거부합니다 GitHub Enterprise Cloud는 GitHub 앱 연결이 필요합니다 코드 접근 페이지에서 GitHub 연결을 끊고, 저장소 추가를 선택한 뒤 GitHub를 선택한 뒤 호스트를 .ghe.com 입력한 뒤, 인증 방법으로 'Bring your own GitHub App'을 선택하세요.

관련 콘텐츠

  • Last updated on