本文介绍如何使用 Terraform 在该区域中创建 Azure DNS 区域 和 A 记录。
使用 Terraform 可以定义、预览和部署云基础结构。 使用 Terraform 时,请使用 HCL 语法来创建配置文件。 利用 HCL 语法,可指定 Azure 这样的云提供程序和构成云基础结构的元素。 创建配置文件后,请创建一个执行计划,利用该计划,可在部署基础结构更改之前先预览这些更改。 验证了更改后,请应用该执行计划以部署基础结构。
在本文中,学习如何:
- 使用 random_pet 为 Azure 资源组名称创建一个随机值
- 使用 azurerm_resource_group 创建 Azure 资源组
- 使用 random_string 创建随机值
- 使用 azurerm_dns_zone 创建 Azure DNS 区域
- 使用 azurerm_dns_a_record 创建 Azure DNS A 记录
注意
本文中的示例代码位于 Azure Terraform GitHub 存储库中。 有关更多示例,请参阅演示如何使用 Terraform 管理 Azure 资源的文章和示例代码
创建用于测试和运行示例 Terraform 代码的目录,并将其设为当前目录。
创建名为
providers.tf
的文件并插入下列代码:
terraform {
required_version = ">=1.2"
required_providers {
azurerm = {
source = "hashicorp/azurerm"
version = "~>3.0"
}
random = {
source = "hashicorp/random"
version = "~>3.0"
}
}
}
provider "azurerm" {
features {}
environment = "china"
}
- 创建名为
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_string" "azurerm_dns_zone_name" {
length = 13
lower = true
numeric = false
special = false
upper = false
}
resource "azurerm_dns_zone" "zone" {
name = (
var.dns_zone_name != null ?
var.dns_zone_name :
"www.${random_string.azurerm_dns_zone_name.result}.azurequickstart.org"
)
resource_group_name = azurerm_resource_group.rg.name
}
resource "azurerm_dns_a_record" "record" {
name = "www"
resource_group_name = azurerm_resource_group.rg.name
zone_name = azurerm_dns_zone.zone.name
ttl = var.dns_ttl
records = var.dns_records
}
- 创建名为
variables.tf
的文件并插入下列代码:
variable "resource_group_location" {
type = string
default = "chinaeast2"
description = "Location for all resources."
}
variable "resource_group_name_prefix" {
type = string
default = "rg"
description = "Prefix of the resource group name that's combined with a random value so name is unique in your Azure subscription."
}
variable "dns_zone_name" {
type = string
default = null
description = "Name of the DNS zone."
}
variable "dns_ttl" {
type = number
default = 3600
description = "Time To Live (TTL) of the DNS record (in seconds)."
}
variable "dns_records" {
type = list(string)
default = ["1.2.3.4", "1.2.3.5"]
description = "List of IPv4 addresses."
}
- 创建名为
outputs.tf
的文件并插入下列代码:
output "resource_group_name" {
value = azurerm_resource_group.rg.name
}
output "dns_zone_name" {
value = azurerm_dns_zone.zone.name
}
output "name_servers" {
value = azurerm_dns_zone.zone.name_servers
}
运行 terraform init,将 Terraform 部署进行初始化。 此命令将下载管理 Azure 资源所需的 Azure 提供程序。
terraform init -upgrade
要点:
- 参数
-upgrade
可将必要的提供程序插件升级到符合配置版本约束的最新版本。
运行 terraform plan 以创建执行计划。
terraform plan -out main.tfplan
要点:
terraform plan
命令将创建一个执行计划,但不会执行它。 它会确定创建配置文件中指定的配置需要执行哪些操作。 此模式允许你在对实际资源进行任何更改之前验证执行计划是否符合预期。- 使用可选
-out
参数可以为计划指定输出文件。 使用-out
参数可以确保所查看的计划与所应用的计划完全一致。 - 若要详细了解如何使执行计划和安全性持久化,请参阅安全警告一节。
运行 terraform apply,将执行计划应用到云基础结构。
terraform apply main.tfplan
要点:
- 上面的
terraform apply
命令假设之前运行了terraform plan -out main.tfplan
。 - 如果为
-out
参数指定了不同的文件名,请在对terraform apply
的调用中使用该相同文件名。 - 如果未使用
-out
参数,请调用不带任何参数的terraform apply
。
获取 Azure 资源组名称。
resource_group_name=$(terraform output -raw resource_group_name)
获取 DNS 区域名称。
dns_zone_name=$(terraform output -raw dns_zone_name)
运行 az network dns zone show 显示有关新 DNS 区域的信息。
az network dns zone show \ --resource-group $resource_group_name \ --name $dns_zone_name
不再需要通过 Terraform 创建的资源时,请执行以下步骤:
运行 terraform plan 并指定
destroy
标志。terraform plan -destroy -out main.destroy.tfplan
要点:
terraform plan
命令将创建一个执行计划,但不会执行它。 它会确定创建配置文件中指定的配置需要执行哪些操作。 此模式允许你在对实际资源进行任何更改之前验证执行计划是否符合预期。- 使用可选
-out
参数可以为计划指定输出文件。 使用-out
参数可以确保所查看的计划与所应用的计划完全一致。 - 若要详细了解如何使执行计划和安全性持久化,请参阅安全警告一节。
运行 terraform apply 以应用执行计划。
terraform apply main.destroy.tfplan