우분투 24.04에 루비 온 레일스 설치하는 방법

루비 온 레일스(Ruby on Rails) 또는 RoR 또는 Rails는 MVC(모델-뷰-컨트롤러) 아키텍처를 가진 루비 웹 애플리케이션 프레임워크이며, 반복하지 말라(DRY), 설정보다 관습(CoC), 액티브 레코드 패턴과 같은 디자인 철학을 포함합니다. 이는 엔터프라이즈급 웹 애플리케이션을 구축하기 위한 풀스택 웹 프레임워크입니다.

이 튜토리얼에서는 우분투 24.04에 루비 온 레일스를 설치하는 과정, 첫 번째 레일스 프로젝트 생성, 레일스 프로젝트의 데이터베이스로 PostgreSQL 구성, ‘rails’ 명령어로 스캐폴드를 생성하는 방법을 안내합니다.

필수 조건

시작하기 전에 다음 사항을 확인하세요:

우분투 24.04 서버.
sudo 관리자 권한이 있는 비루트 사용자.

의존성 설치

우분투 시스템에 루비 온 레일스를 설치하려면 루비, Node.js, PostgreSQL(데이터베이스에 선택 사항), Git 및 추가 개발 패키지와 같은 의존성을 설치해야 합니다. 이러한 패키지는 기본 우분투 저장소에서 사용할 수 있으며 APT를 사용하여 설치할 수 있습니다.

시작하려면 다음 명령어로 우분투 저장소를 업데이트하세요:

sudo apt update

update repo

이제 아래 명령어로 루비 온 레일스의 의존성을 설치하세요. 이를 통해 루비, PostgreSQL, Node.js, git 및 일부 개발 패키지를 설치합니다.

sudo apt install ruby ruby-dev postgresql libpq-dev nodejs yarnpkg git zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev libffi-dev

설치 진행을 위해 Y를 입력하세요.

설치가 완료되면 다음 명령어로 루비 및 Node.js 버전을 확인하세요:

ruby -v  
node -v

아래에서 루비 3.2와 Node.js 18.19가 설치된 것을 확인할 수 있습니다.

다음으로 아래 명령어를 실행하여 Yarn을 Node.js 패키지 관리자 설정하세요. 이 명령어는 새로운 명령어 ‘yarn‘을 생성하며 Yarn의 버전을 확인할 수 있습니다.

sudo ln -s /usr/bin/yarnpkg /usr/bin/yarn  
yarnpkg -v

check versions

마지막으로 다음 명령어로 PostgreSQL 서비스 상태를 확인하세요:

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

PostgreSQL 서버는 시작 시 자동으로 시작되며, PostgreSQL 상태는 ‘active (exited)‘입니다.

PostgreSQL 사용자 생성

의존성이 설치된 후, 레일스 프로젝트를 위한 새로운 PostgreSQL 사용자를 생성합니다. 이 사용자는 PostgreSQL에 로그인하고 새로운 데이터베이스를 생성할 수 있어야 합니다.

아래 명령어로 PostgreSQL 서버에 로그인하세요.

sudo -u postgres psql

다음 쿼리를 실행하여 비밀번호 ‘AppuserPassword‘로 새로운 PostgreSQL 사용자 ‘appuser‘를 생성합니다. 이 사용자는 PostgreSQL에서 데이터베이스와 역할을 생성할 수 있습니다.

CREATE USER appuser WITH PASSWORD 'AppuserPassword';  
ALTER USER appuser CREATEDB CREATEROLE;

이제 quit를 입력하거나 Ctrl+d를 눌러 PostgreSQL에서 로그아웃하세요.

create postgresql user

다음으로 아래 명령어를 실행하여 사용자 ‘appuser‘로 PostgreSQL에 로그인하세요. 프롬프트가 나타나면 비밀번호를 입력하세요.

su - postgres  
psql -U appuser -h 127.0.0.1 -d postgres

로그인 후 다음 명령어로 PostgreSQL 연결 상태를 확인하세요:

elinfo

아래에서 새로운 사용자 ‘appuser‘가 비밀번호 인증을 통해 localhost 또는 127.0.0.1로 PostgreSQL 서버에 연결할 수 있는 것을 확인할 수 있습니다.

루비 온 레일스 설치

이 섹션에서는 사용자 전용 환경에 최신 루비 온 레일스를 설치합니다. 따라서 사용자 아래에 기본 GEM_HOME 디렉토리를 설정해야 합니다.

먼저 다음 명령어로 사용자로 로그인하세요:

su - user

새로운 ~/.gem 디렉토리를 생성하고 ~/.bashrc 파일을 통해 GEM_HOME 환경 변수를 추가합니다. 이를 통해 모든 루비 젬이 ~/.gem 디렉토리에 설치됩니다.

mkdir -p ~/.gem  
echo 'export GEM_HOME=$HOME/.gem' >> $HOME/.bashrc

