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

Terraform을 사용하여 템플릿에서 Atlas 클러스터 만들기

이 페이지에서는 Visual Studio Code용 MongoDB 확장에 포함된 Terraform 파일용 Atlas 템플릿을 사용하여 Flex 클러스터를 생성하는 방법을 간략하게 설명합니다.

템플릿을 로드한 후 클러스터를 구성하고 Atlas 계정에 대한 세부 정보를 제공합니다. 그런 다음 Terraform 명령을 사용하여 Atlas 클러스터를 계획, 적용 및 제거합니다.

Visual Studio Code용 MongoDB 확장에 포함된 Terraform 파일용 Atlas 템플릿을 사용하려면 먼저 다음을 수행해야 합니다.

VS Code 확장에 포함된 Terraform 파일용 Atlas 템플릿을 사용하여 Atlas 클러스터를 구성합니다.

1
운영 체제
메서드
작업

Any

Visual Studio 코드 메뉴

File > New File

macOS

키보드 단축키

Command + N 누르기

Windows 및 Linux

키보드 단축키

Control + N 누르기

2

참고

main.tf Terraform 모듈의 엔트리 포인트에 권장되는 파일 이름입니다.

3

VSCode용 MongoDB 확장은 MongoDB Atlas Terraform 공급자를 사용하여 Flex 클러스터를 만드는 예시 구성으로 파일을 채웁니다.

4

커서를 옮겨서 mongodbatlas_project 리소스의 name 인수 값을 선택하세요.

클러스터를 구성하려면 다음 인수의 값을 입력하세요.

팁

업데이트해야 하는 템플릿에서 다음 인수를 선택하려면 Tab(탭) 키를 누르세요.

속성
값

mongodbatlas_project
.name

이 구성으로 생성되는 Atlas 프로젝트의 이름

mongodbatlas_advanced_cluster
.name

이 구성으로 생성되는 Atlas Flex 클러스터 이름

mongodbatlas_advanced_cluster
.replication_specs.
region_configs.
backing_provider_name

이 구성으로 생성되는 Atlas Flex 클러스터가 호스팅되는 제공자입니다. 허용되는 값 중 하나를 선택합니다.

  • AWS

  • AZURE

  • GCP

mongodbatlas_advanced_cluster
.replication_specs.
region_configs.
region_name

이 구성으로 생성된 Atlas Flex 클러스터가 배포되는 리전입니다. 선택한 리전에서 Flex 클러스터가 지원되는지 확인하세요.

각 제공자가 지원하는 리전에 대한 자세한 내용은 Atlas 설명서에서 다음 섹션을 참조하세요.

5

경고

local 변수에는 민감 정보가 담겨 있습니다. 이러한 값을 공개적으로 사용 가능한 리포지토리에 체크인하지 마세요.

다음 local 변수의 값을 입력하세요.

변수
값

mongodb_atlas_client_id

Atlas 서비스 계정 클라이언트 ID.

mongodb_atlas_client_secret

Atlas 서비스 계정 클라이언트 시크릿.

mongodb_atlas_org_id

프로젝트를 만들려는 Atlas 조직 ID입니다.

mongodb_atlas_database_username

Atlas가 클러스터를 위해 생성하는 MongoDB database 사용자의 사용자 이름입니다.

mongodb_atlas_database_user_password

mongodb_atlas_database_username(으)로 명명된 MongoDB 데이터베이스 사용자의 비밀번호입니다.

mongodb_atlas_accesslistip

Atlas 클러스터에 액세스할 수 있는 IP 주소 또는 CIDR 블록입니다.

참고

이 템플릿은 서비스 계정을 사용하여 Atlas에 인증합니다. API 키도 지원되지만, 서비스 계정이 권장되는 인증 방법입니다. 두 가지 방법에 대해 알아보려면 MongoDB Atlas Terraform 제공자 인증 가이드를 참조하세요.

예시

입력 변수 파일을 사용하여 보안 극대화하기

보안을 극대화하려면 다음 단계를 수행하는 것이 좋습니다.

  1. 입력 변수 파일 에서 local 변수를 정의합니다.

    variable "mongodb_atlas_client_id" { default = "my-client-id"} variable "mongodb_atlas_client_secret" { default = "my-client-secret"}
  2. 리포지토리에서 입력 변수 파일을 제외하세요. 그 예로 리포지토리의 .gitignore 파일에 파일 이름을 추가하세요.

  3. main.tf 파일 내 입력 변수 파일에 있는 변수의 앞에 var.을(를) 붙여 해당 변수를 참조하세요.

    provider "mongodbatlas" { client_id = var.mongodb_atlas_client_id client_secret = var.mongodb_atlas_client_secret}
6

지원되는 구성 옵션의 전체 목록은 MongoDB Atlas Terraform 제공자 설명서를 참조하세요.

프로덕션 배포서버의 경우, 클러스터 리소스와 프로덕션 권장사항 기본값을 번들로 제공하는 공식 MongoDB Atlas 클러스터 모듈을 고려하세요.

참고

플렉스 클러스터는 MongoDB Atlas Terraform 제공자가 제공하는 모든 구성을 지원하지는 않습니다. 지원되지 않는 구성 목록은 Atlas 설명서를 참조하세요.

7

템플릿을 사용하여 Terraform 파일을 생성한 후 Atlas 클러스터를 만듭니다.

1
2

다음 출력은 MongoDB Atlas Terraform Provider가 설치되어 사용할 준비가 되었음을 나타냅니다.

terraform init
3

다음 출력은 Terraform 구성을 적용했을 때 어떻게 되는지를 보여줍니다.

terraform plan

내용이 정확하다면 다음 단계로 넘어가세요.

4

구성의 적용 여부를 묻는 메시지가 나타나면 yes를 입력하세요.

참고

terraform apply 명령이 완료되기까지는 몇 분 정도 걸릴 수 있습니다.

Atlas 클러스터가 생성되면 다음과 같은 출력이 표시됩니다. VS Code Extension을 사용하여 표시된 연결 문자열과 함께 이 배포서버에 대한 연결을 생성 할 수 있습니다.

terraform apply

경고

클러스터를 삭제하면 이 클러스터에 저장된 데이터베이스, 컬렉션, 문서 및 해당 클러스터를 구성한 Terraform 구성에서 정의된 기타 모든 리소스가 폐기됩니다.

진행 시 유의하세요.

Atlas 클러스터를 삭제하려면 다음을 수행하세요.

1
2
terraform destroy

구성에서 정의된 리소스의 폐기 여부를 묻는 메시지가 나타나면 yes를 입력하세요.

참고

terraform destroy 명령이 완료되기까지는 몇 분 정도 걸릴 수 있습니다.

Atlas 클러스터와 연결된 모든 리소스가 삭제되면 다음과 같은 결과가 표시됩니다.

Destroy complete! Resources: 4 destroyed.