path
Jin's Lab
코드로 실험하고 기록하는 개발 일지 · J.Lab

Jin's Lab

코드로 실험하고 기록하는 개발 일지. 커리어와 삶의 방향을 탐색하며 기록하는 공간입니다

Blogger Automation

GAS 마이그레이션 코드 정리 언제 어떻게 지워야 안전할까

J.Lab ·
목차

    최근 내 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 마이그레이션 코드 정리까지 완료해야만 진정한 마무리가 된다는 귀중한 교훈을 얻었다. 앞으로는 개발 단계에서부터 뒷정리가 쉬운 코드를 설계하도록 늘 의식해야겠다.

    Blogger Automation Code Cleanup GAS Refactoring Google Apps Script Self Rescheduling Trigger
    ← 이전 글
    최근 게시물
    다음 글 →
    이전 게시물
    ≡ 글 목록으로
    소개
    path
    J.Lab

    커리어와 삶의 방향을 탐색하며
    기록하는 공간입니다

    카테고리
    403 Forbidden Error 1 429 Error 1 Ad Exchange 1 Ad Layout Guide 1 ad-slot 1 adsense 2 AdSense 2 AdSense Bot Detection 1 AdSense CTR 1 AdSense Display Issue 1 adsense-optimization 1 AI Automation 1 AI Image Generation 1 ai-automation 2 ai-book-writing 1 ai-image-generation 1 AI-Prompting 1 ai-side-hustle 1 ai-workflow 1 ai-writing 1 AIAutomation 1 AIBlogAutomation 1 AICodeLog 1 AIContentGeneration 1 AIImageGeneration 1 AIWritingErrors 1 API Automation 2 API Retry Design 1 api-automation 1 API-Deprecation 1 api-error 1 api-fallback 1 api-integration 2 api-pagination 1 api-retry-strategy 1 api-troubleshooting 1 APIDebugging 1 APIError 1 APIErrorHandling 1 APIIntegration 3 APIQuotaOptimization 1 APITokenRenewal 1 apps-script-trigger 1 AppsScript 1 appsScriptAutomation 1 AutomatedBlogging 1 automation 5 Automation 4 Automation Queue 1 Automation Scheduler 1 Automation Troubleshooting 1 automation-error 1 automation-script 1 AutomationBug 1 AutomationTroubleshooting 1 Backoff Algorithm 1 Base64 Image 1 Base64Encoding 1 batch-processing 1 BatchProcessing 1 Blog Optimization 2 blog-automation 4 blog-customization 2 blog-migration 4 blog-monetization 1 Blog-Sorting 1 blog-strategy 1 blog-theme-customization 1 blog-workflow 1 blogautomation 1 BlogAutomation 4 Blogger 13 Blogger API 2 Blogger Automation 2 Blogger SEO 1 blogger-api 4 blogger-automation 1 blogger-customization 1 blogger-error-400 1 blogger-labels 1 blogger-seo 1 blogger-theme 1 blogger-theme-debug 1 blogger-tips 1 Blogger-Tips 1 blogger-xml 1 BloggerAPI 7 BloggerAutomation 1 BloggerBypath 1 BloggerCustomization 2 BloggerFavicon 1 BloggerPermalink 1 BloggerTemplate 1 BloggerTemplateEditing 1 BloggerTheme 3 BloggerThemeCustomization 1 BloggerXMLStructure 1 Blogging-Automation 1 BloggingTools 1 BlogQuality 1 BlogSpot 1 Bug Fix 1 bug-fix 1 bug-hunting 1 BWidgetBIncludable 1 card-overlay-css 1 CardClickHandler 1 career-advice 1 CDATA 1 checklist-template 1 clamping-text 1 Claude 1 claude-ai 3 claude-code 2 ClaudeChat 1 ClaudeCode 1 CLIPTokenLimit 1 CloudflareWorkersAI 1 CNAME 1 Code Cleanup 1 Code Integration 1 code-refactoring 1 codelog 1 CodeLog 1 codeRefactoring 1 CodeStack 1 coding-log 2 comment-classification 1 config-pattern 1 Content Strategy 1 Content-Marketing 1 content-monetization 1 content-strategy 1 content-writing 1 contentsequencing 1 ContentStrategy 1 context-management 1 cost-reduction 1 CSS 1 css-axis-rotation 1 css-bug-fix 1 CSS-Debugging 1 css-fix 1 css-flexbox 1 css-layout 3 css-logo 1 css-print 1 css-troubleshooting 1 CSSLayout 1 CSSOverlay 1 Custom Domain 1 custom-theme 1 data-backfill 1 data-parsing 1 data-synchronization 1 data-validation 1 DatabaseDesign 1 DataMigration 1 DataRecovery 1 DataValidation 1 DateInjection 1 debugging 2 Debugging 5 Debugging Log 1 DebuggingLog 1 derived-state 1 detail-page-design 1 dev-journey 2 dev-log 1 Developer-Blog 1 developer-career 1 DeveloperJourney 2 DevJourney 1 DevLog 1 digital-creator 1 digital-products 2 display-none-seo 1 DOM-Inspection 1 dom-manipulation 1 Domain Migration 1 DomainMigration 1 DOMAutomation 1 duplicate-content 1 dynamic-menu 1 ebook-marketing 2 ebook-planning 1 ebook-publishing 5 editing-tips 1 Error Handling 2 error-handling 1 Error-Handling 1 ErrorHandling 2 EventDispatch 1 Execution Timeout 1 ExecutionLimit 1 exponential-backoff 1 FactChecking 1 FallbackSystem 1 FaviconEmbedding 1 Feed-API 1 filesystem 1 Flat Illustration 1 flux-model 1 FluxModel 1 FreeAIImage 1 frontend 1 Frontend 1 frontend-developer 1 frontend-layout 1 frontend-tips 1 FrontEndDev 1 FrontendTips 1 GAS 1 GAS Blogger API 1 GAS Refactoring 1 GAS Trigger 1 gas-automation 2 gas-optimization 1 gas-trigger 1 GASTimeout 1 gasTriggerManagement 1 GCP Project Linkage 1 Gemini 1 Gemini API 2 gemini-api 1 GeminiAPI 3 GeminiPrompt 1 GeminiPromptEngineering 1 getBoundingClientRect 1 github-raw-url 1 GmailRestrictions 1 Google AdSense 1 Google Apps Script 12 Google Discover 1 google-apps-script 8 Google-Apps-Script 1 google-blogger 1 googleAppsScript 1 GoogleAppsScript 12 googlesapps-script 1 GoogleSearchConsole 1 grep 1 hero-image 1 hero-image-validation 1 HTML Fix 1 HTMLCSS 1 HTMLWidgetBlogger 1 http-429 1 HuggingFace 1 HuggingFaceAPI 1 ico-generator 1 Image Optimization 1 image-automation 2 image-generation 1 image-hosting 1 image-optimization 1 image-processing 1 image-upload 1 ImageGeneration 2 ImageIntegrity 1 ImageOptimization 1 In-App Browser 1 invalid-argument 1 javascript 4 JavaScript 4 javascript-automation 1 javascript-toc 1 JavaScriptDevLog 1 JavaScriptInjection 1 jlab-codelog 1 JLabDevLog 1 json-schema 1 label-length-limit 1 lead-magnet 1 legacy-code 1 LinkedIn-API 2 LinkedIn-OAuth 1 LinkHub 1 linux 1 markdown 1 meta-description 1 MetaTags 1 Migration 1 Migration Script 1 mobile-friendly 1 Mobile-Web 1 monetization 1 Monitoring Automation 1 MultilingualSEO 1 NakedDomain 1 Negative Prompt 1 node-js 1 nodejs-automation 1 noindex-tag 1 Notion API 1 notion-api 3 notion-database 2 notion-gas-integration 1 notion-setup 1 notion-template 1 NotionAPI 3 NotionAutomation 1 notionintegration 1 NotionIntegration 1 OAuth Scope 1 OpenGraph 1 padding-overlap 1 pagination 1 payload-validation 1 pdf-generation 1 pdf-publishing 1 pdf-selling 1 permalink-management 1 PersonaDesign 1 pil-image-processing 1 Pinterest 2 PinterestAutomation 1 PipelineFix 1 playwright 1 Pollinations 1 Pollinations Flux 1 pollinations-ai 1 pollinations-api 2 PollinationsAI 1 PositionAbsolute 1 post-queue 1 productivity-tools 1 Prompt Design 1 Prompt Engineering 1 prompt-engineering 3 Prompt-Engineering 1 prompt-validation 1 PromptEngineering 3 Publishing Flow 1 publishorder 1 python-favicon 1 python-markdown 1 python-pil 2 python-scripting 1 Queue Design 1 queue-pattern 1 queue-stuck 1 RandomDelay 1 rate-limiting 1 react 1 React 1 Refactoring 1 Resource Exhausted 1 responsive-ads 1 responsive-design 4 ResponsiveCSS 1 ResponsiveDesign 1 retrospective 1 rfc3339 2 Robots Meta Tag 1 RSS Feed 1 rss-feed 1 RSSProxy 2 SAXParseException 1 Script Authorization 1 scriptNotFound 1 SDXL 1 Search Engine Optimization 2 Search-Engine-Optimization 1 SearchConsole 1 Self Rescheduling Trigger 1 SEO 2 SEO Tips 1 seo-optimization 5 SEO-Optimization 1 SEOOptimization 2 seriesmanagement 1 serverless-automation 1 sessionstart-hook 1 shell-script 1 Side Ad Duplication 1 side-income 1 side-project 1 SidebarLinks 1 SNSMarketing 1 Social-Media-Automation 2 SocialSharing 1 state-management 1 StaticWebPage 1 sub-agent 1 SVG Icon 1 svg-mask 1 SVGIcon 1 Synchronization 1 table-of-contents 1 tech-blogging 1 TechJournal 1 TechVibe 1 Template 1 TextSanitization 1 threads-api 2 Threads-API-Comparison 1 ThreadsAPI 3 time-driven-trigger 1 Tistory 2 tistory-customization 1 tistory-migration 1 tistory-skin 1 tistory-theming 1 tistory-tips 1 TOC Ad Placement 1 token-optimization 1 TranslationAPI 1 transparent-favicon 1 triggerCleanup 1 troubleshooting 2 Troubleshooting 2 typesetting 1 ui-optimization 1 unzip 1 URL Slug 1 UrlFetchApp 1 usememo 1 UTF8Encoding 1 vanilla-js 1 Web Development 2 Web Publishing 2 Web Security 1 web-development 7 Web-Development 2 web-development-log 1 web-development-tips 1 web-layout 1 Web-Layout 1 web-performance 1 web-publisher 1 web-scraping 1 WebAccessibility 1 WebAutomation 1 WebDebugging 1 WebDesign 2 WebDevelopment 10 WebDevelopmentTips 1 WebDevJourney 1 WebMigration 1 windows 1 windows-task-scheduler 2 WorkAutomation 1 workflow-automation 1 WorkflowAutomation 1 writing-process 1 XHTML 1 XMLCustomization 1 XMLParser 1 XMLSpecialCharacters 1 XMLTheme 1 z-index-issue 1 zip 1
    인기 글
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    다른 블로그
    IssueLog
    IssueLog
    issuelog.jinbytes.com
    KidStory
    KidStory
    kidstory.jinbytes.com
    IT Story
    IT Story
    jinbytes.com
    이야기하는 밤
    이야기하는 밤
    story.jinbytes.com
    [eBook] 개발자로 살아간다는 것
    [eBook] 개발자로 살아간다는 것
    유료 전자책
    [eBook] FE 실무 디테일
    [eBook] FE 실무 디테일
    유료 전자책
    [미니북] FE 실무 디테일
    [미니북] FE 실무 디테일
    무료 미니북
    © Jin's Lab · J.Lab · All Rights Reserved
    jinbytes.com · Powered by Blogger