Konfigurasikan mode pengembangan situs menggunakan Terraform - Edge Security Acceleration

Gunakan Terraform untuk mengaktifkan mode pengembangan situs Anda secara cepat, yang menyederhanakan proses debugging dan verifikasi perubahan pada konten origin.

Instal Terraform dan konfigurasikan izin

Instal dan konfigurasikan Terraform di komputer Anda

Untuk informasi lebih lanjut tentang cara menggunakan Terraform di komputer Anda, lihat Install and configure Terraform.

Buat pasangan AccessKey untuk Pengguna RAM. Akun Alibaba Cloud memiliki semua izin atas sumber daya. Jika pasangan AccessKey Akun Alibaba Cloud Anda bocor, sumber daya Anda akan menghadapi risiko tinggi. Kami menyarankan Anda menggunakan pasangan AccessKey Pengguna RAM. Untuk informasi lebih lanjut, lihat Create an AccessKey pair.
Buat variabel lingkungan untuk menyimpan kredensial identitas.
Anda dapat membuat dan melihat AccessKey Anda di halaman AccessKey Management.
Jika variabel lingkungan tidak dikonfigurasi, verifikasi identitas akan gagal saat Anda menjalankan Template Terraform.

Gunakan layanan online (tidak perlu instalasi atau konfigurasi izin)

Jika Anda tidak ingin menginstal Terraform, Anda dapat menggunakan layanan online Cloud Shell.

Alibaba Cloud Cloud Shell adalah produk operasi dan pemeliharaan (O&M) gratis yang telah dipra-instal dengan komponen Terraform dan dikonfigurasi dengan kredensial identitas. Dengan demikian, Anda dapat langsung menjalankan perintah Terraform di Cloud Shell. Untuk informasi lebih lanjut, lihat Create resources with Terraform.

Penting

Saat menggunakan Terraform di Cloud Shell, fitur destroy-nya dapat menyebabkan kehilangan data. Kami menyarankan Anda hanya menggunakan Cloud Shell untuk operasi sederhana dan cepat, seperti debugging. Untuk informasi lebih lanjut tentang batasan, lihat Limits.

Sumber daya yang terlibat

Beli paket situs: alicloud_esa_rate_plan_instance
Buat sumber daya situs: alicloud_esa_site
Hasilkan bilangan acak: random_integer (digunakan untuk menghasilkan nama domain uji)

Konfigurasikan mode pengembangan situs

Buat direktori kerja. Kemudian, buat file konfigurasi di dalam direktori tersebut sesuai penjelasan berikut, dan sesuaikan pengaturan dalam kode agar memenuhi kebutuhan Anda.

Tentukan provider dan versi Terraform

Pertama, buat file konfigurasi bernama providers.tf. Lalu, salin kode berikut ke dalam file konfigurasi untuk mengelola semua konfigurasi provider dan batasan versi secara terpusat.

terraform {
  required_providers {
    alicloud = {
      source  = "aliyun/alicloud"
      version = "1.266.0"
      region = "ap-southeast-1"
    }
  }
}

Tentukan sumber daya

Buat file konfigurasi bernama main.tf. Lalu, salin kode berikut ke dalam file tersebut untuk membuat situs dengan mode pengembangan diaktifkan.

# 1. Beli paket situs
resource "alicloud_esa_rate_plan_instance" "default" {
  type       = "NS"        # Jenis akses situs: NS (Server DNS) atau CNAME
  auto_renew = true       # Apakah akan mengaktifkan perpanjangan otomatis
  period     = "1"         # Periode pembelian (satuan: bulan)
  coverage   = "overseas"  # Wilayah akselerasi. Untuk informasi lebih lanjut, lihat bagian Deskripsi Metrik topik ini.
  auto_pay   = true       # Pembayaran otomatis
  plan_name  = "basic"     # Nama paket. Untuk informasi lebih lanjut, lihat bagian Deskripsi Metrik topik ini.
  payment_type = "Subscription" # Jenis pembayaran
}

# 2. Hasilkan bilangan acak (untuk menghasilkan nama domain uji unik)
resource "random_integer" "default" {
  min = 10000
  max = 99999
}

# 3. Buat situs dan aktifkan mode pengembangan
resource "alicloud_esa_site" "default" {
  site_name        = "bcd${random_integer.default.result}.com"  # Nama situs (nama domain). Di lingkungan produksi, ganti ini dengan nama domain aktual Anda.
  coverage         = "overseas"                                # Wilayah akselerasi
  access_type      = "NS"                                      # Jenis akses situs: NS atau CNAME
  instance_id      = alicloud_esa_rate_plan_instance.default.id  # ID paket
  development_mode = "on"                                      # Aktifkan mode pengembangan. Untuk informasi lebih lanjut, lihat bagian Deskripsi Metrik topik ini.
}

