M1 MacOS Ruby & Rails 셋팅 (ruby build failed error, rbenv)

저도 셋팅하면서 고생했었는데 다른분들에게 도움이되면 좋겠습니다.

아래에 해당되는 분들은 도움이 될거에요.

1. 과거 M1 맥북이 출시되면서 로제타를 활용해서 루비 프로젝트를 시작했던 사람

2. brew를 x86 버전으로 설치해서 사용했던 사람

3. 루비 2.X 버전에서 3.X 버전으로 마이그레이션을 진행하는 사람

4. RubyMine을 사용하는 SDK를 조회 못한다면? (Run Configuration Error: No SDK specified)

---

최근 레거시한 프로젝트의 ruby version 마이그레이션 작업을 진행했습니다.

2.5.1 버전을 사용했는데... 전에 작업하신분의 도움으로 어떻게 셋팅은 했었습니다.

하지만 결국 버전을 올리는 작업은 필요하다 느끼고 몇몇 라이브러리 안되는 부분들을 맞추면서 프로젝트의 마이그레이션은 성공했습니다.

 

하지만 !?

버전을 올리면서 집에서 사용하던 맥북이 Ruby SDK를 인식못하게되었습니다.

그래서 rbenv로 새로운 버전을 설치하려고 했으나 계속해서 실패

BUILD FAILED (macOS 14.5 on ... )

위 문제에 대한 이유는 상단에 적었던 내용들이었어요.

 

그래서 계속해서 찾아보니 현재 내 맥북에 설치된 brew가 문제인것을 알게되었고, 저와 동일한 문제로 해결한분의 포스팅을 확인했습니다.

https://iot624.tistory.com/195

M1 MacOS Ventura ruby build failed error (Feat. XCode 14)

---

 

위의 포스팅에서도 자세하게 작성해주셨지만 제 기준으로 해결한 방법을 정리해보겠습니다.

 

1. brew 삭제 (과거 로제타로 이렇게 저렇게 설치한 구버전인 경우 아래와 같이 경로 확인)

$ which brew
/usr/local/bin/brew

 

2. brew 삭제 및 재설치

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

 

3. 설치 후 경로 확인

$ which brew
/opt/homebrew/bin/brew

 

4. ~/.zshrc 기존에 셋팅했던 설정들 모두 제거

 

5. ruby 를 사용하기 위한 설치 

- ruby v3 부터는 openssl3를 사용하는데 명시적으로 옵션 지정

brew install openssl@3 readline libyaml gmp
export RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(brew --prefix openssl@3)"

 

rust 를 homebrew로 미리 설치

brew install rust

 

6. ~/.zshrc 

eval "$(/opt/homebrew/bin/brew shellenv)"
export PATH="/opt/honebrew/bin:$PATH"
export PATH="/opt/homebrew/sbin:$PATH"

# rbenv
export RBENV_ROOT=/opt/homebrew/opt/rbenv
export PATH=$RBENV_ROOT/bin:$PATH
eval "$(rbenv init -)"

# openssl
export LDFLAGS="-L/opt/homebrew/opt/openssl@3/lib"
export CPPFLAGS="-I/opt/homebrew/opt/openssl@3/include"
export RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(brew --prefix openssl@3)"

 

7. rbenv (해당 프로젝트 내에서 rbenv versions로 설정한 버전이 나오는지 확인함. 터미널 재실행도 하면서!)

rbenv install 3.2.0

rbenv global 3.2.0

 

8. 프로젝트내에서 bundle

 

9. rubyMine을 사용한다면 아래와 같이 진행

 

---

마치며

m1 애플 실리콘 & 최신 OS (Sonoma 14.5) & XCode 버전

위 개발환경에 따라 ruby 버전이 정상적으로 호환되지 않음

 

 

덕분에 오래만에 포스팅을 해봤습니다. 🙏