Mulai Cepat: Membuat Azure Front Door menggunakan Terraform

Mulai cepat ini menjelaskan cara menggunakan Terraform untuk membuat profil Front Door guna menyiapkan ketersediaan tinggi untuk titik akhir web.

Dalam artikel ini, Anda akan mempelajari cara:

Prasyarat

• Menginstal dan mengonfigurasi Terraform

Menerapkan kode Terraform

1. Buat direktori untuk menguji dan menjalankan kode sampel Terraform dan menjadikannya direktori saat ini.

2. Buat file bernama providers.tf dan masukkan kode berikut:

   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. Buat file bernama main.tf dan masukkan kode berikut:

   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_id" "front_door_endpoint_name" {
     byte_length = 8
   }
   
   locals {
     front_door_profile_name      = "MyFrontDoor"
     front_door_endpoint_name     = "afd-${lower(random_id.front_door_endpoint_name.hex)}"
     front_door_origin_group_name = "MyOriginGroup"
     front_door_origin_name       = "MyAppServiceOrigin"
     front_door_route_name        = "MyRoute"
   }
   
   resource "azurerm_cdn_frontdoor_profile" "my_front_door" {
     name                = local.front_door_profile_name
     resource_group_name = azurerm_resource_group.rg.name
     sku_name            = var.front_door_sku_name
   }
   
   resource "azurerm_cdn_frontdoor_endpoint" "my_endpoint" {
     name                     = local.front_door_endpoint_name
     cdn_frontdoor_profile_id = azurerm_cdn_frontdoor_profile.my_front_door.id
   }
   
   resource "azurerm_cdn_frontdoor_origin_group" "my_origin_group" {
     name                     = local.front_door_origin_group_name
     cdn_frontdoor_profile_id = azurerm_cdn_frontdoor_profile.my_front_door.id
     session_affinity_enabled = true
   
     load_balancing {
       sample_size                 = 4
       successful_samples_required = 3
     }
   
     health_probe {
       path                = "/"
       request_type        = "HEAD"
       protocol            = "Https"
       interval_in_seconds = 100
     }
   }
   
   resource "azurerm_cdn_frontdoor_origin" "my_app_service_origin" {
     name                          = local.front_door_origin_name
     cdn_frontdoor_origin_group_id = azurerm_cdn_frontdoor_origin_group.my_origin_group.id
   
     enabled                        = true
     host_name                      = azurerm_windows_web_app.app.default_hostname
     http_port                      = 80
     https_port                     = 443
     origin_host_header             = azurerm_windows_web_app.app.default_hostname
     priority                       = 1
     weight                         = 1000
     certificate_name_check_enabled = true
   }
   
   resource "azurerm_cdn_frontdoor_route" "my_route" {
     name                          = local.front_door_route_name
     cdn_frontdoor_endpoint_id     = azurerm_cdn_frontdoor_endpoint.my_endpoint.id
     cdn_frontdoor_origin_group_id = azurerm_cdn_frontdoor_origin_group.my_origin_group.id
     cdn_frontdoor_origin_ids      = [azurerm_cdn_frontdoor_origin.my_app_service_origin.id]
   
     supported_protocols    = ["Http", "Https"]
     patterns_to_match      = ["/*"]
     forwarding_protocol    = "HttpsOnly"
     link_to_default_domain = true
     https_redirect_enabled = true
   }
   

4. Buat file bernama app-service.tf dan masukkan kode berikut:

   resource "random_id" "app_name" {
     byte_length = 8
   }
   
   locals {
     app_name              = "myapp-${lower(random_id.app_name.hex)}"
     app_service_plan_name = "AppServicePlan"
   }
   
   resource "azurerm_service_plan" "app_service_plan" {
     name                = local.app_service_plan_name
     location            = azurerm_resource_group.rg.location
     resource_group_name = azurerm_resource_group.rg.name
   
     sku_name     = var.app_service_plan_sku_name
     os_type      = "Windows"
     worker_count = var.app_service_plan_capacity
   }
   
   resource "azurerm_windows_web_app" "app" {
     name                = local.app_name
     location            = azurerm_resource_group.rg.location
     resource_group_name = azurerm_resource_group.rg.name
     service_plan_id     = azurerm_service_plan.app_service_plan.id
   
     https_only = true
   
     site_config {
       ftps_state          = "Disabled"
       minimum_tls_version = "1.2"
       ip_restriction {
         service_tag               = "AzureFrontDoor.Backend"
         ip_address                = null
         virtual_network_subnet_id = null
         action                    = "Allow"
         priority                  = 100
         headers {
           x_azure_fdid      = [azurerm_cdn_frontdoor_profile.my_front_door.resource_guid]
           x_fd_health_probe = []
           x_forwarded_for   = []
           x_forwarded_host  = []
         }
         name = "Allow traffic from Front Door"
       }
     }
   }
   

