Docker로 MongoDB Community 설치
이 페이지의 내용
공식 MongoDB Community 이미지를 사용하여 MongoDB Community 에디션을 Docker container로 실행할 수 있습니다. MongoDB 배포서버를 실행하기 위한 Docker 이미지는 다음과 같은 경우에 유용합니다.
신속한 배포서버 설치
구성 파일 관리 지원
여러 MongoDB 버전에서 다양한 기능을 테스트
이 작업에 관한 정보
이 페이지에서는 MongoDB Community Edition에 대한 Docker 설치 방법을 설명합니다. MongoDB Enterprise Docker 이미지 및 MongoDB Enterprise Kubernetes Operator는 프로덕션 배포에 권장되며 함께 사용해야 합니다. Enterprise용 지침은 Docker로 MongoDB Enterprise 설치를 참조하세요.
이 절차에서는 MongoDB에서 유지 관리하는 공식 MongoDB Community 이미지를 사용합니다.
Docker에 관한 전체적인 설명은 이 설명서의 범위를 벗어납니다. 이 페이지에서는 Docker에 대한 사전 지식이 있다고 가정합니다.
MongoDB 5.0+ Docker 이미지는 시스템에서 AVX 지원이 필요합니다. 시스템에서 AVX를 지원하지 않는 경우 버전 5.0 이전의 MongoDB의 Docker 이미지를 사용할 수 있습니다.
경고
5.0 이전의 MongoDB 버전은 단종되었으며 더 이상 MongoDB에서 지원되지 않습니다. 이러한 버전은 테스트 용도로만 사용해야 합니다.
시작하기 전에
절차
이미지를 컨테이너로 실행
docker run --name mongodb -p 27017:27017 -d mongodb/mongodb-community-server:latest
이 명령의 -p 27017:27017은 container 포트를 호스트 포트에 매핑합니다. 이렇게 하면 localhost:27017 연결 문자열을 사용하여 MongoDB에 연결할 수 있습니다.
특정 버전의 MongoDB를 설치하려면 Docker 실행 명령에서 : 뒷부분에 버전을 지정합니다. Docker는 지정된 버전을 가져와 실행합니다.
예를 들어 MongoDB 5.0을 실행하려면 다음을 실행합니다.
docker run --name mongodb -p 27017:27017 -d mongodb/mongodb-community-server:5.0-ubuntu2004
사용 가능한 버전의 전체 목록은 태그에서 확인 가능합니다.
참고
명령줄 옵션 추가
Docker 실행 명령에 명령줄 옵션을 추가하여 mongod 명령줄 옵션을 사용할 수 있습니다.
예를 들어 mongod --replSet Docker 명령줄 옵션을 생각할 수 있습니다.
docker run -p 27017:27017 -d mongodb/mongodb-community-server:latest --name mongodb --replSet myReplicaSet
컨테이너 실행 확인
Docker container의 상태를 확인하려면 다음 명령을 실행합니다.
docker container ls
ls 명령의 출력에는 실행 중인 container를 설명하는 다음 필드가 나열됩니다.
Container IDImageCommandCreatedStatusPortNames
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES c29db5687290 mongodb/mongodb-community-server:5.0-ubi8 "docker-entrypoint.s…" 4 seconds ago Up 3 seconds 27017/tcp mongo
배포서버 유효성 검사
MongoDB 인스턴스가 실행 중인지 확인하려면 Hello 명령을 실행합니다.
db.runCommand( { hello: 1 } )
이 명령의 결과는 mongod 배포서버를 설명하는 문서를 반환합니다.
{ isWritablePrimary: true, topologyVersion: { processId: ObjectId("63c00e27195285e827d48908"), counter: Long("0") }, maxBsonObjectSize: 16777216, maxMessageSizeBytes: 48000000, maxWriteBatchSize: 100000, localTime: ISODate("2023-01-12T16:51:10.132Z"), logicalSessionTimeoutMinutes: 30, connectionId: 18, minWireVersion: 0, maxWireVersion: 20, readOnly: false, ok: 1 }
다음 단계(선택 사항)
Cosign을 사용하여 컨테이너 이미지에 대한 MongoDB 서명을 확인할 수 있습니다.
이 절차는 선택 사항입니다. Docker 또는 기타 컨테이너화 플랫폼에서 MongoDB를 실행하기 위해 MongoDB의 서명을 확인하지 않아도 됩니다.
MongoDB의 container 서명을 확인하려면 다음 단계를 수행합니다.
Cosign 다운로드 및 설치
설치 지침은 Cosign GitHub 리포지토리에서 확인 가능합니다.