저널 AI 활용

OpenSRE 정리: 실패한 CI/CD 빌드의 원인을 추적해 PR 수정안까지 만드는 오픈소스 에이전트

OpenSRE 소개 커버 이미지. 깨진 CI/CD 빌드의 원인을 추적하고 PR 수정안을 만드는 오픈소스 에이전트, 60개 이상 연동, CI 환경 오류와 코드 회귀 분리, Apache-2.0 라이선스를 표시.

CI가 빨간불을 켜는 순간, 알림이 알려주는 것은 “무언가 실패했다”까지입니다. 로그는 수천 줄이고, 원인이 방금 올린 코드인지 러너 이미지인지 캐시인지 외부 API인지는 그 안에서 추정해야 합니다. 마감이 몰리면 재실행 버튼을 누르고 넘어가고, 같은 검사가 다시 빨개지면서 기본 브랜치는 계속 빨간 상태로 남습니다.

OpenSRE는 이 지점을 겨냥한 오픈소스 CLI 에이전트입니다. 실패한 CI 실행 로그와 최근 커밋·배포 이력, 그리고 Grafana·Datadog·Sentry 같은 관측 도구의 로그·메트릭·트레이스를 함께 읽어 CI 인프라 때문에 깨진 것과 코드 때문에 깨진 것을 나눠 보여주고, 고칠 곳을 찾으면 PR 브랜치에 수정안을 밀어 넣습니다. 머지는 사람이 합니다.

이 글은 2026년 11월 21일 기준으로 GitHub 저장소의 README, 릴리스 노트, GitHub REST API 응답, 공식 사이트 첫 화면을 직접 열어 대조한 내용입니다. 파이프라인에 붙여 정확도를 측정해 본 후기가 아니라 공개된 문서 기준의 정리이므로, 실제 저장소에서의 진단 품질은 각자 환경에서 확인이 필요합니다.

한눈에 정리

  • 무엇인가: 실패한 CI 실행을 조사해 원인을 추적하고, 수정안을 PR 브랜치에 푸시하는 셀프호스팅 CLI 에이전트입니다. 라이선스는 Apache-2.0입니다.
  • 현재 상태: Public Alpha입니다. 최신 릴리스는 2026년 11월 21일 00시 53분(UTC)에 공개된 v0.1.2026.11.21입니다.
  • 저장소 규모: 2026년 1월 13일 생성, Python 기반, 별 13,637개·포크 1,926개(2026년 11월 21일 조회).
  • 동작 흐름: 수집(Fetch) → 마스킹(Mask) → 추론(Reason) → 답변(Answer) → 수정(Fix) → 공유(Post)의 6단계입니다.
  • 연동: 모델·관측·인프라·DB·CI·인시던트 도구까지 60개 이상. Notion·Teams·Confluence·Linear는 로드맵 단계입니다.
  • 조심할 점: 알파 단계라 API와 연동 스펙이 바뀔 수 있고, 제품 분석·오류 텔레메트리가 기본으로 켜져 있으며(OPENSRE_NO_TELEMETRY=1로 끕니다), 수정안은 자동 머지되지 않습니다.

알파 단계라는 점을 먼저 못 박아 둡니다. 저장소 README 맨 위에는 “핵심 워크플로는 초기 탐색에 쓸 수 있는 수준이며 아직 완전히 안정적이지 않다, API와 연동은 바뀔 수 있다”는 경고가 붙어 있습니다. 아래에 적은 명령과 수치는 2026년 11월 21일의 v0.1.2026.11.21 기준이고, 다음 릴리스에서 달라질 수 있습니다. 운영 파이프라인에 붙이기 전에 개발용 저장소에서 먼저 돌려 보는 편이 안전합니다.

1. OpenSRE가 하는 일: 빨간 빌드에서 “고칠 곳”까지

기존 CI는 실패한 검사의 이름과 로그를 보여줍니다. 그 로그를 읽고 원인을 좁히는 일은 여전히 사람 몫이고, 그 시간이 아껴지지 않으면 팀은 재실행으로 도피합니다. OpenSRE가 바꾸려는 것은 이 조사 단계입니다.

