ruby 가상환경 셋팅 - rbenv

Jekyll을 로컬에서 빌드하기 위해 rbenv를 활용하여 ruby 가상환경을 셋팅하는 방법에 대해 공부한 내용을 정리합니다.

macOS Catalina 10.15.6을 기준으로 작성하였습니다.

1. ruby 설치 유무 확인

Jekyll을 활용하여 만든 git page를 로컬에서 빌드 하기 위해선 ruby가 필요합니다.

ruby가 설치 되어 있는지 확인합니다.

1
ruby -v

ruby가 설치 되어 있지 않다면, Homebrew를 활용하여 ruby를 설치 해 줍니다.

1
2
3
4
5
6
7
8
9
10
11
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" # Install Homebrew

brew install ruby # Install ruby

echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile # Add the brew ruby path to your shell configuration:

# Relaunch terminal

$which ruby # Check ruby's location 

$ruby -v # Check ruby version 

2. rbenv 설치

rbenv는 python의 pipenv와 같이 ruby의 가상환경을 구축 할 수 있도록 도와줍니다.

Homebrew를 활용하여 설치합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
$brew install rbenv # Install rbenv

$rbenv init # Set up rbenv integration with your shell

$curl -fsSL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-doctor | bash # Check your installation

Checking for `rbenv' in PATH: /usr/local/bin/rbenv
Checking for rbenv shims in PATH: not found # Path 설정이 되지 않은 것을 확인 할 수 있습니다. 
  The directory `/Users/rams/.rbenv/shims' must be present in PATH for rbenv to work.
  Please run `rbenv init' and follow the instructions.

Checking `rbenv install' support: /usr/local/bin/rbenv-install (ruby-build 20200819)
Counting installed Ruby versions: 1 versions
Checking RubyGems settings: OK
Auditing installed plugins: OK

위와 같이 나온다면, 정상적으로 설치 된 것입니다.

3. 가상환경을 셋팅 할 버전의 루비 살치

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
$rbenv install 2.6.0 # 2.6.0 버전을 설치하는 경우입니다. 설치하고자 하는 버전을 입력 해 주세요

$ruby -v # 제 컴퓨터에 설치 되어 있던 버전입니다. 
ruby 2.6.3p62 (2019-04-16 revision 67580)

$rbenv version # rbenv에 설치 된 ruby 버전들을 확인 합니다. ( 위 명령어를 통해 여러개 설치 시 여러 버전이 확인됩니다. )
2.6.0 # rbenv에 설치된 루비 버전이 확인됩니다. 2.6.0 버전이 설치 되었음을 확인 할 수 있습니다. 

$ruby -v # 제 컴퓨터에 설치 되어 있던 버전입니다. global 하게 사용 되는 버전이므로, 아직 rbenv의 ruby 버전과는 차이가 있습니다. 
ruby 2.6.3p62

$rbenv global 2.6.0 # 전역적으로 rbenv의 루비 버전인 2.6.0을 사용하겠다고 선언합니다. 
$ruby -v # 하지만 아직 global하게 사용하는 ruby의 버전이 변경되지 않았음을 확인 할 수 있습니다. 
ruby 2.6.3p62

# rbenv의 ruby를 사용하도록 경로 설정 해 줍니다. 
$export PATH="$HOME/.rbenv/bin:$PATH"
$eval "$(rbenv init -)"

# ruby 버전이 변경 된 것을 확인합니다. 
$ruby -v               
ruby 2.6.0p0

# 위와 다르게 PATH가 설정 된것을 확인 할 수 있습니다. 
$curl -fsSL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-doctor | bash

Checking for `rbenv' in PATH: /usr/local/bin/rbenv
Checking for rbenv shims in PATH: OK
Checking `rbenv install' support: /usr/local/bin/rbenv-install (ruby-build 20200819)
Counting installed Ruby versions: 1 versions
Checking RubyGems settings: OK
Auditing installed plugins: OK

아래의 내용은 jekyll theme을 로컬에서 빌드하기 위한 과정입니다.

4. jekyll 빌드에 필요한 gem들 설치 및 theme 로컬 서버 빌드

1
2
3
4
5
6
7
8
9
10
11
12
13
14
$gem install jekyll bundler # gem을 설치하기 위한 bunlder와 jekyll 설치
Successfully installed jekyll-4.1.1
Parsing documentation for jekyll-4.1.1
Installing ri documentation for jekyll-4.1.1
Done installing documentation for jekyll after 1 seconds
Successfully installed bundler-2.1.4
Parsing documentation for bundler-2.1.4
Installing ri documentation for bundler-2.1.4
Done installing documentation for bundler after 2 seconds
2 gems installed

$bundle install # Jekyll theme이 있는 곳에서, 필요한 gem들 설치 

$bundle exec jekyll serve # Jekyll theme이 있는 곳에서, 해당 theme 로컬 서버 빌드

http://localhost:4000 를 접속하여 로컬에서 빌드된 깃헙 블로그를 확인합니다.