Docs Menu

프로그래매틱 도구를 M2, M5 또는 서버리스 인스턴스에서 Flex 클러스터로 마이그레이션합니다.

중요

2월 2025부터 Flex 클러스터를 생성할 수 있으며, 더 이상 Atlas UI, Atlas CLI, Atlas 관리 API, Atlas Kubernetes Operator, HashiCorp Terraform 또는 Atlas CloudFormation 리소스에서 M2M5 클러스터나 서버리스 인스턴스를 생성할 수 없습니다. 기존 M2M5 클러스터와 서버리스 인스턴스를 계속 사용할 수 있습니다.

Atlas는 M2M5 클러스터와 서버리스 인스턴스를 더 이상 지원하지 않습니다. Atlas는 모든 기존 M2M5 클러스터를 Flex 클러스터로 자동으로 마이그레이션합니다. 서버리스 인스턴스의 경우, Atlas는 사용량에 따라 인스턴스를 무료 클러스터, 플렉스 클러스터 또는 전용 클러스터로 마이그레이션할지를 결정합니다. Atlas가 인스턴스를 마이그레이션할 계층을 확인하려면 Atlas UI의 모든 클러스터 페이지를 참조하세요.

선택한 도구가 Flex 클러스터를 지원한 후에는 더 이상 사용되지 않는 인스턴스 유형에 대한 모든 참조를 Flex 클러스터에 대한 참조로 바꿔 코드를 업데이트 .

참고

워크로드에 비공개 엔드포인트 또는 연속 백업 및 특정 시점 복원이 필요한 경우 Atlas 전용 클러스터로 전환하는 것이 좋습니다.

이 섹션의 표에 나열된 클러스터 API 엔드포인트는 M2/M5 클러스터와 호환됩니다. 2025 1월부터 이러한 엔드포인트는 Flex 클러스터를 관리 . 이러한 API 엔드포인트는 2026 1월에 수명 종료(EOL)에 도달할 때까지 변경 없이 계속 사용할 수 있습니다.

1월부터 2025 서버리스 인스턴스용 API 엔드포인트는 Flex 클러스터를 관리 . 3월 2025 이후에는 모든 기존 서버리스 인스턴스가 사용량에 따라 무료 클러스터, Flex 클러스터 또는 전용 클러스터로 마이그레이션됩니다. 서버리스 인스턴스 무료 클러스터 또는 전용 클러스터 로 마이그레이션되는 경우, 대신 클러스터 API 엔드포인트를 사용해야 합니다. Atlas 인스턴스를 마이그레이션 할 계층을 확인하려면 Atlas UI 의 모든 클러스터 페이지를 참조하세요.

1월부터 1월 사이에 createCluster 엔드포인트를 사용하여 또는 클러스터 생성하거나 M2 M5 createServerlessInstance 엔드포인트를 사용하여 서버리스 인스턴스 2025 2026 생성하려고 하는 경우, 대신 Flex 클러스터 생성하게 됩니다. 이러한 엔드포인트에 대한 지원은 2026 1월에 종료됩니다.

서버리스 인스턴스를 Flex 클러스터로 마이그레이션하기 전에 서버리스 인스턴스 API 엔드포인트에 대한 호출을 클러스터 API 엔드포인트에 대해 적절하게 구성된 호출로 바꿔야 합니다.

다음 변경 사항은 2025 1월부터 나열된 API 엔드포인트에도 적용 .

엔드포인트
영향

새 Flex 클러스터에서 더 이상 사용되지 않습니다. 3월 2025 이후 서버리스 인스턴스가 무료, Flex 또는 전용 클러스터로 마이그레이션되면 오류를 반환합니다.

Flex 클러스터에서 사용하는 경우 upgradeSharedCluster 은(는) 사용자가 설정하다 값을 사용하지만 Flex 클러스터에서는 연속 백업을 사용할 수 없으므로 연속 백업을 토글하지 않습니다.

Flex 클러스터에서 사용하는 경우 createServerlessInstance 은(는) 사용자가 설정하다 값을 사용하지만 Flex 클러스터에서는 연속 백업을 사용할 수 없으므로 연속 백업을 토글하지 않습니다.

Flex 클러스터에서 사용하는 경우 updateServerlessInstance 은(는) 사용자가 설정하다 값을 사용하지만 Flex 클러스터에서는 연속 백업을 사용할 수 없으므로 연속 백업을 토글하지 않습니다.

Flex 클러스터에서 사용할 경우 setServerlessAutoIndexing 은(는) 사용자가 설정하다 값을 사용하지만, Flex 클러스터에서는 자동 인덱싱을 사용할 수 없으므로 자동 인덱싱을 토글하지 않습니다.

Flex 클러스터에서 사용할 경우 getServerlessAutoIndexing 은(는) 사용자가 설정하다 값을 사용하지만, Flex 클러스터에서는 자동 인덱싱을 사용할 수 없으므로 자동 인덱싱을 토글하지 않습니다.

HashiCorp Terraform Provider 는 Flex 클러스터를 지원합니다. M2/M5 클러스터 및 서버리스 인스턴스에 대한 일반적인 Terraform 지원 2026 1월까지 계속됩니다.

사용하는 기능에 따라 다음 타임라인에 따라 Flex 클러스터에서 작동하려면 Terraform 구성을 업데이트 해야 합니다.

Atlas 고 (Go)SDK는 11월부터 Flex 클러스터를 지원 2024 합니다. M2/M5 클러스터 및 서버리스 인스턴스에 대한 일반 SDK 지원 2026 1월까지 계속됩니다. 사용하는 기능에 따라 다음 타임라인에 따라 Flex 클러스터에서 작동하도록 SDK 스크립트를 업데이트 해야 합니다.

