Azure DocumentDB의 고성능 스토리지

Azure Portal(https://portal.azure.com)에 로그인합니다.

Azure 포털 메뉴 또는 홈 페이지에서 리소스 만들기를 선택합니다.

새 페이지에서 Azure DocumentDB를 검색하여 선택합니다.

Azure DocumentDB 클러스터 만들기 페이지 및 기본 사항 섹션 내에서 클러스터 계층 섹션 내에서 구성 옵션을 선택합니다.

구성 페이지에서 필요에 따라 클러스터 계층 및 스토리지 크기를 선택합니다. 스토리지 유형을 프리미엄 SSD v2 로 선택하여 고성능 스토리지를 사용하도록 설정한 다음 저장을 선택하여 변경 내용을 적용합니다.

나머지 세부 정보를 입력한 다음 검토 + 만들기를 선택합니다.

제공한 설정을 검토한 다음, 만들기를 선택합니다. 클러스터를 만드는 데 몇 분이 걸립니다. 리소스 배포가 완료되기를 기다립니다.

마지막으로 리소스로 이동을 선택하여 포털에서 Azure DocumentDB 클러스터로 이동합니다.

새 터미널을 엽니다.

Azure CLI 로그인합니다.

역할 정의를 정의하는 새 Bicep 파일을 만듭니다. main.bicep 파일의 이름을 지정합니다.

파일의 콘텐츠에 이 템플릿을 추가합니다. <cluster-name>, <location>, <username>및 <password> 자리 표시자를 적절한 값으로 바꿉다.

resource cluster 'Microsoft.DocumentDB/mongoClusters@2025-09-01' = {
  name: '<cluster-name>'
  location: '<location>'
  properties: {
    administrator: {
      userName: '<username>'
      password: '<password>'
    }
    serverVersion: '8.0'
    storage: {
      sizeGb: 32
      type: 'PremiumSSDv2'
    }
    compute: {
      tier: 'M30'
    }
    sharding: {
      shardCount: 1
    }
    highAvailability: {
      targetMode: 'Disabled'
    }
  }
}

az deployment group create를 사용하여 Bicep 템플릿을 배포합니다. Bicep 템플릿의 이름을 지정하고 <resource-group> 자리 표시자를 대상 Azure 리소스 그룹의 이름으로 바꿉니다.

az deployment group create \
    --resource-group "<resource-group>" \
    --template-file main.bicep

배포가 완료되기를 기다립니다. 배포의 출력을 검토합니다.

새 터미널을 엽니다.

Azure CLI 로그인합니다.

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

az account show

새 Terraform 파일에서 클러스터를 정의합니다. 파일 클러스터의 이름을 지정 합니다tf.

파일의 콘텐츠에 이 리소스 구성을 추가합니다. <cluster-name>, <resource-group>및 <location> 자리 표시자를 적절한 값으로 바꿉 있습니다.

variable "admin_username" {
  type        = string
  description = "Administrator username for the cluster."
  sensitive   = true
}

variable "admin_password" {
  type        = string
  description = "Administrator password for the cluster."
  sensitive   = true
}

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

provider "azurerm" {
  features {}
}

data "azurerm_resource_group" "existing" {
  name = "<resource-group>"
}

resource "azurerm_mongo_cluster" "cluster" {
  name                   = "<cluster-name>"
  resource_group_name    = data.azurerm_resource_group.existing.name
  location               = "<location>"
  administrator_username = var.admin_username
  administrator_password = var.admin_password
  shard_count            = "1"
  compute_tier           = "M30"
  high_availability_mode = "Disabled"
  storage_size_in_gb     = "32"
  storage_type           = "PremiumSSDv2"
  version                = "8.0"
}

Terraform 배포를 초기화합니다.

terraform init --upgrade

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

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

실행 계획을 적용하여 클러스터를 Azure에 배포합니다.

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

배포가 완료되기를 기다립니다. 배포의 출력을 검토합니다.

새 터미널을 엽니다.

Azure CLI 로그인합니다.

cluster.json새 JSON 파일을 만듭니다.

이 문서를 파일의 콘텐츠에 추가합니다. <location>, <username>및 <password> 자리 표시자를 적절한 값으로 바꿉 있습니다.

{
  "location": "<location>",
  "properties": {
    "administrator": {
      "userName": "<username>",
      "password": "<password>"
    },
    "serverVersion": "8.0",
    "storage": {
      "sizeGb": 32,
      "type": "PremiumSSDv2"
    },
    "compute": {
      "tier": "M30"
    },
    "sharding": {
      "shardCount": 1
    },
    "highAvailability": {
      "targetMode": "Disabled"
    }
  }
}

az rest Azure CLI 명령을 사용하여 JSON 파일에 지정된 구성으로 새 클러스터를 만듭니다. JSON 파일 body 의 이름을 요청의 이름으로 지정하고 다음 자리 표시자를 대체합니다.

az rest \
    --method "GET" \
    --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>/users?api-version=2025-09-01" \
    --body @cluster.json

배포가 완료되기를 기다립니다. 배포의 출력을 검토합니다.