로컬 Atlas 배포 만들기

로컬 Atlas 배포에 지원되는 OS

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

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

• Atlas CLI 를 설치합니다.

  예시(macOS):

  brew install mongodb-atlas-cli

  다른 운영 체제에 대한 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 deployments setup

? What would you like to deploy?  [Use arrows to move, type to filter, ? for more help]
> local - Local Database
  atlas - Atlas Database

[Default Settings]
Deployment Name   local50
MongoDB Version   7.0
Port              27017

? How do you want to setup your local MongoDB database?  [Use arrows to move, type to filter]
> default - With default settings
  custom - With custom settings
  cancel - Cancel set up

Creating your deployment local50 [this might take several minutes]
1/4: Downloading and completing configuration...
2/4: Starting your local environment...
3/4: Downloading MongoDB binaries to your local environment...
4/4: Creating your deployment local50...
Deployment created!
Connection string: mongodb://localhost:27017/?directConnection=true

atlas deployments setup

? What would you like to deploy?  [Use arrows to move, type to filter, ? for more help]
> local - Local Database
  atlas - Atlas Database

[Default Settings]
Deployment Name   local50
MongoDB Version   7.0
Port              27017

? How do you want to setup your local MongoDB database?  [Use arrows to move, type to filter]
  default - With default settings
> custom - With custom settings
  cancel - Cancel set up

? Deployment Name [This can't be changed later] (local3612) myLocalRs

? MongoDB Version  [Use arrows to move, type to filter]
> 7.0
  6.0

? Specify a port (49469) 37018

Creating your deployment myLocalRs
1/2: Starting your local environment...
2/2: Creating your deployment myLocalRs...
Deployment created!
Connection string: mongodb://localhost:37018/?directConnection=true

atlas deployments setup myLocalRs1 --type local --force

[Default Settings]
Deployment Name      myLocalRs1
MongoDB Version   7.0
Port              49684
Creating your deployment myLocalRs1
1/2: Starting your local environment...
2/2: Creating your deployment myLocalRs1...
Deployment created!
Connection string: mongodb://localhost:49684/?directConnection=true
connection skipped

로컬 Atlas 배포 관리

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

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

로컬 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를 위한 벡터 임베딩을 인덱스하는 방법을 참조하세요.

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

지원되는 작업

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

오류 문제 해결

로컬 Atlas 배포 문제 해결에 학습 보려면 로컬 Atlas 배포서버 문제 Atlas 을 참조하세요.