설치 mongosh
전제 조건
MongoDB Shell을 사용하려면 연결할 MongoDB deployment가 있어야 합니다.
무료 클라우드 호스팅 배포서버의 경우 MongoDB Atlas를 사용할 수 있습니다.
로컬 MongoDB 배포서버를 실행하는 방법을 알아보려면 MongoDB 설치를 참조하세요.
지원되는 MongoDB 버전
MongoDB Shell을 사용하여 4.2 이상 버전의 MongoDB에 연결할 수 있습니다.
지원되는 운영 체제
이러한 운영 체제에서 MongoDB Shell 2.0.0을 설치할 수 있습니다.
운영 체제 | 지원되는 버전 |
---|---|
macOS | 11+(x64 및 ARM64) |
Microsoft Windows | Microsoft Windows 서버 2016+ Microsoft Windows 10+ |
Linux | Red Hat 엔터프라이즈 Linux(RHEL) 8+ (x64, ARM64, ppc64le, 및 s390x) Ubuntu 20.04+ (x64 and ARM64) Amazon Linux 2023 (x64 and ARM64) Amazon Linux 2 (x64 and ARM64) Debian 11+ SLES 15 Oracle Linux 8+ running the Red Hat Compatible Kernel (RHCK). MongoDB Shell does not support the Unbreakable Enterprise Kernel (UEK). |
호환성 고려 사항
mongosh
2.0.0부터 시작.
Amazon Linux 1, Debian 9 및 macOS 10.14는 지원되지 않습니다.
Red Hat Enterprise Linux(RHEL) 7, Amazon Linux 2, SUSE Linux Enterprise Server(SLES) 12 및 Ubuntu 18.04는 더 이상 지원되지 않으며 이후
mongosh
릴리스에서 제거될 수 있습니다.Node.js
16을mongosh
와 함께 사용해야 한다면Node.js
를 먼저 설치한 후npm
을 통해mongosh
를 설치합니다.npm
을 통해 설치된mongosh
를 실행하고Node.js
16을 사용하는 기능은mongosh
2.x의 수명 기간 내에 제거될 수 있습니다.
절차
운영 체제에 맞는 탭을 선택합니다.
참고
Windows에서는 mongosh
설정 및 구성 옵션이 %APPDATA%/mongodb/mongosh
디렉토리에 저장됩니다.
MSI에서 설치
MongoDB Shell 다운로드 페이지를 엽니다.
MongoDB 다운로드 센터를 엽니다.
.zip
파일에서 설치
MongoDB Shell 다운로드 페이지를 엽니다.
MongoDB 다운로드 센터를 엽니다.
운영 체제에 맞는 mongosh
설치 아카이브를 다운로드합니다.
MongoDB 다운로드 센터에서 mongosh
을(를) 다운로드합니다.
PATH
환경 변수에 mongosh
바이너리를 추가합니다.
추출한 MongoDB Shell 바이너리가 파일 시스템에서 원하는 위치에 있는지 확인한 다음, 해당 위치를 PATH
환경 변수에 추가합니다.
PATH
환경 변수에 MongoDB Shell 바이너리의 위치를 추가하려면 다음을 따르세요.
Control Panel을(를) 엽니다.
System and Security 카테고리에서 System을(를) 클릭합니다.
Advanced system settings를 클릭합니다. 시스템 속성 모달이 표시됩니다.
Environment Variables를 클릭합니다.
시스템 변수 섹션에서
Path
을(를) 선택하고 Edit을(를) 클릭합니다. 환경 변수 편집 모달이 표시됩니다.New를 클릭하고
mongosh
바이너리에 파일 경로를 추가합니다.OK을 클릭하여 변경 사항을 확인합니다. 다른 모달에서 OK을 클릭하여 변경 사항을 확인합니다.
PATH
환경 변수가 mongosh
을(를) 찾도록 올바르게 구성되었는지 확인하려면 명령 프롬프트를 열고 mongosh --help
명령을 입력합니다. PATH
이(가) 올바르게 구성되었으면 유효한 명령 목록이 표시됩니다.
Homebrew로 설치
중요
Homebrew의 전체 시스템 요구 사항 목록을 보려면 Homebrew 웹 사이트를 참조하세요.
Homebrew 패키지 관리자는 macOS에서 mongosh
에 대해 권장되는 설치 방법입니다. 대신 아카이브에서 mongosh
를 수동으로 설치하는 방법을 알아보려면 .zip
파일에서 설치를 참조하세요.
고려 사항
Homebrew와 함께 설치된 mongosh
은(는) 자동 클라이언트 사이드 필드 레벨 암호화를 지원하지 않습니다.
절차
Homebrew로 mongosh
를 설치하려면 다음을 수행합니다.
Homebrew를 설치합니다.
macOS에 Homebrew를 설치하는 단계는 Homebrew 웹사이트를 참조하세요.
.zip
파일에서 설치
다운로드한 .zip
파일을 사용하여 mongosh
을(를) 수동으로 설치하려면 다음을 수행합니다.
MongoDB Shell 다운로드 페이지를 엽니다.
MongoDB 다운로드 센터를 엽니다.
다운로드한 아카이브에서 파일을 추출합니다.
Go mongosh
.zip
아카이브가 포함된 디렉토리로 다음 .zip
파일의 압축을 풉니다.
컴퓨터가 인텔 기반인 경우 다음을 실행합니다.
unzip mongosh-2.3.8-darwin-x64.zip
컴퓨터가 ARM 기반(M1 또는 M2)인 경우 다음을 실행합니다.
unzip mongosh-2.3.8-darwin-arm64.zip
압축을 푼 아카이브에는 bin
폴더에 두 개의 파일, mongosh
및 mongosh_crypt_v1.dylib
이 들어 있습니다.
웹 브라우저가 다운로드의 일부로 아카이브를 자동으로 추출하거나 unzip
명령을 사용하지 않고 아카이브를 추출하는 경우 바이너리를 실행 파일로 만들어야 할 수 있습니다.
바이너리를 실행 파일로 만들려면 아카이브를 추출한 디렉토리에서 다음 명령을 실행합니다.
chmod +x bin/mongosh
다운로드한 바이너리를 PATH
환경 변수에 추가합니다.
둘 중 하나를 수행하면 됩니다.
mongosh
바이너리를PATH
변수에 나열된 디렉토리(예:/usr/local/bin
)에 복사합니다. 다운로드 파일을 추출한 디렉토리에서 다음 명령을 실행합니다.sudo cp mongosh /usr/local/bin/ sudo cp mongosh_crypt_v1.so /usr/local/lib/ MongoDB Shell
에 대한 심볼릭 링크를 생성합니다..tgz
아카이브에서 파일을 추출한 디렉토리로 전환합니다. 다음 명령을 실행하여PATH
에 이미 있는 디렉토리(예:/usr/local/bin
)에 대한 링크를 생성합니다.sudo ln -s $(pwd)/bin/* /usr/local/bin/
아래 탭에서 Linux 배포판과 원하는 패키지에 따라 적절한 탭을 선택합니다.
Ubuntu 22.04(Jammy), Ubuntu 20.04(Focal), Ubuntu 18.04(Bional) 또는 Debian에
.deb
패키지를 설치하려면.deb
탭을 클릭합니다.RHEL, Amazon Linux 2023 또는 Amazon Linux 2에
.rpm
패키지를 설치하려면.rpm
탭을 클릭합니다..tgz
tarball 파일을 설치하려면.tgz
탭을 클릭합니다.
지원 플랫폼
mongosh
는 다음 플랫폼에서 PPA로 사용할 수 있습니다.
Ubuntu 24.04 (Noble Numbat)
Ubuntu 22.04 (Jammy)
Ubuntu 20.04 (Focal)
Ubuntu 18.04 (Bion)
절차
패키지 관리 시스템에서 사용하는 공개 키를 가져옵니다.
터미널에서 다음 명령을 실행하여 https://www.mongodb.org/static/pgp/server-80.asc에서 MongoDB 공용 GPG 키를 가져옵니다.
wget -qO- https://www.mongodb.org/static/pgp/server-8.0.asc | sudo tee /etc/apt/trusted.gpg.d/server-8.0.asc
이전 명령은 GPG 키를 시스템의 /etc/apt/trusted.gpg.d
폴더에 기록하고 키를 터미널에 인쇄합니다. 출력된 키는 단말기에 복사하거나 저장할 필요가 없습니다.
gnupg
이(가) 설치되지 않았다는 오류를 수신하면 다음 단계를 수행하세요.
다음 명령을 사용하여
gnupg
및 필수 라이브러리를 설치합니다.sudo apt-get install gnupg 키 가져오기를 다시 시도합니다.
wget -qO- https://www.mongodb.org/static/pgp/server-8.0.asc | sudo tee /etc/apt/trusted.gpg.d/server-8.0.asc
MongoDB에 대한 목록 파일을 생성합니다.
사용 중인 Ubuntu 버전에 대한 목록 파일 /etc/apt/sources.list.d/mongodb-org-8.0.list
를 생성합니다.
사용 중인 Ubuntu 버전에 맞는 탭을 클릭합니다. 호스트에서 실행 중인 Ubuntu 버전을 잘 모르는 경우 호스트에서 터미널 또는 shell을 열고 lsb_release -dc
을 실행합니다.
다음 지침은 24.04Ubuntu(Noble Numbat)에 대한 지침입니다. 다른 Ubuntu 릴리스의 경우 해당 탭 을 클릭합니다.
Ubuntu 24.04 (Noble Numbat)용 /etc/apt/sources.list.d/mongodb-org-8.0.list
파일 을 만듭니다.
echo "deb [ arch=amd64,arm64 ] 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) 에 적용됩니다. 다른 Ubuntu 릴리스의 경우 해당 탭을 클릭합니다.
Ubuntu 22.04(Jammy)용 /etc/apt/sources.list.d/mongodb-org-8.0.list
파일을 만듭니다.
echo "deb [ arch=amd64,arm64 ] 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(포컬)용입니다. 다른 Ubuntu 릴리스의 경우 해당 탭을 클릭하세요.
Ubuntu 20.04(Focal)용 /etc/apt/sources.list.d/mongodb-org-8.0.list
파일을 만듭니다.
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
다음 지침은 Ubuntu 18.04(바이오닉) 에 대한 것입니다. 다른 Ubuntu 릴리스의 경우 해당 탭을 클릭하세요.
Ubuntu 18.04(Bonic)용 /etc/apt/sources.list.d/mongodb-org-8.0.list
파일을 만듭니다.
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
mongosh
패키지를 설치합니다.
mongosh
OpenSSL을 지원합니다. 시스템의 OpenSSL 설치를 사용하도록 mongosh
를 구성할 수도 있습니다.
포함된 OpenSSL 라이브러리를 사용하여 mongosh
의 최신 안정 버전을 설치하려면 다음을 수행합니다.
sudo apt-get install -y mongodb-mongosh
OpenSSL 1.1 라이브러리와 함께 mongosh
을(를) 설치하려면 다음을 수행합니다.
sudo apt-get install -y mongodb-mongosh-shared-openssl11
OpenSSL 3.0 라이브러리와 함께 mongosh
을(를) 설치하려면 다음을 수행합니다.
sudo apt-get install -y mongodb-mongosh-shared-openssl3
지원 플랫폼
mongosh
는 다음 플랫폼에서 yum
패키지로 제공됩니다.
RHEL
Amazon Linux 2023
Amazon Linux 2
절차
패키지 관리 시스템(yum
)을 구성합니다.
yum
을(를) 사용하여 mongosh
을(를) 직접 설치할 수 있도록 /etc/yum.repos.d/mongodb-org-8.0.repo
파일을 만듭니다.
RHEL 및 Amazon Linux에는 .rpm
배포판이 있습니다.
탭을 선택하여 배포할 파일을 선택합니다.
탭의 내용을 복사합니다.
내용을
.repo
파일에 붙여넣습니다.
[mongodb-org-8.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/8.0/$basearch/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-8.0.asc
MongoDB 리포지토리에서 .rpm
파일을 직접 다운로드할 수도 있습니다. 다운로드는 다음 순서로 구성됩니다.
Red Hat 또는 CentOS 버전(예시:
8
)MongoDB 에디션(예:
mongodb-enterprise
)MongoDB 릴리스 버전(예:
8.0
)아키텍처(예:
x86_64
)
[mongodb-org-8.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/8.0/$basearch/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-8.0.asc
참고
시스템에서 Amazon Linux 2를 사용하는 경우, baseurl에서 2023
을 2
로 바꿉니다.
MongoDB 리포지토리에서 .rpm
파일을 직접 다운로드할 수도 있습니다. 다운로드는 다음 순서로 구성됩니다.
Amazon Linux 버전(예:
2023
)MongoDB 릴리스 버전(예:
8.0
)아키텍처(예:
x86_64
)
mongosh
을(를) 설치합니다.
mongosh
OpenSSL을 지원합니다. 시스템의 OpenSSL 설치를 사용하도록 mongosh
를 구성할 수도 있습니다.
포함된 OpenSSL 라이브러리를 사용하여 mongosh
의 최신 안정 버전을 설치하려면 다음을 수행합니다.
sudo yum install -y mongodb-mongosh
OpenSSL 1.1 라이브러리와 함께 mongosh
을(를) 설치하려면 다음을 수행합니다.
sudo yum install -y mongodb-mongosh-shared-openssl11
OpenSSL 3.0 라이브러리와 함께 mongosh
을(를) 설치하려면 다음을 수행합니다.
sudo yum install -y mongodb-mongosh-shared-openssl3
절차
MongoDB Shell 다운로드 페이지를 엽니다.
MongoDB 다운로드 센터를 엽니다.
Linux 64비트 .tgz
패키지를 다운로드합니다.
운영 체제에 적합한 mongosh
버전을 다운로드합니다. MongoDB는 시스템의 OpenSSL 설치를 사용하는 mongosh
버전도 제공합니다.
MongoDB 다운로드 센터를 참조하세요.
다운로드한 아카이브에서 파일을 추출합니다.
Go .tgz
아카이브가 포함된 디렉토리로 다음 아카이브의 압축을 풉니다.
.tgz
패키지의 이름은 다운로드한 버전에 따라 다릅니다. 다음 명령에서 .tgz
패키지 이름을 다운로드한 패키지의 이름으로 바꾸고 명령을 실행합니다.
tar -zxvf mongosh-2.3.8-linux-x64.tgz
압축을 푼 아카이브에는 bin
폴더에 두 개의 파일, mongosh
및 mongosh_crypt_v1.so
이 들어 있습니다.
웹 브라우저가 다운로드의 일부로 아카이브를 자동으로 추출하거나 tar
명령을 사용하지 않고 아카이브를 추출하는 경우 바이너리를 실행 파일로 만들어야 할 수 있습니다.
바이너리를 실행 파일로 만들려면 아카이브를 추출한 디렉토리에서 다음 명령을 실행합니다.
chmod +x bin/mongosh
다운로드한 바이너리를 PATH
환경 변수에 추가합니다.
둘 중 하나를 수행하면 됩니다.
mongosh
바이너리를PATH
변수에 나열된 디렉토리(예:/usr/local/bin
)에 복사합니다. 다운로드 파일을 추출한 디렉토리에서 다음 명령을 실행합니다.sudo cp mongosh /usr/local/bin/ sudo cp mongosh_crypt_v1.so /usr/local/lib/ MongoDB Shell
에 대한 심볼릭 링크를 생성합니다..tgz
아카이브에서 파일을 추출한 디렉토리로 전환합니다. 다음 명령을 실행하여PATH
에 이미 있는 디렉토리(예:/usr/local/bin
)에 대한 링크를 생성합니다.sudo ln -s $(pwd)/bin/* /usr/local/bin/
다음 단계
mongosh
를 성공적으로 설치했다면 MongoDB 배포서버 연결 방법을 확인합니다.
MongoDB는 애플리케이션을 통해 액세스할 수 있는 프로그래밍 액세스 방식의 mongosh
다운로드 목록을 제공합니다.