MongoDB는 데이터를 표의 행 대신 JSON과 비슷한 문서(document)로 저장합니다. 문서가 모인 곳이 컬렉션(collection)이고, 컬렉션이 모인 곳이 데이터베이스입니다. 이 글에서는 컨테이너로 MongoDB 7을 띄우고, 상품 문서를 넣어 찾고 고치는 기본 순서를 실행합니다.
준비물
| 항목 | 내용 |
|---|---|
| Docker | Docker Desktop 29.5.3 |
| 이미지 | mongo:7 (MongoDB 7.0.48) |
| 셸 | 컨테이너 안의 mongosh |
| 포트 | 127.0.0.1:27018에만 연결 (외부 노출 없음) |
| 예상 소요 시간 | 약 20분 |
1. 컨테이너 띄우기
컨테이너 포트를 호스트의 루프백 주소에만 연결합니다. 기본 설치처럼 인증 없이 띄우는 실습이므로 이 주소 밖으로는 열지 않습니다.
docker run -d --name cr-mongo -p 127.0.0.1:27018:27017 mongo:7
docker exec cr-mongo mongod --version | head -1
db version v7.0.48
2. 기본 데이터베이스 확인
docker exec cr-mongo mongosh --quiet --eval 'db.version()'
docker exec cr-mongo mongosh --quiet --eval 'db.adminCommand({listDatabases:1}).databases.map(d=>d.name)'
7.0.48
[ 'admin', 'config', 'local' ]
MongoDB에는 처음에 시스템 데이터베이스 세 개만 있습니다. 데이터베이스는 첫 문서를 넣을 때 만들어지므로, 다음 단계에서 shopdb가 생깁니다.
3. 문서 넣기
shopdb의 products 컬렉션에 문서 한 개를 넣은 다음 여러 개를 한꺼번에 넣습니다.
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.insertOne({name:"keyboard", price:39000, tags:["usb"], stock:12})'
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.insertMany([{name:"mouse", price:19000, tags:["usb","wireless"], stock:0},{name:"monitor", price:189000, tags:["hdmi"], stock:4}])'
{ acknowledged: true, insertedId: ObjectId('6af81df3054c99755ba635de') }
{ acknowledged: true, insertedIds: { '0': ObjectId(...), '1': ObjectId(...) } }
_id 값은 넣을 때 자동으로 만들어집니다. tags처럼 문서마다 값의 개수가 다른 배열도 그대로 넣을 수 있습니다.
4. 찾기와 조건
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.find({}, {_id:0, name:1, price:1, stock:1}).toArray()'
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.find({stock:{$gt:0}, price:{$lt:100000}}, {_id:0,name:1}).toArray()'
[
{ name: 'keyboard', price: 39000, stock: 12 },
{ name: 'mouse', price: 19000, stock: 0 },
{ name: 'monitor', price: 189000, stock: 4 }
]
[ { name: 'keyboard' } ]
두 번째 명령은 재고가 0보다 크고 가격이 10만 원 미만인 상품을 찾습니다. 마우스는 재고가 0이라 빠지고, 모니터는 10만 원을 넘어 빠집니다. {_id:0, ...}는 결과에서 _id를 숨기는 옵션입니다.
5. 고치기와 세기
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.updateOne({name:"mouse"},{$set:{stock:7}}).modifiedCount'
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.countDocuments({stock:{$gt:0}})'
1
3
$set은 지정한 필드만 바꿉니다. 마우스 재고를 7로 고친 뒤 재고가 있는 상품은 3개가 됩니다.
6. 인덱스 만들기
이름으로 자주 찾는다면 인덱스를 만듭니다.
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.createIndex({name:1})'
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.products.getIndexes().map(i=>i.name)'
docker exec cr-mongo mongosh --quiet shopdb --eval 'db.getCollectionNames()'
name_1
[ '_id_', 'name_1' ]
[ 'products' ]
_id_는 MongoDB가 기본으로 만드는 인덱스이고, name_1이 방금 만든 인덱스입니다. 1은 오름차순을 뜻합니다.
7. 확인 체크리스트
- 컨테이너를
127.0.0.1:27018에만 연결해 띄우고 MongoDB 7.0.48을 확인했습니다. - 첫 문서를 넣기 전에는
shopdb가 없고, 넣은 뒤products컬렉션이 생긴 것을 확인했습니다. - 조건 검색으로 재고 0인 마우스와 10만 원 이상인 모니터가 빠지는 것을 확인했습니다.
-
updateOne으로 마우스 재고를 고치고countDocuments가 3을 돌려주는 것을 확인했습니다. -
name인덱스가 만들어진 것을getIndexes로 확인했습니다.
이 글의 다음 단계
- MongoDB 인증 없는 기본 설치 점검: 다른 컨테이너에서 읽고 쓰기 확인인증 옵션 없이 띄운 MongoDB 7 컨테이너에 다른 컨테이너가 호스트 포트로 접속해 데이터베이스 목록을 보고, 문서를 읽고, 쓰고, 지울 수 있는지 확인합니다. 서버 설정과 접속 상태로 인증이 꺼져 있다는 근거를 모읍니다.
- MongoDB 공개 노출 점검: 0.0.0.0 포트 게시와 127.0.0.1 차이 확인같은 MongoDB 이미지를 두 가지 게시 방식으로 띄워 소켓 상태와 접속 결과를 비교합니다. 호스트의 모든 주소에 열린 포트는 LAN 주소로 접속되고, 루프백에만 게시한 포트는 거절되는 것을 확인하고, 점검 명령으로 노출 여부를 찾습니다.
이 내용을 팀 교육으로 진행하고 싶으신가요?
인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.
교육 문의하기메일로 보내실 수도 있습니다: fankh111@gmail.com