Ubuntu 환경에 몽고DB 설치

Ubuntu에 MongoDB를 설치하려는데, apt install mongodb로는 최신 버전이 설치되지 않습니다. 공식 저장소를 등록해야 합니다.

MongoDB 는 JSON과 유사한 문서(Document) 형태로 데이터를 저장하는 NoSQL 데이터베이스입니다. 스키마가 유연하여 빠른 프로토타이핑과 비정형 데이터 처리에 적합하며, 수평 확장(샤딩)을 기본 지원합니다.

설치 방법

Ubuntu의 기본 apt 저장소에는 MongoDB 최신 버전이 포함되어 있지 않으므로, MongoDB 공식 저장소를 직접 등록하여 설치합니다.

1. 필수 패키지 설치

sudo apt-get install gnupg curl

**gnupg와 curl이 필요한 이유 **: curl은 MongoDB의 GPG 공개 키를 다운로드하는 데 사용하고, gnupg는 해당 키를 시스템에 등록하여 패키지의 무결성을 검증하는 데 사용합니다.

2. MongoDB GPG 키 추가

curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | \
  sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \
  --dearmor

GPG 키란?: 패키지가 MongoDB 공식 배포처에서 서명한 것임을 검증하기 위한 암호화 키입니다. 이 키를 등록하면 apt가 패키지를 다운로드할 때 위변조 여부를 자동으로 확인합니다.

3. MongoDB 저장소 추가

Ubuntu 버전에 맞는 저장소를 등록합니다.

# Ubuntu 20.04 (Focal)
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

** 다른 Ubuntu 버전을 사용하는 경우 **: focal 부분을 해당 버전의 코드명으로 변경합니다.

Ubuntu 버전	코드명
20.04	focal
22.04	jammy
24.04	noble

4. 패키지 업데이트 및 MongoDB 설치

sudo apt-get update
sudo apt-get install -y mongodb-org

서비스 관리

서비스 시작 및 자동 실행 등록

# MongoDB 서비스 시작
sudo systemctl start mongod

# 부팅 시 자동 실행 등록
sudo systemctl enable mongod

상태 확인

sudo systemctl status mongod

active (running) 상태가 표시되면 정상적으로 실행 중입니다.

서비스 중지 및 재시작

# 서비스 중지
sudo systemctl stop mongod

# 서비스 재시작
sudo systemctl restart mongod

설치 확인

MongoDB 셸에 접속하여 정상 동작을 확인합니다.

mongosh

Current Mongosh Log ID: ...
Connecting to: mongodb://localhost:27017
...
test>

프롬프트가 나타나면 MongoDB가 정상적으로 설치 및 실행된 것입니다.

주의할 점

Ubuntu 버전별 코드명 확인

MongoDB 저장소 URL에 포함되는 코드명(focal, jammy, noble)이 실제 Ubuntu 버전과 일치해야 합니다. 잘못된 코드명을 사용하면 apt update에서 에러가 발생합니다. lsb_release -cs 명령으로 현재 코드명을 확인합니다.

GPG 키 미등록 시 패키지 설치 거부

GPG 키를 등록하지 않고 apt install을 실행하면 패키지 서명 검증에 실패하여 설치가 거부됩니다. 설치 순서(GPG 키 등록 → 저장소 추가 → apt update → 설치)를 반드시 지킵니다.

정리