Terraform을 사용하면 Atlas Terraform 제공자 와 함께 MongoDB Atlas 인프라를 코드로 관리 수 있습니다. Atlas Terraform 제공자 는 Atlas 인프라를 코드로 프로비저닝, 관리 및 제어하는 프로세스 를 간소화하여 인프라 배포를 자동화합니다.
이 가이드에서는 기존 MongoDB Atlas 조직에서 Atlas 클러스터를 생성하고 삭제하는 방법을 설명합니다.
참고
Atlas Terraform 제공자는 프로젝트와 리전에서 Atlas가 지원하는 모든 MongoDB 버전을 지원합니다. 클러스터의 MongoDB 버전을 변경하는 방법을 알아보려면 주 버전 업그레이드를 참조하세요.
테스트 환경을 구성한 후에는 MongoDB 및 HashiCorp의 추가 리소스 를 사용하여 Terraform 관리형 인프라를 계속 실험해 보세요.
Atlas Infinite 클러스터는 Atlas Terraform 제공자를 지원합니다. 자세한 내용은 Terraform으로 Atlas Infinite 클러스터 생성 및 MongoDB Atlas Infinite: 개요를 참조하세요.
전제 조건
Terraform과 함께 MongoDB Atlas 를 배포하기 전에 다음을 수행해야 합니다.
Atlas 계정을 만듭니다.
인 조직 ID 를
Organization Owner얻습니다.팁
Atlas UI의 General Settings 아래에서 조직 ID를 찾을 수 있습니다.
Configure a 서비스 계정(SA) 인증. Organization Owner 역할은 조직 ID를 보고, 서비스 계정을 관리하고, 클러스터 및 기타 프로젝트 리소스를 생성하거나 삭제하는 데 필요합니다.
Terraform으로 MongoDB Atlas 배포
지원 파일을 채웁니다.
provider.tf에 다음 내용을 추가합니다.
provider "mongodbatlas" { client_id = var.client_id client_secret = var.client_secret}variables.tf에 다음 내용을 추가합니다.
variable "client_id" { description = "Atlas Service Account client ID" type = string}
variable "client_secret" { description = "Atlas Service Account client secret" type = string sensitive = true}
variable "org_id" { description = "Atlas organization ID" type = string}versions.tf에 다음 내용을 추가합니다.
terraform { required_providers { mongodbatlas = { source = "mongodb/mongodbatlas" version = "~> 2.2" } } required_version = "~> 1.0"}참고
Atlas 서비스 계정 클라이언트 ID와 클라이언트 보안 비밀은 기밀입니다. 환경 변수로 저장하는 것을 고려해 보세요.
main.tf 콘텐츠를 구성합니다.
참고
다음 예시에서는 프로젝트 모듈을 사용하여 프로젝트를 생성하고, mongodbatlas_advanced_cluster 리소스를 사용하여 Free 클러스터를 생성합니다.
main.tf 파일에 다음 내용을 추가합니다.
module "project" { source = "terraform-mongodbatlas-modules/project/mongodbatlas" name = "tenant-example-project" org_id = var.org_id}
resource "mongodbatlas_advanced_cluster" "this" { project_id = module.project.id name = "TenantCluster" cluster_type = "REPLICASET"
replication_specs = [ { region_configs = [ { provider_name = "TENANT" backing_provider_name = "AWS" region_name = "US_EAST_1" priority = 7 electable_specs = { instance_size = "M0" } } ] } ]}다른 클라우드 공급자나 리전을 사용하는 경우, 환경에 맞게 다음 필드를 업데이트할 수 있습니다.
필드 | 새 값 |
|---|---|
| 제공자. 가능한 값은 |
| 사용할 수 있는 모든 리전은 클라우드 제공자 및 리전 을 참조하세요. |
중요
전용 클러스터를 생성할 때 mongodbatlas_advanced_cluster 리소스에서 database_edition을(를) 설정할 수 있습니다. 나중에 변경할 수 없으며, 전용 클러스터를 무료 또는 Flex 클러스터로 다시 확장하다 수 없습니다. database_edition은(는) 이 예시의 M0 클러스터와 같은 Free 클러스터 및 Flex 클러스터에서는 사용할 수 없습니다.
mongodbatlas_advanced_cluster 리소스와 단수(mongodbatlas_advanced_cluster) 및 복수(mongodbatlas_advanced_clusters) 데이터 소스 모두 database_edition 및 읽기 전용 effective_database_edition 속성을 노출합니다. database_edition은(는) 선택 사항이므로, 직접 설정하지 않았더라도 effective_database_edition을(를) 사용하여 Atlas가 할당한 에디션을 확인하세요.
전용 Atlas Infinite 클러스터를 생성하려면 Terraform을 사용하여 Atlas Infinite 클러스터 생성을 참조하세요.
Terraform을 사용하여 Atlas Infinite 클러스터 만들기
다음 예시는 Terraform을 사용하여 컴퓨팅 자동 확장이 활성화된 Atlas Infinite 클러스터를 생성하는 방법을 보여줍니다.
resource "mongodbatlas_advanced_cluster" "infinite" { project_id = module.project.id name = "InfiniteCluster" cluster_type = "REPLICASET" database_edition = "INFINITE"
replication_specs = [ { region_configs = [ { provider_name = "AWS" priority = 7 region_name = "US_EAST_1" electable_specs = { instance_size = "M10" node_count = 2 } auto_scaling = { compute_enabled = true compute_max_instance_size = "M60_GEN_2" storage_config = { shard_size_limit_gb = 10240 } } } ] } ]}Terraform으로 Atlas Infinite 클러스터를 생성할 때 다음 요구 사항 및 제한 사항이 적용됩니다.
필수 설정:
mongodbatlas_advanced_cluster리소스에서database_edition을(를)"INFINITE"(으)로 설정하고,auto_scaling아래에 명시적compute_enabled값(true또는false)을 설정합니다. Atlas는 클러스터 생성 시 이 값이 필요합니다.변경 불가능한 데이터베이스 에디션: 클러스터를 생성한 후에는 데이터베이스 에디션을 변경할 수 없습니다.
공개 미리 보기 제한 사항: Terraform으로 배포하는 클러스터에는 다른 모든 Atlas Infinite 공개 미리 보기 제한 사항이 적용됩니다. 학습 내용은 공개 미리 보기에서 지원되지 않음을 참조하세요.
클러스터 유형: 전용 Atlas Infinite 클러스터는
REPLICASET클러스터 유형만 지원합니다.자동 확장 최대 계층:
compute_enabled이(가)true인 경우compute_max_instance_size이(가) 필요합니다.M30계층 이상의 Atlas Infinite 클러스터는 Amazon Web Services Gen2 hardware에서 실행되므로M60_GEN_2와 같이 계층 이름에_GEN_2을(를) 추가하세요. 자세한 내용은 Gen2 전용 클러스터를 참조하세요.투표 선택 가능 노드: Atlas Infinite 클러스터에는 프라이머리와 대기라는 두 개의 투표 선택 가능 컴퓨팅 노드가 있으므로
node_count을(를)2(으)로 설정하세요. 자세히 알아보려면 복제 및 페일오버를 참조하세요.읽기 전용 및 분석 노드: 더 많은 읽기를 제공하거나 운영 워크로드에서 분석 쿼리를 격리하려면 동일한
region_configs객체 내에서electable_specs와 함께read_only_specs또는analytics_specs을 설정하세요. 자세한 내용은 Atlas Infinite 클러스터의 워크로드 격리를 참조하세요.저장 제한:
storage_config.shard_size_limit_gb은storage_config을 포함하는 경우에만 필요합니다.storage_config를 생략하면 Atlas는 기본값 최대 저장 제한을 적용합니다. 자세한 내용은 최대 저장 제한을 참조하세요.
참고
storage_config.shard_size_limit_gb 클러스터가 저장할 수 있는 최대 데이터 양을 설정합니다. 자세한 내용은 Terraform 제공자 설명서를 참조하세요.
배포서버 확인
terraform apply 가 완료되면 클러스터가 배포되었는지 확인합니다.
새 클러스터가 프로젝트 아래 Atlas UI에 표시됩니다.
main.tf에 출력 값을 추가한 경우 연결 문자열이 Terraform 출력에 표시됩니다.
MongoDB Atlas 인스턴스 종료
Terraform 디렉토리 에 생성된 모든 리소스를 삭제 하려면 다음 명령을 실행 합니다.
terraform destroy경고
모든 리소스를 삭제 하면 복구할 수 없습니다.
메시지가 Do you really want to destroy all resources? 표시되면 을 yes 입력합니다.
다음 단계
클러스터를 배포한 후 다음을 수행할 수 있습니다.
전용 클러스터로 확장하다: 더 완벽한 구성을 보려면 클러스터 모듈 및 Atlas Terraform 제공자 문서를 검토하세요.
클러스터에 연결합니다: 클러스터 객체에서 또는 Terraform 출력 값에서 연결 문자열을 사용합니다.
추가 리소스: