Atlas Kubernetes Operator Flex 클러스터 에서 전용 클러스터 로의 마이그레이션을 지원합니다. 이를 통해 Kubernetes 환경에서 직접 데이터베이스 인프라를 확장하다 할 수 있습니다.
전제 조건
시작하기 전에 다음이 필요합니다.
Atlas Kubernetes Operator 에서 managed 기존 Flex 클러스터 계층
AtlasDeployment입니다.Kubernetes 클러스터 에서 Flex 클러스터 계층
AtlasDeployment리소스 수정할 수 있는 권한입니다.청구, Atlas 프로젝트 에 대한 결제가 활성화되었습니다. 업그레이드하면 Atlas 계정에 요금이 청구됩니다.
절차
업그레이드 하려는 Flex 클러스터 구성을 찾습니다.
Flex 클러스터 구성은 Atlas Kubernetes Operator 가 managed AtlasDeployment 리소스 에서 찾을 수 있습니다.
다음 예시 us-east-1 리전 의 Amazon Web Services 에 대한 Flex 클러스터 구성을 보여줍니다.
# my-cluster.yaml apiVersion: atlas.mongodb.com/v1 kind: AtlasDeployment metadata: name: my-flex-cluster spec: projectRef: name: my-atlas-project flexSpec: name: my-cluster providerSettings: backingProviderName: AWS regionName: US_EAST_1
spec.upgradeToDedicated 필드와 대상 전용 클러스터에 대한 전체 구성을 추가합니다.
AtlasDeployment 리소스 에 spec.upgradeToDedicated 필드 추가합니다. 이 필드 true로 설정하다 되면 Flex 클러스터 에서 전용 클러스터 로 현재 위치 업그레이드 시작하는 부울 플래그입니다.
spec.deploymentSpec 차단 에서 대상 전용 클러스터 에 대한 전체 구성을 제공합니다. 여기에는 제공자, 리전, 인스턴스 크기 및 기타 필요한 매개변수와 같은 세부 정보가 포함됩니다.
전용 클러스터 에 원래 Flex 클러스터 와 동일한 이름을 사용합니다.
참고
전용 클러스터 에 다른 이름을 사용하면 마이그레이션 실패합니다.
다음 예시 Flex 클러스터 구성을 수정하여 전용 클러스터 로의 마이그레이션 시작하는 방법을 보여줍니다.
# my-cluster.yaml apiVersion: atlas.mongodb.com/v1 kind: AtlasDeployment metadata: # The name MUST remain the same name: my-flex-cluster spec: projectRef: name: my-atlas-project # Add the upgrade flag upgradeToDedicated: true # Add the full configuration for the target Dedicated-cluster deploymentSpec: name: "my-cluster" # The name MUST remain the same clusterType: REPLICASET backupEnabled: true replicationSpecs: - regionConfigs: - providerName: AWS regionName: US_EAST_1 priority: 7 electableSpecs: instanceSize: M10 nodeCount: 3
마이그레이션 프로세스 모니터링합니다.
Atlas Kubernetes Operator 즉시 마이그레이션 프로세스 시작합니다. kubectl describe 명령을 사용하여 진행 상황을 모니터 할 수 있습니다.
kubectl describe atlasdeployment my-flex-cluster
처음에는 DeploymentReady 조건이 다음과 같이 표시됩니다.
Status: Conditions: ... - Last Transition Time: 2025-06-18T10:00:00Z Message: Cluster upgrade to dedicated instance initiated in Atlas... Reason: FlexToDedicatedMigrationProgressing Status: "False" Type: DeploymentReady
마이그레이션 완료되면 DeploymentReady 조건이 다음으로 업데이트됩니다.
Status: Conditions: ... - Last Transition Time: 2025-06-18T10:15:00Z Message: Cluster upgrade successful. You can now remove the 'upgradeToDedicated' flag from the spec. Status: "True" Type: DeploymentReady
업그레이드 완료된 후 출력에 Normal 이벤트 도 표시됩니다. 마이그레이션 이 실패하면 DeploymentReady 조건에 오류 메시지와 Reason가 표시됩니다. 클러스터 전용 클러스터 로 이미 마이그레이션한 경우에는 아무 것도 변경되지 않습니다.
마이그레이션 후 정리 .
마이그레이션 이 완료되면 AtlasDeployment 리소스 에서 upgradeToDedicated 플래그를 제거 하고 다시 적용 할 수 있습니다. 이 단계는 선택 사항이지만 구성을 깨끗하게 유지하고 실수로 마이그레이션 이 다시 트리거되는 것을 방지하기 위해 권장됩니다.
최종 AtlasDeployment 리소스 다음 예시 와 유사합니다.
# my-cluster.yaml apiVersion: atlas.mongodb.com/v1 kind: AtlasDeployment metadata: name: my-flex-cluster spec: projectRef: name: my-atlas-project deploymentSpec: name: "my-cluster" # The name MUST remain the same clusterType: REPLICASET backupEnabled: true replicationSpecs: - regionConfigs: - providerName: AWS regionName: US_EAST_1 priority: 7 electableSpecs: instanceSize: M10 nodeCount: 3