Bundling 없이 Rails 프로젝트 생성하기

Ruby on Rails는 웹 애플리케이션을 빠르게 개발할 수 있도록 도와주는 강력한 프레임워크입니다. 일반적으로 Rails 프로젝트를 생성할 때는 Bundler를 사용하여 필요한 gem을 자동으로 설치합니다. 하지만 때때로 Bundler 없이 프로젝트를 생성하고 싶을 수 있습니다. 이 글에서는 Bundler 없이 Rails 프로젝트를 생성하는 방법에 대해 알아보겠습니다.

Bundler란 무엇인가?

Bundler는 Ruby 애플리케이션의 gem 의존성을 관리하는 도구입니다. Bundler를 사용하면 필요한 gem을 쉽게 설치하고, 버전을 관리하며, 프로젝트에 필요한 모든 gem을 한 곳에서 관리할 수 있습니다. 그러나 Bundler 없이도 Rails 프로젝트를 생성할 수 있으며, 이 방법은 특정 상황에서 유용할 수 있습니다.

Bundler 없이 Rails 프로젝트 생성하기

Bundler 없이 Rails 프로젝트를 생성하는 과정은 다음과 같습니다:

Ruby 및 Rails 설치 확인
새 Rails 프로젝트 생성
필요한 gem 수동 설치
프로젝트 실행

1. Ruby 및 Rails 설치 확인

먼저, Ruby와 Rails가 설치되어 있는지 확인해야 합니다. 터미널을 열고 다음 명령어를 입력하여 설치 여부를 확인합니다:

$ ruby -v
$ rails -v

이 명령어를 실행했을 때 Ruby와 Rails의 버전이 출력되면 설치가 완료된 것입니다. 만약 설치되어 있지 않다면, Ruby와 Rails를 설치해야 합니다.

2. 새 Rails 프로젝트 생성

Bundler 없이 Rails 프로젝트를 생성하려면, 다음 명령어를 사용하여 새로운 Rails 애플리케이션을 생성합니다:

$ rails new myapp --skip-bundle

위 명령어에서 myapp은 생성할 프로젝트의 이름입니다. --skip-bundle 플래그를 사용하면 Bundler가 gem을 설치하지 않도록 설정할 수 있습니다.

3. 필요한 gem 수동 설치

프로젝트가 생성되면, Gemfile 파일이 생성됩니다. 이 파일에는 프로젝트에서 사용할 gem의 목록이 포함되어 있습니다. Bundler 없이 gem을 수동으로 설치하려면, Gemfile을 열고 필요한 gem을 추가합니다. 예를 들어:

# Gemfile
source 'https://rubygems.org'

gem 'rails', '~> 6.1.0'
gem 'sqlite3'
gem 'puma'
gem 'sass-rails', '>= 6'
gem 'webpacker', '~> 5.0'
gem 'turbolinks', '~> 5'
gem 'jbuilder', '~> 2.7'

필요한 gem을 추가한 후, 각 gem을 수동으로 설치해야 합니다. 다음 명령어를 사용하여 각 gem을 설치할 수 있습니다:

$ gem install rails -v 6.1.0
$ gem install sqlite3
$ gem install puma
$ gem install sass-rails -v '>= 6'
$ gem install webpacker -v '~> 5.0'
$ gem install turbolinks -v '~> 5'
$ gem install jbuilder -v '~> 2.7'

각 gem의 버전은 Gemfile에 명시된 버전과 일치해야 합니다. 이렇게 하면 Bundler 없이도 필요한 gem을 설치할 수 있습니다.

4. 데이터베이스 설정

Rails 프로젝트를 생성한 후, 데이터베이스를 설정해야 합니다. 기본적으로 Rails는 SQLite를 사용합니다. 데이터베이스를 설정하려면 다음 명령어를 실행합니다:

$ rails db:create
$ rails db:migrate

이 명령어는 데이터베이스를 생성하고, 필요한 테이블을 생성하기 위해 마이그레이션을 실행합니다.

5. 프로젝트 실행

모든 설정이 완료되면, Rails 서버를 실행하여 프로젝트를 확인할 수 있습니다. 다음 명령어를 사용하여 서버를 시작합니다:

$ rails server

서버가 실행되면, 웹 브라우저를 열고 http://localhost:3000에 접속하여 Rails 애플리케이션이 정상적으로 실행되는지 확인합니다.

Bundler 없이 Rails 프로젝트를 관리하는 팁

Bundler 없이 Rails 프로젝트를 관리하는 것은 다소 번거로울 수 있습니다. 다음은 이 과정을 좀 더 수월하게 만드는 몇 가지 팁입니다:

Gemfile.lock 파일 관리: Bundler 없이 gem을 수동으로 설치할 경우, Gemfile.lock 파일이 생성되지 않습니다. 이 파일은 gem의 버전과 의존성을 관리하는 데 중요하므로, 수동으로 관리해야 합니다.
버전 충돌 주의: 여러 gem을 수동으로 설치할 때, 버전 충돌이 발생할 수 있습니다. 각 gem의 호환성을 확인하고, 필요한 경우 버전을 조정해야 합니다.
문서화: 프로젝트에서 사용하는 gem과 그 버전을 문서화하여, 다른 개발자나 미래의 자신이 쉽게 이해할 수 있도록 합니다.

결론

Bundler 없이 Rails 프로젝트를 생성하는 방법에 대해 알아보았습니다. 이 방법은 특정 상황에서 유용할 수 있지만, 일반적으로는 Bundler를 사용하는 것이 더 편리하고 안전합니다. 그러나 이 글을 통해 Bundler 없이도 Rails 프로젝트를 관리할 수 있는 방법을 익혔다면, 다양한 상황에 대처할 수 있는 능력을 갖추게 될 것입니다. 이제 여러분의 Rails 프로젝트를 시작해 보세요!