macOS에서 rbenv로 Ruby on Rails를 설치하는 방법

소개

Rails 개발 프레임워크와 결합된 Ruby 프로그래밍 언어는 앱 개발을 빠르고 효율적으로 만듭니다.

Ruby 및 Rails를 설치하는 한 가지 방법은 명령줄 도구 rbenv를 사용하는 것입니다. rbenv를 사용하면 Ruby on Rails 애플리케이션을 개발하기 위한 잘 제어되고 강력한 환경이 제공되므로 작업 중인 Ruby 버전을 필요에 따라 쉽게 전환할 수 있습니다.

rbenv는 Ruby의 애플리케이션별 버전을 지정하기 위한 지원을 제공하고, 각 사용자에 대해 전역 Ruby를 변경할 수 있게 하며, 환경 변수를 사용하여 Ruby 버전을 재정의할 수 있도록 합니다.

이 튜토리얼에서는 rbenv를 사용하여 로컬 macOS 머신에 Ruby on Rails를 설치하고 설정합니다.

전제 조건

이 자습서를 따르려면 다음이 필요합니다.

macOS가 설치된 컴퓨터 또는 가상 머신 1대, 해당 머신에 대한 관리 액세스 권한 및 인터넷 연결. 이 튜토리얼은 macOS 12.4 Monterey에서 테스트되었습니다.
자산 파이프라인에서 설명한 대로 macOS 시스템에 설치된 Node.js는 JavaScript 런타임에 의존합니다. Node.js는 이 기능을 제공합니다.
macOS 컴퓨터에 설치된 Homebrew 패키지 관리자.

1단계 - rbenv 설치

이 단계에서는 rbenv를 설치하고 부팅 시 자동으로 시작되는지 확인합니다. macOS에서 이 작업을 수행하기 위해 이 자습서에서는 패키지 관리자 Homebrew를 사용합니다.

Homebrew로 rbenv 패키지를 다운로드하려면 다음 명령을 실행하십시오.

brew install rbenv

이렇게 하면 rbenv 및 [ruby-build](https://github.com/rbenv/ruby-build) 플러그인이 설치됩니다. 이 플러그인은 새 버전의 Ruby 설치 프로세스를 간소화하는 rbenv install 명령을 추가합니다. 이것은 몇 가지 다른 종속성을 설치하고 시간이 걸릴 수 있습니다.

다음으로 eval \&#36 (rbenv init -)\ 명령을 ~/.bash_profile 파일에 추가하여 단말기. 이렇게 하려면 nano 또는 선호하는 텍스트 편집기에서 .bash_profile을 엽니다.

nano .bash_profile

파일에 다음 줄을 추가합니다.

eval "$(rbenv init -)"

파일을 저장하고 종료합니다.

다음으로 ~/.bash_profile 파일에 대한 변경 사항을 현재 셸 세션에 적용합니다.

source ~/.bash_profile

rbenv가 제대로 설정되었는지 확인하려면 rbenv 명령에 대한 자세한 정보를 표시하는 type 명령을 사용하십시오.

type rbenv

터미널 창에 다음이 표시됩니다.

Outputrbenv is a function
rbenv ()
{
    local command;
    command="${1:-}";
    if [ "$#" -gt 0 ]; then
        shift;
    fi;
    case "$command" in
        rehash | shell)
            eval "$(rbenv "sh-$command" "$@")"
        ;;
        *)
            command rbenv "$command" "$@"
        ;;
    esac
}

이 시점에서 머신에 rbenv와 ruby-build가 모두 설치되어 있습니다. 이렇게 하면 다음 단계에서 명령줄에서 Ruby를 설치할 수 있습니다.

2단계 — Ruby 설치

이제 ruby-build 플러그인이 설치되었으므로 단일 명령을 통해 필요한 모든 버전의 Ruby를 설치할 수 있습니다. 이 단계에서는 Ruby 버전을 선택하고 컴퓨터에 설치한 다음 설치를 확인합니다.

먼저 -l 플래그를 사용하여 사용 가능한 Ruby 버전을 나열합니다. 목록에 없는 최신 마이너 버전도 사용할 수 있습니다. 예를 들어 이 명령의 출력에 Ruby 3.0.5가 나열되어 있으면 3.0.4도 설치할 수 있습니다.

