快速入門：使用 Terraform 建立實例 - Azure SQL 受控實例

發行項
03/22/2025

使用下列 Terraform 和 Terraform 提供者版本進行測試的文章：

本文說明如何使用 Terraform，在虛擬網路（vNet）和與路由表和網路安全組相關聯的子網中部署 Azure SQL 受控實例。

Terraform 能夠定義、預覽和配置雲端基礎架構。使用 Terraform，您可以使用 HCL 語法建立組態檔。 HCL 語法可讓您指定雲端提供者，例如 Azure，以及構成雲端基礎結構的專案。建立組態檔之後，您會建立 執行計劃，讓您在部署基礎結構變更之前預覽這些變更。驗證變更之後，您會套用執行計劃來部署基礎結構。

在本文中，您將瞭解如何：

建立 SQL 受控實例運行所需的所有支援服務
部署 SQL 受控實例

注意

本文中的範例程式代碼位於 Azure Terraform GitHub 存放庫。請參閱更多文章和範例程式代碼，示範如何使用 Terraform 來管理 Azure 資源

先決條件

Azure 訂用帳戶：如果您沒有 Azure 訂用帳戶，請在開始之前建立免費帳戶。

Azure 訂用帳戶。如果您沒有 Azure 訂用帳戶，建立免費帳戶
在一般情況下，您的用戶必須具有指派於訂用帳戶範圍的 SQL 管理的實例貢獻者角色。
如果在已經委派給 Azure SQL 受控實例的子網中進行布建，您的使用者只需要在訂閱範圍內被賦予 Microsoft.Sql/managedInstances/write 許可權。
安裝和設定 Terraform

實作 Terraform 程式代碼

建立目錄，在其中測試並執行範例 Terraform 程式代碼，並將其設為目前目錄。

建立名為 providers.tf 的檔案，並插入下列程序代碼：

terraform {
  required_version = ">= 1.0"

  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = ">= 3.0, < 4.0"
    }
    random = {
      source  = "hashicorp/random"
      version = ">= 3.0"
    }
  }
}

provider "azurerm" {
  features {
    resource_group {
      prevent_deletion_if_contains_resources = false
    }
  }
}

建立名為 main.tf 的檔案，並插入下列程序代碼：

# TODO set the variables below either enter them in plain text after = sign, or change them in variables.tf
#  (var.xyz will take the default value from variables.tf if you don't change it)

# Create resource group
resource "azurerm_resource_group" "example" {
  name     = "${random_pet.prefix.id}-rg"
  location = var.location
}

# Create security group
resource "azurerm_network_security_group" "example" {
  name                = "${random_pet.prefix.id}-nsg"
  location            = azurerm_resource_group.example.location
  resource_group_name = azurerm_resource_group.example.name
}

# Create a virtual network
resource "azurerm_virtual_network" "example" {
  name                = "${random_pet.prefix.id}-vnet"
  resource_group_name = azurerm_resource_group.example.name
  address_space       = ["10.0.0.0/24"]
  location            = azurerm_resource_group.example.location
}

# Create a subnet
resource "azurerm_subnet" "example" {
  name                 = "${random_pet.prefix.id}-subnet"
  resource_group_name  = azurerm_resource_group.example.name
  virtual_network_name = azurerm_virtual_network.example.name
  address_prefixes     = ["10.0.0.0/27"]

  delegation {
    name = "managedinstancedelegation"

    service_delegation {
      name = "Microsoft.Sql/managedInstances"
      actions = [
        "Microsoft.Network/virtualNetworks/subnets/join/action",
        "Microsoft.Network/virtualNetworks/subnets/prepareNetworkPolicies/action",
        "Microsoft.Network/virtualNetworks/subnets/unprepareNetworkPolicies/action"
      ]
    }
  }
}

# Associate subnet and the security group
resource "azurerm_subnet_network_security_group_association" "example" {
  subnet_id                 = azurerm_subnet.example.id
  network_security_group_id = azurerm_network_security_group.example.id
}

# Create a route table
resource "azurerm_route_table" "example" {
  name                          = "${random_pet.prefix.id}-rt"
  location                      = azurerm_resource_group.example.location
  resource_group_name           = azurerm_resource_group.example.name
  disable_bgp_route_propagation = false
}

# Associate subnet and the route table
resource "azurerm_subnet_route_table_association" "example" {
  subnet_id      = azurerm_subnet.example.id
  route_table_id = azurerm_route_table.example.id

  depends_on = [azurerm_subnet_network_security_group_association.example]
}

