문서 홈 → MongoDB 실행 및 관리 → MongoDB Atlas
Atlas cluster 생성
프로젝트에 대한 cluster를 만듭니다.
빠르게 시작하려면 cluster 이름, 클라우드 공급자, 리전을 지정하여 최신 MongoDB Server 버전으로 3명의 멤버로 구성된 복제본 세트를 배포하세요. 배포를 완벽하게 제어하거나 멀티 cloud cluster를 생성하려면 --file 플래그가 포함된 JSON 구성 파일을 제공하세요.
이 명령을 사용하려면 프로젝트 소유자 역할이 있는 사용자 계정 또는 API 키로 인증해야 합니다.
구문
atlas clusters create [name] [options]
arguments
이름 | 유형 | 필수 사항 | 설명 |
|---|---|---|---|
이름 | 문자열 | 거짓 | cluster의 이름입니다. 클러스터가 생성된 후에는 클러스터 이름을 변경할 수 없습니다. cluster 이름에는 ASCII 문자, 숫자, 하이픈을 포함할 수 있습니다. --file 옵션을 사용하지 않는 경우 cluster 이름 인수를 지정해야 합니다. |
옵션
이름 | 유형 | 필수 사항 | 설명 |
|---|---|---|---|
--backup | 거짓 | 배포서버를 위해 연속 cloud 백업을 활성화하는 플래그입니다. M10보다 작은 cluster에서는 이 옵션을 사용할 수 없습니다. | |
--biConnector | 거짓 | 배포 시 Atlas용 BI Connector를 사용하도록 설정하는 플래그입니다. --file과 상호 배타적입니다. | |
--diskSizeGB | float | 거짓 | 호스트 루트 볼륨의 용량(단위: 기가바이트[GB])입니다. --file과 상호 배타적입니다. 이 값의 기본값은 2입니다. |
--enableTerminationProtection | 거짓 | cluster에 대한 종료 방지 기능을 활성화합니다. 종료 방지 기능이 활성화된 cluster는 삭제할 수 없습니다. | |
-f, --file | 문자열 | 거짓 | 클러스터 설정을 정의하는 선택적 JSON 구성 파일의 경로입니다. Atlas CLI의 클러스터 구성 파일에 대해 자세히 알아보려면 https://dochub.mongodb.org/core/cluster-config-file-atlascli 를 참조하세요. . MongoCLI의 클러스터 구성 파일에 대해 자세히 알아보려면 https://dochub.mongodb.org/core/mms-cluster-settings-file-mcli를 참조하세요. --tier, --provider, --members, --region, --diskSizeGB, --mdbVersion, --biConnector, --type, --shards, --tag와 상호 배타적입니다. |
-h, --help | 거짓 | 만들기 도움말 | |
--mdbVersion | 문자열 | 거짓 | 클러스터의 주요 MongoDB 버전입니다. --file과 상호 배타적입니다. |
-m, --members | int | 거짓 | 복제본 세트의 멤버 수입니다. --file과 상호 배타적입니다. 이 값의 기본값은 3입니다. |
-o, --출력 | 문자열 | 거짓 | 출력 형식입니다. 유효한 값은 json, json-path, go-템플릿 또는 go-템플릿 파일입니다. 전체 출력을 보려면 -o json 옵션을 사용합니다. |
--projectId | 문자열 | 거짓 | 사용할 프로젝트를 식별하는 16진수 문자열입니다. 이 옵션은 구성 파일 또는 환경 변수의 설정을 재정의합니다. |
--provider | 문자열 | 거짓 | cloud 서비스 제공자의 이름입니다. 유효한 값은 Amazon Web Services, Azure 또는 GCP입니다. --file 옵션을 사용하지 않는 경우 provider 옵션을 지정해야 합니다. --file과 상호 배타적입니다. |
-r, --region | 문자열 | 거짓 | MongoDB 클러스터의 물리적 위치입니다. --file 옵션을 사용하지 않는 경우 리전 옵션을 지정해야 합니다. 지원되는 AWS 리전의 전체 목록은https://dochub.mongodb.org/core/aws-atlas 를 참조하세요. . 지원되는 Azure 리전의 전체 목록은https://dochub.mongodb.org/core/azure-atlas 를 참조하세요. . 지원되는GCP 리전의 전체 목록은 https://dochub.mongodb.org/core/gcp-atlas를참조하세요. --file과 상호 배타적입니다. |
-s, --shards | int | 거짓 | cluster의 샤드 수입니다. --file과 상호 배타적입니다. 이 값의 기본값은 1입니다. |
--tag | 키=값 | 거짓 | 클러스터에 태그를 지정하고 분류하기 위한 1~255자 길이의 키-값 쌍이 포함된 목록입니다. --file과 상호 배타적입니다. |
--tier | 문자열 | 거짓 | 클러스터의 각 데이터 보유 서버에 대한 계층. 클러스터 계층에 대해 자세히 알아보려면 https://dochub.mongodb.org/core/cluster-tier-atlas를 참조하세요. --file과 상호 배타적입니다. 이 값의 기본값은 "M2"입니다. |
--type | 문자열 | 거짓 | 생성하려는 cluster의 유형입니다. 유효한 값은 REPLLICASET 또는 샤드입니다. --file과 상호 배타적입니다. 이 값의 기본값은 'REPLICET'입니다. |
-w, --watch | 거짓 | 명령이 실행이 완료되거나 감시 시간이 초과될 때까지 명령을 감시할지 여부를 나타내는 플래그입니다. 감시 시간이 초과되는 시간을 설정하려면 --watchTimeout 옵션을 사용합니다. | |
--watchTimeout | uint | 거짓 | watch 시간이 초과될 때까지의 시간(초)입니다. 감시 시간이 초과되면 Atlas CLI는 더 이상 명령을 감시하지 않습니다. |
상속된 옵션
이름 | 유형 | 필수 사항 | 설명 |
|---|---|---|---|
-P, --profile | 문자열 | 거짓 | 구성 파일에서 사용할 프로필의 이름입니다. Atlas CLI의 프로필에 대해 자세히 알아보려면 https://dochub.mongodb.org/core/atlas-cli-save-connection-settings를 참조하세요. |
출력
명령이 성공하면 Atlas CLI는 다음 샘플과 유사한 출력을 반환합니다. 괄호 안의 값은 사용자의 값을 나타냅니다.
Cluster '<Name>' is being created.
예제
# Deploy a free cluster named myCluster for the project with the ID 5e2211c17a3e5a48f5497de3: atlas cluster create myCluster --projectId 5e2211c17a3e5a48f5497de3 --provider AWS --region US_EAST_1 --tier M0
# Deploy a free cluster named myCluster for the project with the ID 5e2211c17a3e5a48f5497de3 and tag "env=dev": atlas cluster create myCluster --projectId 5e2211c17a3e5a48f5497de3 --provider AWS --region US_EAST_1 --tier M0 --tag env=dev
# Deploy a three-member replica set named myRS in AWS for the project with the ID 5e2211c17a3e5a48f5497de3: atlas cluster create myRS --projectId 5e2211c17a3e5a48f5497de3 --provider AWS --region US_EAST_1 --members 3 --tier M10 --mdbVersion 5.0 --diskSizeGB 10
# Deploy a three-member replica set named myRS in AZURE for the project with the ID 5e2211c17a3e5a48f5497de3: atlas cluster create myRS --projectId 5e2211c17a3e5a48f5497de3 --provider AZURE --region US_EAST_2 --members 3 --tier M10 --mdbVersion 5.0 --diskSizeGB 10
# Deploy a three-member replica set named myRS in GCP for the project with the ID 5e2211c17a3e5a48f5497de3: atlas cluster create myRS --projectId 5e2211c17a3e5a48f5497de3 --provider GCP --region EASTERN_US --members 3 --tier M10 --mdbVersion 5.0 --diskSizeGB 10
# Deploy a cluster or a multi-cloud cluster from a JSON configuration file named myfile.json for the project with the ID 5e2211c17a3e5a48f5497de3: atlas cluster create --projectId <projectId> --file myfile.json