rbenv install -l

Output2.6.10
2.7.6
3.0.4
3.1.2
jruby-9.3.6.0
mruby-3.1.0
picoruby-3.0.0
rbx-5.0
truffleruby-22.1.0
truffleruby+graalvm-22.1.0

해당 명령의 출력은 설치하도록 선택할 수 있는 긴 버전 목록입니다.

이 튜토리얼에서는 Ruby 3.1.2를 설치합니다.

rbenv install 3.1.2

Ruby 설치는 시간이 오래 걸릴 수 있으므로 설치를 완료하는 데 시간이 걸릴 수 있도록 준비하십시오.

설치가 완료되면 global 하위 명령을 사용하여 Ruby의 기본 버전으로 설정합니다.

rbenv global 3.1.2

버전 번호를 확인하여 Ruby가 제대로 설치되었는지 확인합니다.

ruby -v

출력은 다음과 같습니다.

Outputruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x86_64-darwin21]

다른 버전의 Ruby를 설치하고 사용하려면 rbenv install 2.7.6 및 <와 같이 다른 버전 번호로 rbenv 명령을 실행하십시오. 코드>rbenv 글로벌 2.7.6.

이제 한 버전의 Ruby가 설치되었고 기본 Ruby 버전이 설정되었습니다. 다음으로 Ruby 패키지 및 라이브러리 또는 gems 작업을 설정하여 Rails를 설치할 수 있습니다.

3단계 - 보석 작업

Gems는 Ruby 생태계 전체에 배포할 수 있는 Ruby 라이브러리 및 프로그램 패키지입니다. gem 명령을 사용하여 이러한 gem을 관리합니다. 이 단계에서는 gem 명령을 구성하여 Rails 설치를 준비합니다.

gem을 설치할 때 설치 프로세스는 로컬 문서를 생성합니다. 이렇게 하면 각 gem의 설치 프로세스에 상당한 시간이 추가될 수 있으므로 이 기능을 해제하는 구성 설정이 포함된 ~/.gemrc라는 파일을 생성하여 로컬 문서 생성을 해제할 수 있습니다.

echo "gem: --no-document" > ~/.gemrc

완료되면 gem 명령을 사용하여 프로젝트의 gem 종속성을 관리하는 도구인 Bundler를 설치합니다. Rails가 올바르게 작동하려면 다음이 필요합니다.

gem install bundler

다음과 같은 출력이 표시됩니다.

Output
Fetching: bundler-2.3.18.gem
Successfully installed bundler-2.3.18
1 gem installed

gem env 명령을 사용하여 gem의 환경 및 구성에 대해 자세히 알아볼 수 있습니다. 설치된 gem의 위치를 보려면 다음과 같이 home 인수를 사용하십시오.

gem env home

다음과 유사한 출력이 표시됩니다.

/Users/sammy/.rbenv/versions/3.1.2/lib/ruby/gems/3.1.0

gem 워크플로를 설정하고 탐색했으므로 이제 자유롭게 Rails를 설치할 수 있습니다.

4단계 - 레일 설치

Rails를 설치하려면 gem install 명령을 사용하십시오.

gem install rails

gem 명령은 지정한 gem과 모든 종속성을 설치합니다. Rails는 복잡한 웹 개발 프레임워크이며 많은 종속성이 있으므로 프로세스를 완료하는 데 시간이 걸립니다. 결국 Rails가 종속성과 함께 설치되었다는 메시지가 표시됩니다.

Output...
Successfully installed rails-7.0.3.1
35 gems installed

참고: 다른 버전의 Rails를 설치하려는 경우 검색을 수행하여 유효한 버전의 Rails를 나열하면 가능한 버전의 긴 목록이 출력됩니다. 그런 다음 -v 플래그를 사용하여 4.2.7과 같은 특정 버전을 설치할 수 있습니다.

gem search '^rails$' --all
gem install rails -v 4.2.7

