Rails 개발 환경 설정을 위해 다음의 주요 단계를 따릅니다.
1. Xcode Command Line Tools 설치
가장 먼저 Xcode Command Line Tools를 설치해야 합니다. 이는 Ruby 및 Rails가 의존하는 컴파일러와 기타 시스템 유틸리티를 포함하며, xcode-select --install 명령어를 터미널에 입력하여 설치할 수 있습니다. 이미 설치되어 있다면 시스템에서 자동으로 감지합니다.
2. Homebrew 설치 및 설정
Homebrew는 macOS용 비공식 패키지 관리자로, 다양한 소프트웨어를 쉽게 설치할 수 있게 해줍니다. brew.sh 웹사이트에서 제공하는 설치 스크립트를 복사하여 터미널에서 실행합니다. 설치 완료 후, Homebrew가 올바르게 작동하도록 .zshrc 파일(macOS Catalina 이상 버전의 기본 셸인 ZSH 기준)에 Homebrew 환경 변수 설정을 추가해야 합니다. 이를 통해 새로운 터미널 세션마다 Homebrew가 로드됩니다.
3. Ruby 종속성 설치
Ruby를 설치하기 전에 몇 가지 시스템 라이브러리가 필요합니다. Homebrew를 사용하여 OpenSSL 3 (보안 연결), libYAML (YAML 파일 처리), GMP (수학 라이브러리), 그리고 Rust 프로그래밍 언어를 설치합니다. 이들은 Ruby 및 Rails의 특정 기능에 필수적입니다.
4. Ruby 버전 관리자 mise 설치 및 Ruby 3.4.2 설치
다양한 Ruby 프로젝트에서 여러 버전을 사용할 수 있으므로, Ruby 버전 관리자 mise를 설치하는 것이 권장됩니다. mise는 Node.js, Python 등 다른 언어도 지원하는 유연한 도구입니다. curl 명령을 통해 mise를 설치하고, Homebrew와 마찬가지로 .zshrc 파일에 mise 활성화 스크립트를 추가합니다. mise가 정상적으로 설치되면, mise use -g ruby 3.4.2 명령을 사용하여 최신 Ruby 버전인 3.4.2를 전역적으로 설치하고 활성화합니다.
5. Rails 8 설치
Ruby 설치가 완료되면 Rails 프레임워크를 설치할 차례입니다. Rails는 Ruby gem의 일종으로, Ruby에 추가 기능을 제공하는 라이브러리입니다. gem install rails 명령을 통해 최신 버전인 Rails 8을 설치합니다. 설치 완료 후 rails -v 명령으로 버전 확인이 가능합니다.
6. Rails 애플리케이션 생성 및 실행
Rails는 기본적으로 SQLite라는 경량 데이터베이스를 사용하며, 별도의 설정 없이 바로 사용할 수 있습니다. 필요에 따라 PostgreSQL이나 MySQL과 같은 다른 데이터베이스를 사용할 수도 있습니다. 새로운 Rails 애플리케이션을 생성하려면 rails new my_app 명령을 사용합니다. 생성된 애플리케이션 디렉토리(my_app)로 이동한 후, rails s 명령을 입력하여 개발 서버를 시작합니다. 웹 브라우저에서 localhost:3000으로 접속하면 Ruby on Rails 환영 페이지를 확인할 수 있습니다. 이는 개발 환경 설정이 성공적으로 완료되었음을 의미합니다.