Snabbstart: Skapa en Azure Traffic Manager-profil med Terraform
Den här snabbstarten beskriver hur du använder Terraform för att skapa en Traffic Manager-profil med externa slutpunkter med hjälp av prestandadirigeringsmetoden.
Terraform möjliggör definition, förhandsversion och distribution av molninfrastruktur. Med Terraform skapar du konfigurationsfiler med hjälp av HCL-syntax. Med HCL-syntaxen kan du ange molnleverantören – till exempel Azure – och de element som utgör din molninfrastruktur. När du har skapat konfigurationsfilerna skapar du en körningsplan som gör att du kan förhandsgranska ändringarna i infrastrukturen innan de distribueras. När du har verifierat ändringarna tillämpar du körningsplanen för att distribuera infrastrukturen.
I den här artikeln kan du se hur du:
- Skapa ett slumpmässigt värde för Azure-resursgruppens namn med hjälp av random_pet.
- Skapa en Azure-resursgrupp med hjälp av azurerm_resource_group.
- Skapa ett slumpmässigt värde för Azure Traffic Manager-profilnamnet med hjälp av random_string.
- Skapa ett slumpmässigt värde för azure Traffic Manager-profilens DNS-konfigurationsrelativt namn med hjälp av random_string.
- Skapa en Azure Traffic Manager-profil med hjälp av azurerm_traffic_manager_profile.
- Skapa två externa Slutpunkter för Azure Traffic Manager med hjälp av azurerm_traffic_manager_external_endpoint.
Förutsättningar
Implementera Terraform-koden
Kommentar
Exempelkoden för den här artikeln finns på Azure Terraform GitHub-lagringsplatsen. Du kan visa loggfilen som innehåller testresultaten från aktuella och tidigare versioner av Terraform.
Se fler artiklar och exempelkod som visar hur du använder Terraform för att hantera Azure-resurser
Skapa en katalog där du kan testa och köra Terraform-exempelkoden och göra den till den aktuella katalogen.
Skapa en fil med namnet
providers.tf
och infoga följande kod:terraform { required_version = ">=1.0" required_providers { azurerm = { source = "hashicorp/azurerm" version = "~>3.0" } random = { source = "hashicorp/random" version = "~>3.0" } } } provider "azurerm" { features {} }
Skapa en fil med namnet
main.tf
och infoga följande kod: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_traffic_manager_profile_name" { length = 25 upper = false numeric = false special = false } resource "random_string" "azurerm_traffic_manager_profile_dns_config_relative_name" { length = 10 upper = false numeric = false special = false } resource "azurerm_traffic_manager_profile" "profile" { name = random_string.azurerm_traffic_manager_profile_name.result resource_group_name = azurerm_resource_group.rg.name traffic_routing_method = "Performance" dns_config { relative_name = random_string.azurerm_traffic_manager_profile_dns_config_relative_name.result ttl = 30 } monitor_config { protocol = "HTTPS" port = 443 path = "/" expected_status_code_ranges = ["200-202", "301-302"] } } resource "azurerm_traffic_manager_external_endpoint" "endpoint1" { profile_id = azurerm_traffic_manager_profile.profile.id name = "endpoint1" target = "www.contoso.com" endpoint_location = "eastus" weight = 50 } resource "azurerm_traffic_manager_external_endpoint" "endpoint2" { profile_id = azurerm_traffic_manager_profile.profile.id name = "endpoint2" target = "www.fabrikam.com" endpoint_location = "westus" weight = 50 }
Skapa en fil med namnet
variables.tf
och infoga följande kod: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" }
Skapa en fil med namnet
outputs.tf
och infoga följande kod:output "resource_group_name" { value = azurerm_resource_group.rg.name } output "azurerm_traffic_manager_profile_name" { value = azurerm_traffic_manager_profile.profile.name } output "azurerm_traffic_manager_profile_fqdn" { value = azurerm_traffic_manager_profile.profile.fqdn }
Initiera Terraform
Kör terraform init för att initiera Terraform-distributionen. Det här kommandot laddar ned den Azure-provider som krävs för att hantera dina Azure-resurser.
terraform init -upgrade
Viktiga punkter:
- Parametern
-upgrade
uppgraderar nödvändiga provider-plugin-program till den senaste versionen som uppfyller konfigurationens versionsbegränsningar.
Skapa en Terraform-körningsplan
Kör terraform-planen för att skapa en körningsplan.
terraform plan -out main.tfplan
Viktiga punkter:
- Kommandot
terraform plan
skapar en körningsplan, men kör den inte. I stället avgör den vilka åtgärder som krävs för att skapa den konfiguration som anges i konfigurationsfilerna. Med det här mönstret kan du kontrollera om körningsplanen matchar dina förväntningar innan du gör några ändringar i faktiska resurser. - Med den valfria
-out
parametern kan du ange en utdatafil för planen. Med hjälp av parametern-out
ser du till att planen du granskade är exakt vad som tillämpas.
Tillämpa en Terraform-körningsplan
Kör terraform gäller för att tillämpa körningsplanen på din molninfrastruktur.
terraform apply main.tfplan
Viktiga punkter:
terraform apply
Exempelkommandot förutsätter att du tidigare kördeterraform plan -out main.tfplan
.- Om du har angett ett annat filnamn för parametern
-out
använder du samma filnamn i anropet tillterraform apply
. - Om du inte använde parametern
-out
anroparterraform apply
du utan några parametrar.
Verifiera resultatet
Hämta namnet på Azure-resursgruppen.
resource_group_name=$(terraform output -raw resource_group_name)
Hämta Traffic Manager-profilnamnet.
traffic_manager_profile_name=$(terraform output -raw azurerm_traffic_manager_profile_name)
Kör az network traffic-manager profile show för att visa information om den nya Traffic Manager-profilen.
az network traffic-manager profile show \ --resource-group $resource_group_name \ --name $traffic_manager_profile_name
Rensa resurser
Gör följande när du inte längre behöver de resurser som skapats via Terraform:
Kör terraform-plan och ange
destroy
flaggan.terraform plan -destroy -out main.destroy.tfplan
Viktiga punkter:
- Kommandot
terraform plan
skapar en körningsplan, men kör den inte. I stället avgör den vilka åtgärder som krävs för att skapa den konfiguration som anges i konfigurationsfilerna. Med det här mönstret kan du kontrollera om körningsplanen matchar dina förväntningar innan du gör några ändringar i faktiska resurser. - Med den valfria
-out
parametern kan du ange en utdatafil för planen. Med hjälp av parametern-out
ser du till att planen du granskade är exakt vad som tillämpas.
- Kommandot
Kör terraform tillämpa för att tillämpa körningsplanen.
terraform apply main.destroy.tfplan
Felsöka Terraform i Azure
Felsöka vanliga problem när du använder Terraform i Azure