개요
이 튜토리얼을 통해 타사 Homebrew 패키지 관리자를 사용하여 macOS에 MongoDB 8.0 Enterprise Edition을 설치합니다.
Homebrew를 통해 MongoDB 설치하면 MongoDB 데이터베이스 도구 도 설치됩니다. 자세한 내용은 MongoDB 데이터베이스 도구 사용을 참조하세요.
고려 사항
플랫폼 지원
MongoDB 8.0 Enterprise Edition은 macOS 14 이상을 지원하며 Haswell 이상의 CPU 아키텍처가 필요합니다.
자세한 내용은 플랫폼 지원에서 확인 가능합니다.
프로덕션 정보
프로덕션 환경에 MongoDB 배포하기 전에 자체 관리형 배포서버에 대한 프로덕션 노트 문서에서 성능 고려 사항 및 구성 권장 사항을 확인하세요.
시작하기 전에
시스템이 아래와 같은 각 사전 조건을 충족하는지 확인합니다. 시스템에서 각 사전 조건 단계를 한 번만 수행하면 됩니다. 이전 MongoDB 설치 과정에서 Homebrew를 사용하여 필수 단계를 이미 수행한 경우 이를 생략하고 설치 절차로 넘어가도 됩니다.
Xcode 명령줄 도구 설치
Homebrew를 사용하려면 Apple의 Xcode 명령줄 도구가 필요합니다.
Xcode 명령줄 도구를 설치하려면 다음 명령을 실행 .
xcode-select --install
Homebrew 설치
macOS does not include the Homebrew brew package by default.
Homebrew를 설치하려면 공식 Homebrew 설치 지침을 따르세요.
MongoDB Enterprise Edition 설치
Homebrew를 사용하여 MongoDB 엔터프라이즈 Edition을 설치하려면 다음 단계를 완료하세요.
MongoDB Homebrew 탭을 추가합니다.
MongoDB Homebrew 탭을 사용하면 시스템에서 공식 MongoDB 및 데이터베이스 도구 Homebrew 수식을 사용할 수 있습니다.
MongoDB Homebrew 탭을 추가하려면 다음 명령을 실행 .
brew tap mongodb/brew
그런 다음 탭을 신뢰할 수 있음으로 표시합니다.
brew trust mongodb/brew
이전 MongoDB 설치에서 이 작업을 수행한 경우 이 단계를 생략할 수 있습니다.
팁
또는 원하는 경우 이전 버전의 MongoDB를 지정할 수도 있습니다. 이러한 방식으로 여러 버전의 MongoDB를 함께 유지 관리할 수도 있습니다.
팁
이전 버전의 공식을 설치한 경우 ChecksumMismatchError가 발생할 수 있습니다. 이 문제를 해결하려면 ChecksumMismatchError 문제 해결을 참조하세요.
MongoDB Enterprise Edition 실행
MongoDB Enterprise Edition을 실행하려면 다음 단계를 따르세요. 이 지침에서는 기본 설정을 사용한다고 가정합니다.
brew를 사용하여 MongoDB를 macOS 서비스로 실행하거나 백그라운드 프로세스로 수동 실행할 수 있습니다.
참고
Homebrew 설치 방법을 사용하여 MongoDB 설치한 macOS 시스템의 경우 brew services을 통해 MongoDB 시작할 때 열린 파일 제한이 자동으로 설정하다 되지 않을 수 있습니다. ulimit 값을 수동으로 구성해야 할 수도 있습니다.
자세한 내용은 Ulimit 설정 을 참조하세요.
구성 파일 을 사용하여 배경 프로세스 로 를 수동으로
mongod실행 하려면 다음을 수행합니다.배포서버 에서 TLS 연결을 사용하지 않는 경우
--fork옵션을 사용합니다.Intel 프로세서에서 실행 macOS의 경우 다음을 실행.
mongod --config /usr/local/etc/mongod.conf --fork Apple Silicon 프로세서에서 실행 macOS의 경우 실행.
mongod --config /opt/homebrew/etc/mongod.conf --fork
두 방법 모두 설치 중에 생성된 mongod.conf 파일을 사용합니다. 이 파일에 사용자만의 MongoDB 구성 옵션을 추가할 수도 있습니다.
참고
macOS에서 mongod이 열리지 않는 경우
설치 후 macOS가 mongod 실행을 차단할 수 있습니다. mongod을 시작할 때 개발자를 식별하거나 확인할 수 없다는 보안 오류를 수신한 경우 다음을 실행하여 mongod에 액세스 권한을 부여합니다.
시스템 설정열기
사이드바에서 개인정보 보호 및 보안 을 클릭합니다.
보안 섹션에서 에 대한 Open Anyway
mongod메시지오른쪽에 있는 버튼을 클릭합니다.
To verify that MongoDB is running, perform one of the following:
MongoDB를 macOS 서비스로 시작한 경우,
brew services list started로 나열된mongodb-enterprise서비스가 표시되어야 합니다.MongoDB를 백그라운드 프로세스로서 수동으로 시작한 경우,
ps aux | grep -v grep | grep mongod 출력에서
mongod프로세스를 확인할 수 있습니다.
아래와 같이 로그 파일에서 mongod 프로세스의 현재 상태를 확인할 수도 있습니다. /usr/local/var/log/mongodb/mongo.log.
Connect and Use MongoDB
MongoDB 사용을 시작하려면 mongosh를 실행 중인 인스턴스에 연결합니다. 새 터미널에서 다음을 실행합니다.
mongosh
CRUD(생성, 읽기, 업데이트, 삭제) 작업에 대한 자세한 내용은 아래에서 확인할 수 있습니다.
추가 정보
기본 로컬 호스트 바인딩
MongoDB는 bindIp가 로컬 호스트 네트워크 인터페이스에 바인딩되는 127.0.0.1로 설정되어 실행되도록 기본 설정되어 있습니다. 이는 mongod가 동일한 시스템에서 실행 중인 클라이언트의 연결만 허용할 수 있음을 의미합니다. 원격 클라이언트는 mongod에 연결할 수 없으며, 이 값이 유효한 네트워크 인터페이스로 설정되어 있지 않으면 mongod는 복제본 세트를 초기화할 수 없습니다.
이 값은 다음 중 한 가지 방법으로 구성할 수 있습니다.
경고
인스턴스를 공개적으로 접근 가능한 IP 주소에 바인딩하기 전에 무단 접근으로부터 클러스터를 보호해야 합니다. 보안 권장 사항의 전체 목록은 자체 관리 배포서버에 대한 보안 검사 목록을 참조하세요. 최소한 인증을 활성화하고 네트워크 인프라를 강화하는 것을 고려합니다.
bindIp 구성에 대한 자세한 내용 은 자체 관리 배포서버의 IP 바인딩을 참조하세요.
포함된 바이너리
설치 과정에 아래와 같은 바이너리가 포함됩니다.
참고
설치에는 MongoDB 데이터베이스 도구 도 포함됩니다. 자세한 내용은 MongoDB 데이터베이스 도구 사용을 참조하세요.
파일 경로
또한 설치 시 Apple 하드웨어에 따라 아래 지정된 위치에 다음과 같은 파일과 디렉토리가 생성됩니다.
Intel 프로세서 | Apple Silicon Processor | |
|---|---|---|
|
| |
|
| |
|
|
Apple 실리콘 프로세서를 사용하는 하드웨어의 현재 목록은 Apple 문서에서 확인 가능합니다. 다음 명령을 실행하여 brew에서 이러한 파일과 디렉토리를 설치한 위치도 확인할 수 있습니다.
brew --prefix