Edge Security Acceleration：Gunakan EdgeRoutine di Konsol DCDN

Alur Kerja

Untuk menggunakan EdgeRoutine, Anda perlu mengaktifkan DCDN. Gambar berikut menunjukkan cara membuat dan menerapkan routine di EdgeRoutine.

Aktifkan EdgeRoutine

1. Masuk ke Konsol DCDN.

2. Di panel navigasi sebelah kiri, klik EdgeRoutine.

3. Pilih Enable ER > Activate Now untuk mengaktifkan EdgeRoutine.

Buat dan konfigurasikan routine

1. Masuk ke Konsol DCDN.

2. Di panel navigasi sebelah kiri, klik EdgeRoutine.

3. Pertama kali menggunakan EdgeRoutine, buat subdomain.

   1. Di halaman EdgeRoutine, klik Create Subdomain.

      

   2. Di kotak dialog Create Subdomain, tentukan nama subdomain.

      Catatan

      • Subdomain adalah repositori tempat semua routine yang Anda buat disimpan. Setelah subdomain dibuat, Anda tidak dapat mengubah namanya.

      • Subdomain merupakan pengenal unik untuk setiap pengguna dan bagian dari ID routine.

      • Nama subdomain tidak dapat diubah setelah dibuat. Nama tersebut boleh terdiri atas huruf kecil, angka, dan tanda hubung (-). Panjang nama minimal 2 karakter. Contoh: subdomain-name.

   3. Klik OK.

4. Di halaman EdgeRoutine, klik Create Routine. Tabel berikut menjelaskan parameter-parameter tersebut.

   

   Parameter	Deskripsi
   Routine Name	Masukkan nama routine. Catatan The name can contain lowercase letters, digits, and hyphens (-). The name cannot be less than 2 characters in length. Example: routine-name. The routine name cannot be modified after it is created.
   Description	Opsional. Masukkan deskripsi untuk routine.
   Specification	Pilih maksimum time slice CPU untuk satu eksekusi routine. Waktu I/O untuk menunggu tanggapan jaringan tidak termasuk. Biaya bervariasi berdasarkan spesifikasi routine. Untuk informasi selengkapnya, lihat Aturan Penagihan. CPU Time Slice for Individual Requests: 5 ms CPU Time Slice for Individual Requests: 50 ms (default) CPU Time Slice for Individual Requests: 100 ms

5. Setelah membuat routine, klik Details di kolom Actions untuk mengonfigurasi routine di lingkungan berbeda. Pengaturan routine bersifat independen antarlingkungan. Anda dapat memodifikasi pengaturan routine di lingkungan produksi, lingkungan pengujian, dan lingkungan rilis canary. Untuk informasi selengkapnya, lihat Lingkungan canary (opsional). Tabel berikut menjelaskan parameter-parameter tersebut.

   Parameter	Deskripsi
   Routine Specifications	Maksimum time slice CPU untuk satu eksekusi routine. Waktu I/O untuk menunggu tanggapan jaringan tidak termasuk. Real Time Maksimum: 120 detik. Memori: 128 MB. CPU Time Slice for Individual Requests: 5 ms CPU Time Slice for Individual Requests: 50 ms (default) CPU Time Slice for Individual Requests: 100 ms
   Domain Name Whitelist	Nama domain yang dapat dikaitkan dengan routine. Nama domain wildcard didukung. Secara default, daftar putih nama domain kosong. Artinya, nama domain apa pun dapat dikaitkan dengan routine. Catatan Contohnya, jika Anda mengatur parameter Domain Name Whitelist menjadi example.com, hanya permintaan dari example.com yang dapat memicu routine tersebut.

Kaitkan nama domain dengan routine

Routine memerlukan nama domain untuk menyediakan layanan kepada client. Nama domain tersebut dapat berupa nama domain akselerasi CDN atau nama domain akselerasi DCDN. Setelah membuat dan mengonfigurasi routine, Anda perlu mengaitkan nama domain akselerasi DCDN dengan routine tersebut. Routine kemudian dipicu oleh permintaan dari nama domain yang dikaitkan dengan routine tersebut. Masuk ke konsol layanan tempat nama domain Anda ditambahkan.

1. Masuk ke Konsol DCDN.

2. Di panel navigasi sebelah kiri, klik Domain Names.

3. Di halaman Domain Names, temukan nama domain yang ingin Anda kelola lalu klik Configure.

4. Di panel navigasi sebelah kiri, klik EdgeRoutine.

