[DB] MongoDB Atlas 설정 및 삭제 방법 총정리

프로젝트에서 MongoDB Atlas를 사용하며 설정하는 과정을 정리하려고 한다. 처음부터 차근차근 진행한 내용을 공유하여, 같은 설정을 하는 분들에게 도움이 될 수 있도록 작성하였다.

 

MogoDB Atlas 설정 방법

1. 무료로 시작하기 선택

• MongoDB Atlas 사이트에서 무료로 시작하기(Free) 버튼을 클릭한다.

2. 계정 생성

• 이메일, 비밀번호를 입력하여 새 계정을 만들거나, Google 계정으로 간편 가입이 가능하다.

 

3. 프로젝트 생성

• 프로젝트 이름을 입력하고 프로젝트 생성(Create Project)을 클릭한다.
• Tags는 선택 사항이므로 입력하지 않아도 된다.

 

4. 멤버 추가 및 권한 설정

• 필요하다면 팀원을 추가하고, 역할(Role)을 설정할 수 있다.
• 단독 사용이라면 그대로 넘어가도 무방하다.

 

5. 프로젝트 등록 완료 및 클러스터 생성 시작

• 프로젝트가 생성되면 클러스터(Cluster)를 등록하는 단계로 이동한다.

 

 

6. 클러스터 등록 및 설정

• 무료(Free Shared) 옵션 선택한다.
• 지역(Region)과 설정을 선택 후 Cluster 생성(Create Cluster) 진행한다.
• Tags는 선택 사항이므로 입력하지 않아도 된다.

Quick setup

• Automate security setup
  → 현재 IP를 자동 허용하여 로컬에서 DB 접속 가능하도록 설정
  → 로컬 개발 시 편리, 하지만 공용 Wi-Fi에서는 주의
• Preload sample dataset
  → MongoDB 샘플 데이터(100MB) 추가하여 테스트 가능
  → 초보자나 테스트용으로 유용, 실무에서는 필요 없을 수도 있음

 

7. 데이터베이스 사용자 생성 (Database User 생성)

• Username과 Password를 설정 후 기억해둔다.
• Create Database User 버튼 클릭하여 사용자 생성한다.
• 이 단계를 건너뛰고 바로 연결 방식을 선택하면 "Set up your user security permission below" 오류가 발생한다.

 

8. 연결 방법(Choose a Connection Method) 선택

• 클러스터 생성 후, Choose a Connection Method 클릭한다.

 

MongoDB Atlas 연결 방법 선택

• 연결 방식 선택 가능
  • Drivers: 애플리케이션(Node.js, Python 등)에서 MongoDB에 연결하는 드라이버
  • Compass: GUI 기반으로 MongoDB 데이터를 탐색하고 관리
  • Shell: 명령어(CLI)로 MongoDB 데이터를 추가/수정/삭제
  • MongoDB for VS Code: VS Code에서 MongoDB 데이터 조회 및 쿼리 실행
  • Atlas SQL: SQL로 MongoDB 데이터를 분석하고 시각화

 

9. MongoDB Compass 사용 준비

나는 MongoDB Compass를 사용 중이기 때문에 Compass 기준으로 설명하겠다.

• MongoDB Compass가 설치되지 않았다면 다운로드 및 설치한다.
• 설치된 경우 클러스터의 Connection URL을 복사한다.

 

10. MongoDB Compass에서 연결

• MongoDB Compass 실행 후 복사한 Connection URL 붙여넣는다.
• Connection URL의 <db_password> 부분에 설정해둔 Password를 입력하면 된다.
• Connect 버튼 클릭하여 데이터베이스에 연결한다.

 

Password 재설정 방법

비밀번호를 까먹거나 다시 설정하고 싶다면, Database Access에서 비밀번호를 변경할 수 있다.

 

 

Edit Password를 클릭한 후, 새 비밀번호를 입력하고 Update User를 클릭하면 된다.

 

 

 

 

프로젝트 삭제 방법

1. 먼저 Leave Project를 선택하여 프로젝트에서 나간다.

 

2. 프로젝트로 이동한 후, Clusters에서 Terminate를 선택한다.

 

설정된 클러스터 이름을 입력한 후, Terminate 버튼을 클릭한다.

 

3. 클러스터가 완전히 삭제되면, Projects에서 휴지통 아이콘이 활성화된다.

 

프로젝트 이름을 입력하고 Delete Project 버튼을 클릭하여 삭제한다.