gem과 Bundler란 무엇인가요?

Question

Accepted Answer

**gem**은 RubyGems를 통해 배포되는 Ruby의 패키지(라이브러리)입니다. **Bundler**는 프로젝트의 gem 의존성을 관리합니다 — 올바른 버전을 설치하고 lockfile을 통해 머신 간 **일관되고 재현 가능한** 환경을 보장합니다. 함께 이들은 Ruby 프로젝트가 의존성을 관리하는 방식입니다.

## gem — Ruby 패키지

```bash
gem install rails          # gem을 전역으로 설치
gem list                   # 설치된 gem 목록
# gem은 rubygems.org에서 옴 — 중앙 패키지 레지스트리 (Rails, RSpec 등)
```

gem은 패키징된 Ruby 라이브러리(코드 + 메타데이터)입니다. RubyGems는 패키지 관리자이고 rubygems.org는 레지스트리입니다 — Ruby의 npm/pip에 해당합니다.

## Bundler — 프로젝트 의존성 관리

```ruby
# Gemfile — 프로젝트의 gem 의존성을 선언
source "https://rubygems.org"

gem "rails", "~> 7.0"        # 버전 제약 (~> 는 호환 업데이트 허용)
gem "pg"                     # PostgreSQL 어댑터
gem "rspec", group: :test    # test 환경에서만
```

```bash
bundle install               # Gemfile의 모든 gem 설치 (Gemfile.lock 생성)
bundle update                # 허용된 더 새 버전으로 gem 업데이트
bundle exec rspec            # 프로젝트의 정확한 gem 버전으로 명령 실행
```

**`Gemfile`**은 버전 제약과 함께 프로젝트 의존성을 선언합니다. `bundle install`이 이를 설치하고 **`Gemfile.lock`**을 생성합니다.

## lockfile — 재현 가능한 설치

```text
Gemfile      → 제약과 함께 의존성 선언 (예: rails ~> 7.0)
Gemfile.lock → 설치된 모든 gem(과 하위 의존성)의 정확한 버전 기록
→ Gemfile.lock 커밋 → 모두(팀, CI, 프로덕션)가 동일한 버전을 얻음.
  버전 차이로 인한 "내 컴퓨터에선 되는데" 버그를 방지.
```

**`Gemfile.lock`**은 모든 gem(전이 의존성 포함)의 정확한 버전을 고정하므로, 이를 커밋하면 모든 개발자, CI, 프로덕션이 *동일한* 의존성 트리를 설치하도록 보장합니다 — 재현 가능하고 일관된 환경. 항상 커밋하세요.

## bundle exec — 프로젝트의 버전 사용

```bash
bundle exec rspec    # Gemfile.lock의 정확한 버전으로 rspec 실행
# (vs `rspec` 는 다른 전역 설치 버전을 사용할 수 있음)
```

## 왜 중요한가

gem과 Bundler는 Ruby 개발의 근본입니다 — 사실상 모든 Ruby 프로젝트가 의존성을 관리하는 방식이므로, 이를 이해하는 것은 필수적입니다. **gem**(rubygems.org의 Ruby 패키지)은 실제 애플리케이션이 의존하는 라이브러리와 프레임워크(Rails, RSpec 등)를 제공하고, **Bundler**는 프로젝트에서 이를 관리하는 표준 도구입니다.

Bundler가 제공하는 핵심 가치 — 그리고 이해해야 할 가장 중요한 개념 — 은 **재현 가능하고 일관된 환경**입니다: **`Gemfile`**은 버전 제약과 함께 의존성을 선언하고, **`Gemfile.lock`**은 설치된 모든 gem(전이 의존성 포함)의 *정확한* 버전을 고정합니다.

`Gemfile.lock`을 커밋하면 모두 — 전체 팀, CI, 프로덕션 — 가 동일한 의존성 트리를 설치하도록 보장하여, 버전 차이에서 발생하는 "내 컴퓨터에선 되는데" 버그를 방지합니다.

이 재현성은 신뢰할 수 있는 협업 개발과 배포에 결정적입니다.

gem(Ruby의 패키지), Gemfile(의존성 선언), `bundle install`, **lockfile과 이를 커밋하는 이유**(재현 가능한 설치 — 핵심 이점), `bundle exec`(프로젝트의 정확한 버전으로 명령 실행)를 이해하는 것은 모든 Ruby 프로젝트에 중요한 일상 지식입니다.

의존성 관리는 실제 애플리케이션의 근본이고, Bundler의 lockfile 기반 재현성이 Ruby 팀이 개발·CI·프로덕션 전반에서 일관된 환경을 보장하는 방식이므로, gem과 Bundler를 숙달하는 것 — Node의 npm/package-lock.json에 유사함 — 은 전문적인 Ruby 개발에 필수적이고 자주 적용되는 지식입니다.