오류 상황
깃허브 페이지가 deploy 되지 않는 오류가 발생하고 있다. 주요 오류 메세지는 아래와 같다.
1
2
3
4
Error: Logging at level: debug Configuration file:/github/workspace/./_config.yml
GitHub Pages: github-pages v229 GitHub Pages: jekyll v3.9.4 Theme: jekyll-theme-primer
Theme source: /usr/local/bundle/gems/jekyll-theme-primer-0.6.0 Requiring:
jekyll-github-metadata Requiring: ...
github 이슈, 그리고 스택오버플로를 살펴보니 이번 깃허브 페이지 업데이트 이후 이러한 문제들이 발생하고 있는 것으로 보인다.
github page 가 v228 -> v229 로 업데이트가 되었는데, 업데이트 내용 중 jekyll 버전이 3.9.3 에서 3.9.4로 업그레이드 되는 내용이 포함되어있다. 자세한 내용까지는 잘 모르지만, 지킬 버전이 올라가면서 충돌이 발생한 것으로 추정된다.
관련 글
https://github.com/jekyll/jekyll/issues/9544
https://stackoverflow.com/questions/77972098/github-jekyll-page-build-keeps-failing
해결책은?
사람들은 크게 두 가지의 해결책을 제시하고 있다.
(1) 404.md, about.md, non-menu-page 들의 excerpt 설정을 삭제해주는 것
(2) 혹은 기존 github page deploy 방식 대신 github actions를 사용해 배포하는 것
나는 이중 두 번째 해결책(github actions 로 배포)을 선택했다.
1번을 적용하기에는 내가 적용한 테마의 non-menu-page 의 범위가 감이 오지 않았기 때문이다.
해결
1. 배포 방식을 github actions로 변경
우선 github page 설정을 기존 배포 방식에서 github action을 통한 배포 방식으로 바꿔야 한다.
(1) 깃허브 페이지 repository의 settings 메뉴로 들어간다.
(2) 왼쪽 메뉴 중 Pages 메뉴를 선택하고
(3) Build and deployment 에서 source 를 Github Actions 로 선택한다.
2. github actions workflow 설정
그리고 Github Actions 의 Workflow를 설정해줘야 한다.
(1) 깃허브 페이지 repository의 Actions 메뉴로 들어가서
(2) Github Pages Jekyll 워크플로우의 configure를 선택한다.
3. Workflow configuration
다음은 워크플로우의 configure 파일을 작성하면 된다.
기본적으로 템플릿이 작성되어있기 때문에 조금만 수정을 해주면 된다.
(1) configure 파일 (jekyll-gh-pages.yml) 의 빌드 페이지 버전 (빨간 색 네모)을 1 - > 1.0.9로 수정한다.
(2) 수정이 완료되면 우측 상단의 Commit changes 를 눌러 커밋해준다.
4. gemfile 수정
이제 로컬 혹은 깃허브에서 gemfile을 수정해준다.
(1) 로컬에서 작업중이라면 먼저 pull을 해준다. (workflow 설정파일이 pull 될 것이다.)
(2) gemfile 파일을 열어준 뒤 아래 내용을 적고 저장한다.
(3) 리포지토리로 Push 한다.
1
2
gem "github-pages", "=228"
gem "jekyll", "=3.9.3"
결과 및 리뷰
얼마만에 보는 배포 성공 메세지인지.. 11시부터 시작해서 지금 새벽 5시까지..
로컬에서 작업하다 발생한 오류인가 싶어 루비 삭제 및 재설치 등의 삽질 끝에 영롱한 초록색을 보니 눈물이 날 것 같다.
가장 큰 도움을 받은 포스트를 소개하면서 글을 마치겠다. 이제 드디어 잘 수 있겠다.
https://kongdori.tistory.com/146
–> 감사합니다!
Refernce
github page v229 issue : https://stackoverflow.com/questions/77972098/github-jekyll-page-build-keeps-failing
github page v229 issue : https://github.com/jekyll/jekyll/issues/9544
github actions jekyll build 적용 doc : https://jekyllrb.com/docs/continuous-integration/github-actions/
깃허브 블로그 지킬 빌드 오류 이슈 : https://kongdori.tistory.com/146