문서 메뉴
문서 홈
/
MongoDB 아틀라스
/
아틀라스 CLI
/
Atlas 관리
/
로컬 및 클라우드 배포

로컬 Atlas 배포 만들기

이 페이지의 내용

  • 로컬 Atlas 배포에 지원되는 OS
  • 사전 요구 사항을 완료하세요.
  • 로컬 Atlas 배포 만들기
  • 로컬 Atlas 배포 관리
  • 로컬 Atlas 배포와 함께 Atlas Search 사용
  • 로컬 Atlas 배포와 함께 Atlas Vector Search 사용
  • 지원되는 작업
  • 오류 문제 해결

이 튜토리얼에서는 atlas deployments 명령을 사용하여 로컬 Atlas 배포를 만드는 방법을 보여줍니다. 이 튜토리얼에서는 로컬 컴퓨터에 단일 노드 복제본 세트를 배포합니다. 그런 다음 배포를 managed하고 Atlas Search 및 Atlas Vector Search를 사용할 수 있습니다.

테스트 및 개발용으로만 로컬 배포를 사용해야 합니다.

중요

공개 미리보기

atlas deployments 명령 및 후속 관련 명령은 공개 미리 보기로 사용할 수 있습니다. 기능 및 해당 설명서는 공개 미리 보기 단계에서 언제든지 변경될 수 있습니다. 질문하고 피드백을 제공하려면 Atlas CLI 로컬 개발 커뮤니티 포럼을 참조하세요.

로컬 Atlas 배포에 지원되는 OS

운영 체제
운영 체제 버전
아키텍처
최소 CPU 코어
최소 여유 RAM(GB)
macOS
13.2 이상
x86-64, ARM
2
2
Red Hat Enterprise Linux / CentOS
8, 9
x86-64, ARM
2
2

참고

공개 프리뷰 단계에서는 Windows 및 Ubuntu가 로컬 Atlas 배포에 완전히 지원되지 않습니다.

사전 요구 사항을 완료하세요.

시작하기 전에 다음 사전 요구 사항을 완료하세요.

중요

각 사전 조건 제품에 대한 호환성 정보는 관련 설치 페이지를 참조하세요.

  • Atlas CLI를 설치합니다.

    예시(macOS):

    brew install mongodb-atlas-cli

    다른 운영 체제에 대한 Atlas CLI 설치 지침에 대해 자세히 알아보려면 Atlas CLI 설치 또는 업데이트를 참조하세요.

  • mongosh 버전 2 을(를) 설치합니다.0 이상.

    예시(macOS):

    brew install mongosh

    다른 운영 체제에 대한 mongosh 설치 지침에 대해 알아보려면 mongosh 설치를 참조하세요.

  • (선택 사항) Compass 버전 1 을(를) 설치합니다.39.4 이상.

    예시(macOS):

    brew install mongodb-compass

    다른 운영 체제에 대한 Compass 설치 지침에 대해 알아보려면 Compass 다운로드 및 설치를 참조하세요.

  • MongoDB database 도구를 설치합니다.

    예시(macOS):

    brew tap mongodb/brew && brew install mongodb-database-tools

    다른 운영 체제에 대한 MongoDB database 도구 설치 지침에 대해 자세히 알아보려면 데이터베이스 도구 설치를 참조 Database Tools.

  • Podman 설치 버전 4 4. 이상.

    예시(macOS):

    brew install podman

    참고

    Podman은 MongoDB 이미지를 가져오고 캐싱하기 위한 네트워크 연결이 필요합니다.

로컬 Atlas 배포 만들기

로컬 Atlas 배포를 만들려면 atlas deployments 명령을 사용합니다.

이 명령은 다음과 같은 방법으로 실행할 수 있습니다.

  • 대화형 모드(기본값): 명령은 배포 설정을 묻는 메시지를 표시하고 기본값을 제공합니다.

  • 대화형 모드(사용자 지정): 명령은 배포 설정을 묻는 메시지를 표시하고 사용자 정의 값을 제공할 수 있도록 합니다.

  • 비대화형 모드: 지정된 옵션을 사용하여 명령을 실행합니다. 이 명령은 추가 값을 제공하라는 메시지를 표시하지 않습니다. atlas deployments가 지원하는 모든 조치에 대해 알아보려면 Atlas 배포를 참조하세요.

다음 탭 중 하나를 클릭하면 원하는 모드에 대한 명령을 확인할 수 있습니다.