실패한 실행이 생기면 OpenSRE는 실패한 검사와 CI 로그, 최근 커밋과 배포 이력, 그리고 연결된 관측 시스템의 로그·메트릭·트레이스를 한자리에서 읽습니다. 그다음 도구를 호출해 가설을 검증하는 루프를 돌면서, 러너·캐시·네트워크처럼 CI 쪽에서 생긴 실패와 코드 변경 때문에 생긴 회귀를 구분합니다. 답변에는 어떤 로그 줄과 어떤 커밋을 근거로 삼았는지가 함께 붙고, 원인이 명확하면 수정안을 PR 브랜치에 푸시해 사람이 리뷰할 수 있게 둡니다.

저장소 자체는 최근에 만들어진 프로젝트입니다. 2026년 1월 13일에 공개됐고, 2026년 11월 21일 기준 별 13,637개, 포크 1,926개, 열린 이슈 15개, 태그 232개, 브랜치 77개, 커밋 4,439개입니다. 코드는 Python이고 라이선스는 Apache-2.0이며, 저장소 소개 문구는 “CI/CD 신뢰성을 위한 오픈소스 에이전트”입니다. 별 수가 많다는 사실은 이 도구가 내 파이프라인에 맞는다는 뜻은 아니지만, 적어도 혼자 쓰는 실험실 프로젝트는 아니라는 점은 확인됩니다.

GitHub의 Tracer-Cloud/opensre 저장소 화면. 별 13.6k, 포크 1.9k, Apache-2.0 라이선스, 최신 릴리스 OpenSRE 0.1.2026.11.21 표시.
저장소 화면(2026년 11월 21일 확인). 오른쪽 정보란에 Apache-2.0 라이선스와 최신 릴리스 0.1.2026.11.21이, 상단에 별 13.6k·포크 1.9k가 보입니다.

핵심은 셀프호스팅입니다. 저장소 설명과 공식 사이트 모두 “내 인프라에서, 내가 고른 모델로 돌린다”를 전면에 내세웁니다. 모델은 Anthropic·OpenAI·Google Gemini·Ollama·Bedrock 등에서 고르고, 로그와 대화 기록은 기본적으로 로컬에서 다뤄집니다. 사내 규정상 외부 SaaS에 CI 로그를 넘기기 어려운 팀이 1차 검토 대상이 되는 이유입니다.

2. 여섯 단계로 도는 진단 루프

README가 설명하는 흐름은 6단계입니다. 순서대로 보면 이 도구가 어디까지 자동으로 하고 어디서 멈추는지가 분명해집니다.

1단계 수집(Fetch)은 실패한 검사와 CI 로그, 최근 커밋·배포, 상관관계가 있는 로그·메트릭·트레이스를 모읍니다. 2단계 마스킹(Mask)은 외부 LLM으로 보내기 전에 민감한 식별자를 가리는 선택 단계입니다. 여기서 중요한 것은 이 단계가 선택 사항이라는 점입니다. 민감 정보가 섞인 로그를 다룬다면 켜져 있는지 직접 확인해야 합니다.

3단계 추론(Reason)이 이 도구의 본체입니다. 연결된 시스템을 오가며 도구 호출 루프로 가설을 세우고 검증하면서, CI가 만든 실패와 코드가 만든 실패를 분리합니다. 4단계 답변(Answer)은 그 결과를 근거 링크와 함께 대화에 붙입니다. 5단계 수정(Fix)은 원인을 고친 변경을 PR 브랜치에 푸시하거나, 다음에 할 일을 제안하고 선택적으로 조치를 실행합니다. 6단계 공유(Post)는 요약을 Slack·PagerDuty·Telegram으로 보내 조사 결과가 대화창 밖으로도 남게 합니다.

OpenSRE 진단 흐름 도표. 실패한 CI 실행 감지, 컨텍스트 수집, PII 마스킹, 근본 원인 추론 루프, PR 수정안 푸시와 Slack 요약 순서.
README의 6단계 설명을 그림으로 옮긴 도표. 왼쪽에서 오른쪽으로 실패 감지 → 컨텍스트 수집 → 마스킹 → 추론 루프 → PR·요약 순서이고, 아래쪽 화살표는 결과가 다시 관측 데이터로 돌아가는 피드백 경로입니다.