5. Di halaman EdgeRoutine, aktifkan sakelar dan konfigurasikan parameter Routine ID. Tabel berikut menjelaskan parameter-parameter tersebut.

   

   Parameter	Deskripsi
   Routine ID	ID routine adalah pengenal unik untuk setiap routine. Format: routineName.subdomain. Catatan Di panel navigasi sebelah kiri Konsol DCDN, klik EdgeRoutine. Anda dapat melihat ID routine di halaman Function.
   Trigger Mode	Pilih mode di mana permintaan yang mencoba mengakses nama domain akselerasi DCDN memicu routine. Mode berikut didukung: Redirect: Permintaan yang mencoba mengakses nama domain akselerasi DCDN diproses oleh routine. Anda dapat menulis kode di dalam routine untuk memproses permintaan tersebut. Routine dapat mengembalikan konten yang diminta ke client, membaca cache dengan memanggil Cache API, atau mengarahkan ulang permintaan ke origin server dengan mengirim fetch request. Bypass: Permintaan yang mencoba mengakses nama domain akselerasi DCDN memicu routine. Kemudian, pengaturan yang dikonfigurasi di konsol DCDN dieksekusi, dan permintaan diarahkan ke origin server. Mode pemicu ini cocok untuk skenario seperti otentikasi atau pelacakan log.
   Redirect to Origin if Error Occurs	Yes: Ketika routine melemparkan exception, Titik kehadiran (POP) meneruskan permintaan ke origin server nama domain akselerasi DCDN menggunakan URL yang diminta oleh client. Origin server memproses permintaan tersebut. Ini menjamin kelangsungan bisnis dan pemulihan bencana. No: Ketika routine melemparkan exception, kode status HTTP 5xx dikembalikan ke client. Catatan Pertama kali menggunakan routine, kami menyarankan Anda mengatur parameter Redirect to Origin if Error Occurs ke No. Anda dapat menggunakan kode status HTTP 5xx yang dikembalikan untuk memecahkan masalah. Jika terjadi exception, Anda dikenai biaya berdasarkan jumlah permintaan back-to-origin. Persentase permintaan back-to-origin abnormal sangat rendah dan dapat diabaikan.

Kembangkan dan debug routine

1. Masuk ke Konsol DCDN.

2. Di panel navigasi sebelah kiri, klik EdgeRoutine.

3. Temukan routine yang telah Anda buat lalu klik Details di kolom Actions.

4. Di halaman routine yang ditampilkan, klik tab Code untuk mengembangkan routine menggunakan JavaScript. Pada contoh kode, digunakan skrip HelloWorld.

5. Setelah pengkodean selesai, klik Release to Staging Environment. Anda dapat mengaitkan alamat IP lingkungan pengujian yang disediakan di halaman tersebut dengan mesin yang digunakan untuk debugging routine.

   Catatan

   Anda dapat menambahkan alamat IP lingkungan pengujian dan nama domain yang dikaitkan dengan routine ke file hosts mesin lokal Anda. Misalnya, tambahkan 10.10.10.10 dan example.com ke file hosts mesin lokal Anda. Ganti alamat IP dengan alamat IP yang ditampilkan pada gambar di atas, dan ganti nama domain dengan nama domain akselerasi DCDN yang dikaitkan dengan routine tersebut.

Simpan versi

Publikasikan versi

1. Di halaman routine yang ditampilkan, klik tab Versions, temukan versi yang ingin Anda publikasikan, lalu klik Release di kolom Actions.

2. Pilih Staging Environment, Production Environment, atau Canary Environment tempat Anda ingin mempublikasikan versi tersebut.

   Catatan

   We recommend that you release a routine to the canary environments before you release it to the production environments.

3. Klik OK untuk men-deploy kode ke lingkungan produksi semua POP.

Iterasi

Pada bagian-bagian sebelumnya, HelloWorld digunakan untuk menjelaskan cara mengonfigurasi dan mempublikasikan routine.

• Untuk informasi tentang cara melakukan iterasi routine, lihat bagian "Kembangkan dan debug routine", "Simpan versi", dan "Publikasikan versi".

• Jika ingin menyesuaikan konfigurasi, seperti spesifikasi routine atau daftar putih nama domain, lihat bagian "Buat dan konfigurasikan routine".

• Jika ingin menonaktifkan EdgeRoutine untuk nama domain akselerasi DCDN, hapus konfigurasi routine yang telah Anda atur dengan mengikuti langkah-langkah di bagian "Kaitkan nama domain dengan routine".

FAQ

• Bagaimana cara memilih spesifikasi yang sesuai untuk routine saya?

• Bagaimana cara memastikan kelangsungan bisnis jika terjadi exception pada ER saya?

• Bagaimana cara membatalkan rilis canary?

• Bagaimana cara menghapus lingkungan rilis canary?

• Bagaimana cara memilih wilayah untuk rilis canary?

• Error ER umum