rbenv는 shims의 디렉토리 또는 호출을 가로채 변경하거나 리디렉션하는 라이브러리를 생성하여 작동합니다. 이 경우 shim은 Ruby 명령이 현재 활성화된 Ruby 버전에서 사용하는 파일을 가리킵니다. rehash 하위 명령을 통해 rbenv는 서버에 설치된 모든 Ruby 버전에서 모든 Ruby 명령과 일치하도록 해당 디렉토리의 shim을 유지합니다. 새 버전의 Ruby 또는 Rails와 같은 명령을 제공하는 gem을 설치할 때마다 rehash를 사용해야 합니다.

shim 디렉터리를 다시 해시하려면 다음 명령을 실행합니다.

rbenv rehash

다음 명령으로 해당 버전을 인쇄하여 Rails 설치를 확인하십시오.

rails -v

설치된 Rails 버전이 표시됩니다.

Output
Rails 7.0.3.1

Rails가 성공적으로 설치되면 Ruby on Rails 설치를 테스트하고 웹 애플리케이션 개발을 시작할 수 있습니다. 다음 단계에서는 rbenv 및 Ruby를 업데이트하고 제거하는 방법을 배웁니다.

5단계 - rbenv 및 Ruby 업데이트 및 제거

프로젝트를 유지 관리할 때 필요할 때 업데이트하고 제거하는 방법을 아는 것이 유용합니다. 이 단계에서는 rbenv를 업그레이드한 다음 컴퓨터에서 Ruby 및 rbenv를 제거합니다.

다음 명령을 실행하여 Homebrew를 사용하여 rbenv 및 ruby-build를 업그레이드할 수 있습니다.

brew upgrade rbenv ruby-build

rbenv 또는 ruby-build를 업데이트해야 하는 경우 Homebrew가 자동으로 업데이트를 수행합니다. 설정이 이미 최신인 경우 다음과 유사한 출력이 표시됩니다.

OutputWarning: rbenv 1.2.0 already installed
Warning: ruby-build 20220713 already installed

이렇게 하면 사용 가능한 최신 버전의 rbenv를 사용할 수 있습니다.

Ruby의 추가 버전을 다운로드하면 ~/.rbenv/versions 디렉토리에 원하는 것보다 더 많은 버전이 누적될 수 있습니다. ruby-build 플러그인의 uninstall 하위 명령을 사용하여 이러한 이전 버전을 제거할 수 있습니다.

예를 들어 다음을 실행하여 Ruby 버전 2.1.3을 제거합니다.

rbenv uninstall 2.1.3

rbenv uninstall 명령을 사용하면 현재 사용 중인 것보다 더 많이 설치되지 않도록 이전 버전의 Ruby를 정리할 수 있습니다.

더 이상 rbenv를 사용하지 않기로 결정했다면 시스템에서 rbenv를 제거할 수 있습니다.

이렇게 하려면 먼저 편집기에서 ~/.bash_profile 파일을 엽니다.

nano ~/.bash_profile

터미널을 열 때 rbenv가 시작되지 않도록 하려면 파일에서 다음 줄을 찾아 제거하십시오.

...
eval "$(rbenv init -)"

이 줄을 삭제했으면 파일을 저장하고 편집기를 종료합니다.

다음 명령을 실행하여 변경 사항을 셸에 적용합니다.

source ~/.bash_profile

다음으로 다음 명령을 사용하여 rbenv 및 설치된 모든 Ruby 버전을 제거합니다.

rm -rf `rbenv root`

마지막으로 Homebrew를 사용하여 rbenv 패키지 자체를 제거합니다.

brew uninstall rbenv

rbenv 버전을 확인하여 제거되었는지 확인하십시오.

rbenv -v

다음과 같은 결과가 표시됩니다.

Output-bash: /usr/local/bin/rbenv: No such file or directory

이는 시스템에서 rbenv를 성공적으로 제거했음을 의미합니다.

결론

이 튜토리얼에서는 macOS에서 rbenv와 함께 Ruby on Rails를 설치했습니다. 여기에서 응용 프로그램에 더 많은 확장성, 중앙 집중화 및 안정성을 제공하는 기본 sqlite3 데이터베이스가 아닌 PostgreSQL을 사용하여 Ruby에서 코딩하는 방법에 대해 자세히 알아볼 수 있습니다.