『 웹에서 시작하는 MongoDB Atlas 실전 연동 가이드 』 강의안

MongoDB Atlas로 웹에서 MongoDB 연결하기

MongoDB Atlas란?

MongoDB Atlas는 MongoDB 공식 클라우드 서비스로, 별도 설치 없이 웹에서 데이터베이스를 생성하고 관리할 수 있습니다. 로컬 환경보다 안정적이고, 협업이나 배포에도 적합해 실무에서도 널리 사용됩니다.

사용 위치

• 로컬에 MongoDB 설치 없이 빠르게 실습 환경 구성할 때
• 프론트엔드/백엔드 개발자가 데이터베이스를 웹에 연결해야 할 때
• 팀 프로젝트에서 데이터 공유가 필요할 때
  
  

MongoDB Atlas 연결 절차

1단계 – MongoDB Atlas 가입 및 클러스터 생성

1. MongoDB Atlas 접속
2. 계정 생성 또는 소셜 로그인(Google, GitHub 등)
3. "Shared" → Free Tier 선택
4. 클러스터 이름 지정 → 지역 선택(예: AWS 서울 or AWS Virginia) → Create

2단계 – DB 사용자 생성

• 왼쪽 메뉴 Database Access > Add New Database User
• 사용자 이름과 비밀번호 설정
• Role은 기본 readWriteAnyDatabase 유지

3단계 – 네트워크 접근 설정

• 왼쪽 메뉴 Network Access > Add IP Address
• 개발용: 0.0.0.0/0 (모든 IP 허용)
• 보안이 중요할 경우 현재 IP만 등록

4단계 – 연결 정보 복사

1. 클러스터 > Connect
2. "Connect your application" 선택
3. Connection String 복사

예시:

mongodb+srv://<username>:<password>@cluster0.xxxxxx.mongodb.net/myDatabase?retryWrites=true&w=majority

Node.js 백엔드에 MongoDB Atlas 연동하기

예시: Mongoose 사용

// server/db/mongoose.js
import mongoose from 'mongoose';

const connectDB = async () => {
  try {
    await mongoose.connect('mongodb+srv://<username>:<password>@cluster0.xxxxxx.mongodb.net/myDatabase', {
      useNewUrlParser: true,
      useUnifiedTopology: true,
    });
    console.log('MongoDB Atlas 연결 성공');
  } catch (err) {
    console.error('MongoDB 연결 실패:', err.message);
  }
};

export default connectDB;

// server/index.js
import express from 'express';
import connectDB from './db/mongoose.js';

const app = express();
connectDB();

app.listen(3000, () => {
  console.log('서버 실행 중: http://localhost:3000');
});

부가 팁

Atlas에서 데이터 직접 확인하는 법

• 클러스터 → Browse Collections 메뉴에서 문서 확인 및 직접 추가 가능

Atlas의 한계 (Free Tier 기준)

• 최대 512MB 저장 공간
• 100개 동시 연결 제한
• 하루 약 100MB 전송량

강좌 회차 구성 (총 5회)

1회차 – MongoDB Atlas 소개와 계정 생성

• MongoDB란? 로컬 vs 클라우드 비교
• Atlas 플랫폼 소개
• 계정 생성 및 클러스터 생성 과정 안내
• Free Tier의 장단점

2회차 – 사용자 권한 설정과 IP 접근 허용

• DB 사용자 생성 (readWrite 권한)
• 비밀번호 설정 주의사항
• IP Whitelist 설정 방법 (0.0.0.0/0 vs 개인 IP)

3회차 – 연결 문자열 복사와 테스트

• 연결 URL 구성 분석
• 각 구성 요소의 의미 (username, password, 클러스터주소, DB명 등)
• MongoDB Compass 또는 VS Code MongoDB 확장으로 연결 테스트

4회차 – Node.js + Mongoose로 연결 실습

• Express 서버 기본 구조
• mongoose로 연결 코드 작성 및 연결 테스트
• Atlas에서 실제 데이터 확인

5회차 – 데이터 삽입/조회/삭제 테스트 (CRUD 실습)

• insertOne, find, deleteOne, updateOne 등 기본 CRUD 실습
• Atlas에서 데이터가 실시간 반영되는지 확인
• 에러 발생 시 디버깅 팁

단계 요약

• 계정 생성과 클러스터 만들기
• 사용자 생성 및 IP 허용 설정
• 연결 문자열 복사하여 코드에 삽입
• Node.js 또는 프론트엔드 프로젝트에서 연결 테스트
• Atlas를 이용한 CRUD 실습까지 마무리

MongoDB Atlas는 실습과 배포에 매우 적합한 클라우드 DB 플랫폼입니다. 특히 데이터베이스 설치에 익숙하지 않은 개발자에게 큰 도움을 줍니다.

 

💬 댓글

이번 글이 도움이 되었길 바랍니다. 궁금한 점이나 요청이 있다면 언제든 댓글로 남겨주세요. 댓글은 저에게 큰 힘이 됩니다. 다음 글도 기대해주세요.