이제 아래 명령어를 실행하여 현재 셸을 다시 로드하고 GEM_HOME 환경 변수를 확인하세요. GEM_HOME이 ~/.gem 디렉토리를 가리키고 있는 것을 확인할 수 있습니다.

source ~/.bashrc  
echo $GEM_HOME

gem setup

다음으로 아래 gem 명령어를 실행하여 시스템에 bundler를 설치하세요.

gem install bundler

install bundler

그 후, 다음 gem 명령어로 루비 온 레일스를 설치하세요. 최신 버전의 루비 온 레일스를 설치하거나 -v 옵션을 사용하여 특정 버전을 선택할 수 있습니다.

gem install rails  
gem install rails -v 7.1.0

install rails

설치가 완료되면 아래 명령어로 루비 온 레일스 버전을 확인하세요:

rails --version  
rails --help

아래와 같이 최신 루비 온 레일스 7.1.3이 설치되었으며, ‘rails’ 명령어의 기본 사용법도 확인할 수 있습니다.

check version rails

PostgreSQL과 함께 루비 온 레일스 프로젝트 생성

이제 루비 온 레일스를 설치했습니다. 이 섹션에서는 PostgreSQL을 기본 데이터베이스로 사용하여 첫 번째 레일스 프로젝트를 생성합니다.

아래 ‘rails’ 명령어를 실행하여 새로운 레일스 프로젝트를 생성하세요. 이 예제에서는 기본 데이터베이스 PostgreSQL로 새로운 프로젝트 testapp을 생성합니다.

rails new testapp -d postgresql

아래에서 레일스 애플리케이션이 생성되었으며, git이 초기화된 것을 확인할 수 있습니다.

create app rails

이제 ~/testapp 디렉토리로 이동하여 데이터베이스 구성 ‘config/database.yml‘ 파일을 편집하세요.

cd ~/testapp/  
nano config/database.yml

development, test, production 환경의 데이터베이스 세부정보를 다음과 같이 변경하세요. 각 환경의 데이터베이스는 마이그레이션 중에 자동으로 생성됩니다.

development:  
 <<: *default  
 database: testapp_development  
 username: appuser  
 password: AppuserPassword  
 host: localhost  
 port: 5432  
  
test:  
 <<: *default  
 database: testapp_test  
 username: appuser  
 password: AppuserPassword  
 host: localhost  
 port: 5432  
  
production:  
 <<: *default  
 database: testapp_production  
 username: appuser  
 password: <%= ENV["TESTAPP_DATABASE_PASSWORD"] %>

완료되면 파일을 저장하고 종료하세요.

다음으로 아래 ‘rails‘ 명령어를 실행하여 데이터베이스를 설정하고 마이그레이션하세요.

rails db:setup  
rails db:migrate

migrating database

데이터베이스 마이그레이션이 완료되면 아래 명령어로 레일스 프로젝트를 실행하세요:

rails server -b 0.0.0.0

아래에서 레일스 프로젝트가 기본 포트 3000에서 실행되고 있는 것을 확인할 수 있습니다.

run rails

웹 브라우저를 사용하여 서버 IP 주소 http://192.168.5.30:3000/를 방문하세요. 루비 온 레일스 설치가 성공적이라면 다음 기본 레일스 인덱스를 확인할 수 있습니다:

ror index

스캐폴딩으로 생성하기

루비 온 레일스는 초보자를 위한 애플리케이션 구축을 쉽게 할 수 있는 방법을 제공합니다. 스캐폴드를 활용하여 레일스 프로젝트의 기본 구조를 생성할 수 있으며, 여기에는 컨트롤러, 모델 및 뷰가 포함됩니다.

아래 명령어를 실행하여 두 개의 사용자 입력 ‘name‘과 ‘url‘을 가진 간단한 애플리케이션 ‘site‘에 대한 스캐폴드를 생성하세요.

rails g scaffold site name:string url:string

아래는 애플리케이션의 레일스 모델, 컨트롤러 및 뷰가 생성되는 모습입니다.

scaffolding ror

스캐폴드가 생성된 후, 아래 명령어를 실행하여 레일스 데이터베이스를 마이그레이션하세요.

rails db:migrate

아래에서 레일스 데이터베이스가 마이그레이션된 것을 확인할 수 있습니다.

migrating database

이제 아래 명령어로 레일스 프로젝트를 실행하세요.

rails server -b 0.0.0.0

마지막으로 서버 IP 주소 http://192.168.5.30:3000/sites를 방문하여 ‘site‘ 애플리케이션에 접근하세요. 새로운 데이터 이름과 URL을 제출할 수 있습니다. 그런 다음, 새로운 데이터가 제출된 후의 예제를 아래에서 확인할 수 있습니다.

scaffolding site

결론

축하합니다! 우분투 24.04에 루비 온 레일스 설치를 완료했습니다. PostgreSQL을 데이터베이스로 사용하여 레일스 프로젝트를 생성했습니다. 마지막으로 스캐폴드 기능을 사용하여 레일스에서 기본 애플리케이션을 생성하는 방법도 배웠습니다.