피드로 돌아가기
Dev.toDevOps
원문 읽기
Ollama 기반 로컬 AI로 구현한 Backstage 메타데이터 자동 생성 파이프라인
Build an AI-Powered Developer Portal with Backstage and .NET
AI 요약
Context
수동 YAML 작성으로 인한 Internal Developer Portal(IDP) 데이터 최신성 유지의 한계 직면. README.md나 Wiki의 파편화로 인한 서비스 가시성 확보 및 소유권 파악의 병목 현상 발생.
Technical Solution
- Backstage를 UI Layer로 활용하여 서비스 카탈로그 및 API 문서의 Single Source of Truth 구축
- .NET CLI 도구를 통한 소스 코드 스캔 및 프로젝트별 메타데이터 추출 로직 구현
- 보안 및 비용 최적화를 위해 Ollama 기반의 llama3:8b 로컬 LLM을 통한 요약 생성 체계 채택
- Token Limit 및 연산 비용 절감을 위해 Program.cs와 *.csproj 등 핵심 컨텍스트 파일만 선별 전송
- AI 생성 텍스트의 비결정성 제어를 위해 콜론 및 개행 문자를 제거하는 정교한 Sanitization 프로세스 적용
- CI 파이프라인 내 정적 호스팅 기반의 Thin Client 구조 설계를 통한 유지보수 효율성 증대
실천 포인트
1. AI 모델에 전체 레포지토리를 전달하지 않고 핵심 설정 파일만 추출하여 컨텍스트 윈도우 최적화
2. 외부 API 유출 방지를 위해 소스 코드 분석 시 Local LLM(Ollama 등) 활용 검토
3. 비정형 AI 출력물을 YAML 등 구조화된 형식으로 변환 시 엄격한 문자열 Sanitization 로직 필수 적용
4. IDP 구축 시 Write 작업보다는 Read-only 정적 카탈로그 형태로 시작하여 복잡도 제어