PromleeBlog
sitemap
aboutMe

posting thumbnail
MongoDB 설치 및 환경 설정 - MongoDB 올인 3일차
Installing & Setting Up MongoDB - All-in Day 3

📅
🚀 들어가기 전에
🚀 무엇을 설치하나요? MongoDB Community Server
🚀 운영체제별 MongoDB 설치 방법
✅ 윈도우
✅ 맥
✅ 리눅스
🚀 설치 확인 및 기본 설정
✅ MongoDB Shell 접속하기
✅ 기본 설정 파일
🚀 결론
✅ 참고
🚀

들어가기 전에 🔗

지난 시간에는 MongoDB의 내부 구조, 즉 아키텍처에 대해 살펴보았습니다. 문서와 컬렉션이 어떻게 구성되는지, 그리고 복제 세트와 샤딩이 왜 중요한지를 배웠죠.
이제 이론을 넘어 실제로 MongoDB를 우리 컴퓨터에 설치하고 실행해 볼 차례입니다.
🚀

무엇을 설치하나요? MongoDB Community Server 🔗

MongoDB는 여러 버전이 있지만, 우리가 주로 사용하고 학습할 버전은
MongoDB Community Server
입니다.
이름 그대로 커뮤니티를 위한 무료 버전이며, MongoDB의 핵심 기능을 모두 포함하고 있어 학습 및 개발 목적으로 충분합니다.
(참고로, 유료 기술 지원 등이 포함된 Enterprise 버전도 있습니다.)

우리는 각자의 컴퓨터 운영체제(OS)에 맞는 방식으로 Community Server를 설치할 것입니다.
🚀

운영체제별 MongoDB 설치 방법 🔗

MongoDB는 Windows, macOS, Linux 등 다양한 운영체제를 지원합니다.
여기서는 가장 일반적인 설치 방법들을 운영체제별로 나누어 설명하겠습니다.
✅

윈도우(Windows)에 설치하기 🔗