5. Buat file bernama variables.tf dan masukkan kode berikut:

   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 "app_service_plan_sku_name" {
     type        = string
     description = "The SKU for the plan. Possible values include: B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, Y1."
     default     = "S1"
     validation {
       condition     = contains(["B1", "B2", "B3", "D1", "F1", "I1", "I2", "I3", "I1v2", "I2v2", "I3v2", "I4v2", "I5v2", "I6v2", "P1v2", "P2v2", "P3v2", "P0v3", "P1v3", "P2v3", "P3v3", "P1mv3", "P2mv3", "P3mv3", "P4mv3", "P5mv3", "S1", "S2", "S3", "SHARED", "EP1", "EP2", "EP3", "WS1", "WS2", "WS3", "Y1"], var.app_service_plan_sku_name)
       error_message = "The SKU value must be one of the following: B1, B2, B3, D1, F1, I1, I2, I3, I1v2, I2v2, I3v2, I4v2, I5v2, I6v2, P1v2, P2v2, P3v2, P0v3, P1v3, P2v3, P3v3, P1mv3, P2mv3, P3mv3, P4mv3, P5mv3, S1, S2, S3, SHARED, EP1, EP2, EP3, WS1, WS2, WS3, Y1."
     }
   }
   
   variable "app_service_plan_capacity" {
     type        = number
     description = "The number of Workers (instances) to be allocated."
     default     = 1
   }
   
   variable "front_door_sku_name" {
     type        = string
     description = "The SKU for the Front Door profile. Possible values include: Standard_AzureFrontDoor, Premium_AzureFrontDoor"
     default     = "Standard_AzureFrontDoor"
     validation {
       condition     = contains(["Standard_AzureFrontDoor", "Premium_AzureFrontDoor"], var.front_door_sku_name)
       error_message = "The SKU value must be one of the following: Standard_AzureFrontDoor, Premium_AzureFrontDoor."
     }
   }
   

6. Buat file bernama outputs.tf dan masukkan kode berikut:

   output "resource_group_name" {
     value = azurerm_resource_group.rg.name
   }
   
   
   output "frontDoorEndpointHostName" {
     value = azurerm_cdn_frontdoor_endpoint.my_endpoint.host_name
   }
   

Inisialisasi Terraform

Jalankan terraform init untuk menginisialisasi penyebaran Terraform. Perintah ini mengunduh penyedia Azure yang diperlukan untuk mengelola sumber daya Azure Anda.

terraform init -upgrade

Poin utama:

• Parameter -upgrade meningkatkan plugin penyedia yang diperlukan ke versi terbaru yang sesuai dengan batasan versi konfigurasi.

Buat rencana eksekusi Terraform

Jalankan terraform plan untuk membuat rencana eksekusi.

terraform plan -out main.tfplan

Poin utama:

• Perintah terraform plan membuat rencana eksekusi, tetapi tidak menjalankannya. Perintah ini justru menentukan tindakan yang diperlukan untuk membuat konfigurasi yang ditentukan dalam file konfigurasi Anda. Pola ini memungkinkan Anda memastikan apakah rencana eksekusi telah sesuai dengan ekspektasi Anda sebelum membuat perubahan pada sumber daya aktual.
• Parameter -out opsional memungkinkan Anda menentukan file output untuk rencana. Menggunakan parameter -out memastikan bahwa rencana yang Anda tinjau benar-benar sesuai dengan yang diterapkan.

Terapkan rencana eksekusi Terraform

Jalankan terraform apply untuk menerapkan rencana eksekusi ke infrastruktur cloud Anda.

terraform apply main.tfplan

Poin utama:

• Contoh terraform apply perintah mengasumsikan Anda sebelumnya menjalankan terraform plan -out main.tfplan.
• Jika Anda menentukan nama file yang berbeda untuk parameter -out, gunakan nama file yang sama dalam panggilan ke terraform apply.
• Jika Anda tidak menggunakan parameter -out, panggil terraform apply tanpa parameter apa pun.

Memverifikasi hasil

1. Dapatkan titik akhir Front Door:

   terraform output -raw frontDoorEndpointHostName
   

2. Tempelkan titik akhir ke browser.

   

Membersihkan sumber daya

Ketika Anda tidak lagi membutuhkan sumber daya yang dibuat melalui Terraform, lakukan langkah-langkah berikut:

1. Jalankan terraform plan dan tentukan bendera destroy.

   terraform plan -destroy -out main.destroy.tfplan
   

   Poin utama:

   • Perintah terraform plan membuat rencana eksekusi, tetapi tidak menjalankannya. Perintah ini justru menentukan tindakan yang diperlukan untuk membuat konfigurasi yang ditentukan dalam file konfigurasi Anda. Pola ini memungkinkan Anda memastikan apakah rencana eksekusi telah sesuai dengan ekspektasi Anda sebelum membuat perubahan pada sumber daya aktual.
   • Parameter -out opsional memungkinkan Anda menentukan file output untuk rencana. Menggunakan parameter -out memastikan bahwa rencana yang Anda tinjau benar-benar sesuai dengan yang diterapkan.

2. Jalankan terraform apply untuk menerapkan rencana eksekusi.

   terraform apply main.destroy.tfplan
   

Memecahkan masalah Terraform pada Azure

Memecahkan masalah umum saat menggunakan Terraform di Azure

Langkah berikutnya