Konfigurasikan aturan penulisan ulang URL dengan Terraform - Edge Security Acceleration

Anda dapat menggunakan Terraform untuk mengonfigurasi aturan penulisan ulang URL pada sebuah situs guna mentransformasikan path dan query string berdasarkan ekspresi.

Instal Terraform dan konfigurasikan izin

Instal dan konfigurasikan Terraform di komputer Anda

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

Buat Pasangan Kunci Akses (AccessKey pair) untuk Pengguna RAM. Akun Alibaba Cloud memiliki semua izin atas resource. Jika Pasangan Kunci Akses Akun Alibaba Cloud Anda bocor, resource Anda akan menghadapi risiko besar. Kami menyarankan agar Anda menggunakan Pasangan Kunci Akses milik Pengguna RAM. Untuk informasi selengkapnya, 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 (tanpa 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 maintenance (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 selengkapnya, lihat Create resources with Terraform.

Penting

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

Resources

Kueri informasi situs: alicloud_esa_sites (Data Source untuk mereferensikan situs yang sudah ada)
Konfigurasikan aturan penulisan ulang URL: alicloud_esa_rewrite_url_rule

Konfigurasikan aturan penulisan ulang URL

Buat file konfigurasi bernama main.tf dan salin kode berikut ke dalam file tersebut. Kode ini membuat aturan penulisan ulang URL untuk sebuah situs.

# 1. Kueri informasi tentang situs yang sudah ada.
data "alicloud_esa_sites" "default" {
  site_name = "<span class="var-span" contenteditable="true" data-var="DOMAIN">{{DOMAIN}}"</span>  # Ganti dengan nama domain situs Anda yang telah ditambahkan ke Edge Security Acceleration, misalnya example.com.
}

# 2. Konfigurasikan penulisan ulang URL: Menulis ulang path yang dimulai dengan /images/ menjadi /static/img/ dan menghapus semua parameter kueri.
resource "alicloud_esa_rewrite_url_rule" "example" {
  site_id                   = data.alicloud_esa_sites.default.sites[0].site_id
  rule_name                 = "rewrite-images-prefix"
  rule_enable               = "on"
  rule                      = "starts_with(http.request.uri.path, \"/images/\")"
  rewrite_uri_type          = "dynamic"
  uri                       = "regex_replace(http.request.uri.path, \"^/images/\", \"/static/img/\")"
  rewrite_query_string_type = "static"
  query_string              = ""  # String kosong menunjukkan bahwa semua parameter kueri dihapus.
}

Buka direktori yang berisi file konfigurasi, lalu jalankan perintah berikut untuk menginisialisasi lingkungan Terraform.
```
terraform init
```
Jalankan perintah berikut untuk memvalidasi sintaksis dan konfigurasi file Terraform.
```
terraform validate
```
Jika output-nya mirip dengan gambar berikut, validasi berhasil.
Jalankan perintah berikut untuk melihat pratinjau 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 terraform show

Jalankan perintah berikut di direktori kerja Anda untuk melihat detail resource yang dibuat oleh Terraform:

terraform show

Verifikasi di Konsol

Di Konsol ESA, pilih Site Management, lalu pada kolom Website, klik situs target.
Di panel navigasi sebelah kiri, pilih Rules > Transform Rules untuk melihat aturan yang telah dibuat beserta konfigurasinya.

(Opsional) Bersihkan resource

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

terraform destroy

Referensi

Parameter rewrite_uri_type

Tabel berikut menjelaskan nilai-nilai yang valid untuk parameter rewrite_uri_type pada resource Terraform alicloud_esa_rewrite_url_rule.

Value	Description	Deskripsi
`static`	Static	Menulis ulang path ke tujuan tetap.
`dynamic`	Dynamic	Menggunakan ekspresi untuk menghitung jalur tujuan secara dinamis.

Parameter rewrite_query_string_type

Pada resource yang sama, tabel berikut menjelaskan nilai-nilai yang valid untuk parameter rewrite_query_string_type.

Value	Description	Deskripsi
`static`	Static	Mengganti query string dengan nilai tetap yang ditentukan oleh `query_string`. Mengatur nilai ini menjadi string kosong akan menghapus semua parameter kueri.
`dynamic`	Dynamic	Menggunakan ekspresi untuk menghasilkan query string secara dinamis.