❗️모든 설치과정은 MacOS Ventura(M1 Mac) 환경에서 진행됩니다 ❗️


rbenv 패키지 설치하기

  • rbenv란?
    • MacOS는 기본적으로 ruby가 설치되어 있습니다.
      따라서 ruby는 OS의 영향을 받고, 다양한 버전을 독립적으로 관리하기가 쉽지 않습니다.
    • 이럴 때 독립적으로 ruby의 버전 관리를 도와주는 것이 rbenv입니다.

1️⃣ 1단계

자, 그럼 rbenv 패키지를 설치해봅시다.

  • rbenv 설치 바로가기
    홈페이지에는 rbenv에 대한 정보가 담겨 있어요.
    홈페이지를 참고해서 설치해도 되고, 저를 따라오셔도 됩니다.

❗️못할 것 같다는 생각은 잊어버리고, 터미널을 켜줍니다! 그리고 다음 명령어들을 쭉 입력해주세요

1
2
brew install rbenv ruby-build 
rbenv verions # 설치가 완료되면 버전을 확인해보기

image

위와 같은 이미지가 뜬다면 성공입니다. 아까 설명한 OS의 ruby를 사용하고 있다는 말이에요!

2️⃣ 2단계

1
2
3
4
ruby install -l #설치가 가능한 ruby 버전을 확인해보기
ruby install 3.2.2 # 3.2.2 버전 설치하기
rbenv global 3.2.2 # 3.2.2 버전으로 설정하기
rbenv versions 

image

위와 같은 이미지가 뜬다면 성공입니다.

❗️필독❗️ 에러: BUILD FAILED (macOS 13.0.1 using ruby-build 20230330) 대처

  • ruby install 3.2.2를 입력하고 설치하는 과정에서
    BUILD FAILED (macOS 13.0.1 using ruby-build 20230330) 이라는 에러가 발생할 수 있어요.

  • 이럴 때는 다음과 같이 터미널에 입력해 주세요.
    1
    2
    3
    
    brew install readline openssl
    # 설치가 끝나면 차례대로 입력해 주세요
    brew install libyaml
    
  • 오류가 발생하는 이유를 여러가지 의심해 볼 수 있어요
    • ruby-build를 설치하는 과정에서 homebrew의 패키지인 readline openssl, libyaml 를 사용한다.
    • brew를 처음하는 사용자는 위의 패키지가 설치되어 있지 않다.

참고: BUILD FAILED 에러 발생 이유

3️⃣ 3단계

  • 지난 번 homebrew 에러 발생과 마찬가지로 vi ~/.zshrc에 진입해 경로를 설정해줘야 해요.
  1. vi 편집기 진입
    1
    
    vi ~/.zshrc
    
  2. 알파벳 “i”를 눌러 insert 모드에 진입합니다.
    모드가 바뀐 것은 터미널 하단에서 확인할 수 있어요.

  3. 다음 명령어를 그대로 추가해 줍니다.
    1
    2
    3
    
    [[ -d ~/.rbenv  ]] && \
         export PATH="$HOME/.rbenv/bin:$PATH" && \
         eval "$(rbenv init -)"
    
  4. ESC를 누르고 :wq를 입력한 후에 빠져나오면 돼요
    • 참고: :wq는 저장 후 종료입니다. 이외에 :q는 종료, :!q는 강제 종료 등 여러 가지 명령어가 있어요
  5. 적용까지 해주기
    1
    
    source ~/.zshrc
    

    터미널을 재실행해도 system ruby가 아닌 독립적인 ruby 버전을 적용합니다.

저는 BUILD FAILED 에러 해결해 보겠다고 4~5시간 구글링했는데,
여러분은 꼭 이 글을 통해 쉽게 해결했으면 좋겠습니다! 다음 파트에서 뵙겠습니다😅

댓글남기기