Docs Menu
Docs Home
/
MongoDB Shell

설치 mongosh

이 페이지의 내용

  • 전제 조건
  • 호환성 고려 사항
  • 절차
  • 다음 단계

MongoDB Shell을 사용하려면 연결할 MongoDB deployment가 있어야 합니다.

  • 무료 클라우드 호스팅 배포서버의 경우 MongoDB Atlas를 사용할 수 있습니다.

  • 로컬 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 디렉토리에 저장됩니다.

1

MongoDB 다운로드 센터를 엽니다.

2
3
4
5
1

MongoDB 다운로드 센터를 엽니다.

2

MongoDB 다운로드 센터에서 mongosh을(를) 다운로드합니다.

3

cmd 터미널을 열고 mongosh .zip아카이브가 있는 디렉토리에서 다음 명령을 실행합니다.

tar -xf mongosh-2.3.8-win32-x64.zip

압축을 푼 아카이브에는 bin 폴더에 두 개의 파일, mongosh.exemongosh_crypt_v1.dll이 들어 있습니다.

4

추출한 MongoDB Shell 바이너리가 파일 시스템에서 원하는 위치에 있는지 확인한 다음, 해당 위치를 PATH 환경 변수에 추가합니다.

PATH 환경 변수에 MongoDB Shell 바이너리의 위치를 추가하려면 다음을 따르세요.

  1. Control Panel을(를) 엽니다.

  2. System and Security 카테고리에서 System을(를) 클릭합니다.

  3. Advanced system settings를 클릭합니다. 시스템 속성 모달이 표시됩니다.

  4. Environment Variables를 클릭합니다.

  5. 시스템 변수 섹션에서 Path을(를) 선택하고 Edit을(를) 클릭합니다. 환경 변수 편집 모달이 표시됩니다.

  6. New를 클릭하고 mongosh 바이너리에 파일 경로를 추가합니다.

  7. OK을 클릭하여 변경 사항을 확인합니다. 다른 모달에서 OK을 클릭하여 변경 사항을 확인합니다.

PATH 환경 변수가 mongosh을(를) 찾도록 올바르게 구성되었는지 확인하려면 명령 프롬프트를 열고 mongosh --help 명령을 입력합니다. PATH이(가) 올바르게 구성되었으면 유효한 명령 목록이 표시됩니다.

중요

Homebrew 패키지 관리자는 macOS에서 mongosh에 대해 권장되는 설치 방법입니다. 대신 아카이브에서 mongosh를 수동으로 설치하는 방법을 알아보려면 .zip 파일에서 설치를 참조하세요.

Homebrew와 함께 설치된 mongosh은(는) 자동 클라이언트 사이드 필드 레벨 암호화를 지원하지 않습니다.

Homebrew로 mongosh 를 설치하려면 다음을 수행합니다.

1

macOS에 Homebrew를 설치하는 단계는 Homebrew 웹사이트를 참조하세요.

2

터미널에서 다음 명령을 실행하여 mongosh 패키지를 설치합니다.

brew install mongosh

다운로드한 .zip 파일을 사용하여 mongosh 을(를) 수동으로 설치하려면 다음을 수행합니다.

1

MongoDB 다운로드 센터를 엽니다.

2

운영 체제에 적합한 mongosh 버전을 다운로드합니다. MongoDB는 Intel 및 ARM 아키텍처에 mongosh 버전을 제공합니다.

3

Go mongosh .zip 아카이브가 포함된 디렉토리로 다음 .zip 파일의 압축을 풉니다.

컴퓨터가 인텔 기반인 경우 다음을 실행합니다.

unzip mongosh-2.3.8-darwin-x64.zip

컴퓨터가 ARM 기반(M1 또는 M2)인 경우 다음을 실행합니다.

unzip mongosh-2.3.8-darwin-arm64.zip

압축을 푼 아카이브에는 bin 폴더에 두 개의 파일, mongoshmongosh_crypt_v1.dylib이 들어 있습니다.

웹 브라우저가 다운로드의 일부로 아카이브를 자동으로 추출하거나 unzip 명령을 사용하지 않고 아카이브를 추출하는 경우 바이너리를 실행 파일로 만들어야 할 수 있습니다.

