AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

Terraform 및 MongoDB Atlas 제공자 시작하기

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 를 배포하기 전에 다음을 수행해야 합니다.

1
mkdir terraform-projcd terraform-proj
2

main.tf, provider.tf, variables.tf 및 versions.tf 파일을 만듭니다.

touch main.tf provider.tf variables.tf versions.tf
3

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와 클라이언트 보안 비밀은 기밀입니다. 환경 변수로 저장하는 것을 고려해 보세요.

4

참고

다음 예시에서는 프로젝트 모듈을 사용하여 프로젝트를 생성하고, 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" } } ] } ]}

다른 클라우드 공급자나 리전을 사용하는 경우, 환경에 맞게 다음 필드를 업데이트할 수 있습니다.

필드
새 값

backing_provider_name

제공자. 가능한 값은 "AWS", "AZURE" 또는 "GCP" 입니다.

region_name

사용할 수 있는 모든 리전은 클라우드 제공자 및 리전 을 참조하세요.

중요

전용 클러스터를 생성할 때 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 클러스터 생성을 참조하세요.

5

Terraform 구성의 정보를 터미널 창 으로 출력할 수 있습니다. 이는 Atlas 가 연결 string 과 같은 리소스를 생성할 때까지 알 수 없는 값에 유용합니다.

프로젝트 배포 후 매개변수를 표시하려면 main.tf 파일 에 일부 출력 코드 줄을 추가합니다.

6

프로젝트 를 초기화하려면 다음 명령을 실행 합니다.

terraform init

이 명령은 MongoDB Atlas 제공자를 다운로드하여 설치하기도 합니다(아직 다운로드하지 않은 경우).

7

실행 계획을 보려면 다음 명령을 실행 합니다.

terraform plan

Terraform은 향후 변경 사항을 자세히 설명합니다. 출력이 예상과 다른 경우 main.tf 파일 에 문제가 있을 수 있습니다.

8

인프라를 배포 하려면 다음 명령을 실행 합니다.

terraform apply

메시지가 Do you want to perform these actions? 표시되면 을 yes 입력합니다.

참고

새 Atlas 리소스를 프로비저닝하는 데 몇 분 정도 걸릴 수 있습니다. Atlas Terraform 제공자 는 완료될 때까지 10초마다 업데이트합니다.

다음 예시는 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 출력에 표시됩니다.

Terraform 디렉토리 에 생성된 모든 리소스를 삭제 하려면 다음 명령을 실행 합니다.

terraform destroy

경고

모든 리소스를 삭제 하면 복구할 수 없습니다.

메시지가 Do you really want to destroy all resources? 표시되면 을 yes 입력합니다.

클러스터를 배포한 후 다음을 수행할 수 있습니다.

  • 전용 클러스터로 확장하다: 더 완벽한 구성을 보려면 클러스터 모듈 및 Atlas Terraform 제공자 문서를 검토하세요.

  • 클러스터에 연결합니다: 클러스터 객체에서 또는 Terraform 출력 값에서 연결 문자열을 사용합니다.

추가 리소스: