Free 클러스터 또는 Flex 클러스터의 클러스터 계층을 전용 클러스터로 확장할 수 있습니다.
필요한 액세스 권한
클러스터 계층을 확장하려면 프로젝트에 대한 Project Cluster Manager 이상의 역할이 있어야 합니다.
데이터베이스 에디션
Free 클러스터 또는 Flex 클러스터를 생성할 때 Atlas Core 또는 Atlas Infinite를 선택했습니다. Atlas는 해당 선택 사항을 저장했지만 Free 클러스터 또는 Flex 클러스터 자체에는 적용하지 않았으므로 해당 클러스터의 작동 방식은 변경되지 않았습니다.
각 에디션에 대해 자세히 알아보려면 MongoDB Atlas Infinite: 개요 및 MongoDB Atlas Core: 개요를 참조하세요.
클러스터 계층을 전용 클러스터로 확장하면 Atlas는 이미 지정하고 저장한 에디션을 사용합니다. 원하는 경우 해당 시점에 다른 에디션을 선택할 수 있습니다.
Atlas Infinite 선택은 옵트인 방식입니다. Free 클러스터 또는 Flex 클러스터를 생성할 때 Atlas Infinite를 선택하지 않은 경우, 기본값 Atlas는 클러스터 계층을 Atlas Core의 전용 클러스터로 확장합니다.
고려 사항
Free 클러스터 또는 Flex 클러스터를 전용 클러스터로 확장하려면 가동 중지 시간이 필요합니다. 데이터 손상을 방지하려면 확장 작업 기간 동안 쓰기 (write) 작업을 중단하세요.
전용 클러스터를 무료 클러스터 또는 Flex 클러스터로 확장할 수 없습니다.
클러스터를 생성한 후에는 Atlas Core와 Atlas Infinite 사이의 어떤 방향으로든 데이터베이스 에디션을 변경할 수 없습니다.
절차
Free 클러스터 또는 Flex 클러스터를 전용 클러스터로 확장하려면 소스 클러스터 유형에 대한 테넌트 업그레이드 엔드포인트로 요청을 보냅니다. 요청 본문의 databaseEdition 필드는 결과 전용 클러스터의 데이터베이스 에디션을 설정합니다. databaseEdition을(를) 생략하면 Atlas는 클러스터를 Atlas Core의 전용 클러스터로 확장합니다.
호출하는 엔드포인트의 리소스 버전에 Accept 헤더를 설정합니다. Free 클러스터 엔드포인트의 경우 application/vnd.atlas.2023-01-01+json, Flex 클러스터 엔드포인트의 경우 application/vnd.atlas.2024-11-13+json를 사용하세요.
Atlas Infinite에서 전용 클러스터로 확장하려면 요청 본문에서
databaseEdition을(를)INFINITE(으)로 설정하세요.For a Free cluster, send a
POSTrequest to /groups/{groupId}/clusters/tenantUpgrade.For a Flex cluster, send a
POSTrequest to /groups/{groupId}/flexClusters:tenantUpgrade.
Atlas Core에서 전용 클러스터로 확장하려면
databaseEdition을(를) 생략하거나CORE(으)로 설정하세요.For a Free cluster, send a
POSTrequest to /groups/{groupId}/clusters/tenantUpgrade.For a Flex cluster, send a
POSTrequest to /groups/{groupId}/flexClusters:tenantUpgrade.
Atlas CLI를 사용하여 M0 또는 Flex Atlas 클러스터에 대한 클러스터 계층, 디스크 크기 및/또는 MongoDB 버전을 업그레이드하려면 다음 명령을 실행하세요.
atlas clusters upgrade [clusterName] [options]
To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas clusters upgrade.
공개 미리 보기 기간 동안 atlas clusters upgrade은 Atlas Infinite 클러스터로의 확장을 지원하지 않습니다. 해당 명령에는 데이터베이스 에디션 옵션이 없습니다. 따라서 항상 Free 클러스터 또는 Flex 클러스터를 Atlas Core에서 전용 클러스터로 확장합니다. 설정 파일에서 databaseEdition을(를) 설정하면 명령은 필드를 제거하고 오류 대신 경고를 반환합니다.
대신 atlas api 명령을 사용하세요. 이러한 명령은 요청 본문을 변경하지 않고 Atlas Administration API로 보내므로 Atlas가 databaseEdition을(를) 적용합니다.
databaseEdition을(를) INFINITE(으)로 설정하는 payload.json 파일을 만듭니다. 다른 값을 클러스터 구성으로 바꿉니다.
{ "name": "{CLUSTER-NAME}", "databaseEdition": "INFINITE", "providerSettings": { "providerName": "AWS", "instanceSizeName": "M10", "regionName": "US_EAST_1" } }
Free 클러스터를 확장하려면 다음 명령을 실행합니다.
atlas api clusters upgradeTenantUpgrade \ --version 2023-01-01 \ --groupId {GROUP-ID} \ --file payload.json
Flex 클러스터를 확장하려면 다음 명령을 실행하세요.
atlas api flexClusters tenantUpgrade \ --version 2024-11-13 \ --groupId {GROUP-ID} \ --file payload.json
databaseEdition을(를) 생략하면 Atlas는 Free 클러스터 또는 Flex 클러스터를 생성할 때 선택한 에디션을 사용합니다.
Atlas 에서 프로젝트 의 Clusters 페이지로 이동합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
사이드바에서 Database 제목 아래의 Clusters를 클릭합니다.
Clusters(클러스터) 페이지가 표시됩니다.