여기서 자동 머지는 없다는 점을 짚어야 합니다. 5단계가 만들어내는 것은 사람이 리뷰할 PR 브랜치이고, 6단계는 그 결과를 알리는 일입니다. 즉 OpenSRE는 “고치기까지”를 자동화하되 “반영”은 사람에게 남깁니다. 이 경계는 사고를 줄이는 설계이지만, 동시에 결과를 읽는 사람이 없으면 아무것도 반영되지 않는다는 뜻이기도 합니다.

3. 설치와 실행: 한 줄 설치에서 헤드리스·Python 호출까지

설치는 스크립트 한 줄입니다. macOS·Linux에서는 아래 명령이 최신 빌드를 받아 깔고, -gh는 GitHub 연동에 필요한 준비를 함께 처리합니다. 설치 스크립트는 sudo 없이 동작하고, opensre 명령이 잡히지 않으면 안내되는 PATH 설정을 따르거나 터미널을 새로 열면 됩니다.

curl -fsSL https://install.opensre.com | bash -s -- -gh

Windows는 PowerShell에서 & ([scriptblock]::Create((irm https://install.opensre.com/install.ps1))) -gh를 쓰거나 WSL을 쓰도록 안내합니다. 특정 버전에 고정하려면 설치 스크립트에 --release --version 0.1.2026.11.21을 넘깁니다. 첫 실행에서 호스팅 모델이 활성화되고, 계정 확인을 거쳐 대화형 셸이 열립니다.

실행 방식은 네 갈래입니다. 첫째, 대화형 셸은 opensre만 입력하면 열리고 TTY가 필요합니다. /status, /cost, /sessions, /resume, /compact, /new, /exit 같은 슬래시 명령으로 세션을 다루고, /integrations list·/integrations verify로 연동 상태를 확인합니다. 진행 중인 턴은 Ctrl+C로 끊되 세션 상태는 유지됩니다.

둘째, 헤드리스 CLI입니다. opensre ask "why is checkout-api slow?"처럼 한 턴을 비대화식으로 돌려 터미널·스크립트·CI 잡에서 호출할 수 있습니다. 셋째, Python 코드 안에서 세션을 열어 쓸 수 있습니다. 소스 체크아웃이 필요하고, start_embedded_session()으로 세션을 만든 뒤 session.chat() 결과의 accounting_status가 완료이고 취소되지 않았을 때 응답 본문을 읽는 구조입니다. 넷째, 서버 배포입니다.

배포는 세 가지 경로가 문서화돼 있습니다. 조직 관리자가 웹 앱에서 프로비저닝하는 OpenSRE Cloud 관리형 게이트웨이, AMI와 systemd로 세우는 게이트웨이 이미지(make build-gateway-image 후 make deploy-gateway, Telegram 게이트웨이 전용이며 Docker를 쓰지 않음), 그리고 저장소의 Dockerfile을 Railway·ECS·Vercel에 올리는 셀프호스팅 컨테이너입니다. 컨테이너에서는 MODE와 LLM_PROVIDER, 모델 API 키를 지정하고, Slack Events API 복제본처럼 여러 인스턴스가 상태를 공유해야 할 때만 DATABASE_URL로 Postgres를 붙입니다.

야간 책상에서 노트북과 모니터로 CI 파이프라인과 코드를 확인하는 개발자 작업 공간.
이 도구가 실제로 줄이려는 시간은 빌드가 빨간 동안 로그를 읽는 시간입니다. 자동화가 끝나는 지점은 여전히 사람이 PR을 읽는 자리입니다.

관리 명령도 함께 있습니다. opensre integrations setup으로 연동을 설정하고, opensre update로 갱신하며, opensre uninstall은 프로그램과 함께 로컬 데이터까지 지웁니다. 마지막 명령은 되돌릴 수 없으니 지우기 전에 남길 세션이 없는지 확인해야 합니다.

4. 60개 넘는 연동: 붙일 수 있는 것과 아직인 것

OpenSRE의 값어치는 결국 어떤 시스템을 읽을 수 있느냐에 달려 있습니다. README는 연동 범위를 60개 이상으로 적고, 범주별로 나눠 표로 정리합니다. 대표적인 것만 추리면 아래와 같습니다.

범주 대표 연동 메모
모델 Anthropic, OpenAI, OpenAI Codex, Google Gemini, Ollama, Bedrock, OpenRouter, NVIDIA NIM 셀프호스팅이면 로컬 모델(Ollama)도 선택지
관측 Grafana(Loki·Mimir·Tempo·annotations), Datadog, Sentry, CloudWatch, New Relic, Honeycomb, Splunk, Elasticsearch, Azure Monitor 로그·메트릭·트레이스를 함께 읽는 핵심 입력
인프라 Kubernetes, AWS(S3·Lambda·EKS·EC2·CloudTrail·Bedrock), Azure, ArgoCD, Helm 배포·클러스터 상태를 근거로 붙임
DB·데이터 PostgreSQL, MySQL, MongoDB, Redis, Snowflake, ClickHouse, Supabase, Neon, Airflow, Kafka, Dagster, Temporal 데이터 파이프라인 실패 추적에 사용
코드·CI GitHub, GitHub MCP, GitLab, Bitbucket, Jenkins 실패 실행·커밋·PR이 1차 입력
인시던트 PagerDuty, Jira, Alertmanager, incident.io, ServiceNow 알림에서 조사를 시작하는 경로
커뮤니케이션 Slack, Telegram, Discord, Google Docs, WhatsApp, Rocket.Chat 6단계 요약이 도착하는 곳
배포·프로토콜 Vercel, AWS EC2·ECS, Railway, MCP 에이전트 자체를 올리는 경로

반대로 아직 없는 것도 분명합니다. Notion, Microsoft Teams, Confluence, Linear는 로드맵으로 표시돼 있고, 저장소 이슈로만 관리됩니다. 사내 문서가 Confluence에 있고 이슈가 Linear에 있는 팀이라면, 그 두 곳을 근거로 삼는 진단은 기대하기 어렵습니다. 도입 전에 “우리 실패의 근거가 어디에 쌓이는가”를 먼저 확인하고, 그 저장소가 위 표에 있는지 보는 순서가 맞습니다.

5. 기존 CI 운영과 비교: 어디에 넣으면 값이 나오나

지금의 CI 운영 방식과 나란히 놓으면 차이가 어디서 생기는지 보입니다.

기준 지금의 CI 운영 OpenSRE
실패 직후 알림 확인 → 로그 열기 → 재실행 실패 실행을 자동으로 조사해 원인 후보 제시
원인 판별 사람이 로그를 읽고 추정 CI 인프라 문제와 코드 회귀를 분리
근거 로그 줄, 기억, 동료 경험 로그·커밋·배포·메트릭 링크를 붙여 제시
고치는 일 담당자가 직접 수정·푸시 PR 브랜치에 수정안 푸시(리뷰 대기)
사람의 역할 조사 + 수정 + 리뷰 리뷰와 판단(머지는 사람)
준비물 CI와 로그 접근 권한 CLI 설치, 모델 키, 연동 자격증명

맞는 경우는 실패가 잦고 원인 추적에 시간이 새는 팀입니다. 검사가 여러 개 붙은 모노레포, 러너 이미지와 캐시가 자주 말썽을 부리는 파이프라인, 관측 데이터가 이미 Grafana나 Datadog에 쌓여 있는 조직이라면 1단계부터 4단계까지의 이득이 바로 보입니다. 야간에 실패한 빌드를 아침에 요약으로 받는 용도(6단계)도 부담이 적습니다.

맞지 않을 수 있는 경우도 있습니다. 하루에 빌드가 몇 번 돌지 않고 실패도 드물다면 조사 자동화가 돌아갈 자리가 없습니다. 반대로 보안 요구가 매우 강해 CI 로그를 어떤 외부 모델에도 보낼 수 없다면, 로컬 모델(Ollama 등)로 품질이 충분한지부터 확인해야 합니다. 알파 단계라 연동 스펙이 바뀌는 것을 감당하기 어려운 운영 환경도 지금은 후순위가 맞습니다.

도입 전에 확인할 것은 네 가지로 정리됩니다. 첫째, 텔레메트리입니다. 제품 분석과 오류 수집(Sentry)이 기본으로 켜져 있고, 끄려면 export OPENSRE_NO_TELEMETRY=1을 설정합니다. 둘째, 민감 정보입니다. 마스킹은 선택 단계이므로 로그에 고객 식별자가 섞이는 환경이라면 설정을 직접 확인해야 합니다. 셋째, 권한 범위입니다. PR 브랜치에 푸시하고 Slack·PagerDuty에 쓰려면 그만큼의 토큰 권한이 필요하고, 그 권한은 사람 계정이 아니라 전용 계정으로 두는 편이 안전합니다. 넷째, 비용입니다. 도구 자체는 Apache-2.0 오픈소스지만 추론에 쓰는 모델 요금은 사용자가 고른 제공자에 지불합니다. 유료 OpenSRE Cloud의 요금 상세와 실제 저장소 대상 정확도 벤치마크는 저장소에 공개돼 있지 않으므로, 이 글에서는 수치를 추정하지 않습니다.

자주 묻는 질문

Q. 무료인가요?
소스는 Apache-2.0으로 공개돼 있고 셀프호스팅은 무료입니다. 다만 추론에 쓰는 모델은 사용자가 고른 제공자의 요금을 따르므로, 실제 비용은 모델 선택과 사용량에 달려 있습니다. 조직용 관리형 게이트웨이(OpenSRE Cloud)는 별도 계층이고, 저장소에는 그 요금 상세가 없습니다.

Q. 회사 코드와 로그가 외부로 나가나요?
구조상 외부 LLM을 호출할 수 있고, 그 전에 민감 식별자를 가리는 마스킹 단계가 있습니다. 다만 README는 이 단계를 선택 사항으로 설명합니다. 로컬 트랜스크립트를 기본으로 다루고 원시 로그를 조용히 대량 반출하지 않는 설계라고 밝히지만, 제품 분석과 오류 텔레메트리는 기본으로 켜져 있으므로 민감한 환경이라면 OPENSRE_NO_TELEMETRY=1 설정과 마스킹 여부를 먼저 확인해야 합니다.

Q. 수정안을 알아서 머지하나요?
아니요. 5단계에서 PR 브랜치에 수정안을 푸시할 뿐이고, 반영은 사람의 리뷰와 머지로 끝납니다. 자동 반영을 기대하고 도입하면 오히려 PR이 쌓이는 구조입니다.

Q. 어떤 환경에서 돌릴 수 있나요?
macOS·Linux는 설치 스크립트로, Windows는 PowerShell 스크립트나 WSL로 설치합니다. 실행은 대화형 셸, 헤드리스 CLI, Python 임베디드 API, 컨테이너(Railway·ECS·Vercel), AMI 기반 게이트웨이까지 선택할 수 있습니다. CI 잡에서 쓰려면 헤드리스 CLI가 가장 단순합니다.

출처

  • github.com/Tracer-Cloud/opensre — README(6단계 동작 흐름, 60개 이상 연동 표, 설치·실행 명령, 배포 경로, 텔레메트리 안내), Apache-2.0 라이선스 (2026년 11월 21일 확인)
  • 릴리스 v0.1.2026.11.21 — 2026년 11월 21일 00시 53분(UTC) 공개, 설치 명령과 변경 내역
  • 릴리스 목록 — 일 단위로 이어지는 v0.1.2026.11.x 태그 흐름 확인
  • GitHub REST API 저장소 메타데이터 — 별 13,637개, 포크 1,926개, 열린 이슈 15개, 2026년 1월 13일 생성, Python, Apache-2.0 (2026년 11월 21일 조회)