팟캐스트 Jekyll 빌드가 자꾸 멈춘다면? 이미지 변환 작업의 함정

🎙️ 오늘의 팟캐스트

Jekyll 빌드가 자꾸 멈춘다면? 이미지 변환 작업의 함정

 

📌 에피소드 주요 내용

• Jekyll 빌드 프로세스가 이미지 변환 작업에서 무한 대기 상태에 빠지는 문제
• 손상된 이미지 파일, 고해상도 이미지, 또는 포맷 오류가 주요 원인
• 이미지 사전 최적화, 의심 파일 제거, Jekyll 설정 조정 등 세 가지 해결 방법

 

 

🎧 전체 대본

지혜: 안녕하세요, 여러분! 오늘은 Jekyll 블로그를 운영하면서 겪을 수 있는 흔하지만 답답한 문제를 다루려고 해요. 노교수님, 안녕하세요!

박교수: 안녕하세요. 요즘 디지털 시대에 여생의 기록을 남기려다 보니 이런 기술적 난제들을 만나게 되는군요. 처음에는 마크다운 문법도 낯설고, 대학원 시절 프로그래밍 기초가 있어도 꽤 골치 아팠습니다.

지혜: 맞아요. 그런데 어느 날 갑자기 빌드가 멈춰버렸다고 들었는데, 정확히 무슨 일이 있었던 거예요?

박교수: 그렇습니다. 몇 달을 잘 운영하다가 갑자기 빌드 프로세스가 무한 대기 상태에 빠져버렸어요. 시간이 초과되고, GitHub Actions 로그에는 ‘이미지 변환 작업’이라는 메시지만 계속 반복되었습니다. 이 문제를 해결하는 데 대여섯 시간을 소비했으니까요.

지혜: 우와, 그렇게 오래 걸렸어요? 원인이 뭐였어요?

박교수: 핵심은 이미지 처리의 병목 현상이었습니다. 특히 고해상도 이미지나 용량이 큰 파일을 업로드한 후에 이런 증상이 나타나더라고요. 제 경우엔 대학 자료를 스캔한 PDF를 JPEG으로 변환했는데, 그 변환 과정이 완전하지 않아 손상된 이미지 헤더를 가진 파일이 섞여있었던 겁니다. Jekyll이 이 파일을 처리하려다가 계속 재시도하는 악순환에 빠진 거죠.

지혜: 아, 그래서 계속 멈춰있었군요. 그럼 어떻게 문제를 파악했어요?

박교수: 먼저 GitHub Actions 로그를 자세히 살펴봤습니다. 단순 실패 메시지만 봐서는 안 되고, ‘Show all’ 버튼으로 전체 로그를 펼쳐야 해요. 로컬 환경에서도 같은 재현을 시도해봤는데, 터미널에서 bundle exec jekyll build를 실행하니 어느 파일에서 걸리는지 더 빠르게 파악할 수 있었습니다.

지혜: 그 다음엔 어떻게 해결하셨어요?

박교수: 세 가지 방법을 순서대로 시도했습니다. 첫째는 이미지 사전 최적화예요. ImageMagick이나 온라인 컨버터로 모든 이미지를 72 DPI로 통일하고, 너비를 1200~2000픽셀 사이로 유지하는 거죠. 제 경우 JPEG 85% 품질로 압축했더니 빌드 시간이 절반으로 줄었습니다. 둘째는 의심 파일을 임시로 삭제해서 빌드를 시도해보는 방법입니다. 그 후 해당 파일을 다시 변환해서 재업로드하는 거고요. 셋째는 Jekyll 설정에서 자동 최적화 기능을 일시적으로 비활성화하는 것입니다.

지혜: 아, 여러 방법을 조합해서 해결하신 거네요. 이거 정말 유용한 팁인데, 더 자세한 내용은 블로그 원문에서 확인하실 수 있어요!

 

🔑 핵심 키워드

Jekyll, 이미지 변환, 빌드 오류, GitHub Pages, 최적화

 

🔗 관련 링크

• 원문 보기: Jekyll 빌드가 자꾸 멈춘다면? 이미지 변환 작업의 함정
• 블로그 홈: damesek.com