CodeRabbit 멀티 레포 분석: 크로스 레포 장애를 머지 전에 잡아내기
PR이 모든 체크를 통과하고, 리뷰에서도 깔끔해 보여서 머지했는데, 10분 뒤에 다른 서비스가 터져본 경험이 있으신가요?
아키텍처가 여러 레포에 걸쳐 있을 때(마이크로서비스, 공유 라이브러리, 프론트·백엔드 분리 등) 한쪽의 변경이 다른 쪽을 조용히 망가뜨리는 일은 흔합니다. API 응답 스키마에서 필드 이름을 하나 바꿨다고 가정해 보세요. 해당 PR만 놓고 보면 아무 문제 없어 보이지만, 그 응답을 파싱하는 세 개의 서비스는 무슨 일이 벌어질지 전혀 모릅니다.
멀티 레포 환경을 운영하는 팀에서 가장 많이 겪는 고통이자, CodeRabbit에 가장 많이 요청된 기능이기도 합니다.
그래서 만들었습니다.
멀티 레포 분석이란?
멀티 레포 분석은 Pro 및 Enterprise 티어 사용자가 이용할 수 있는 새로운 기능으로, 관련 레포지토리를 연결하면 CodeRabbit이 코드 리뷰 시 연결된 모든 레포의 컨텍스트를 함께 참조합니다. 마이크로서비스, 공유 라이브러리, API 계약 변경 등 한 레포의 변경이 다른 레포에 영향을 줄 수 있는 모든 구조에 적합합니다.
PR이 공유 API, 타입 정의, 데이터베이스 스키마를 수정하면, CodeRabbit이 연결된 레포지토리를 자동으로 탐색해 다운스트림 영향을 분석합니다.
변경 사항을 개별 레포 단위로 고립시켜 보는 게 아니라, 머지하기 전에 전체 그림을 파악할 수 있게 되는 것입니다.
설정 방법
사용하기 전에, CodeRabbit 봇이 연결된 모든 레포에 읽기 권한을 갖도록 플랫폼별 사전 설정이 필요합니다.
| 플랫폼 | 요구 사항 |
|---|---|
| GitHub | CodeRabbit GitHub App이 연결 대상 레포에 설치되어 있어야 합니다. 접근 불가한 레포는 건너뛰며, 리뷰 요약에 경고가 표시됩니다. |
| GitLab | 봇 토큰에 읽기 권한이 필요합니다. 토큰은 보통 그룹 또는 인스턴스 단위로 스코핑됩니다. |
| Bitbucket Cloud | 봇 토큰에 읽기 권한이 필요합니다. 토큰은 워크스페이스 단위로 스코핑됩니다. |
| Azure DevOps | PAT에 읽기 권한이 필요합니다. 토큰은 조직 단위로 스코핑됩니다. |
사전 설정이 완료되면, 두 가지 방법으로 연결을 마무리할 수 있습니다.
CodeRabbit 웹 인터페이스를 통한 설정
- Repositories 섹션에서 연결하려는 레포를 선택합니다
- Use Organization Settings 토글을 끕니다
- Knowledge Base 내 Linked Repositories 섹션으로 이동합니다
- 리뷰 시 CodeRabbit이 참고할 가이드와 함께 연결 레포를 추가합니다
YAML 설정을 통한 설정
.coderabbit.yaml 파일의 knowledge_base 아래에 linked_repositories 섹션을 추가하면 됩니다.
# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
knowledge_base:
linked_repositories:
- repository: "myorg/backend-api"
instructions: "REST API 엔드포인트와 데이터베이스 모델을 포함"현재는 레포당 하나의 연결 레포만 지원되지만, 향후 복수 연결 레포 지원이 계획되어 있습니다. 전체 설정 방법은 공식 문서에서 확인할 수 있습니다.
실제 동작 확인하기
실제로 크로스 레포 이슈를 잡아내는 모습을 보고 싶다면, CodeRabbit 개발자 애드보킷이 만든 튜토리얼 영상을 참고하세요.
지금 바로 사용해 보세요
멀티 레포 분석 기능은 이미 사용 가능합니다. 레포를 연결하고, PR을 열어서, 지금까지 놓쳤던 크로스 레포 이슈들을 CodeRabbit이 어떻게 잡아내는지 직접 확인해 보세요.