바이너리를 실행 파일로 만들려면 아카이브를 추출한 디렉토리에서 다음 명령을 실행합니다.

chmod +x bin/mongosh
4

둘 중 하나를 수행하면 됩니다.

  • 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/
5

설치 후 macOS에서 mongosh 이(가) 실행되지 않을 수 있습니다. mongosh 를 시작할 때 개발자를 식별하거나 확인할 수 없다는 보안 오류를 수신하는 경우 다음 조치를 수행합니다.

  1. 시스템 환경설정 을 엽니다.

  2. 보안 및 개인 정보 창을 선택합니다

  3. 일반 탭에서 macOS 버전에 따라 Open Anyway 또는 Allow Anyway 로 표시된 mongosh 에 대한 메시지 오른쪽에 있는 버튼을 클릭합니다.

아래 탭에서 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)

1

터미널에서 다음 명령을 실행하여 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 이(가) 설치되지 않았다는 오류를 수신하면 다음 단계를 수행하세요.

  1. 다음 명령을 사용하여 gnupg 및 필수 라이브러리를 설치합니다.

    sudo apt-get install gnupg
  2. 키 가져오기를 다시 시도합니다.

    wget -qO- https://www.mongodb.org/static/pgp/server-8.0.asc | sudo tee /etc/apt/trusted.gpg.d/server-8.0.asc
2

사용 중인 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
3

아래 명령을 실행하여 로컬 패키지 데이터베이스를 다시 불러옵니다.

sudo apt-get update
4

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
5

mongosh 이(가) 성공적으로 설치되었는지 확인하려면 다음 명령을 실행합니다.

mongosh --version

터미널은 설치한 mongosh 버전으로 응답해야 합니다.

mongosh는 다음 플랫폼에서 yum 패키지로 제공됩니다.

  • RHEL

  • Amazon Linux 2023

  • Amazon Linux 2

1

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 파일을 직접 다운로드할 수도 있습니다. 다운로드는 다음 순서로 구성됩니다.

  1. Red Hat 또는 CentOS 버전(예시: 8)

  2. MongoDB 에디션(예: mongodb-enterprise)

  3. MongoDB 릴리스 버전(예: 8.0)

  4. 아키텍처(예: 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에서 20232로 바꿉니다.

MongoDB 리포지토리에서 .rpm 파일을 직접 다운로드할 수도 있습니다. 다운로드는 다음 순서로 구성됩니다.

  1. Amazon Linux 버전(예: 2023)

  2. MongoDB 릴리스 버전(예: 8.0)

  3. 아키텍처(예: x86_64)

2

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
1

MongoDB 다운로드 센터를 엽니다.

2

운영 체제에 적합한 mongosh 버전을 다운로드합니다. MongoDB는 시스템의 OpenSSL 설치를 사용하는 mongosh 버전도 제공합니다.

MongoDB 다운로드 센터를 참조하세요.

3

Go .tgz 아카이브가 포함된 디렉토리로 다음 아카이브의 압축을 풉니다.

.tgz 패키지의 이름은 다운로드한 버전에 따라 다릅니다. 다음 명령에서 .tgz 패키지 이름을 다운로드한 패키지의 이름으로 바꾸고 명령을 실행합니다.

tar -zxvf mongosh-2.3.8-linux-x64.tgz

압축을 푼 아카이브에는 bin 폴더에 두 개의 파일, mongoshmongosh_crypt_v1.so이 들어 있습니다.

웹 브라우저가 다운로드의 일부로 아카이브를 자동으로 추출하거나 tar 명령을 사용하지 않고 아카이브를 추출하는 경우 바이너리를 실행 파일로 만들어야 할 수 있습니다.

바이너리를 실행 파일로 만들려면 아카이브를 추출한 디렉토리에서 다음 명령을 실행합니다.

chmod +x bin/mongosh
4

둘 중 하나를 수행하면 됩니다.

  • 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 다운로드 목록을 제공합니다.

돌아가기

MongoDB Shell(mongosh)에 오신 것을 환영합니다.