Terraform 및 MongoDB Atlas 제공자 시작하기

Terraform을 사용하면 Atlas Terraform 제공자 와 함께 MongoDB Atlas 인프라를 코드로 관리 수 있습니다. Atlas Terraform 제공자 는 Atlas 인프라를 코드로 프로비저닝, 관리 및 제어하는 프로세스 를 간소화하여 인프라 배포를 자동화합니다.

이 가이드 에서는 기존 MongoDB Atlas 조직 및 프로젝트 에서 Atlas cluster를 생성, 수정 및 폐기하는 방법을 설명합니다.

테스트 환경을 구성한 후에는 MongoDB 및 HashiCorp의 추가 리소스 를 사용하여 Terraform 관리형 인프라를 계속 실험해 보세요.

전제 조건

Terraform과 함께 MongoDB Atlas 를 배포하기 전에 다음을 수행해야 합니다.

Atlas 계정을 만듭니다.
인 조직 ID 를 Organization Owner얻습니다.

팁
Atlas UI의 General Settings 아래에서 조직 ID를 찾을 수 있습니다.
Configure a 서비스 계정(SA) 인증. Organization Owner 역할은 조직 ID를 보고, 서비스 계정을 관리하고, 클러스터 및 기타 프로젝트 리소스를 생성하거나 삭제하는 데 필요합니다.
Terraform을 설치합니다.

Terraform으로 MongoDB Atlas 배포

빈 디렉토리 를 만들고 탐색합니다.

mkdir terraform-proj
cd terraform-proj

Terraform 파일을 만듭니다.

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

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

지원 파일을 채웁니다.

Atlas-basic 모듈 을 확인하고 이전 단계에서 생성한 파일에 콘텐츠를 복사합니다(콘텐츠를 보려면 Source Code 의 링크 클릭).

참고

Atlas 공개 키와 비공개 키는 비밀입니다. 환경변수로 저장하는 것이 좋습니다.

`main.tf` 콘텐츠를 구성합니다.

main.tf 파일 에서 다음 필드를 업데이트합니다.

필드	새 값
`instance_size`	`"M0"`
`backing_provider_name`	제공자. 가능한 값은 `"AWS"`, `"AZURE"` 또는 `"GCP"` 입니다.
`region_name`	사용할 수 있는 모든 리전은 클라우드 제공자 및 리전 을 참조하세요.

(선택 사항) 매개변수를 표시합니다.

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

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

프로젝트 를 초기화합니다.

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

terraform init

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

실행 계획을 확인합니다.

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

terraform plan

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

인프라를 배포하세요.

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

terraform apply

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

참고

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

배포서버 확인

terraform apply 가 완료되면 클러스터가 배포되었는지 확인합니다.

새 클러스터가 프로젝트 아래 Atlas UI에 표시됩니다.
main.tf에 출력 값을 추가한 경우 연결 문자열이 Terraform 출력에 표시됩니다.

MongoDB Atlas 인스턴스 종료

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

terraform destroy

경고

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

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

다음 단계

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

조직 및 프로젝트 만들기: Atlas가 처음이신 경우 조직 및 프로젝트 관리를 참조하세요.
고급 구성 탐색: 더 완전한 구성을 위해 atlas-basic 모듈 과 Atlas Terraform 제공자 문서 를 검토합니다.
클러스터에 연결합니다: 클러스터 객체에서 또는 Terraform 출력 값에서 연결 문자열을 사용합니다.

추가 리소스:

돌아가기

개요

Terraform 모듈