快速入門：使用 Terraform 部署 Azure DocumentDB 叢集

在這個快速入門中，你將使用 Terraform 部署一個新的 Azure DocumentDB 叢集。這個快速入門提供逐步指引，幫助你快速開始。這個叢集包含你所有的 MongoDB 資源：資料庫、收藏和文件。它提供一個獨特的端點，讓工具與軟體開發套件（SDK）連接 Azure DocumentDB 並執行操作。

先決條件

Azure 訂用帳戶
- 如果您沒有 Azure 訂用帳戶，請建立免費帳戶

Terraform 1.2.0 或更新版本。

使用 Azure Cloud Shell 中的 Bash 環境。如需詳細資訊，請參閱開始使用 Azure Cloud Shell。
若要在本地執行 CLI 參考命令，請安裝 Azure CLI。若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。如需詳細資訊，請參閱如何在 Docker 容器中執行 Azure CLI。
- 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。請遵循您終端機上顯示的步驟，完成驗證程序。如需其他登入選項，請參閱使用 Azure CLI 向 Azure 進行驗證。
- 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。如需擴充功能的詳細資訊，請參閱使用和管理 Azure CLI 的擴充功能。
- 執行 az version 以尋找已安裝的版本和相依程式庫。若要升級至最新版本，請執行 az upgrade。

設定環境

設定你的 Azure CLI 環境，管理訂閱中的 Azure DocumentDB 資源。

從空白目錄開始。
登入 Azure CLI。
```
az login
```
請檢查您的目標 Azure 訂用帳戶。
```
az account show
```
備註

如果你沒有連接到預期的訂閱，請使用這個指令更改你的訂閱：
```
az account set --subscription "<subscription-name>"
```
欲了解更多資訊，請參閱使用 Azure CLI 管理 Azure 訂閱。

準備 Terraform 設定

建立並設定一個 Terraform 檔案，以定義部署 Azure DocumentDB 叢集所需的資源。

在你的專案目錄中建立一個新的 main.tf 檔案。

將此設定加入檔案內容中。

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 資源的選項資訊，請參閱 azurerm Terraform 註冊局中的提供者文件。

部署設定

使用執行計畫部署前一步建立的設定檔。

使用 Terraform CLI 初始化 Terraform 部署。
```
terraform init --upgrade
```
建立執行計畫，並儲存到一個名為 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。

套用執行計畫來部署資源到 Azure。

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

等部署作業完成後再繼續。

檢閱已部署的資源

列出已部署到你的資源群組的 Azure DocumentDB 資源。

用 az resource list 來取得你資源群組中的資源清單。

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

在範例輸出中，尋找具有類型的 Microsoft.DocumentDB/mongoClusters資源。以下是預期的輸出類型範例：
```
[
  "msdocs-documentdb-example-cluster"
]
```

清理資源

移除 Terraform 設定中所有定義的資源。

用指令 destroy 銷毀由 Terraform 管理的資源。
```
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
```
這很重要

執行這個指令前，請確定你不再需要這些資源，因為這會永久刪除它們。
請確認任何與繼續刪除相關的提示。

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-11-20