# Create managed instance
resource "azurerm_mssql_managed_instance" "main" {
  name                         = "${random_pet.prefix.id}-mssql"
  resource_group_name          = azurerm_resource_group.example.name
  location                     = azurerm_resource_group.example.location
  subnet_id                    = azurerm_subnet.example.id
  administrator_login          = "${replace(random_pet.prefix.id, "-", "")}admin"
  administrator_login_password = random_password.password.result
  license_type                 = var.license_type
  sku_name                     = var.sku_name
  vcores                       = var.vcores
  storage_size_in_gb           = var.storage_size_in_gb

  depends_on = [azurerm_subnet_route_table_association.example]
}

resource "random_password" "password" {
  length      = 20
  min_lower   = 1
  min_upper   = 1
  min_numeric = 1
  min_special = 1
  special     = true
}

resource "random_pet" "prefix" {
  prefix = var.prefix
  length = 1
}

建立名為 variables.tf 的檔案，並插入下列程序代碼：

variable "prefix" {
  type        = string
  default     = "mi"
  description = "Prefix of the resource name"
}

variable "location" {
  type        = string
  description = "Enter the location where you want to deploy the resources"
  default     = "eastus"
}

variable "sku_name" {
  type        = string
  description = "Enter SKU"
  default     = "GP_Gen5"
}

variable "license_type" {
  type        = string
  description = "Enter license type"
  default     = "BasePrice"
}

variable "vcores" {
  type        = number
  description = "Enter number of vCores you want to deploy"
  default     = 8
}

variable "storage_size_in_gb" {
  type        = number
  description = "Enter storage size in GB"
  default     = 32
}

初始化 Terraform

執行 terraform init 來初始化 Terraform 部署。此命令會下載管理 Azure 資源所需的 Azure 提供者。

terraform init -upgrade

重點：

-upgrade 參數會將必要的提供者外掛程式升級至符合組態版本條件約束的最新版本。

建立 Terraform 執行計劃

執行 terraform plan，以建立執行計劃。

terraform plan -out main.tfplan

重點：

terraform plan 命令會建立執行計劃，但不會執行它。然而，它會決定哪些動作是必要的，以建立您組態檔中所指定的設定。此模式可讓您在對實際資源進行任何變更之前，先確認執行計劃是否符合您的預期。
選擇性 -out 參數可讓您指定計劃的輸出檔。使用 -out 參數可確保您查看的計劃確切地被套用。

套用 Terraform 執行計劃

執行 terraform 套用，將執行計劃套用至您的雲端基礎結構。

terraform apply main.tfplan

重點：

範例 terraform apply 命令假設您先前已執行 terraform plan -out main.tfplan。
如果您為 -out 參數指定了不同的檔案名，請在呼叫 terraform apply時使用相同的檔案名。
如果您未使用 -out 參數，請呼叫沒有任何參數的 terraform apply。

確認結果

若要確認 Azure 入口網站內的結果，請流覽至新的資源群組。新實例在部署之後會位於新的資源群組中。若要查看部署進度，請保持 PowerShell 打開，或是前往 Azure 管理入口網站，搜尋 SQL 受控實例，然後依狀態篩選所有實例來查看。

清除資源

當您不再需要透過 Terraform 建立的資源時，請執行下列步驟：

執行 terraform 方案並指定 destroy 旗標。
```
terraform plan -destroy -out main.destroy.tfplan
```
重點：
- terraform plan 命令會建立執行計劃，但不會執行它。然而，它會決定哪些動作是必要的，以建立您組態檔中所指定的設定。此模式可讓您在對實際資源進行任何變更之前，先確認執行計劃是否符合您的預期。
- 選擇性 -out 參數可讓您指定計劃的輸出檔。使用 -out 參數可確保您查看的計劃確切地被套用。
運行 terraform apply 來套用執行計劃。
```
terraform apply main.destroy.tfplan
```

排除 Azure 上 Terraform 的故障

針對在 Azure 上使用 Terraform 時的常見問題進行疑難解答

後續步驟

深入瞭解 Azure SQL 受控實例

共用方式為

快速入門：使用 Terraform 建立實例 - Azure SQL 受控實例

先決條件

實作 Terraform 程式代碼

初始化 Terraform

建立 Terraform 執行計劃

套用 Terraform 執行計劃

確認結果

清除資源

排除 Azure 上 Terraform 的故障

後續步驟

意見反應

其他資源