Mac에서 Ruby on Rails 개발 환경 설정하기

Beginner's Guide to Installing Ruby on Rails - by Typecraft

작성자
Ruby on Rails Youtube
발행일
2025년 07월 16일

핵심 요약

  • 1 본 영상은 Mac OS 환경에서 Ruby on Rails 개발을 위한 필수 도구 설치 과정을 안내합니다.
  • 2 Xcode Command Line Tools, Homebrew, Ruby 종속성, Ruby 버전 관리자(mise), Ruby, 그리고 Rails 프레임워크를 순차적으로 설치합니다.
  • 3 최종적으로 새로운 Rails 애플리케이션을 생성하고 실행하여 개발 환경이 성공적으로 설정되었음을 확인합니다.

도입

본 문서는 풀 스택 웹 개발에 관심 있는 개발자들을 위해 Mac OS 환경에서 Ruby on Rails 개발 환경을 구축하는 상세한 절차를 설명합니다. Ruby on Rails는 아이디어를 최소 기능 제품(MVP)으로 빠르게 구현할 수 있도록 돕는 강력한 웹 프레임워크입니다. 이 가이드는 개발 환경 설정의 각 단계를 명확히 제시하여 사용자가 효율적으로 개발을 시작할 수 있도록 돕습니다. 비록 Mac OS에 초점을 맞추고 있지만, Linux나 Windows 사용자도 개념적인 단계를 이해하여 각자의 환경에 적용할 수 있습니다.

개발 환경 설정을 위한 첫 번째 단계는 Xcode Command Line Tools를 설치하는 것입니다. 이는 Ruby와 Rails가 의존하는 컴파일러 및 기타 시스템 유틸리티를 포함하며, xcode-select --install 명령어를 터미널에 입력하여 설치할 수 있습니다. 이미 설치되어 있다면 건너뛰거나, xcode-select -p 명령어로 설치 경로를 확인할 수 있습니다.

두 번째 단계는 Mac OS의 비공식 패키지 관리자인 Homebrew를 설치하는 것입니다. Homebrew는 소프트웨어 설치를 매우 용이하게 하며, brew.sh 웹사이트에서 제공하는 스크립트를 터미널에 복사하여 실행함으로써 설치됩니다. 설치 후에는 Homebrew가 올바르게 작동하도록 .zshrc 파일(혹은 사용하는 셸에 따라 .bash_profile 등)에 환경 변수를 추가하고, source ~/.zshrc 명령어로 적용해야 합니다. brew -v로 설치 여부를 확인할 수 있습니다.

세 번째 단계는 Ruby 설치에 필요한 시스템 라이브러리들을 Homebrew를 통해 설치하는 것입니다. brew install openssl@3 libyaml gmp rust 명령어를 사용하여 OpenSSL 3, libYAML, GMP, Rust를 설치합니다. 이들은 각각 보안 연결, YAML 파일 처리, 수학 라이브러리, 특정 젬을 위한 프로그래밍 언어로서 Ruby 및 Rails의 원활한 작동을 위해 필요합니다.

네 번째 단계는 Ruby 버전을 효율적으로 관리하기 위한 mise (또는 asdf와 같은 다른 버전 관리자)를 설치하는 것입니다. mise는 다양한 Ruby 버전을 프로젝트별로 쉽게 전환할 수 있게 해주며, Node.js나 Python과 같은 다른 언어도 지원합니다. mise 설치 스크립트를 실행한 후, Homebrew와 마찬가지로 .zshrc 파일에 eval "$(~/.config/mise/bin/mise activate zsh)" 라인을 추가하고 소싱하여 환경을 설정합니다. 이후 mise install ruby@3.4.2 명령어를 사용하여 Ruby 3.4.2를 설치하고, mise use -g ruby@3.4.2 명령어로 전역 버전으로 설정합니다. ruby -v로 설치된 Ruby 버전을 확인할 수 있습니다.

다섯 번째 단계는 Rails 8 프레임워크를 설치하는 것입니다. Rails는 Ruby 젬(Gem)의 일종으로, 젬은 Ruby에 추가 기능을 제공하는 라이브러리 또는 플러그인과 같습니다. gem install rails 명령어를 사용하여 Rails를 설치하며, rails -v 명령어로 설치된 Rails 버전을 확인할 수 있습니다. 기본적으로 Rails는 SQLite 데이터베이스를 사용하지만, 필요에 따라 PostgreSQL 또는 MySQL과 같은 다른 데이터베이스를 사용할 수 있습니다. 이는 rails new my_app -d postgresql과 같이 애플리케이션 생성 시 -d 플래그를 통해 지정할 수 있습니다.

마지막으로, rails new my_app 명령어를 통해 새로운 Rails 애플리케이션을 생성합니다. 이 명령은 Rails 애플리케이션에 필요한 모든 파일과 폴더 구조를 자동으로 설정하고, 필요한 젬들을 bundle install을 통해 설치합니다. 애플리케이션 디렉토리(cd my_app)로 이동한 후 rails s 명령어를 실행하면 개발 서버가 시작되며, 웹 브라우저에서 localhost:3000으로 접속하여 Ruby on Rails 환영 페이지를 확인할 수 있습니다.

결론

이 가이드를 통해 Mac OS 환경에서 Ruby on Rails 개발 환경을 성공적으로 구축하고, 첫 번째 Rails 애플리케이션을 실행하는 방법을 익혔습니다. Xcode Command Line Tools, Homebrew, Ruby 종속성, Ruby 버전 관리자(mise), Ruby, 그리고 Rails 프레임워크의 설치는 Rails 개발의 필수적인 시작점입니다. 이제 개발자는 아이디어를 실제 웹 애플리케이션으로 빠르게 구현할 수 있는 기반을 마련했습니다. 이 환경 설정을 바탕으로, Rails의 강력한 기능을 활용하여 다양한 웹 애플리케이션을 개발할 수 있을 것입니다.

댓글 0

댓글 작성

0/1000
정중하고 건설적인 댓글을 작성해 주세요.

아직 댓글이 없습니다

첫 번째 댓글을 작성해보세요!