빠른 시작: Terraform을 사용하여 Azure CDN 프로필 및 엔드포인트 만들기

중요합니다

Microsoft(클래식)의 Azure CDN 표준은 2027년 9월 30일에 사용 중지됩니다. 서비스 중단을 방지하려면 2027년 9월 30일까지 Azure CDN 표준을 Microsoft(클래식) 프로필에서 Azure Front Door 표준 또는 프리미엄 계층으로 마이그레이션하는 것이 중요합니다. 자세한 내용은 Azure CDN Standard from Microsoft (클래식) 사용 중지를 참조하세요.

Edgio의 Azure CDN은 2025년 1월 15일에 사용 중지되었습니다. 자세한 내용은 Edgio 사용 중지 FAQ의 Azure CDN을 참조하세요.

이 문서에서는 Terraform을 사용하여 Azure CDN 프로필 및 엔드포인트를 만드는 방법을 보여줍니다.

Terraform 을 사용하면 클라우드 인프라의 정의, 미리 보기 및 배포가 가능합니다. Terraform을 사용하여 HCL 구문을 사용하여 구성 파일을 만듭니다. HCL 구문을 사용하면 클라우드 공급자(예: Azure) 그리고 클라우드 인프라를 구성하는 요소를 지정할 수 있습니다. 구성 파일을 만든 후에는 인프라 변경 내용을 배포하기 전에 미리 볼 수 있는 실행 계획을 만듭니다. 변경 내용을 확인 한 후에는 실행 계획을 적용하여 인프라를 배포합니다.

이 문서에서는 다음 방법을 설명합니다.

• random_pet 사용하여 Azure 리소스 그룹 이름에 대한 임의 애완 동물 이름 만들기
• azurerm_resource_group 사용하여 Azure 리소스 그룹 만들기
• random_string 사용하여 CDN 엔드포인트 이름에 대한 임의 문자열 만들기
• azurerm_cdn_profile 사용하여 Azure CDN 프로필 만들기
• azurerm_cdn_endpoint 사용하여 Azure CDN 엔드포인트 만들기

필수 조건

• Terraform 설치 및 구성

Terraform 코드 구현

참고 항목

이 문서의 샘플 코드는 Azure Terraform GitHub 리포지토리에 있습니다. 현재 및 이전 버전의 Terraform에서 테스트 결과를 포함하는 로그 파일을 볼 수 있습니다.

Terraform을 사용하여 Azure 리소스를 관리하는 방법을 보여 주는 더 많은 문서 및 샘플 코드를 참조하세요.

1. 샘플 Terraform 코드를 테스트 및 실행할 디렉터리를 만들고 현재 디렉터리로 만듭니다.

2. 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" "aazurerm_cdn_profile_name" {
     length  = 13
     lower   = true
     numeric = false
     special = false
     upper   = false
   }
   
   resource "azurerm_cdn_profile" "profile" {
     name                = "profile-${random_string.azurerm_cdn_endpoint_name.result}"
     location            = azurerm_resource_group.rg.location
     resource_group_name = azurerm_resource_group.rg.name
     sku                 = var.cdn_sku
   }
   
   resource "random_string" "azurerm_cdn_endpoint_name" {
     length  = 13
     lower   = true
     numeric = false
     special = false
     upper   = false
   }
   
   resource "azurerm_cdn_endpoint" "endpoint" {
     name                          = "endpoint-${random_string.azurerm_cdn_endpoint_name.result}"
     profile_name                  = azurerm_cdn_profile.profile.name
     location                      = azurerm_resource_group.rg.location
     resource_group_name           = azurerm_resource_group.rg.name
     is_http_allowed               = true
     is_https_allowed              = true
     querystring_caching_behaviour = "IgnoreQueryString"
     is_compression_enabled        = true
     content_types_to_compress = [
       "application/eot",
       "application/font",
       "application/font-sfnt",
       "application/javascript",
       "application/json",
       "application/opentype",
       "application/otf",
       "application/pkcs7-mime",
       "application/truetype",
       "application/ttf",
       "application/vnd.ms-fontobject",
       "application/xhtml+xml",
       "application/xml",
       "application/xml+rss",
       "application/x-font-opentype",
       "application/x-font-truetype",
       "application/x-font-ttf",
       "application/x-httpd-cgi",
       "application/x-javascript",
       "application/x-mpegurl",
       "application/x-opentype",
       "application/x-otf",
       "application/x-perl",
       "application/x-ttf",
       "font/eot",
       "font/ttf",
       "font/otf",
       "font/opentype",
       "image/svg+xml",
       "text/css",
       "text/csv",
       "text/html",
       "text/javascript",
       "text/js",
       "text/plain",
       "text/richtext",
       "text/tab-separated-values",
       "text/xml",
       "text/x-script",
       "text/x-component",
       "text/x-java-source",
     ]
   
     origin {
       name      = "origin1"
       host_name = var.origin_url
     }
   }
   

3. outputs.tf라는 파일을 만들고 다음 코드를 삽입합니다.

   output "resource_group_name" {
     value = azurerm_resource_group.rg.name
   }
   
   output "cdn_profile_name" {
     value = azurerm_cdn_profile.profile.name
   }
   
   output "cdn_endpoint_endpoint_name" {
     value = azurerm_cdn_endpoint.endpoint.name
   }
   
   output "cdn_endpoint_fqdn" {
     value = azurerm_cdn_endpoint.endpoint.fqdn
   }
   

