소스 코드 서비스 연결

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

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

사전 요구 사항

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

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

소스 코드 커넥터

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

GitHub 및 Azure DevOps는 인증 옵션을 라디오 버튼으로 제공합니다. GitLab은 개인 액세스 토큰을 사용합니다.

1단계: Code Access 열기

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

2단계: 인증

저장소 추가(Add repositories) 대화상자는 두 단계로 구성되어 있습니다: 연결(Connection)과 저장소 추가(Add repositories). 연결 시 플랫폼을 선택하고 저장소 URL 또는 조직을 입력한 후 인증을 설정하세요. 연결한 후 '다음'을 선택하고 마지막 단계에서 저장하세요.

GitHub

GitHub Enterprise Cloud용이거나 조직 또는 설치별로 액세스 범위를 지정하려면 GitHub 앱 사용을 선택하세요.

1. https://github.com/owner/repo 전체를 입력하세요(예: ).
2. 일치하는 자격 증명이 있다면 기존 연결을 선택해 재사용하거나, 새 연결을 선택하여 다른 것을 설정하세요.
3. 연결 방법 아래에서 'GitHub 앱 사용'을 선택하세요.
4. 마법사가 표시한 앱 설정 필드를 완료하세요.
5. Connect를 선택하고 연결이 성공했는지 확인하세요.
6. 다음을 선택합니다.

GitHub Enterprise Cloud (.ghe.com)는 GitHub 앱 연결이 필요합니다. github.com에서도 OAuth 및 개인 액세스 토큰(PAT)을 지원합니다. GitHub 앱 인증은 비밀 URI가 아니라 RSA Key Vault 키 URI/keys/()를 필요로 합니다. GitHub BYO 앱 설정을 참고하세요.

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

Azure DevOps

운영 환경에서는 장기간 유지되는 자격 증명을 피할 수 있는 Managed Identity를 사용합니다.

1. Azure DevOps 조직 이름을 입력하세요.
2. 로그인 방법 아래에서 관리 ID를 선택합니다.
3. 마법사가 표시한 필드를 완료하고, 에이전트의 관리 신원이 에이전트가 필요로 하는 Azure DevOps 프로젝트와 저장소에 접근할 수 있는지 확인하세요.
4. 연결( Connect )을 선택하고 연결 성공을 확인하세요.
5. 다음을 선택합니다.

사용자 계정(OAuth)과 PAT 인증도 지원되지만, 개발, 테스트 또는 관리 신원을 사용할 수 없는 상황에 가장 적합합니다. 에이전트가 필요로 하는 프로젝트와 저장소를 읽을 수 있는 가장 좁은 신원이나 토큰을 사용하세요.

연결 후 에이전트는 저장소를 검색하고, 풀 리퀘스트를 읽으며, 프로젝트 전반의 작업 항목을 검사할 수 있습니다.

GitLab

1. GitLab의 개인 접근 토큰(PAT)을 입력하세요.
2. 다음을 선택합니다.

PAT에는 저장소, 이슈, 병합 요청 접근에 필요한 범위만 부여하세요.

연결 후 에이전트는 토큰이 접근할 수 있는 프로젝트 내 저장소, 이슈, 병합 요청을 읽을 수 있습니다.

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

3단계: 저장소 추가

추가할 저장소를 검토하세요. GitHub에서는 각 저장소를 확장하여 표시 이름과 설명을 수정하세요. Azure DevOps와 GitLab의 경우, 테이블에서 이 필드들을 직접 편집하세요.

1. 서비스가 Azure DevOps인 경우 먼저 Azure DevOps Project 드롭다운에서 프로젝트를 선택하세요. 저장소 URL 열에는 해당 프로젝트의 저장소가 표시됩니다.

2. 초기 저장소 URL을 검토하세요. 더 많은 항목을 원하시면 드롭다운에서 저장소를 선택하거나 URL을 직접 입력하세요. Azure DevOps의 경우, 먼저 프로젝트를 선택하세요.

3. 에이전트가 저장소를 참조할 때 사용하는 짧은 디스플레이 이름을 입력하세요. GitHub에서는 항목을 확장하여 이 필드를 찾으세요.

4. 선택적으로 에이전트가 저장소를 더 잘 이해할 수 있도록 설명을 입력할 수도 있습니다. GitHub에서는 먼저 설명 추가를 선택하세요.

5. Azure DevOps 환경에서 Remote 옵션을 제공한다면, 전체 저장소를 복제하지 않고도 AI 기반 검색을 할 수 있습니다. 이 옵션은 모든 환경에서 제공되는 것은 아닙니다.

6. 다른 저장소를 추가하려면 GitHub용 Add repository를 선택하거나 Azure DevOps 또는 GitLab 그리드에서 Add 하세요. 이와 관련된 추가 GitHub 저장소들은 동일한 호스트와 자격 증명을 사용합니다.

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

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

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

2. 다음과 같은 읽기 관련 질문을 합니다.

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

3. 도구 카드를 확인해 에이전트가 서비스를 검색하고 사용자의 데이터에 기반한 결과를 반환하는 것을 확인합니다.

저장소를 참조하는 결과가 나타나면, 연결이 전체적으로 정상 작동합니다.

Troubleshooting

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

관련 콘텐츠

• 알림 서비스 연결
• 텔레메트리 소스에 연결
• 관리 커넥터를 설정하세요