Поделиться через


Быстрый старт: Создание профиля Azure Traffic Manager с помощью Terraform

В этом кратком руководстве описывается, как использовать Terraform для создания профиля диспетчера трафика с внешними конечными точками с помощью метода маршрутизации производительности.

Terraform включает определение, предварительную версию и развертывание облачной инфраструктуры. С помощью Terraform вы создаете файлы конфигурации с помощью синтаксиса HCL. Синтаксис HCL позволяет указать поставщика облачных служб, таких как Azure, и элементы, составляющие облачную инфраструктуру. После создания файлов конфигурации вы создадите план выполнения , который позволяет предварительно просмотреть изменения инфраструктуры перед развертыванием. После проверки изменений примените план выполнения для развертывания инфраструктуры.

В этой статье вы узнаете, как:

  • Создайте случайное значение для имени группы ресурсов Azure с помощью random_pet.
  • Создайте группу ресурсов Azure с помощью azurerm_resource_group.
  • Создайте случайное значение для имени профиля диспетчера трафика Azure с помощью random_string.
  • Создайте случайное значение для относительного имени конфигурации DNS профиля диспетчера трафика Azure с помощью random_string.
  • Создайте профиль диспетчера трафика Azure с помощью azurerm_traffic_manager_profile.
  • Создайте две внешние конечные точки Диспетчера трафика Azure с помощью azurerm_traffic_manager_external_endpoint.

Предпосылки

Реализация кода Terraform

Примечание.

Пример кода для этой статьи находится в репозитории Azure Terraform GitHub. Вы можете просмотреть файл журнала, содержащий результаты теста из текущих и предыдущих версий Terraform.

Дополнительные статьи и пример кода, демонстрирующие использование Terraform для управления ресурсами Azure

  1. Создайте каталог для тестирования и выполнения примера кода Terraform и сделайте его текущим каталогом.

  2. Создайте файл с именем providers.tf и вставьте следующий код:

    terraform {
      required_version = ">=1.0"
      required_providers {
        azurerm = {
          source  = "hashicorp/azurerm"
          version = "~>3.0"
        }
        random = {
          source  = "hashicorp/random"
          version = "~>3.0"
        }
      }
    }
    provider "azurerm" {
      features {}
    }
    
  3. Создайте файл с именем 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_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
    }
    
  4. Создайте файл с именем 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"
    }
    
  5. Создайте файл с именем outputs.tf и вставьте следующий код:

    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
    }
    

Инициализируйте 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. Получите имя группы ресурсов Azure.

    resource_group_name=$(terraform output -raw resource_group_name)
    
  2. Получите имя профиля диспетчера трафика.

    traffic_manager_profile_name=$(terraform output -raw azurerm_traffic_manager_profile_name)
    
  3. Запустите az network traffic-manager profile show , чтобы отобразить сведения о новом профиле диспетчера трафика.

    az network traffic-manager profile show \
        --resource-group $resource_group_name \
        --name $traffic_manager_profile_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
    

Устранение неполадок с Terraform в Azure

Устранение распространенных проблем при использовании Terraform в Azure

Дальнейшие действия