기능
업데이트 기한

3월, 2025

기타 모든 기능

1월, 2026

Atlas CLI 2024 12월부터 Flex 클러스터를 지원 . M2/M5 클러스터 및 서버리스 인스턴스에 대한 일반 Atlas CLI 지원 2026 1월까지 계속됩니다. 서버리스 인스턴스의 지속적인 cloud 백업 지원이 2025 1월에 종료되었습니다. 서버리스 인스턴스 연속 cloud 백업 제거 하려면 2025 1월 이전에 Atlas CLI 워크플로를 업데이트 해야 합니다. 2026 1월 이전에 Atlas CLI 워크플로에서 모든 M2/M5 및 서버리스 인스턴스 명령을 제거 해야 합니다.

Atlas Kubernetes Operator 2월부터 Flex 클러스터를 2025 지원합니다.

  • 2026 1월까지 일정 기간 이전 버전과의 호환성을 유지하기 위해 Atlas Atlas Kubernetes Operator 사용하는 경우를 포함하여 서버리스 인스턴스와 Flex 클러스터 API를 모두 통해 마이그레이션된 클러스터를 관리 할 수 있습니다.

  • 서버리스 인스턴스와 및 클러스터를 생성하고 managed 동일한 사용자 지정 리소스에서 Flex 클러스터를 생성하고 관리 AtlasDeployment M2 M5 할 수 있습니다. 자세히 학습 Atlas Kubernetes Operator 문서에서 AtlasDeployment 사용자 지정 리소스 참조하세요.

  • Atlas 에서는 새 M2/ 클러스터 및 서버리스 인스턴스를 만들 수 없습니다. 이 작업을 시도하면 대신 Flex 클러스터 생성됩니다.M5

  • 기존 서버리스 인스턴스가 2월 초 2025부로 더 이상 사용되지 않더라도 Atlas Kubernetes Operator 에서 기존 서버리스 인스턴스를 계속 사용할 수 있습니다.

  • 기존 서버리스 인스턴스의 경우 AtlasDeployment 사용자 지정 리소스의 spec.serverlessSpec 에 대한 참조를 spec.flexSpec에 대한 구성으로 바꾸도록 선택할 수 있습니다. 또는 동일한 사양을 계속 사용할 수 있습니다. AtlasDeployment Custom Resource(사용자 지정 리소스)의 spec.serverlessSpec 을(를) 통해 배포서버 관리하는 것은 2025 3월에 Atlas 이러한 기존 클러스터를 Flex 클러스터로 자동 마이그레이션하는 경우에도 계속 작동합니다.

  • 기존 M2M5 클러스터의 경우 AtlasDeployment 사용자 지정 리소스에서 spec.deploymentSpec 에 대한 참조를 spec.flexSpec에 대한 구성으로 바꾸도록 선택할 수 있습니다. 또는 동일한 사양을 계속 사용할 수 있습니다. AtlasDeployment Custom Resource(사용자 지정 리소스)의 spec.deploymentSpec 을(를) 통해 배포서버 관리하는 것은 2025 5월 Atlas 이러한 기존 M2M5 클러스터를 Flex 클러스터로 자동 마이그레이션하는 경우에도 계속 작동합니다.

  • 기존 서버리스 인스턴스의 경우 비공개 엔드포인트 와 관련된 조정 중에 오류가 발생하면 Atlas Kubernetes Operator 2.7.1으로 업그레이드 하거나 serverlessSpec 구성을 AtlasDeployment 사용자 지정 리소스 의 flexSpec 구성으로 바꿔야 합니다.

  • M2M5 클러스터의 경우 자동 마이그레이션 후 발생할 수 있는 조정 오류를 방지하려면 CRD 구성을 다음과 같이 변경하세요.

    • spec.deploymentSpec.replicationSpecs.zoneName 설정을 제거합니다.

    • 첫 번째 설정하다 이후에 spec.deploymentSpec.replicationSpecs.regionConfigs 설정 중 하나를 제거합니다.

    • spec.deploymentSpec.clusterType에만 replicaset 를 지정합니다.

    또는 AtlasDeployment 사용자 지정 리소스의 spec.deploymentSpec 에 대한 참조를 spec.flexSpec에 대한 구성으로 바꿉니다.

  • 2026 1월까지, API의 이전 버전과의 호환성이 1월 2026에 종료되므로, Atlas Kubernetes Operator 사용자 지정 리소스에서 나머지 M2/M5 및 서버리스 인스턴스 구성을 모두 제거 해야 합니다. Flex 클러스터와 관련된 클러스터는 그대로 유지됩니다.

  • Atlas Kubernetes Operator 의 최신 릴리스에서는 기존 M2/M5 클러스터 및 서버리스 인스턴스에 대한 지원이 중단됩니다. 이전 버전의 Atlas Kubernetes Operator 2026 1월까지 이러한 인스턴스 유형을 계속 지원 .

Atlas CFN 및 CDK는 2025 전반부부터 Flex 클러스터를 지원 . M2/M5 클러스터에 대한 일반 지원 2026 1월까지 계속됩니다.

서버리스 비공개 엔드포인트 및 Properties.ContinuousBackupEnabled 서버리스 인스턴스 리소스 의 매개 변수에 대한 지원은 Atlas CFN에서 Flex 클러스터 지원 도입하면 종료됩니다. 20253월까지 이러한 리소스를 제거 하려면 CFN 및 CDK 리소스를 업데이트 해야 합니다. 202632} 1월 이전에 Atlas CFN 및 CDK 리소스에서 모든 M2/M5 및 서버 인스턴스 기능을 제거 해야 합니다.