로컬 Atlas 배포 관리

로컬 Atlas 배포를 관리하려면 atlas deployments 명령을 사용합니다. 로컬 및 클라우드 Atlas 배포 모두에 다음 명령을 사용할 수 있습니다. --type local 또는 --type atlas를 사용하여 로컬 또는 클라우드 Atlas 배포에 대해 각각 명령을 실행할 수 있습니다.

1

사용 가능한 배포를 나열합니다.

예시:

atlas deployments list
NAME        TYPE    MDB VER   STATE
local50     LOCAL   7.0.1     IDLE
local62     LOCAL   7.0.1     IDLE
myLocalRs   LOCAL   7.0.1     IDLE
myLocalRs1  LOCAL   7.0.1     IDLE
2

샘플 데이터를 다운로드하고 로드합니다.

  1. 다음 명령을 실행하여 샘플 데이터를 다운로드합니다.

    curl  https://atlas-education.s3.amazonaws.com/sampledata.archive -o sampledata.archive

  2. 다음 명령을 복사하여 터미널에 붙여넣고 {port-number}를 배포용 포트로 바꿉니다.

    mongorestore --archive=sampledata.archive --port={port-number}
3

배포에 연결합니다.

  1. 다음 명령을 실행하여 배포에 연결합니다.

    atlas deployments connect

  2. 연결할 배포를 지정하고 Enter 을(를) 누릅니다.

  3. 배포에 연결할 방법을 지정하고 Enter 키를 누릅니다.

4

배포를 일시 중지합니다.

  1. 배포를 일시 중지하려면 다음 명령을 실행합니다.

    atlas deployments pause

  2. 일시 중지할 배포를 지정하고 Enter 키를 누릅니다.

5

배포를 시작합니다

  1. 다음 명령을 실행하여 배포를 시작합니다.

    atlas deployments start

  2. 시작할 배포를 지정하고 Enter 키를 누릅니다.

6

배포에 대한 로그를 반환합니다.

  1. 배포에 대한 로그를 반환하려면 다음 명령을 실행합니다.

    atlas deployments logs

  2. 로그를 반환할 배포를 지정하고 Enter 키를 누릅니다.

7

배포를 삭제합니다.

  1. 배포를 삭제하려면 다음 명령을 실행합니다.

    atlas deployments delete

  2. 삭제할 배포서버를 지정하고 Enter 키를 누릅니다.

  3. y 을(를) 지정하고 Enter 을(를) 누릅니다. 확인합니다.

로컬 Atlas 배포와 함께 Atlas Search 사용

atlas deployments search indexes create 명령을 사용하여 Atlas Search Atlas Search 인덱스를 생성합니다. 그런 다음 Atlas Search 쿼리를 실행할 수 있습니다. 자세히 알아보려면 Atlas Search를 참조하세요.

로컬 및 클라우드 Atlas 배포서버에서 이 명령을 실행할 수 있습니다. 자세한 단계는 Atlas Search 인덱스 생성 및 쿼리 실행을 참조하세요.

로컬 Atlas 배포와 함께 Atlas Vector Search 사용

atlas deployments search indexes create 명령을 사용하여 Atlas Vector Search로 작업하세요. 자세한 내용 은 Vector Atlas Search를 위한 벡터 임베딩을 인덱스하는 방법을 참조하세요.

이 명령은 로컬 및 클라우드 Atlas 배포서버에서 실행할 수 있습니다. 자세한 단계 는 Atlas 배포에 Atlas Vector Search 사용을 참조하세요.

중요

Atlas CLI를 Atlas Vector Search와 함께 사용하려면 MongoDB 7.0.5 이상을 사용하여 Atlas 배포를 만들어야 합니다. 이전 MongoDB 버전으로 로컬 Atlas 배포를 만든 경우, 최신 MongoDB 버전이 자동으로 제공되지 않습니다. 이전 이미지와 배포를 삭제해야 합니다. 그런 다음 새 Atlas 배포를 생성해야 합니다.

지원되는 작업

atlas deployments가 지원하는 모든 조치에 대해 알아보려면 Atlas 배포를 참조하세요.

오류 문제 해결

로컬 Atlas 배포 문제 해결에 대해 자세히 알아보려면 로컬 Atlas 배포 문제 해결을 참조하세요.

← 로컬 및 클라우드 배포
Docker로 배포하기 →

이 페이지의 내용