[루비] Gem::FilePermissionError 에러 원인과 해결 방법

깃허브 블로그를 설치하는 과정에서 다양한 오류가 발생할 수 있습니다. 그중에서도 특히 많이 겪는 문제가 Gem::FilePermissionError입니다. 이 글에서는 이 오류의 원인과 해결 방법에 대해 자세히 알아보겠습니다. 이를 통해 원활하게 깃허브 블로그를 설치하고 운영할 수 있을 것입니다.

에러 메시지

우선, 에러 메시지는 다음과 같습니다:

Error: While executing gem ... (Gem::FilePermissionError)

You don't have write permissions for the /Library/Ruby/Gems/2.6.0 directory.

이 메시지는 사용자가 /Library/Ruby/Gems/2.6.0 디렉토리에 쓰기 권한이 없다는 것을 의미합니다.

원인

맥 OS는 기본적으로 루비(Ruby)를 내장하고 있습니다. 이를 시스템 버전 루비라고 합니다. 시스템 버전 루비는 맥 OS의 정상 작동에 중요한 역할을 하기 때문에, 이를 변경하거나 접근하는 데 제한이 있습니다. 이로 인해 Gem::FilePermissionError가 발생합니다.

해결 방법

사용자 전용 루비 설치

이 문제를 해결하기 위해서는 시스템 버전 루비가 아닌 사용자 전용 루비를 설치해야 합니다. 이를 통해 시스템 파일에 접근하지 않고도 루비를 사용할 수 있습니다.

RVM (Ruby Version Manager) 또는 rbenv 사용: 먼저 RVM 또는 rbenv와 같은 도구를 사용해 루비를 설치합니다.

RVM 설치:

\curl -sSL https://get.rvm.io | bash -s stable

rbenv 설치:

brew install rbenv
rbenv init

이후, 원하는 루비 버전을 설치하고 설정합니다.

rbenv install 2.7.2
rbenv global 2.7.2

번들러 설치

사용자 전용 루비를 설치한 후, bundler를 설치하여 에러가 해결되었는지 확인합니다.

gem install bundler

gem은 루비용 패키지 관리자이며, bundler는 프로젝트에 일관성 있는 환경을 제공하는 도구입니다. 각 패키지의 원하는 버전을 자동으로 관리해줍니다.

블로그 테마 설치

블로그 테마를 설치하려면 다음 명령어를 실행합니다:

bundle install

만약 다음과 같은 에러가 발생한다면:

`require': cannot load such file -- webrick (LoadError)

이는 webrick이 필요하다는 의미입니다. webrick을 추가하여 문제를 해결합니다.

bundle add webrick

이 과정이 완료되면 블로그 테마 설치가 정상적으로 진행될 것입니다.

결론

Gem::FilePermissionError는 맥 OS의 시스템 버전 루비로 인해 발생하는 권한 문제입니다. 이를 해결하려면 사용자 전용 루비를 설치하고, bundler를 사용하여 프로젝트 환경을 관리하면 됩니다. 이 글에서 제시한 방법을 따라 하면 깃허브 블로그 설치 과정에서 발생하는 권한 문제를 쉽게 해결할 수 있을 것입니다.