macOS에 MongoDB 설치하는 방법: Homebrew(홈브루) 단계별 완벽 가이드

이 가이드는 macOS 환경에서 MongoDB를 설치하는 방법을 다룹니다. macOS에 MongoDB를 설치하는 방법은 크게 두 가지입니다. 하나는 공식 사이트에서 제공하는 TAR.GZ 파일을 직접 다운로드해 설치하는 방법이고, 다른 하나는 Homebrew(홈브루)를 이용하는 방법입니다.

TAR.GZ 파일은 윈도우의 Zip 파일처럼 여러 파일을 하나의 패키지로 묶어놓은 압축 형식입니다. 하지만 수동으로 압축을 풀고 경로를 설정하는 과정이 복잡하고 오류가 발생하기 쉬워, 많은 개발자들이 Mac에서 TAR.GZ 방식으로 MongoDB를 설치하는 것을 어려워합니다. 그래서 이 글에서는 훨씬 간편한 Homebrew 방식을 사용하겠습니다.

Homebrew(홈브루)란 무엇인가?

Homebrew는 macOS에서 가장 널리 쓰이는 패키지 관리자입니다. 무료로 제공되는 이 도구를 활용하면 명령어 한 줄만으로 라이브러리와 소프트웨어 패키지를 손쉽게 설치하고, 업데이트하고, 관리할 수 있습니다.

굳이 Homebrew가 필요할까?

엄밀히 말하면 TAR.GZ 파일을 직접 다운로드해서 MongoDB를 설치할 수도 있기 때문에 Homebrew가 반드시 필요한 것은 아닙니다. 다만 Homebrew를 통해 설치하면 다음과 같은 장점을 누릴 수 있습니다.

• 컴파일, 다운로드, 설정 과정이 자동화되어 시간과 수고를 크게 절약할 수 있습니다.
• 유틸리티, 라이브러리, 개발 언어 등 필요한 소프트웨어 대부분을 명령어 한 줄로 설치할 수 있습니다.
• 설치된 패키지의 버전 관리와 업그레이드도 간단하게 처리됩니다.

더 자세한 정보가 궁금하다면 brew.sh 공식 사이트를 방문해 보세요.

Homebrew로 MongoDB 설치하기: 단계별 안내

이제 실제로 Homebrew를 이용해 MongoDB를 설치하는 방법을 살펴보겠습니다.

1. MongoDB를 설치하기 전에 먼저 Homebrew가 설치되어 있어야 합니다.
2. 터미널을 열고 brew.sh 사이트에 접속합니다.
3. 사이트에 표시된 설치 명령어 옆의 복사 아이콘을 클릭해 명령어를 복사합니다.
   
4. 복사한 명령어를 터미널에 붙여넣고 Enter 키를 누릅니다. 이 과정만으로 brew 자체가 바로 실행되지는 않습니다. 마무리하려면 숨겨진 설정 파일인 .zshrc(셸 설정 파일)에 brew 경로를 등록하는 추가 작업이 필요합니다.
5. 올바른 디렉터리에 있는지 확인하려면 터미널에 cd ~를 입력하고 Enter 키를 눌러 홈 디렉터리로 이동합니다.
6. 이어서 ls -la를 입력하고 Enter 키를 누르면 숨김 파일을 포함한 전체 목록이 출력됩니다.
7. 목록에서 마침표(.)로 시작하는 항목들을 확인할 수 있는데, 우리가 찾아야 할 것은 .zshrc 파일입니다.
   
8. .zshrc 파일에 Homebrew 경로를 추가하기 위해 vim ~/.zshrc를 입력하고 Enter 키를 눌러 Vim 편집기를 엽니다.
9. I 키를 눌러 입력 모드로 전환한 뒤, 다음 명령어를 입력해 Homebrew 경로를 추가합니다.

   export PATH="$PATH:/opt/homebrew/bin/"

10. 입력이 끝나면 Esc 키를 누르고, 콜론(:)을 입력한 후 wq(저장 후 종료)를 입력하고 Enter 키를 누릅니다.
11. 변경된 설정을 적용하려면 .zshrc 파일을 다시 로드해야 합니다. 다음 명령어를 입력하거나 터미널을 재시작하세요.

    source ~/.zshrc

12. Homebrew가 정상적으로 설치되었는지 확인하려면 다음 명령어를 입력합니다.

    brew --version

13. 터미널에 brew 버전이 표시되면 Homebrew가 정상적으로 설치된 것이므로, 이제 MongoDB 설치로 넘어갈 수 있습니다.
14. MongoDB를 설치하려면 먼저 Xcode 커맨드라인 도구가 필요합니다. 다음 명령어를 실행해 설치하세요.

    xcode-select --install

    
    
15. Xcode 도구 설치가 완료되면, 다음 명령어로 MongoDB 공식 저장소(tap)를 등록합니다. 이렇게 하면 brew가 MongoDB 패키지를 인식하게 됩니다.

    brew tap mongodb/brew

16. 마지막으로 다음 명령어를 입력해 MongoDB를 설치합니다.

    brew install mongodb-community@6.0

17. 설치가 끝났다고 해서 바로 MongoDB를 사용할 수 있는 것은 아니며, 몇 가지 명령어를 더 실행해야 합니다. MongoDB 서비스를 시작하려면 다음 명령어를 실행하세요.

    brew services start mongodb-community@6.0

18. MongoDB 서비스를 중지하려면 같은 명령어에서 start를 stop으로 바꿔 입력하면 됩니다.

    brew services stop mongodb-community@6.0

19. 매번 터미널에서 서버를 켜고 끄는 명령어를 입력하는 것은 번거롭습니다. 터미널을 닫아도 MongoDB가 백그라운드 프로세스로 계속 실행되도록 설정하려면 다음 명령어를 사용하세요.

    mongod --config /opt/homebrew/etc/mongod.conf --fork

20. 이제 언제든지 다음 명령어를 입력해 MongoDB 셸(mongosh)에 접속할 수 있습니다.

    mongosh

21. 셸에 접속했다면 프로젝트 작업을 바로 시작할 수 있습니다. MongoDB 서버가 정상적으로 구동 중인지 확인하려면 show dbs를 입력해 보세요. MongoDB의 기본 데이터베이스 목록이 출력되면 정상 작동하는 것입니다.
    
22. 여기까지 완료했다면, macOS에 MongoDB가 성공적으로 설치된 것입니다!

설치 과정에서 문제가 발생한다면 StackOverflow나 기타 프로그래밍 포럼, 개발자 커뮤니티에 질문을 올려 도움을 받아보세요. 대부분의 오류는 이미 다른 개발자들이 겪고 해결한 사례가 있습니다.

저자 소개

Hamza Mohammad Anwar

Hamza Mohammad Anwar는 MERN 스택(MongoDB, Express, ReactJS, NodeJS) 기반의 고성능 웹 애플리케이션 개발을 전문으로 하는 JavaScript 웹 개발자입니다. ReactJS, MongoDB, Express, NodeJS 등 관련 기술에 대한 전문성을 갖추고 있으며, Google IT 자격증을 보유한 IT 지원 전문가이기도 합니다. 뛰어난 문제 해결 능력을 바탕으로, 의도적으로 오류를 재현하고 원인을 분석해 다양한 기술적 문제의 해결책을 찾는 활동을 꾸준히 이어오고 있습니다.