Apple의 M1 Silicon Mac 환경에서 github.io 블로그를 만들어보고자 한다.

현재의 나와 같을 미래의 초보 개발자들을 위해 필자가 겪었던 오류 뿐만 아니라, 과정을 자세히(친절히) 풀어 써보고자 한다.

1-1. Ruby (rbenv 설치)

Mac 유저 중 github.io 블로그를 만들기 위해 구글링을 해본 사람들은 다들 프로세스를 따라하다가 Ruby 설치 과정에서 다음과 같은 오류를 직면한다. (필자도 그랬음.)

$ gem install bundler

ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /Library/Ruby/Gems/2.3.0 directory.


Mac은 시스템에서 이미 Ruby를 사용하고 있기 때문에, 시스템에 이미 있던 Ruby에서 gem install bundler 명령어를 실행하면 다음과 같이 Permission Error가 나는 것!

이 때 당황하지 말고,

brew를 먼저 update 후, brew를 통해 rbenv를 설치하자.

$ brew update

$ brew install rbenv ruby-build


rbenv가 잘 설치되었는지 다음 명령어로 확인하자.

$ rbenv versions

현재 Mac system에 있는 Ruby를 사용 중임을 알 수 있다.

* system (set by /Users/skykim/.rbenv/version)


맥 system Ruby가 아닌, rbenv로 관리되는 Ruby 설치가 필요하다.

다음 명령어로 설치 가능한 Ruby의 버전들을 먼저 확인하자.

$ rbenv install -l

필자는 가장 최신 버전 3.2.2을 설치했다. (2023.09.18 기준)

$ rbenv install 3.2.2


rbenv로 Ruby의 버전을 다시 확인하자.

$ rbenv versions

다음과 같이 별 기호가 system에 붙어 있는 걸 보니, 여전히 system Ruby를 사용중이지만, 아래에 방금 설치한 3.2.2 버전이 보인다.

* system
  3.2.2 (set by/Users/skykim/.rbenv/version)


이 때, rbenv로 global version을 방금 설치한 3.2.2로 변경하자.

$ rbenv global 3.2.2

마지막으로 다시 버전을 확인하면,

$ rbenv versions

다음과 같이 별 기호가 성공적으로 3.2.2 옆으로 옮겨 간 것을 볼 수 있다. (즉, 3.2.2 버전을 global로 사용중)


마지막으로는, rbenv PATH를 추가해 주어야 하는데, 본인이 사용하는 Shell의 설정파일(.zshrc or .bashrc)을 열어 다음과 같은 코드를 추가하자.

다음 명령어로 .zshrc 설정파일을 열어보자. (필자는 zsh를 사용)

$ vim ~/.zshrc

i 키를 눌러 – INSERT – 모드로 변경한 후, 아래의 코드를 추가하자.

[[ -d ~/.rbenv  ]] && \
  export PATH=${HOME}/.rbenv/bin:${PATH} && \
  eval "$(rbenv init -)"

Uejm8Ow.png

추가했다면 esc 키를 누른 후, :wq! 를 입력하면, 저장 및 나가기 완료!

그러고 나서 처음에 오류가 났던 gem install bundler 명령어를 실행하면, 정상적으로 실행된다.


1-2. Jekyll & bundler 설치

다음으로는 gem install 명령어로 Jekyll, bundler를 설치해야한다.

$ gem install jekyll bundler


📙 NOTE: What is ‘gem’?

  • ‘gem’은 분산 패키지 시스템으로 라이브러리의 작성이나 공개, 설치를 도와주는 시스템.

  • Linux에서의 apt 시스템과 유사하다. Ruby는 gem을 사용하여 라이브러리 설치를 진행한다는 것을 알아두자!


Jekyll이 잘 설치되었는지 확인하면 끝!

$ jekyll -v