Ubuntu에 MongoDB Community Edition 설치
이 페이지의 내용
개요
이 튜토리얼을 통해 apt
패키지 관리자를 사용하여 Ubuntu Linux 의 LTS(장기 지원 ) 릴리스에 MongoDB 8.0 Community Edition을 설치합니다.
MongoDB 버전
이 튜토리얼에서는 MongoDB 8 을(를) 설치합니다.0 Community Edition. 다른 버전의 MongoDB Community를 설치하려면 페이지 왼쪽 상단의 버전 드롭다운 메뉴에서 해당 버전에 대한 문서를 선택하세요.
고려 사항
플랫폼 지원
MongoDB 8.0 Community Edition은 x86_64 아키텍처에서 다음 64비트 Ubuntu LTS(장기 지원) 릴리스를 지원합니다.
24.04 LTS ('노블')
22.04 LTS ('Jammy')
20.04 LTS('Focal')
MongoDB는 이러한 플랫폼의 64비트 버전만 지원합니다. 호스트에서 실행 중인 Ubuntu 릴리스를 확인하려면 호스트의 터미널에서 다음 명령을 실행합니다.
cat /etc/lsb-release
Ubuntu의 MongoDB 8.0 Community Edition은 일부 플랫폼에서 ARM64 아키텍처도 지원합니다.
자세한 정보는 플랫폼 지원에서 확인할 수 있습니다.
프로덕션 정보
프로덕션 환경에 MongoDB를 배포하기 전에, 프로덕션 MongoDB 배포에 대한 성능 고려 사항 및 구성 권장 사항을 제공하는 자체 관리 배포서버에 대한 프로덕션 노트 문서를 고려하세요.
MongoDB 공식 패키지
이 지침에서는 Ubuntu 시스템에 MongoDB Community를 설치하기 위해 MongoDB Inc에서 유지 관리 및 지원하는 공식 mongodb-org
패키지를 사용합니다. 공식 mongodb-org
패키지에는 항상 최신 버전의 MongoDB가 포함되어 있으며 자체 전용 저장소에서 사용할 수 있습니다.
중요
Ubuntu에서 제공하는 mongodb
패키지는 MongoDB Inc.에서 유지 관리하지 않으며 공식 mongodb-org
패키지와 충돌합니다. Debian 시스템에 mongodb
패키지를 이미 설치했다면, 먼저 해당 mongodb
패키지를 제거한 후 본 지침을 진행합니다.
공식 패키지의 전체 목록은 MongoDB Community Edition 패키지 를 참조하세요.
MongoDB Community Edition 설치
다음 단계에 따라 apt
패키지 관리자를 사용하여 MongoDB Community Edition을 설치합니다.
목록 파일 만들기
사용 중인 Ubuntu 버전에 대한 목록 파일 /etc/apt/sources.list.d/mongodb-org-8.0.list
를 생성합니다.
Ubuntu 24.04 (Noble)에 대한 목록 파일을 생성합니다.
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
Ubuntu 22.04 (Jammy)의 목록 파일 을 만듭니다.
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
Ubuntu 20.04 (Focal)에 대한 목록 파일을 만듭니다.
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
MongoDB Community 서버 설치
MongoDB의 안정적인 최신 버전이나 특정 MongoDB 버전을 설치할 수 있습니다.
최신 스테이블 버전을 설치하려면 다음을 실행합니다.
sudo apt-get install -y mongodb-org
특정 릴리스를 설치하려면 다음 예시와 같이 각 구성 요소 패키지를 개별적으로 지정하고 패키지 이름에 버전 번호를 추가합니다.
sudo apt-get install -y mongodb-org=8.0.0 mongodb-org-database=8.0.0 mongodb-org-server=8.0.0 mongodb-mongosh=8.0.0 mongodb-org-mongos=8.0.0 mongodb-org-tools=8.0.0
mongodb-org=8.0.0
만 설치하고 구성 요소 패키지를 포함하지 않으면 지정한 버전에 관계없이 각 MongoDB 패키지의 최신 버전이 설치됩니다.
선택 사항입니다. 이용 가능한 모든 MongoDB 버전을 지정할 수 있지만 최신 버전을 사용할 수 있는 경우 apt-get
이 패키지를 업그레이드합니다. 의도하지 않은 업그레이드를 방지하려면 현재 설치된 버전으로 패키지를 고정할 수 있습니다.
echo "mongodb-org hold" | sudo dpkg --set-selections echo "mongodb-org-database hold" | sudo dpkg --set-selections echo "mongodb-org-server hold" | sudo dpkg --set-selections echo "mongodb-mongosh hold" | sudo dpkg --set-selections echo "mongodb-org-mongos hold" | sudo dpkg --set-selections echo "mongodb-org-tools hold" | sudo dpkg --set-selections
Ubuntu에 MongoDB 설치 중 오류가 발생하여 도움이 필요하면 문제 해결 가이드를 확인합니다.
MongoDB Community Edition 실행
ulimit 고려 사항
대부분의 Unix 계열 운영 체제는 프로세스 가 사용할 수 있는 시스템 리소스를 제한합니다. 이러한 제한은 MongoDB 작업에 부정적인 영향 수 있으므로 조정해야 합니다. 플랫폼에 권장 되는 설정은 자체 관리 배포서버를 위한 UNIX ulimit
설정을 참조하세요.
참고
열려 있는 파일 수의 ulimit
값이 64000
미만인 경우 MongoDB가 시작 경고를 생성합니다.
디렉토리
패키지 관리자를 통해 설치한 경우 설치 과정에서 데이터 디렉토리 /var/lib/mongodb
및 로그 디렉토리 /var/log/mongodb
가 생성됩니다.
기본적으로 MongoDB는 mongodb
사용자 계정을 사용하여 실행됩니다. MongoDB 프로세스를 실행하는 사용자를 변경하는 경우 해당 사용자가 액세스할 수 있도록 데이터 및 로그 디렉토리에 대한 권한도 반드시 수정해야 합니다.
구성 파일
공식 MongoDB 패키지에는 구성 파일(/etc/mongod.conf
)이 포함되어 있습니다. 이러한 설정(예: 데이터 디렉토리 및 로그 디렉토리 사양)은 시작 시 적용됩니다. 즉, MongoDB 인스턴스가 실행 중인 상태에서 구성 파일을 변경하는 경우 변경 사항을 적용하려면 인스턴스를 다시 시작해야 합니다.
절차
다음 단계에 따라 시스템에서 MongoDB Community Edition을 실행합니다. 이 지침에서는 Ubuntu에서 제공하는 비공식 mongodb
패키지가 아닌 공식 mongodb-org
패키지를 사용 중이며 기본 설정을 사용하고 있다고 가정합니다.
init 시스템
mongod
을 실행하고 관리하기 위해 운영 체제에 내장된 init 시스템을 사용하게 됩니다. 최신 버전의 Linux는 systemctl
명령을 사용하는 systemd를 사용하는 경향이 있는 반면, 구버전은 service
명령을 사용하는 System V init를 주로 사용합니다.
플랫폼에서 사용하는 init 시스템을 정확히 알 수 없다면 다음 명령을 실행합니다.
ps --no-headers -o comm 1
이후 결과에 따라 아래에서 적절한 탭을 선택합니다.
systemd
- 아래의 systemd(systemctl) 탭을 선택합니다.init
- 아래의 System V Init(서비스) 탭을 선택합니다.
MongoDB를 중지합니다.
필요에 따라 다음 명령을 실행하여 mongod
프로세스를 중지할 수 있습니다.
sudo systemctl stop mongod
MongoDB를 다시 시작합니다.
다음 명령을 실행하여 mongod
프로세스를 다시 시작할 수 있습니다:
sudo systemctl restart mongod
/var/log/mongodb/mongod.log
파일의 출력을 확인하여 오류나 중요한 메시지에 대한 프로세스 상태를 따를 수 있습니다.
MongoDB 사용을 시작합니다.
mongod
와 동일한 호스트 머신에서 mongosh
세션을 시작합니다. 명령줄 옵션 없이 mongosh
를 실행하여 기본 포트 27017에서 localhost에서 실행 중인 mongod
에 연결할 수 있습니다.
mongosh
다른 호스트 및/또는 포트에서 실행하는 mongod
인스턴스에 연결하는 등 mongosh
(을)를 사용하여 연결하는 방법에 대한 자세한 내용은 mongosh 문서를 참조하세요.
MongoDB는 사용을 시작하는 데 도움이 되도록 다양한 드라이버 에디션에 대해 시작 가이드를 제공합니다. 드라이버 설명서는 MongoDB로 개발 시작하기를 참조하세요.
MongoDB를 시작합니다.
다음 명령을 실행해 mongod
을(를) 시작합니다.
sudo service mongod start
MongoDB를 중지합니다.
필요에 따라 다음 명령을 실행하여 mongod
프로세스를 중지할 수 있습니다.
sudo service mongod stop
MongoDB를 다시 시작합니다.
다음 명령을 실행해 mongod
을(를) 다시 시작합니다.
sudo service mongod restart
MongoDB 사용을 시작합니다.
mongod
와 동일한 호스트 머신에서 mongosh
세션을 시작합니다. 명령줄 옵션 없이 mongosh
를 실행하여 기본 포트 27017에서 localhost에서 실행 중인 mongod
에 연결할 수 있습니다.
mongosh
다른 호스트 및/또는 포트에서 실행하는 mongod
인스턴스에 연결하는 등 mongosh
(을)를 사용하여 연결하는 방법에 대한 자세한 내용은 mongosh 문서를 참조하세요.
MongoDB는 사용을 시작하는 데 도움이 되도록 다양한 드라이버 에디션에 대해 시작 가이드를 제공합니다. 드라이버 설명서는 MongoDB로 개발 시작하기를 참조하세요.
MongoDB Community Edition 제거
시스템에서 MongoDB를 완전히 제거하려면 MongoDB 애플리케이션 자체와 구성 파일 및 데이터와 로그가 포함된 모든 디렉토리를 제거해야 합니다. 다음 섹션에서는 필요한 단계를 안내합니다.
경고
이 프로세스는 MongoDB와 그 구성, 모든 데이터베이스를 완전히 제거합니다. 이 프로세스는 되돌릴 수 없으므로 모든 구성과 데이터의 백업 여부를 확인한 이후에 진행해야 합니다.
MongoDB를 중지합니다.
다음 명령을 실행하여 mongod
프로세스를 중지합니다.
sudo service mongod stop
추가 정보
기본 로컬 호스트 바인딩
기본적으로 MongoDB는 bindIp
를 로컬 호스트 네트워크 인터페이스에 바인딩하는 127.0.0.1
로 설정하여 실행됩니다. 즉, mongod
는 동일한 시스템에서 실행 중인 클라이언트의 연결만 허용할 수 있습니다. 원격 클라이언트는 mongod
에 연결할 수 없으며, 이 값이 유효한 네트워크 인터페이스로 설정되어 있지 않으면 mongod
는 복제본 세트 를 초기화할 수 없습니다.
이 값은 다음 중 한 가지 방법으로 구성할 수 있습니다.
경고
공개적으로 액세스할 수 있는 IP 주소에 인스턴스를 바인딩하기 전에 무단 액세스로부터 클러스터를 보호해야 합니다. 보안 권장 사항의 전체 목록은 자체 관리 배포서버를 위한 보안 체크리스트를 참조하세요. 최소한 인증을 활성화 하고 네트워크 인프라를 강화하는 것을 고려하세요.
bindIp
구성에 대한 자세한 내용 은 자체 관리 배포서버의 IP 바인딩을 참조하세요.
MongoDB Community Edition 패키지
MongoDB Community Edition은 자체 전용 리포지토리에서 사용할 수 있으며 다음과 같은 공식 지원 패키지를 포함합니다.
패키지 이름 | 설명 | ||||||
---|---|---|---|---|---|---|---|
mongodb-org | metapackage 는 아래 나열된 구성요소 패키지를 자동으로 설치합니다. | ||||||
mongodb-org-database | |||||||
mongodb-mongosh | MongoDB Shell( mongosh )을 포함합니다. | ||||||
mongodb-org-tools |
|