4. 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 {}
   }
   

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 "origin_url" {
     type        = string
     description = "Url of the origin."
     default     = "www.contoso.com"
   }
   
   variable "cdn_sku" {
     type        = string
     description = "CDN SKU names."
     default     = "Standard_Microsoft"
     validation {
       condition     = contains(["Standard_Akamai", "Standard_Microsoft", "Standard_Verizon", "Premium_Verizon"], var.cdn_sku)
       error_message = "The cdn_sku must be one of the following: Standard_Akamai, Standard_Microsoft, Standard_Verizon, Premium_Verizon."
     }
   }
   

Terraform 초기화

terraform init를 실행하여 Terraform 배포를 초기화합니다. 이 명령은 Azure 리소스를 관리하는 데 필요한 Azure 공급자를 다운로드합니다.

terraform init -upgrade

핵심 사항:

• -upgrade 매개 변수는 필요한 공급자 플러그 인을 구성의 버전 제약 조건을 준수하는 최신 버전으로 업그레이드합니다.

Terraform 실행 계획 만들기

terraform 계획을 실행하여 실행 계획을 만듭니다.

terraform plan -out main.tfplan

핵심 사항:

• terraform plan 명령은 실행 계획을 만들지만 실행하지는 않습니다. 대신 구성 파일에 지정된 구성을 만드는 데 필요한 작업을 결정합니다. 이 패턴을 사용하면 실제 리소스를 변경하기 전에 실행 계획이 예상과 일치하는지 확인할 수 있습니다.
• 선택 사항인 -out 매개 변수를 사용하여 계획의 출력 파일을 지정할 수 있습니다. -out 매개 변수를 사용하면 검토한 계획이 정확하게 적용됩니다.

Terraform 실행 계획 적용

terraform 적용을 실행하여 클라우드 인프라에 실행 계획을 적용합니다.

terraform apply main.tfplan

핵심 사항:

• 예시 terraform apply 명령은 이전에 terraform plan -out main.tfplan를 실행했다고 가정합니다.
• -out 매개 변수에 다른 파일 이름을 지정한 경우 terraform apply에 대한 호출에서 동일한 파일 이름을 사용합니다.
• -out 매개 변수를 사용하지 않은 경우 매개 변수 없이 terraform apply를 호출합니다.

결과 확인

Azure CLI

1. Azure CDN 프로필 및 엔드포인트가 만들어진 Azure 리소스 그룹 이름을 가져옵니다.

   resource_group_name=$(terraform output -raw resource_group_name)
   

2. CDN 프로필 이름을 가져옵니다.

   cdn_profile_name=$(terraform output -raw cdn_profile_name)
   

3. CDN 엔드포인트 이름을 가져옵니다.

   cdn_endpoint_endpoint_name=$(terraform output -raw cdn_endpoint_endpoint_name)
   

4. az cdn custom-domain show를 실행하여 이 문서에서 만든 사용자 지정 도메인의 세부 정보를 표시합니다.

   az cdn endpoint show --resource-group $resource_group_name \
                        --profile-name $cdn_profile_name \
                        --name $cdn_endpoint_endpoint_name
   

Azure PowerShell

1. Azure CDN 프로필 및 엔드포인트가 만들어진 Azure 리소스 그룹 이름을 가져옵니다.

   $resource_group_name=$(terraform output -raw resource_group_name)
   

2. CDN 프로필 이름을 가져옵니다.

   $cdn_profile_name=$(terraform output -raw cdn_profile_name)
   

3. CDN 엔드포인트 이름을 가져옵니다.

   $cdn_endpoint_endpoint_name=$(terraform output -raw cdn_endpoint_endpoint_name)
   

4. Get-AzCdnEndpoint를 실행하여 이 문서에서 만든 사용자 지정 도메인의 세부 정보를 표시합니다.

   Get-AzCdnEndpoint -ResourceGroupName $resource_group_name `
                     -ProfileName $cdn_profile_name `
                     -Name $cdn_endpoint_endpoint_name
   

리소스 정리

Terraform을 통해 리소스를 만들 필요가 더 이상 없으면 다음 단계를 수행합니다.

1. terraform 계획을 실행하고 플래그를 지정합니다destroy.

   terraform plan -destroy -out main.destroy.tfplan
   

   핵심 사항:

   • terraform plan 명령은 실행 계획을 만들지만 실행하지는 않습니다. 대신 구성 파일에 지정된 구성을 만드는 데 필요한 작업을 결정합니다. 이 패턴을 사용하면 실제 리소스를 변경하기 전에 실행 계획이 예상과 일치하는지 확인할 수 있습니다.
   • 선택 사항인 -out 매개 변수를 사용하여 계획의 출력 파일을 지정할 수 있습니다. -out 매개 변수를 사용하면 검토한 계획이 정확하게 적용됩니다.

2. terraform을 실행하여 실행 계획을 적용합니다.

   terraform apply main.destroy.tfplan
   

Azure의 Terraform 문제 해결

Azure에서 Terraform을 사용할 때 발생하는 일반적인 문제 해결

다음 단계

자습서: CDN을 사용하여 웹앱에서 정적 콘텐츠 제공