クイックスタート: Terraform を使用して Azure で Linux VM クラスターを作成する

適用対象: ✔️ Linux VM

この記事では、Terraform を使用して Azure で (2 つの Linux VM インスタンスを含む) Linux VM クラスターを作成する方法を示します。

この記事では、次のことについて説明します。

• random_pet を使用して Azure リソース グループ名のランダムな値を作成する。
• azurerm_resource_group を使用して Azure リソース グループを作成する。
• azurerm_virtual_network を使用して仮想ネットワークを作成する
• azurerm_subnet を使用してサブネットを作成する
• azurerm_public_ip を使用してパブリック IP を作成する
• azurerm_lb を使用してロード バランサーを作成する
• azurerm_lb_backend_address_pool を使用してロード バランサー アドレス プールを作成する
• azurerm_network_interface を使用してネットワーク インターフェイスを作成する
• azurerm_managed_disk を使用してマネージド ディスクを作成する
• azurerm_availability_set を使用して可用性セットを作成する
• azurerm_linux_virtual_machine を使用して Linux 仮想マシンを作成する
• AzAPI リソース azapi_resource を作成します。
• azapi_resource_action を使用して SSH キー ペアを生成する AzAPI リソースを作成します。

前提条件

• Terraform のインストールと構成

Terraform コードを実装する

注意

この記事のサンプル コードは、Azure Terraform GitHub リポジトリにあります。 Terraform の現在および以前のバージョンのテスト結果を含むログ ファイルを表示できます。

Terraform を使用して Azure リソースを管理する方法を示すその他の記事とサンプル コードを参照してください

1. サンプルの Terraform コードをテストするディレクトリを作成し、それを現在のディレクトリにします。

2. providers.tf という名前のファイルを作成し、次のコードを挿入します。

   terraform {
     required_version = ">=1.0"
     required_providers {
       azapi = {
         source  = "azure/azapi"
         version = "~>1.5"
       }
       azurerm = {
         source  = "hashicorp/azurerm"
         version = "~>3.0"
       }
       random = {
         source  = "hashicorp/random"
         version = "~>3.0"
       }
     }
   }
   provider "azurerm" {
     features {}
   }
   

3. ssh.tf という名前のファイルを作成し、次のコードを挿入します。

   resource "random_pet" "ssh_key_name" {
     prefix    = "ssh"
     separator = ""
   }
   
   resource "azapi_resource_action" "ssh_public_key_gen" {
     type        = "Microsoft.Compute/sshPublicKeys@2022-11-01"
     resource_id = azapi_resource.ssh_public_key.id
     action      = "generateKeyPair"
     method      = "POST"
   
     response_export_values = ["publicKey", "privateKey"]
   }
   
   resource "azapi_resource" "ssh_public_key" {
     type      = "Microsoft.Compute/sshPublicKeys@2022-11-01"
     name      = random_pet.ssh_key_name.id
     location  = azurerm_resource_group.rg.location
     parent_id = azurerm_resource_group.rg.id
   }
   
   output "key_data" {
     value = azapi_resource_action.ssh_public_key_gen.output.publicKey
   }
   