Buka direktori yang berisi file konfigurasi. Lalu, jalankan perintah berikut untuk menginisialisasi lingkungan Terraform.
```
terraform init
```
Jalankan perintah berikut untuk memvalidasi sintaks dan konfigurasi file Terraform.
```
terraform validate
```
Jika output-nya mirip dengan gambar berikut, validasi berhasil.
Jalankan perintah berikut untuk meninjau perubahan yang akan diterapkan.
```
terraform plan
```
Jalankan perintah berikut untuk mengeksekusi skrip Terraform.
```
terraform apply
```
Saat diminta, masukkan yes untuk mengonfirmasi operasi.

Verifikasi Hasil

Jalankan Perintah terraform show

Di direktori kerja, gunakan perintah berikut untuk menanyakan detail sumber daya yang dibuat oleh Terraform:

terraform show

Login ke Konsol untuk Melihat

Di Konsol ESA, pilih Site Management. Di kolom Website, klik situs target.
Di panel navigasi sebelah kiri, pilih Caching > Settings.
Di halaman Settings, lihat detail konfigurasi cache yang baru dibuat.

(Opsional) Bersihkan sumber daya

Jika Anda tidak lagi memerlukan sumber daya yang dibuat atau dikelola oleh Terraform, Anda dapat menjalankan perintah terraform destroy untuk melepaskan sumber daya tersebut.

terraform destroy

Referensi terkait

Jenis paket

Tabel berikut menjelaskan nilai yang valid untuk bidang plan_name dari sumber daya Terraform alicloud_esa_rate_plan_instance.

Nilai parameter	Nama paket	Deskripsi
`entranceplan_intl`	Entrance	Cocok untuk skenario pengujian dan bisnis skala kecil. Menyediakan kemampuan akselerasi dan mitigasi dasar.
`basicplan_intl`	Pro	Konfigurasi yang direkomendasikan. Cocok untuk website dan aplikasi usaha kecil dan menengah.
`vipplan_intl`	Enterprise	Cocok untuk perusahaan menengah dan besar. Menyediakan kemampuan performa dan perlindungan keamanan yang lebih tinggi.

Deskripsi parameter

Tabel berikut menjelaskan nilai yang valid untuk bidang development_mode dalam sumber daya Terraform alicloud_esa_site.

Nilai	Fungsi	Deskripsi
`on`	Aktifkan mode pengembangan	Permintaan sumber daya statis melewati komponen cache POP ESA dan langsung mengakses server origin. Ini berguna untuk debugging karena Anda dapat membandingkan performa akses langsung ke server origin dengan performa akses ke konten yang di-cache.
`off`	Nonaktifkan mode pengembangan (default)	Permintaan sumber daya statis mengikuti jalur standar melalui cache POP edge dan mengembalikan konten berdasarkan kebijakan cache.

Skenario

Gunakan mode pengembangan dalam skenario berikut:

Debugging konten origin: Aktifkan mode pengembangan saat Anda memerlukan klien untuk mengambil sumber daya statis terbaru langsung dari origin.
Pengujian perbandingan efek: Bandingkan perbedaan antara akses langsung ke server origin dan akses melalui cache ESA.
Validasi perubahan cepat: Setelah memperbarui konten origin, validasi perubahan segera tanpa menunggu kedaluwarsa cache atau merefresh cache secara manual.

Peringatan

Mode pengembangan mengarahkan semua permintaan sumber daya statis langsung ke origin. Hal ini dapat meningkatkan beban origin dan waktu respons. Gunakan hanya selama pengembangan dan debugging. Selalu nonaktifkan di lingkungan produksi.

FAQ

Apa yang harus dilakukan ketika muncul "StatusCode400 Code: ConfExceedLimit" selama eksekusi kode Terraform?

Saat Anda mengonfigurasi pengaturan cache di Konsol, aturan yang sesuai akan dibuat secara otomatis. Namun, sumber daya Terraform alicloud_esa_cache_rule juga membuat aturan. Oleh karena itu, Anda tidak dapat langsung memperbarui konfigurasi cache yang sudah ada. Pertama, panggil API ListCacheRules untuk mendapatkan ConfigId konfigurasi cache situs saat ini. Lalu, panggil API DeleteCacheRule untuk menghapus konfigurasi cache situs tersebut. Setelah itu, terapkan kode Terraform.