# MongoDB 시작하기: 컨테이너로 띄우고 첫 컬렉션에 문서 넣기

> MongoDB 7 컨테이너를 127.0.0.1에만 열어 띄우고, mongosh로 데이터베이스와 컬렉션을 만든 뒤 문서를 넣고 찾고 고치고 인덱스를 겁니다. 모든 명령과 출력은 이 실습 컨테이너에서 실행한 결과입니다.

- 주소: https://copyandrun.com/blog/mongodb-install-first-collection-insert/
- 분야: DevSecOps
- 발행일: 2026-11-14
- 태그: MongoDB, NoSQL, mongosh, Docker, 컬렉션

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. 컨테이너 띄우기

컨테이너 포트를 호스트의 루프백 주소에만 연결합니다. 기본 설치처럼 인증 없이 띄우는 실습이므로 이 주소 밖으로는 열지 않습니다.

```bash
docker run -d --name cr-mongo -p 127.0.0.1:27018:27017 mongo:7
docker exec cr-mongo mongod --version | head -1
```

```text
db version v7.0.48
```

## 2. 기본 데이터베이스 확인

```bash
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)'
```

```text
7.0.48
[ 'admin', 'config', 'local' ]
```

MongoDB에는 처음에 시스템 데이터베이스 세 개만 있습니다. 데이터베이스는 첫 문서를 넣을 때 만들어지므로, 다음 단계에서 `shopdb`가 생깁니다.

## 3. 문서 넣기

`shopdb`의 `products` 컬렉션에 문서 한 개를 넣은 다음 여러 개를 한꺼번에 넣습니다.

```bash
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}])'
```

```text
{ acknowledged: true, insertedId: ObjectId('6af81df3054c99755ba635de') }
{ acknowledged: true, insertedIds: { '0': ObjectId(...), '1': ObjectId(...) } }
```

`_id` 값은 넣을 때 자동으로 만들어집니다. `tags`처럼 문서마다 값의 개수가 다른 배열도 그대로 넣을 수 있습니다.

## 4. 찾기와 조건

```bash
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()'
```

```text
[
  { 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. 고치기와 세기

```bash
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}})'
```

```text
1
3
```

`$set`은 지정한 필드만 바꿉니다. 마우스 재고를 7로 고친 뒤 재고가 있는 상품은 3개가 됩니다.

## 6. 인덱스 만들기

이름으로 자주 찾는다면 인덱스를 만듭니다.

```bash
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()'
```

```text
name_1
[ '_id_', 'name_1' ]
[ 'products' ]
```

`_id_`는 MongoDB가 기본으로 만드는 인덱스이고, `name_1`이 방금 만든 인덱스입니다. `1`은 오름차순을 뜻합니다.

## 7. 확인 체크리스트

- [x] 컨테이너를 `127.0.0.1:27018`에만 연결해 띄우고 MongoDB 7.0.48을 확인했습니다.
- [x] 첫 문서를 넣기 전에는 `shopdb`가 없고, 넣은 뒤 `products` 컬렉션이 생긴 것을 확인했습니다.
- [x] 조건 검색으로 재고 0인 마우스와 10만 원 이상인 모니터가 빠지는 것을 확인했습니다.
- [x] `updateOne`으로 마우스 재고를 고치고 `countDocuments`가 3을 돌려주는 것을 확인했습니다.
- [x] `name` 인덱스가 만들어진 것을 `getIndexes`로 확인했습니다.