4. main.tf という名前のファイルを作成し、次のコードを挿入します。

   resource "random_pet" "rg_name" {
     prefix = var.resource_group_name_prefix
   }
   
   resource "azurerm_resource_group" "rg" {
     name     = random_pet.rg_name.id
     location = var.resource_group_location
   }
   
   resource "random_pet" "azurerm_virtual_network_name" {
     prefix = "vnet"
   }
   
   resource "azurerm_virtual_network" "test" {
     name                = random_pet.azurerm_virtual_network_name.id
     address_space       = ["10.0.0.0/16"]
     location            = azurerm_resource_group.rg.location
     resource_group_name = azurerm_resource_group.rg.name
   }
   
   resource "random_pet" "azurerm_subnet_name" {
     prefix = "sub"
   }
   
   resource "azurerm_subnet" "test" {
     name                 = random_pet.azurerm_subnet_name.id
     resource_group_name  = azurerm_resource_group.rg.name
     virtual_network_name = azurerm_virtual_network.test.name
     address_prefixes     = ["10.0.2.0/24"]
   }
   
   resource "azurerm_public_ip" "test" {
     name                = "publicIPForLB"
     location            = azurerm_resource_group.rg.location
     resource_group_name = azurerm_resource_group.rg.name
     allocation_method   = "Static"
   }
   
   resource "azurerm_lb" "test" {
     name                = "loadBalancer"
     location            = azurerm_resource_group.rg.location
     resource_group_name = azurerm_resource_group.rg.name
   
     frontend_ip_configuration {
       name                 = "publicIPAddress"
       public_ip_address_id = azurerm_public_ip.test.id
     }
   }
   
   resource "azurerm_lb_backend_address_pool" "test" {
     loadbalancer_id = azurerm_lb.test.id
     name            = "BackEndAddressPool"
   }
   
   resource "azurerm_network_interface" "test" {
     count               = 2
     name                = "acctni${count.index}"
     location            = azurerm_resource_group.rg.location
     resource_group_name = azurerm_resource_group.rg.name
   
     ip_configuration {
       name                          = "testConfiguration"
       subnet_id                     = azurerm_subnet.test.id
       private_ip_address_allocation = "Dynamic"
     }
   }
   
   resource "azurerm_availability_set" "avset" {
     name                         = "avset"
     location                     = azurerm_resource_group.rg.location
     resource_group_name          = azurerm_resource_group.rg.name
     platform_fault_domain_count  = 2
     platform_update_domain_count = 2
     managed                      = true
   }
   
   resource "random_pet" "azurerm_linux_virtual_machine_name" {
     prefix = "vm"
   }
   
   resource "azurerm_linux_virtual_machine" "test" {
     count                 = 2
     name                  = "${random_pet.azurerm_linux_virtual_machine_name.id}${count.index}"
     location              = azurerm_resource_group.rg.location
     availability_set_id   = azurerm_availability_set.avset.id
     resource_group_name   = azurerm_resource_group.rg.name
     network_interface_ids = [azurerm_network_interface.test[count.index].id]
     size                  = "Standard_DS1_v2"
   
     # Uncomment this line to delete the OS disk automatically when deleting the VM
     # delete_os_disk_on_termination = true
   
     # Uncomment this line to delete the data disks automatically when deleting the VM
     # delete_data_disks_on_termination = true
   
     source_image_reference {
       publisher = "Canonical"
       offer     = "UbuntuServer"
       sku       = "16.04-LTS"
       version   = "latest"
     }
   
     admin_ssh_key {
       username   = var.username
       public_key = azapi_resource_action.ssh_public_key_gen.output.publicKey
     }
   
     os_disk {
       caching              = "ReadWrite"
       storage_account_type = "Standard_LRS"
       name                 = "myosdisk${count.index}"
     }
   
     computer_name  = "hostname"
     admin_username = var.username
   }
   
   resource "azurerm_managed_disk" "test" {
     count                = 2
     name                 = "datadisk_existing_${count.index}"
     location             = azurerm_resource_group.rg.location
     resource_group_name  = azurerm_resource_group.rg.name
     storage_account_type = "Standard_LRS"
     create_option        = "Empty"
     disk_size_gb         = "1024"
   }
   
   resource "azurerm_virtual_machine_data_disk_attachment" "test" {
     count              = 2
     managed_disk_id    = azurerm_managed_disk.test[count.index].id
     virtual_machine_id = azurerm_linux_virtual_machine.test[count.index].id
     lun                = "10"
     caching            = "ReadWrite"
   }
   

5. variables.tf という名前のファイルを作成し、次のコードを挿入します。

   variable "resource_group_location" {
     type        = string
     description = "Location for all resources."
     default     = "eastus"
   }
   
   variable "resource_group_name_prefix" {
     type        = string
     description = "Prefix of the resource group name that's combined with a random ID so name is unique in your Azure subscription."
     default     = "rg"
   }
   
   variable "username" {
     type        = string
     description = "The username for the local account that will be created on the new VM."
     default     = "azureadmin"
   }
   

6. outputs.tf という名前のファイルを作成し、次のコードを挿入します。

   output "resource_group_name" {
     value = azurerm_resource_group.rg.name
   }
   
   output "virtual_network_name" {
     value = azurerm_virtual_network.test.name
   }
   
   output "subnet_name" {
     value = azurerm_subnet.test.name
   }
   
   output "linux_virtual_machine_names" {
     value = [for s in azurerm_linux_virtual_machine.test : s.name[*]]
   }
   

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 を呼び出します。

Terraform での仮想マシン作成プロセス中のコスト情報は、Azure portal と同じようには表示されません。 仮想マシンのコストのしくみの詳細を知りたい場合は、コスト最適化の概要ページを参照してください。

結果を確認する

Azure CLI

1. Azure リソース グループ名を取得します。

   resource_group_name=$(terraform output -raw resource_group_name)
   

2. JMESPath クエリを使用して az vm list を実行し、リソース グループに作成された仮想マシンの名前を表示します。

   az vm list \
     --resource-group $resource_group_name \
     --query "[].{\"VM Name\":name}" -o table
   

Azure PowerShell

1. Azure リソース グループ名を取得します。

   $resource_group_name=$(terraform output -raw resource_group_name)
   

2. Get-AzVm を実行して、リソース グループ内のすべての仮想マシンの名前を表示します。

   Get-AzVm -ResourceGroupName $resource_group_name
   

リソースをクリーンアップする

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 を使用する場合の一般的な問題のトラブルシューティング

次のステップ

Azure Linux 仮想マシンのチュートリアル