최근 내 KidStory 블로그의 기존 발행글 대표 이미지를 일괄 교체하는 일회성 작업을 진행했다. AI 이미지 생성 API를 활용해 이미지를 만들고 이를 구글 드라이브에 경유하여 업로드하는 고난도 작업이었다. 마이그레이션 자체는 완벽하게 끝났지만, 작업을 마친 후 소스코드 파일인 Code_KidStory.gs를 열어보고 깊은 한숨이 나왔다. 오직 일회성 마이그레이션만을 위해 작성했던 수많은 함수와 상수들이 고스란히 남아 코드를 어지럽히고 있었기 때문이다.
1회성 마이그레이션 코드가 남긴 흔적들
평소 같으면 나중에 또 쓸 일이 있을까 싶어 코드를 남겨두었겠지만, 이번에는 과감하게 Google Apps Script 리팩토링 작업을 시작했다. 더 이상 쓰지 않는 코드를 방치하면 결국 미래의 내가 코드를 분석할 때 엄청난 짐이 되기 때문이다. 이번 정리 작업에서는 그동안 일시적으로 활성화했던 수많은 함수와 상수들을 전량 제거하기로 결정했다.
구체적인 제거 대상은 이미지 교체 작업의 중심축이었던 refreshKidStoryBlogImages, fetchImageToDrive, stripAllImages 함수들이었다. 또한 제목을 기반으로 프롬프트를 자동 생성하던 generateHeroPromptFromTitle과 단 한 건의 포스트만 테스트해 보기 위해 만들었던 testPollinationsHeroOnePost 함수도 삭제했다. 여기에 전체 큐를 생성하고 교체 루틴을 수행하던 buildKidStoryPolliQueue, replaceKidStoryImagesWithPollinations 함수와 트리거 설정을 담당하던 setupPolliAutoTrigger, runPolliQueueStep 함수까지 깨끗하게 도려냈다. 코드 상단에 자리 잡고 있던 KIDSTORY_HERO_BASE, KIDSTORY_HERO_SLUGS, KIDSTORY_POLLI_* 계열의 상수들도 예외 없이 전부 정리 대상이었다.
이렇게 대대적인 정리 과정을 거치고 나니 수백 줄에 달하던 스크립트 파일이 한결 가벼워졌다. Blogger 이미지 일괄 교체라는 목표를 달성한 뒤 남은 잔재들을 말끔히 지우니 비로소 속이 다 시원해지는 느낌이었다.
자기지속형 트리거가 품고 있는 치명적인 위험성
이번에 대대적인 정리를 감행한 결정적인 이유는 바로 자기지속형 트리거의 위험성을 깨달았기 때문이다. 이번 마이그레이션 과정에서는 대량의 이미지 생성 작업을 일정 간격으로 끊어 처리하기 위해 setupPolliAutoTrigger를 사용했다. 이 함수는 작업을 마친 뒤 스스로 다음 실행을 예약하는 구조로 설계되어 있었다.
이러한 방식은 제한 시간이 있는 서버리스 환경에서 대량 작업을 처리할 때 무척 유용하다. 하지만 마이그레이션 작업이 모두 끝난 뒤에도 코드를 제때 분리하거나 삭제하지 않으면 심각한 유지보수 문제가 발생한다. 매일 돌아가는 신규 게시글 발행용 상시 운영 로직과 일회성 마이그레이션 로직이 한 파일 안에서 뒤섞여 버리기 때문이다.
결국 시간이 흐른 뒤 코드를 다시 볼 때마다 '이 트리거가 현재도 실시간으로 도는 트리거인가? 아니면 예전에 끝난 일회성 작업인가?'를 매번 처음부터 다시 추적해야 하는 끔찍한 피로감을 느끼게 된다. 트리거 오작동으로 인한 불필요한 리소스 낭비 가능성도 항상 존재한다.
안전한 마이그레이션을 위한 코드 격리 규칙
이번 삽질을 통해 앞으로의 일회성 작업을 위한 나만의 확실한 규칙 두 가지를 세웠다. 첫째, 1회성 마이그레이션 코드는 애초에 상시 운영 코드와 분리된 전용 파일에 격리해서 짜야 한다. 이렇게 하면 작업이 완전히 종료된 시점에 고민할 필요 없이 해당 파일만 통째로 지우거나 비활성화하면 되기 때문에 대단히 안전하다.
둘째, 어쩔 수 없이 실시간으로 작동하는 자기지속형 트리거를 설계할 때는 무조건 명확한 종료 조건과 함께 트리거 자체를 스스로 제거하는 자기제거 로직을 강제해야 한다. 큐가 완전히 바닥나면 예약된 시간 트리거를 스스로 해제하도록 예외 처리를 꼼꼼히 해두는 습관이 필수적이다.
데이터를 성공적으로 옮겼다고 해서 마이그레이션이 끝난 것은 아니다. 코드를 원래대로 깨끗하게 되돌려놓는 GAS 마이그레이션 코드 정리까지 완료해야만 진정한 마무리가 된다는 귀중한 교훈을 얻었다. 앞으로는 개발 단계에서부터 뒷정리가 쉬운 코드를 설계하도록 늘 의식해야겠다.