(MongoDB) (1/3) Mac M1 MongoDB 설치 (feat. Compass)

❓공부하게 된 계기

➡️ 학교 졸업프로젝트에서 NoSQL 을 사용하기로 하였고, DB로 MongoDB 를 선택하였다. 컴퓨터에 MongoDB 를 설치하고, 기본적인MongoDB 용어를 익히면서 Spring Boot 에 연동하여 사용하는 과정까지 정리해보고자 한다.

➡️ MongoDB 설치는 공식 레퍼런스를 보면서 진행하였고, 용어 정리와 Spring Boot 연동에는 공식 레퍼런스와 더불어 여러 블로그들을 참고하였다.

🔗 참고

Install MongoDB Community Edition on macOS — MongoDB Manual

❗️공부한 내용

1️⃣ MongoDB 설치 전체 명렁어

➡️ 하나하나 확인이 귀찮으면 아래 명령어를 쭉 따라치면 무난하게 설치 가능하다.

# 설치되어 있지 않은 경우 설치
xcode-select --install
# 이미 mongodb 가 설치되어있는 경우에는 생략 가능
brew tap mongodb/brew
# brew 업데이트
brew update
# mongodb 설치 (버전은 자유롭게)
# 설치되는 목록 : 1. server(mongod) 2. shared cluster(mongos) 3. DB shell(mongosh)
# 생성하는 파일/폴더 : 1. config 파일 2. log 폴더 3. data 폴더
brew install mongodb-community@6.0
# MacOS 에서 mongodb의 설치 경로를 확인하는 명령어
brew --prefix
# MongoDB 실행 명령어 (MacOs Service 로 실행)
brew services start mongodb-community@6.0
# MongoDB 실행 확인 명령어 (MacOs Service 로 실행 시)
# 정상 실행 시 : mongodb-community started
brew services list 
# MongoDB Shell 열기 (먼저 services start 로 실행해주어야함)
mongosh

2️⃣ 상세 과정

① xcode-select 설치

# 설치되어 있지 않은 경우 설치
xcode-select --install

➡️ 맥 CLI 명령어 도구라고 한다. 설치되어있지 않으면 설치하고 시작하면 된다.

 

② brew 명령어를 통한 MongoDB 저장소 생성

# 이미 mongodb 가 설치되어있는 경우에는 생략 가능
brew tap mongodb/brew
# brew 업데이트
brew update

➡️ brew tap 의 경우 패키지 저장소를 생성하는 명령어이다. 만약 MongoDB 를 처음 설치하는 상황이라면 해당 명령어를 통해 저장소를 만들어 주어야한다.

➡️ 저장소를 만들어 주었으니 brew update 를 통해 업데이트 해준다.

 

③ brew 명령어를 통한 MongoDB 설치

# mongodb 설치 (버전은 자유롭게)
brew install mongodb-community@(원하는 버전)

➡️ 이제 원하는 버전으로 설치하면된다. 맨위 참고란에 있는 공식 레퍼런스를 들어가면 다양한 버전으로 선택이 가능하다.

➡️ 나의 경우 설치하는 과정에서 Xcode 버전 관련 에러가 발생했다. 앱스토어에서 업데이트를 하면 쉽게 해결되지만 문제는 업데이트가 오래걸린다. 유튜브 영화 (결말포함) 하나 보고 오면 대충 끝나있으니 참고하도록 하자.

# MacOS 에서 mongodb의 설치 경로를 확인하는 명령어
brew --prefix
# MongoDB 설치 확인
brew list

➡️ 위 두 명령어를 통해 설치 경로와 설치 여부 확인을 할 수 있다.

 

④ MongoDB 실행

# MongoDB 실행 명령어 (MacOs Service 로 실행)
brew services start mongodb-community@(설치한 버전)

# MongoDB 실행 확인 명령어 (MacOs Service 로 실행 시)
# 정상 실행 시 : mongodb-community started
brew services list

➡️ MongoDB 를 실행시켜주고 brew 를 통해 서비스 목록을 확인하면 실행 여부를 확인 할 수 있다.

⑤ MongoDB Shell 열기

# MongoDB Shell 열기 (먼저 services start 로 실행해주어야함)
mongosh

➡️ 과정 ④ 의 명령어를 통해 MongoDB 를 정상적으로 실행하였다면 아래 사진 처럼 설치한 버전이 보이면서 문제없이 들어갈 수 있다.

✏️  Compass 시각화 도구 설치

➡️ CLI 화면으로 보기 번잡스럽다면 mongosh 접속 대신 자체 시각화 도구인 Compass 를 활용하는 방법도 있다.

Try MongoDB Tools - Download Free Here

 

➡️ 사용하는 OS 를 잘 선택해주고 파일을 다운받으면 바로 설치가능하다.

➡️ 앞의 과정을 통해 MongoDB 가 잘 설치되었으면 Connect 로 접속했을 때 정상적으로 화면이 전환된다.

🧐  다음 내용

➡️ 다음에는 MongoDB 에 대한 간략한 내용과 함께 기본 CRUD 명령어와 사용자 추가 정도를 다뤄볼 예정이다.