FastAPI RAG 백엔드에서 pgvector CI 불일치 수정
AI 지원 에이전트 데모를 위한 FastAPI 백엔드인 mini-agent 프로젝트에서 CI 실패가 발생했습니다. 이 실패는 테스트 스위트가 PostgreSQL의 pgvector 확장에 의존했기 때문에 발생했습니다. GitHub Actions 워크플로우는 실수로 이 필수 확장이 포함되지 않은 범용 PostgreSQL 이미지를 사용하고 있었습니다. 결과적으로, 벡터 확장을 생성하려고 할 때 데이터베이스 초기화 단계가 실패했습니다. 테스트 환경과 애플리케이션 요구 사항 간의 이러한 불일치로 인해 워크플로우가 테스트 실행 단계에서 중단되었습니다. 수정 작업은 GitHub Actions 구성에서 PostgreSQL 서비스 이미지를 변경하는 것을 포함했습니다. 업데이트된 이미지인 pgvector/pgvector:0.8.6-pg17은 필요한 pgvector 확장을 명시적으로 포함합니다. 이 한 줄의 변경으로 CI의 데이터베이스 서비스가 이제 애플리케이션의 기능과 일치하게 되었습니다. 이 수정 후 CI 워크플로우가 성공적으로 완료되어 안정적인 통합 테스트를 복구했습니다. 배운 교훈은 CI에 대한 명시적인 런타임 종속성으로 데이터베이스 확장을 취급해야 함을 강조합니다.