옵티오: 티켓에서 PR까지 쿠버네티스에서 AI 코딩 에이전트 오케스트레이션하기

Optio는 지속적인 인간 감독 없이 작업 수신부터 병합된 풀 리퀘스트까지 전체 워크플로우를 관리하는 AI 코딩 에이전트용 오픈소스 오케스트레이션 시스템입니다. Fastify, Next.js, BullMQ 및 Postgres 기반 Drizzle로 구축되었으며 프로덕션 배포를 위한 Helm 차트를 제공합니다.

작동 방식

시스템은 세 단계 파이프라인을 따릅니다:

• 수신 – GitHub Issues, Linear 또는 수동 생성에서 작업을 가져옴
• 실행 – 리포지토리별로 격리된 Kubernetes 파드를 생성하고, git 작업 트리에서 Claude Code 또는 Codex 실행
• PR 모니터링 – CI 검사, 리뷰 상태 및 병합 준비 여부를 30초마다 확인

핵심 차별점은 피드백 루프입니다. CI가 실패하면 Optio는 실패 내용을 에이전트에 피드백합니다. 리뷰어가 변경을 요청하면 해당 코멘트가 에이전트의 다음 프롬프트가 됩니다. PR이 병합되거나 수동으로 중지할 때까지 이 과정이 계속됩니다.

아키텍처 및 기능

Optio는 리포지토리당 하나의 장수명 Kubernetes 파드를 사용하는 파드-퍼-리포 아키텍처를 채택합니다. 각 파드는 여러 동시 작업을 위한 git 작업 트리 격리를 유지합니다. 시스템에는 다음이 포함됩니다:

• 자가 치유 – CI 실패, 병합 충돌 또는 리뷰어 변경 요청 시 에이전트 자동 재개
• 완료 자동화 – 모든 검사가 통과하면 PR을 스쿼시 병합하고 연결된 이슈를 닫음
• 리포지토리별 구성 – 모델 선택, 프롬프트 템플릿, 컨테이너 이미지, 동시성 제한 및 설정 명령을 리포지토리별로 조정 가능
• 코드 리뷰 에이전트 – 별도의 프롬프트와 모델을 가진 서브태스크로 리뷰 에이전트 자동 실행
• 실시간 대시보드 – 실시간 로그 스트리밍, 파이프라인 진행 상황, 비용 분석 및 클러스터 상태 모니터링

기술 구현

아키텍처는 세 가지 주요 구성 요소로 이루어집니다:

• 웹 UI (포트 3100의 Next.js) – 대시보드, 작업 관리 및 실시간 스트리밍 포함
• API 서버 (Fastify) – 작업 큐, PR 감시자, 상태 모니터링 및 티켓 동기화를 위한 워커 포함
• Kubernetes 클러스터 – AI 에이전트를 실행하는 여러 작업 트리를 포함한 리포지토리 파드

서비스에는 리포지토리 풀 관리, 리뷰 에이전트 실행 및 인증/비밀 처리 등이 포함되며, 모두 작업, 로그 및 이벤트를 위한 Postgres를 백엔드로 사용합니다.