🚀 Groq와 Pipelines를 사용해 Bitbucket용 AI 기반 코드 리뷰어 구축

Source: Dev.to

개요

현대 개발 팀은 코드 품질을 위해 풀 리퀘스트에 크게 의존하지만, 수동 리뷰는 느리고 일관성이 없으며 비용이 많이 듭니다. Bitbucket의 Rovo Dev와 GitHub의 Ask Copilot은 AI‑지원 PR 리뷰를 제공하지만, 가격 모델(예: $20 / 개발자 / 월)이 제 요구에 맞지 않았습니다.

이미 Groq API 키가 있었고 완전 자동화된 파이프라인 기반 솔루션을 원했기에, 다음을 이용해 Bitbucket용 AI‑구동 PR 리뷰어를 만들었습니다:

• Bitbucket Pipelines
• Groq LLM (llama‑3.3‑70b‑versatile)
• Git 기반 diff 추출 (REST API 인증 번거로움 없음)

이 시스템은 모든 PR을 자동으로 검토하고, 구조화된 체크리스트 기반 AI 리뷰를 출력하며 개발자당 라이선스 비용이 전혀 발생하지 않습니다.

기존 솔루션과의 비교

동기와 목표

원하지 않았던 것:

• 또 다른 좌석당 SaaS 구독
• 수동 “Ask AI” 워크플로우
• 가격 변동 시 깨지는 시스템

원했던 것:

• CI 수준의 강제 적용
• 맞춤형 리뷰 규칙
• 가능한 가장 낮은 비용

그래서 Groq + Pipelines를 선택했습니다.

초기 접근 방식 (Bitbucket REST API)

첫 번째 시도는 일반적인 패턴을 따랐습니다:

1. Bitbucket REST API를 통해 PR diff 가져오기
2. 다음 토큰 중 하나를 사용해 PR 코멘트 게시:
   • Atlassian API 토큰
   • 워크스페이스 토큰
   • 리포지토리 액세스 토큰

올바른 스코프를 지정했음에도 불구하고, 401 Unauthorized 오류가 반복적으로 발생했습니다. 원인:

• 토큰 동작의 일관성 부족
• Bitbucket 보안 모델의 지속적인 변화
• 2025년 토큰 동작에 대한 문서 부족

광범위한 디버깅 끝에 diff 수집을 위해 Bitbucket REST API를 완전히 배제하는 것이 가장 현명한 선택이라는 결론에 도달했습니다.

프로덕션 아키텍처

풀 리퀘스트 생성

• diff를 위한 REST API 호출 없음
• 인증 실패 없음
• 권한 문제 없음
• 완전히 결정적이며 플레이크 프리

Diff 추출

Bitbucket 엔드포인트를 호출하는 대신, 파이프라인에서 Git 명령만 실행합니다:

# Get the diff for the current PR
git fetch origin main
git diff origin/main...HEAD

• 정확한 PR diff 제공
• API 인증 필요 없음
• 모든 CI 환경에서 동작

이 한 가지 결정으로 **≈ 90 %**의 시스템 복잡성이 사라졌습니다.

AI 리뷰 체크리스트 (TypeScript + Angular)

이 체크리스트는 일관된 리뷰, 표준 강제 적용, 리뷰어 편향 제로를 보장합니다.

Groq LLM 통합

왜 Groq인가?

• 큰 diff에서도 뛰어난 추론 능력
• 많은 대안보다 비용 효율적
• OpenAI 호환 API
• 친환경적 (요청당 낮은 연산 시간)

AI는 다음과 같이 카테고리별 피드백을 제공합니다:

• 🚨 치명적 이슈
• 🔒 보안 분석
• ⚡ 성능 리뷰
• 🏗️ 아키텍처 피드백
• 📝 유지보수성
• ✅ 최종 판정 (MERGE READY / NEEDS WORK)

AI 리뷰 표시 위치

• 전체 AI 리뷰는 Pipelines 로그에 출력
• 선택적으로 다운로드 가능한 ai-review.md 아티팩트로 저장 가능
• PR 쓰기 권한이 필요 없으므로 보안 위험 없음

이 접근 방식은 PR에 자동으로 코멘트를 다는 방식보다 기업 환경에 훨씬 적합했습니다.

프로덕션 영향

• 모든 PR이 몇 분 안에 자동으로 리뷰됨
• 리뷰 표준이 일관되게 적용
• 인간 리뷰어는 비즈니스 로직에 집중 가능
• 인증 문제로 인한 파이프라인 실패 없음
• 재시도로 인한 빌드 시간 낭비 없음
• 개발자당 라이선스 비용 제로

주요 엔지니어링 교훈

• AI 리뷰어는 보조 역할을 해야 하며, 개발자를 차단해서는 안 된다
• PR 코멘트는 선택 사항이며, 리뷰는 신뢰할 수 있어야 한다
• Pipelines + Git + LLM 조합은 매우 강력하다
• Groq는 CI/CD AI 워크로드에 최적화돼 있다
• 좋은 AI 리뷰를 얻기 위해 $20 / 개발자 / 월 라이선스를 구매할 필요가 없다

앞으로의 계획

• 판정이 NEEDS WORK일 경우 자동으로 머지 차단
• 언어별 리뷰어 추가 (예: .NET, SQL)
• 보안 전용 리뷰 모드
• 아키텍처 드리프트 탐지

마무리 생각

Git을 이용해 diff를 추출하고, Groq로 AI 분석을 수행하며, Pipelines로 자동화하세요. 가능한 한 REST API 인증은 피하는 것이 좋습니다.