GitHub.io 블로그 ruby 관련 오류
깃헙 블로그 살리기
Obsidian에서 작성한 메모를 GitHub.io 블로그에 간편하게 올리고 싶었다. 그러려면 먼저 깃헙 블로그를 살려야 했다. 로컬에 세팅을 하던 중 ruby 관련해서 오류가 났다. 발생 원인과 해결 과정을 공유한다.
1. GitHub.io 저장소 클론하기
기존에 사용하던 GitHub.io 블로그를 클론해왔다.
2. Bundler와 Jekyll 설치 시도
GitHub.io 블로그를 실행하려면 로컬 환경에 bundler와 jekyll이 필요하다. 그래서 먼저 다음 명령어로 Bundler를 설치하려 했으나 오류가 발생했다.
1
gem install bundler
1
you don't have write permissions for the /library/ruby/gems/2.6.0 directory.
시스템의 Ruby를 이용하고 있기 때문에 쓰기 권한이 없어서 발생한 오류였다. 오류를 해결하기 위해 rbenv를 이용해 시스템의 Ruby 버전과 동일한 버전의 Ruby를 설치하기로 했다.
3. rbenv 설치
1
2
brew update
brew install rbenv ruby-build
1
rbenv versions
설치한 rbenv로 현재 설치된 루비 버전 목록을 확인한 결과, system 한 개만 있었다. 이게 기존에 있던 시스템의 ruby로, 현재 적용되고 있는 ruby였다. 이제 이 목록에 또다른 ruby를 추가해야 하는 거시었다.
3-1. 터미널 설정 파일 수정
M1 Mac에서는 추가로 터미널 설정 파일에서 rbenv 경로를 설정해 주어야 한다.
1
echo $SHELL
/bin/zsh 라고 떴다. zsh를 쓰니 zsh 설정 파일을 수정해줘야 한다. ~/.zshrc 파일을 열어 아래 내용을 추가했다.
1
export PATH={$Home}/.rbenv/bin:$PATH && \ eval "$(rbenv init -)"
이후, 변경 사항을 적용했다.
source ~/.zshrc
4. 현재 Ruby 버전 확인
1
ruby --version
2.6.10으로 되어있었다. 즉 현재 적용되고 있는 시스템 루비의 버전이 2.6.10이라는 사실을 확인할 수 있었다.
5. 새로운 Ruby 버전 설치
rbenv로 설치 가능한 Ruby 버전의 목록을 확인한다.
1
rbenv install -list
설치 가능한 ruby 버전이 쭉 뜨는데 그중 2.6.10은 없었다. 겁나 오래된 버전이기 때문이었다.
1
rbenv install --list-all
이렇게 하니까 있었다.
1
rbenv install 2.6.10
…을 하고 이후 이어지는 과정들을 진행한 결과, bundler를 설치하려면 ruby 버전이 3.0.0 이상이어야 한다면서 퇴짜맞았다. 그래서 여기서 2.6.10 대신 최근 stable version인 3.3.5를 설치해줬다.
1
rbenv install 3.3.5
6. 기본 Ruby 버전 변경
설치한 3.3.5 버전을 global으로 설정하고, 잘 변경되었는지 확인한다.
1
2
rbenv global 3.3.5
rbenv versions
7. Bundler 및 Jekyll 설치 재시도
이제 다시 bundler와 jekyll을 설치해봤다. 오류 없이 설치가 완료되었다!
1
2
gem install bundler
gem install jekyll