윈도우 환경에서는 보통 설치 마법사 파일(.msi)을 이용하여 쉽게 설치할 수 있습니다.
  1. 설치 파일 다운로드
    :
    • MongoDB 공식 다운로드 센터 (https://www.mongodb.com/try/download/community↗)에 접속합니다.
    • 'MongoDB Community Server' 탭을 선택하고, 사용 중인 윈도우 버전에 맞는 'MSI' 패키지를 선택하여 다운로드합니다.
    MongoDB 다운로드
    MongoDB 다운로드
  2. 설치 마법사 실행
    :
    • 다운로드한 MSI 파일을 실행하면 설치 마법사가 시작됩니다. 'Next'를 눌러 진행합니다.
    • 라이선스 동의(Accept) 후, 'Complete'(전체 설치) 또는 'Custom'(사용자 지정 설치)을 선택합니다. 처음 설치하는 경우 'Complete'를 추천합니다.
    Complete 설치
    Complete 설치
  3. 서비스 설정
    :
    • 'Install MongoD as a Service' 옵션을 체크하는 것이 좋습니다. 이렇게 하면 MongoDB 서버가 윈도우 서비스로 등록되어 컴퓨터가 켜질 때 자동으로 시작될 수 있습니다.
    • 서비스 이름, 데이터 저장 경로(Data Directory), 로그 저장 경로(Log Directory) 등을 기본값으로 두거나 필요에 따라 변경할 수 있습니다.
  4. MongoDB Compass 설치 (선택 사항)
    :
    • MongoDB Compass는 데이터를 시각적으로 보고 관리할 수 있는 편리한 GUI 도구입니다. 함께 설치하는 것을 추천합니다. 체크박스를 선택하고 'Next'를 누릅니다.
  5. 설치 완료
    :
    • 'Install' 버튼을 클릭하면 설치가 진행되고, 완료되면 'Finish' 버튼을 누릅니다.
  6. 환경 변수 설정
    :
    • MongoDB 명령어를 어느 위치에서든 사용하려면 설치 경로를 시스템 환경 변수 'Path'에 추가해야 합니다.
    • 보통 C:\Program Files\MongoDB\Server\[버전]\bin 경로를 시스템 변수 Path에 추가합니다.
    시스템 환경 변수 - Path 변수에 MongoDB bin 경로 추가
    시스템 환경 변수 - Path 변수에 MongoDB bin 경로 추가
  7. MongoDB Shell (mongosh) 설치
    :
    • MongoDB Shell은 MongoDB와 상호작용하기 위한 명령줄 도구입니다. 최신 버전에서는 mongosh라는 이름으로 제공됩니다.
    • MongoDB Shell 설치 페이지↗에서 Windows용 설치 파일을 다운로드하여 설치합니다.
✅

맥(macOS)에 설치하기 🔗

macOS에서는
Homebrew
라는 패키지 관리자를 사용하는 것이 가장 편리합니다. Homebrew가 설치되어 있지 않다면 먼저 설치해야 합니다 (https://brew.sh/index_ko↗).
자세한 사용법은 다음 포스팅을 참고해주세요! 홈브루 설치하기 (Homebrew for MacOS)
  1. MongoDB Homebrew Tap 추가
    :
    • 터미널(Terminal) 앱을 열고 다음 명령어를 실행하여 MongoDB 공식 Homebrew 저장소를 추가합니다.
    brew tap mongodb/brew
  2. MongoDB 설치
    :
    • 다음 명령어를 실행하여 최신 버전의 MongoDB Community Server를 설치합니다.
    brew install mongodb-community
  3. MongoDB 서비스 시작
    :
    • 설치가 완료되면 다음 명령어를 사용하여 MongoDB 서비스를 백그라운드에서 시작할 수 있습니다.
    brew services start mongodb/brew/mongodb-community
    • 서비스를 중지하려면 stop 명령어를, 상태를 확인하려면 list 명령어를 사용하면 됩니다.
✅

리눅스(Linux - Ubuntu 예시)에 설치하기 🔗

리눅스 배포판(예: Ubuntu)에서는 apt와 같은 패키지 관리자를 사용하여 설치합니다. MongoDB 공식 저장소를 추가한 후 설치하는 것이 최신 버전을 사용하는 데 좋습니다.
  1. MongoDB 공개 키 가져오기
    :
    • 터미널을 열고 다음 명령어를 실행하여 MongoDB 공개 GPG 키를 가져옵니다. (버전별로 URL이 다를 수 있으니 공식 문서 확인 필요)
    wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -
    주의
    : apt-key는 점차 사용되지 않는 추세이므로, 최신 Ubuntu 버전에서는 다른 방식(예: /etc/apt/keyrings 사용)을 권장할 수 있습니다. 공식 문서를 꼭 확인하세요.
  2. MongoDB 저장소 목록 파일 만들기
    :
    • 사용 중인 Ubuntu 버전에 맞는 저장소 목록 파일을 생성합니다. 예를 들어 Ubuntu 22.04 (Jammy)의 경우:
    echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
  3. 패키지 목록 업데이트
    :
    • 새로운 저장소 정보를 시스템에 알리기 위해 패키지 목록을 업데이트합니다.
    sudo apt-get update
  4. MongoDB 설치
    :
    • 다음 명령어를 실행하여 MongoDB 패키지(서버, 셸 등 포함)를 설치합니다.
    sudo apt-get install -y mongodb-org
  5. MongoDB 서비스 시작 및 상태 확인
    :
    • 설치 후 MongoDB 서비스(데몬 mongod)를 시작하고, 시스템 부팅 시 자동으로 시작되도록 설정합니다.
    sudo systemctl start mongod
sudo systemctl enable mongod
    • 서비스가 정상적으로 실행 중인지 확인합니다.
    sudo systemctl status mongod
🚀

설치 확인 및 기본 설정 🔗

MongoDB 서버를 성공적으로 설치하고 실행했다면, 이제 잘 작동하는지 확인해 볼 차례입니다.
✅

MongoDB Shell 접속하기 🔗

MongoDB 서버와 상호작용하기 위해
MongoDB Shell
이라는 명령줄 인터페이스를 사용합니다. 최신 버전에서는 mongosh라는 이름으로 제공됩니다. (구 버전에서는 mongo였습니다.)
터미널(Windows에서는 명령 프롬프트 또는 PowerShell)을 열고 다음 명령어를 입력합니다.
mongosh
성공적으로 접속되면 MongoDB Shell 프롬프트(예: > 또는 test>)가 나타납니다. 여기서 MongoDB 명령어를 직접 입력하여 데이터베이스를 조작할 수 있습니다.
몇 가지 기본 명령어를 실행해 봅시다.
✅

기본 설정 파일 (mongod.conf) 🔗

MongoDB 서버(mongod)가 시작될 때 참조하는 설정 파일이 있습니다. 이 파일에는 데이터 저장 경로, 로그 파일 경로, 네트워크 포트 등 다양한 설정을 지정할 수 있습니다.
지금 당장 이 파일을 수정할 필요는 없지만, 나중에 설정을 변경해야 할 때 이 파일의 존재와 위치를 알아두면 유용합니다. 주요 설정 항목으로는 다음과 같은 것들이 있습니다.
🚀

결론 🔗

오늘은 각 운영체제별로 MongoDB Community Server를 설치하고, MongoDB Shell을 통해 서버에 접속하여 기본적인 명령어를 실행하는 방법까지 알아보았습니다.
또한, 서버 설정 파일의 존재에 대해서도 간략히 살펴보았습니다. 이제 우리는 MongoDB를 가지고 실제로 데이터를 다룰 준비가 되었습니다.
다음 시간에는 MongoDB에서 데이터를 어떻게 구조화하여 저장할지 고민하는 과정, 즉
데이터 모델링
에 대해 알아보겠습니다. 문서와 컬렉션을 어떻게 설계하는 것이 효율적인지 함께 배워봅시다!
✅

참고 🔗