共用方式為


快速入門:使用 AzAPI Terraform 提供者部署您的第一個 Azure 資源

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

Terraform 可讓您定義、預覽和部署雲端基礎結構。 使用 Terraform 時,您可以使用 HCL 語法來建立設定檔。 HCL 語法可讓您指定雲端提供者 (例如 Azure) 和構成雲端基礎結構的元素。 建立設定檔之後,您可以建立執行計畫,讓您先預覽基礎結構變更,之後再部署。 驗證變更之後,您可以套用執行計畫來部署基礎結構。

在本文中,您將瞭解如何使用 AzAPI Terraform 提供者來管理 AzureRM 提供者目前不支援的 Azure 服務。 azapi_resource將用來管理 Azure 實驗室服務帳戶和實驗室。

  • 定義及設定 AzureRM 和 AzAPI 提供者。
  • 使用 AzureRM 提供者建立 Azure 資源群組
  • 使用 AzureRM 提供者在您的訂用帳戶中註冊 「Microsoft.LabServices」 提供者
  • 使用 AzAPI 提供者建立 Azure 實驗室服務資源

注意

本文中的範例程式碼位於 Azure Terraform GitHub 存放庫

必要條件

  • Azure 訂用帳戶:如果您沒有 Azure 訂用帳戶,請在開始前建立免費帳戶

實作 Terraform 程式碼

  1. 建立目錄,然後在目錄中測試範例 Terraform 程式碼,並將其設為目前的目錄。

  2. 建立名為 providers.tf 的檔案,並插入下列程式碼:

    terraform {
      required_providers {
        azapi = {
          source  = "azure/azapi"
          version = "=0.1.0"
        }
        azurerm = {
          source  = "hashicorp/azurerm"
          version = "=3.0.2"
        }
      }
    }
    
    provider "azapi" {
      default_location = "eastus"
      default_tags = {
        team = "Azure deployments"
      }
    }
    
    provider "azurerm" {
      features {}
    }
    
  3. 建立名為 main.tf 的檔案,並插入下列程式碼:

    resource "azurerm_resource_group" "qs101" {
      name     = "rg-qs101"
      location = "westus2"
    }
    
  4. 建立名為 main-generic.tf 的檔案,並插入下列程式碼:

    # Provision a Lab Service Account and a Lab that are in public preview
    resource "azapi_resource" "qs101-account" {
      type      = "Microsoft.LabServices/labaccounts@2018-10-15"
      name      = "qs101LabAccount"
      parent_id = azurerm_resource_group.qs101.id
    
      body = jsonencode({
        properties = {
          enabledRegionSelection = false
        }
      })
    }
    
    resource "azapi_resource" "qs101-lab" {
      type      = "Microsoft.LabServices/labaccounts/labs@2018-10-15"
      name      = "qs101Lab"
      parent_id = azapi_resource.qs101-account.id
    
      body = jsonencode({
        properties = {
          maxUsersInLab  = 10
          userAccessMode = "Restricted"
        }
      })
    }
    

初始化 Terraform

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

terraform init -upgrade

重點︰

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

建立 Terraform 執行計畫

執行 terraform plan 以建立執行計畫。

terraform plan -out main.tfplan

重點︰

  • terraform plan 命令會建立執行計畫,但不會執行。 相反地,其會決定要在您指定的設定檔中建立設定所需的動作。 此模式可讓您在對實際資源進行任何變更之前,先確認執行方案是否符合您的預期。
  • 選用的 -out 參數可讓您指定計畫的輸出檔。 使用 -out 參數可確保您所檢閱的方案就是所套用的方案。

套用 Terraform 執行計畫

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

terraform apply main.tfplan

重點︰

  • 範例 terraform apply 命令假設您之前已執行過 terraform plan -out main.tfplan
  • 如果您為 -out 參數指定了不同的檔案名稱,請在呼叫 terraform apply 時使用該檔案名稱。
  • 若您未使用 -out 參數,請呼叫 terraform apply,不需要使用參數。

驗證結果

  1. 確認您的金鑰已列出為套用 terraform 的結果。

清除資源

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

  1. 執行 terraform plan 並指定 destroy 旗標。

    terraform plan -destroy -out main.destroy.tfplan
    

    重點︰

    • terraform plan 命令會建立執行計畫,但不會執行。 相反地,其會決定要在您指定的設定檔中建立設定所需的動作。 此模式可讓您在對實際資源進行任何變更之前,先確認執行方案是否符合您的預期。
    • 選用的 -out 參數可讓您指定計畫的輸出檔。 使用 -out 參數可確保您所檢閱的方案就是所套用的方案。
  2. 執行 terraform apply 以套用執行方案。

    terraform apply main.destroy.tfplan
    

對 Azure 上的 Terraform 進行疑難排解

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

下一步