다음을 통해 공유

빠른 시작: Terraform을 사용하여 Azure DocumentDB 클러스터 배포

이 빠른 시작에서는 Terraform을 사용하여 새 Azure DocumentDB 클러스터를 배포합니다. 이 빠른 시작에서는 빠르게 시작하는 데 도움이 되는 단계별 지침을 제공합니다. 이 클러스터에는 모든 MongoDB 리소스(데이터베이스, 컬렉션 및 문서)가 포함됩니다. Azure DocumentDB에 연결하고 작업을 수행할 수 있는 도구 및 SDK(소프트웨어 개발 키트)에 대한 고유한 엔드포인트를 제공합니다.

필수 조건

  • Azure 구독

환경 구성

구독에서 Azure DocumentDB 리소스를 관리하도록 Azure CLI 환경을 설정합니다.

  1. 빈 디렉터리에서 시작합니다.

  2. Azure CLI에 로그인합니다.

    az login

  3. 대상 Azure 구독을 확인합니다.

    az account show

    비고

    예상한 구독에 연결되지 않은 경우 다음 명령을 사용하여 구독을 변경합니다.

    az account set --subscription "<subscription-name>"

    자세한 내용은 Azure CLI를 사용하여 Azure 구독 관리를 참조하세요.

Terraform 구성 준비

Azure DocumentDB 클러스터를 배포하는 데 필요한 리소스를 정의하도록 Terraform 파일을 만들고 구성합니다.

  1. 프로젝트 디렉터리에 새 main.tf 파일을 만듭니다.

  2. 파일의 콘텐츠에 이 구성을 추가합니다.

    variable "admin_username" {
  type = string
  description = "Username for default administrator account"
}

variable "admin_password" {
  type = string
  description = "Password for default administrator account"
  sensitive = true
}

terraform {
  required_providers {
    azurerm = {
      source = "hashicorp/azurerm"
      version = "~> 4.0"
    }
  }
}

provider "azurerm" {
  features { }
}

resource "azurerm_resource_group" "resource_group" {
  name     = "example-resource-group"
  location = "West US"
}

resource "azurerm_mongo_cluster" "cluster" {
  name                   = "example-mongo-cluster"
  resource_group_name    = azurerm_resource_group.resource_group.name
  location               = azurerm_resource_group.resource_group.location
  administrator_username = var.admin_username
  administrator_password = var.admin_password
  shard_count            = "1"
  compute_tier           = "M10"
  high_availability_mode = "Disabled"
  storage_size_in_gb     = "32"
  version                = "8.0"
}

    팁 (조언)

    리소스를 사용하는 azurerm_mongo_cluster 옵션에 대한 자세한 내용은 Terraform Registry의 공급자 설명서를 참조azurerm하세요.

구성 배포

실행 계획을 사용하여 이전 단계에서 만든 구성 파일을 배포합니다.

  1. Terraform CLI를 사용하여 Terraform 배포를 초기화합니다.

    terraform init --upgrade

  2. 실행 계획을 만들고 main.tfplan이라는 파일에 저장합니다. admin_username 및 admin_password 변수에 대한 입력을 요청받으면 값을 입력하십시오.

    ARM_SUBSCRIPTION_ID=$(az account show --query id --output tsv) terraform plan --out "main.tfplan"

    비고

    이 명령은 환경 변수를 ARM_SUBSCRIPTION_ID 일시적으로 설정합니다. 이 설정은 버전 4.0 이상의 azurerm 공급자에게 필요합니다. 자세한 내용은 azurerm의 구독 ID를 참조하세요.

  3. 실행 계획을 적용하여 Azure에 리소스를 배포합니다.

    ARM_SUBSCRIPTION_ID=$(az account show --query id --output tsv) terraform apply "main.tfplan"

  4. 계속 진행하기 전에 배포 작업이 완료되기를 기다립니다.

배포된 리소스 검토

리소스 그룹에 배포된 Azure DocumentDB 리소스를 나열합니다.

  1. 리소스 그룹의 리소스 목록을 가져오는 데 사용합니다 az resource list .

    az resource list \
    --resource-group "<resource-group-name>" \
    --namespace "Microsoft.DocumentDB" \
    --resource-type "mongoClusters" \
    --query "[].name" \
    --output json

  2. 예제 출력에서 형식 Microsoft.DocumentDB/mongoClusters이 있는 리소스를 찾습니다. 다음은 예상할 출력 형식의 예입니다.

    [
  "msdocs-documentdb-example-cluster"
]

자원을 정리하세요

Terraform 구성에 정의된 모든 리소스를 제거합니다.

  1. 명령을 사용하여 Terraform에서 관리하는 리소스를 삭제합니다 destroy .

    ARM_SUBSCRIPTION_ID=$(az account show --query id --output tsv) terraform destroy

    팁 (조언)

    리소스 그룹을 구독에서 제거하려면 az group delete을(를) 사용하십시오.

    az group delete \
    --name "<resource-group-name>" \
    --yes \
    --no-wait

    중요합니다

    이 명령을 실행하기 전에 리소스가 영구적으로 삭제되므로 리소스가 더 이상 필요하지 않은지 확인합니다.

  2. 삭제를 진행하라는 관련 프롬프트를 확인합니다.

관련 콘텐츠

  • Last updated on