Mulai cepat: Menyebarkan Azure Cosmos DB ke Azure Container Instances

Artikel diuji dengan versi penyedia Terraform dan Terraform berikut:

• Terraform v1.2.7
• AzureRM Provider v.3.20.0

Terraform memungkinkan definisi, pratinjau, dan penyebaran infrastruktur cloud. Menggunakan Terraform, Anda membuat file konfigurasi menggunakan sintaksis HCL. Sintaksis HCL memungkinkan Anda menentukan penyedia cloud - seperti Azure - dan elemen yang membentuk infrastruktur cloud Anda. Setelah membuat file konfigurasi, Anda membuat rencana eksekusi yang memungkinkan Anda untuk melihat pratinjau perubahan infrastruktur Anda sebelum disebarkan. Setelah memverifikasi perubahan, Anda menerapkan rencana eksekusi untuk menyebarkan infrastruktur.

Artikel ini memperlihatkan cara menggunakan Terraform untuk menyebarkan Azure Cosmos DB ke Azure Container Instances.

Dalam artikel ini, Anda akan mempelajari cara:

• Membuat instans Azure Cosmos DB
• Membuat Azure Container Instance
• Membuat aplikasi yang berfungsi di dua sumber daya ini

Catatan

Kode contoh dalam artikel ini terletak di repositori GitHub Terraform Microsoft.

Prasyarat

• Langganan Azure: Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum memulai.

• Konfigurasi Terraform: Jika Anda belum melakukannya, konfigurasikan Terraform menggunakan salah satu opsi berikut:

  • Mengonfigurasi Terraform in Azure Cloud Shell dengan Bash
  • Mengonfigurasi Terraform in Azure Cloud Shell dengan PowerShell
  • Konfigurasikan Terraform dalam Windows dengan Bash
  • Konfigurasikan Terraform dalam Windows dengan PowerShell

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 "azurerm_resource_group" "rg" {
     name     = "${random_pet.rg_name.id}-rg"
     location = var.resource_group_location
   }
   
   resource "azurerm_cosmosdb_account" "vote_cosmos_db" {
     name                = "${random_pet.rg_name.id}-${random_integer.ri.result}"
     location            = azurerm_resource_group.rg.location
     resource_group_name = azurerm_resource_group.rg.name
     offer_type          = "Standard"
     kind                = "GlobalDocumentDB"
   
     consistency_policy {
       consistency_level       = "BoundedStaleness"
       max_interval_in_seconds = 10
       max_staleness_prefix    = 200
     }
   
     geo_location {
       location          = azurerm_resource_group.rg.location
       failover_priority = 0
     }
   }
   
   resource "random_integer" "ri" {
     min = 10000
     max = 99999
   }
   
   resource "random_pet" "rg_name" {
     prefix = var.prefix
   }
   

4. Buat file bernama aci.tf dan masukkan kode berikut:

   resource "azurerm_container_group" "main" {
     name                = "${random_pet.rg_name.id}-vote-aci"
     location            = azurerm_resource_group.rg.location
     resource_group_name = azurerm_resource_group.rg.name
     ip_address_type     = "Public"
     dns_name_label      = "vote-aci-${random_integer.ri.result}"
     os_type             = "Linux"
   
     container {
       name   = "vote-aci"
       image  = "mcr.microsoft.com/azuredocs/azure-vote-front:cosmosdb"
       cpu    = "0.5"
       memory = "1.5"
       ports {
         port     = 80
         protocol = "TCP"
       }
   
       secure_environment_variables = {
         "COSMOS_DB_ENDPOINT"  = azurerm_cosmosdb_account.vote_cosmos_db.endpoint
         "COSMOS_DB_MASTERKEY" = azurerm_cosmosdb_account.vote_cosmos_db.primary_key
         "TITLE"               = "Azure Voting App"
         "VOTE1VALUE"          = "Cats"
         "VOTE2VALUE"          = "Dogs"
       }
     }
   }
   

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

   variable "resource_group_location" {
     default     = "eastus"
     description = "Location of the resource group."
   }
   
   variable "prefix" {
     type        = string
     default     = "cosmos-db-aci"
     description = "Prefix of the resource name"
   }
   

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

   output "resource_group_name" {
     value = azurerm_resource_group.rg.name
   }
   
   output "cosmosdb_account_name" {
     value = azurerm_cosmosdb_account.vote_cosmos_db.name
   }
   
   output "dns" {
     value = azurerm_container_group.main.fqdn
   }
   

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 nama grup sumber daya.

   echo "$(terraform output resource_group_name)"
   

2. Dapatkan nama akun Azure Cosmos DB.

   echo "$(terraform output cosmosdb_account_name)"
   

3. Jalankan az cosmosdb sql database list/

   az cosmosdb sql database list \
     --resource-group <resource_group_name> \
     --account-name <cosmosdb_account_name>
   

Aplikasi pengujian

1. Dapatkan nama akun Azure Cosmos DB.

   echo "$(terraform output dns)"
   

2. Telusuri ke URL yang ditunjukkan pada langkah sebelumnya. Anda akan melihat hasil yang mirip dengan output berikut:

   

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

Pelajari selengkapnya tentang menggunakan Terraform di Azure