Profile picture

[Github Pages] Jekyll 빌드 오류

JaehyoJJAng2024년 02월 10일

◾️ 문제점

포스팅 글을 작성하고 github-pages 배포를 했는데 갑자기 메일이 날라왔다.
image
🥹


뭐지 하면서 내 블로그 레포지토리의 Actions로 가봤더니 아래와 같은 에러가 나를 반겨줬다.
image
처음에는 포스팅된 글 들 중에 뭔가 잘못 적은게 있나? 살펴봤는데 문제되는걸 찾을 수 없었다.


수 십분 구글링 결과 나와 비슷한 이슈를 가진 사람이 jekyll 깃허브에 이슈를 등록한 것을 확인하였다.
https://github.com/jekyll/jekyll/issues/9544

자세한 원인은 잘 모르겠지만, 대충 이슈에 달린 글들을 정독해보면 github-pages가 2.28에서 2.29로 버전업 되면서, jekyll도 3.9.3 버전에서 3.9.4 버전을 사용하게 되었는데, 이 과정에서 충돌이 일어난 것 같다.


▪️ 해결 방법

1. Github Actions을 이용한 해결 방법

다음 과정은 Jekyll Issue을 참고하였다.


1. 블로그 레포지토리 > Actions > New Workflow 클릭
image


2. Jekyll을 검색하여 Jekyll 이라고 되어있는 workflow 찾기
image
해당 워크플로우의 Configure 클릭


3. Commit > Changes 버튼을 눌러 본인의 workflow로 등록
image


4. 로컬 레포지토리로 넘어가 git pull 명령으로 깃허브 레포지토리와 싱크 맞추기

# Local repository
cd ~/jaehyojjang.github.io
git pull origin main

5. 로컬 레포지토리에서 포스팅 생성 / 수정 / 삭제 하여 수정사항 커밋 후 git push 명령으로 푸시

cd ~/jaehyojjang.github.io
touch ./new_commit
git add .
git commit -m "new file"
git push -u origin main

위처럼 설정하면 푸시할 때 본래 있던 pages-build-deployment 워크플로우와 이번에 새로 만든 Deploy jekyll site to pages 워크플로우가 동시에 실행된다.

제대로 동작하지 않는 pages-build-deploymentSettings - Pages로 들어가 Source를 Github Actions로 바꾸어 꺼두어도 되고, 해결될 때를 파악하기 위해 그대로 켜둔채 푸시해도 될 것 같다.


◾️ Ref


Loading script...