혼자 개발하는데 CI가 왜 필요했나 — 편의 기능인 줄 알았는데 임계 경로였습니다
1인 개발자에게 CI는 사치일까요. 어느 날 CI가 통째로 멈추고 나서야, 그것이 테스트를 대신 돌려주는 편의 기능이 아니라 머지 자체를 막는 임계 경로였다는 것을 알게 됐습니다.
1인 개발자에게 CI는 사치일까요. 어느 날 CI가 통째로 멈추고 나서야, 그것이 테스트를 대신 돌려주는 편의 기능이 아니라 머지 자체를 막는 임계 경로였다는 것을 알게 됐습니다.
글을 통째로 벡터 하나에 담던 설계를 조각내 다시 세웠습니다. 헤딩 경계 청킹과 taskType 비대칭으로 잘림을 풀었고, 그 재임베딩 배치가 정확히 50번째 글마다 죽던 MongoDB 커서 타임아웃까지 잡은 기록입니다.
코드는 1만 자에서 잘랐지만, gemini-embedding-001은 그보다 앞선 2,048 토큰에서 조용히 나머지를 버리고 있었습니다. 같은 글의 prefix를 길이별로 임베딩해 비교하니 6,000자부터 벡터가 비트 단위로 동일했고, 글 셋 중 하나가 뒷부분을 검색에서 잃고 있었습니다.
반년 전 붙여둔 하이브리드 검색이 정말 정확한지 추측 대신 검색어 16개로 직접 측정했습니다. Precision@1은 88%로 나쁘지 않았지만, 재는 과정에서 정작 고쳐야 할 것은 정확도가 아니라 파이프라인의 숨은 결함 네 개라는 걸 알게 됐습니다.
Search Console에 sitemap을 API로 재제출하려다 403을 만났습니다. 서비스 계정을 소유자로 올려도 여전히 403이었습니다. 인가가 두 겹—리소스 권한과 OAuth 스코프—이었기 때문입니다. 스코프는 발급 시점에 굳으며, 서비스 계정 키로 직접 뚫는 법을 정리했습니다.
최근 28일 데이터만 보고 '이 주제엔 수요가 없다'고 진단했다가, 분석 창을 넓혀 다시 보니 특정 하루에 무너진 절벽이었습니다. 분석 윈도우의 크기가 원인 진단을 통째로 바꾼 오진 복기와, 독립 소스 교차검증·배제법으로 급락 원인을 좁히는 방법을 정리했습니다.
검색 성과가 급락하면 Slack으로 알려주는 경보를 만들었는데, 정작 트래픽이 완전히 소멸하는 최악의 순간에 조용히 침묵했습니다. GSC Search Analytics API가 0인 날짜의 행을 아예 생략하는 성질과 위치 기반 슬라이스가 맞물린 역설을 한 줄씩 추적하고, 날짜 경계로 나눠 고친 버그 회고입니다.
코드는 한 줄도 안 건드렸는데 pre-commit이 모든 커밋을 막았습니다. 'Definition for rule not found'의 범인은 Node 버전업이었습니다. require(ESM) 인터롭이 ESLint 플러그인의 규칙을 .default에 가둔 과정을 추적했습니다.
clone하면 된다는 착각, 원격 URL에 박힌 토큰, age 키 경로 함정, 멀티라인 값 손상까지. 백업을 '저장했다'가 아니라 '새로 clone해 실제 복호화된다'로 증명하기까지 마주친 실전 함정들을 문제·원인·해결·검증으로 정리했습니다.