MongoDB 설치 및 설정 가이드
1. MongoDB 설치
Windows
- MongoDB 설치 파일 다운로드
- MongoDB 공식 웹사이트에서 설치 파일을 다운로드합니다: MongoDB 다운로드 센터
- 설치 파일 실행
- 다운로드한 설치 파일을 실행하고 설치 과정을 따릅니다.
- 설치 시 “Complete” 설치 옵션을 선택합니다.
- “Install MongoDB as a Service” 옵션을 선택하여 MongoDB를 서비스로 실행되도록 설정합니다.
- 환경 변수 설정
- MongoDB의
bin
디렉토리를 시스템 환경 변수PATH
에 추가합니다. (기본 설치 경로:C:\Program Files\MongoDB\Server\X.X\bin
)
- MongoDB의
- MongoDB 서비스 시작
- Windows 서비스 관리 도구에서 MongoDB 서비스를 시작합니다.
macOS
- Homebrew로 MongoDB 설치
- Homebrew가 설치되어 있지 않다면 Homebrew 웹사이트를 참조하여 설치합니다.
- 터미널을 열고 다음 명령어를 입력하여 MongoDB를 설치합니다.bash코드 복사
brew tap mongodb/brew brew install mongodb-community@6.0
- MongoDB 서비스 시작
- 다음 명령어를 입력하여 MongoDB 서비스를 시작합니다.bash코드 복사
brew services start mongodb/brew/mongodb-community
- 다음 명령어를 입력하여 MongoDB 서비스를 시작합니다.bash코드 복사
Linux (Ubuntu)
- MongoDB 패키지 관리용 GPG 키 추가bash코드 복사
wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
- MongoDB 리포지토리 추가bash코드 복사
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
- MongoDB 설치bash코드 복사
sudo apt update sudo apt install -y mongodb-org
- MongoDB 서비스 시작bash코드 복사
sudo systemctl start mongod
2. MongoDB 설정
- MongoDB 설정 파일 수정 (선택 사항)
- 기본 설정으로 충분하지 않은 경우 설정 파일 (
/etc/mongod.conf
)을 수정할 수 있습니다. - 설정 파일의 기본 위치는 다음과 같습니다.
- Windows:
C:\Program Files\MongoDB\Server\X.X\bin\mongod.cfg
- macOS:
/usr/local/etc/mongod.conf
- Linux:
/etc/mongod.conf
- Windows:
- 기본 설정으로 충분하지 않은 경우 설정 파일 (
- MongoDB 서비스 재시작
- 설정 파일을 수정한 경우 MongoDB 서비스를 재시작합니다.
sudo systemctl restart mongod
3. MongoDB 연결
- MongoDB Compass 설치 (선택 사항)
- GUI로 MongoDB를 관리하기 위해 MongoDB Compass를 설치할 수 있습니다: MongoDB Compass 다운로드
- MongoDB 연결 테스트
- 터미널에서 다음 명령어를 입력하여 MongoDB 셸에 접속할 수 있는지 확인합니다.
mongo
4. Node.js 애플리케이션과 MongoDB 연결
- MongoDB Node.js 드라이버 설치
- 프로젝트 루트 디렉토리에서 다음 명령어를 입력하여 MongoDB Node.js 드라이버를 설치합니다.
npm install mongoose
- MongoDB 연결 설정 (backend/app.js)
- backend/app.js 파일에서 MongoDB에 연결하는 코드를 작성합니다.
const express = require('express'); const mongoose = require('mongoose'); const bodyParser = require('body-parser'); const cors = require('cors'); const app = express(); require('dotenv').config(); // Middleware app.use(bodyParser.json()); app.use(cors()); // MongoDB 연결 mongoose.connect(process.env.MONGO_URI, { useNewUrlParser: true, useUnifiedTopology: true, }).then(() => { console.log('MongoDB connected'); }).catch((err) => { console.error('MongoDB connection error:', err); }); // 라우트 설정 const userRoutes = require('./routes/userRoutes'); const bookRoutes = require('./routes/bookRoutes'); const transactionRoutes = require('./routes/transactionRoutes'); app.use('/api/users', userRoutes); app.use('/api/books', bookRoutes); app.use('/api/transactions', transactionRoutes); // 서버 시작 const PORT = process.env.PORT || 5000; app.listen(PORT, () => console.log(`Server running on port ${PORT}`));
- 환경 변수 설정 (.env 파일)
- 프로젝트 루트 디렉토리에
.env
파일을 생성하고 MongoDB 연결 문자열을 추가합니다.
MONGO_URI=mongodb://localhost:27017/your_projec_name JWT_SECRET=your_jwt_secret
- 프로젝트 루트 디렉토리에
- 백엔드 서버 실행
- 백엔드 서버를 시작하여 MongoDB와의 연결을 확인합니다.
cd backend node app.js
5. MongoDB 연결 확인
- 서버 로그 확인
- 서버가 시작되면서 “MongoDB connected” 메시지가 출력되는지 확인합니다.
- 데이터베이스 확인
- MongoDB 셸 또는 MongoDB Compass를 사용하여
y
데이터베이스가 생성되었는지 확인합니다.our_projec_name
- MongoDB 셸 또는 MongoDB Compass를 사용하여
이 과정을 통해 MongoDB를 설치하고 설정하여 Node.js 애플리케이션과 연결할 수 있습니다. MongoDB와의 연결이 성공적으로 이루어지면, 데이터 모델을 정의하고 CRUD 작업을 수행할 수 있습니다.