Topik ini menjelaskan cara mengaktifkan dan menggunakan EdgeRoutine di konsol Dynamic Content Delivery Network (DCDN).
DCDN akan memfase out EdgeRoutine untuk pengguna baru dari 8 Mei 2025, pukul 00:00 hingga 13 Mei 2025, pukul 23:00 (UTC+8). Pengguna saat ini tidak terpengaruh.
Kami merekomendasikan Anda tingkatkan ke ESA untuk menggunakan Edge Routine.
Alur Kerja
Untuk menggunakan EdgeRoutine, Anda perlu mengaktifkan DCDN. Gambar berikut menunjukkan bagaimana rutin dibuat dan diimplementasikan di EdgeRoutine.
EdgeRoutine dalam rilis beta dan hanya tersedia untuk pengguna yang dipilih. Jika bandwidth puncak harian layanan DCDN Anda melebihi 500 Mbit/s, Anda dapat ajukan tiket untuk mengaktifkan EdgeRoutine. Setelah permintaan disetujui, EdgeRoutine akan ditampilkan di panel navigasi sisi kiri konsol DCDN.
Aktifkan EdgeRoutine
Masuk ke Konsol DCDN.
Di panel navigasi sisi kiri, klik EdgeRoutine.
Pilih untuk mengaktifkan EdgeRoutine.
Buat dan konfigurasikan rutin
Masuk ke Konsol DCDN.
Di panel navigasi sisi kiri, klik EdgeRoutine.
Pertama kali menggunakan EdgeRoutine, buat subdomain.
Di halaman EdgeRoutine, klik Create Subdomain.

Di kotak dialog Create Subdomain, tentukan nama subdomain.
CatatanSubdomain adalah repositori tempat semua rutin yang Anda buat berada. Setelah subdomain dibuat, Anda tidak dapat mengubah nama subdomain tersebut.
Subdomain adalah pengenal unik untuk setiap pengguna dan merupakan bagian dari ID rutin.
Nama subdomain tidak dapat diubah setelah dibuat. Nama dapat berisi huruf kecil, angka, dan tanda hubung (-). Nama harus memiliki panjang minimal 2 karakter. Contoh: nama-subdomain.
Klik OK.
Di halaman EdgeRoutine, klik Create Routine. Tabel berikut menjelaskan parameter.

Parameter
Deskripsi
Routine Name
Masukkan nama rutin.
CatatanThe 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 rutin.
Specification
Pilih waktu maksimum CPU untuk satu eksekusi rutin. Waktu I/O untuk menunggu respons jaringan tidak termasuk. Biaya bervariasi berdasarkan spesifikasi rutin. Untuk informasi lebih lanjut, 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
Setelah membuat rutin, klik Details di kolom Actions untuk mengonfigurasi rutin di lingkungan yang berbeda. Pengaturan rutin bersifat independen di setiap lingkungan. Anda dapat memodifikasi pengaturan rutin di lingkungan produksi, lingkungan pengujian, dan lingkungan rilis canary. Untuk informasi lebih lanjut, lihat Lingkungan canary (opsional). Tabel berikut menjelaskan parameter.
Parameter
Deskripsi
Routine Specifications
Waktu maksimum CPU untuk satu eksekusi rutin. Waktu I/O untuk menunggu respons jaringan tidak termasuk. Waktu Nyata 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 diasosiasikan dengan rutin.
Nama domain wildcard didukung.
Secara default, daftar putih domain kosong. Ini menunjukkan bahwa nama domain apa pun dapat diasosiasikan dengan rutin.
CatatanSebagai contoh, jika Anda mengatur parameter Daftar Putih Domain menjadi example.com, hanya permintaan dari example.com yang dapat memicu rutin.
Asosiasikan nama domain dengan rutin
Rutin memerlukan nama domain untuk menyediakan layanan kepada klien. Nama domain dapat berupa nama domain akselerasi CDN atau nama domain akselerasi DCDN. Setelah membuat dan mengonfigurasi rutin, Anda perlu mengasosiasikan nama domain DCDN-akselerasi dengan rutin. Kemudian rutin dipicu oleh permintaan dari nama domain yang diasosiasikan dengan rutin. Masuk ke konsol layanan tempat nama domain Anda ditambahkan.
Masuk ke Konsol DCDN.
Di panel navigasi sisi kiri, klik Domain Names.
Di halaman Domain Names, temukan nama domain yang ingin Anda kelola dan klik Configure.
Di panel navigasi sisi kiri, klik EdgeRoutine.
Di halaman EdgeRoutine, aktifkan saklar dan konfigurasikan parameter Routine ID. Tabel berikut menjelaskan parameter.

Parameter
Deskripsi
Routine ID
ID rutin adalah pengenal unik untuk setiap rutin. Format: namaRutin.subdomain.
CatatanDi panel navigasi sisi kiri konsol DCDN, klik EdgeRoutine. Anda dapat melihat ID rutin di halaman Function.

Trigger Mode
Pilih mode di mana permintaan yang mencoba mengakses nama domain akselerasi DCDN memicu rutin. Mode berikut didukung:
Redirect: Permintaan yang mencoba mengakses nama domain akselerasi DCDN diproses oleh rutin. Anda dapat menulis kode di rutin untuk memproses permintaan. Rutin dapat mengembalikan konten yang diminta ke klien, membaca cache dengan memanggil API Cache, atau mengarahkan ulang permintaan ke server asal dengan mengirimkan permintaan fetch.
Bypass: Permintaan yang mencoba mengakses nama domain akselerasi DCDN memicu rutin. Kemudian, pengaturan yang dikonfigurasikan di konsol DCDN dieksekusi, dan permintaan dialihkan ke server asal. Mode pemicu ini cocok untuk skenario seperti otentikasi atau pelacakan log.
Redirect to Origin if Error Occurs
Yes: Ketika rutin melempar pengecualian, POP meneruskan permintaan ke server asal dari nama domain akselerasi DCDN menggunakan URL yang diminta oleh klien. Server asal memproses permintaan. Ini memastikan kontinuitas bisnis dan pemulihan bencana.
No: Ketika rutin melempar pengecualian, kode status HTTP 5xx dikembalikan ke klien.
CatatanPertama kali Anda menggunakan rutin, kami merekomendasikan Anda mengatur parameter Alihkan ke Asal jika Terjadi Kesalahan ke Tidak. Anda dapat menggunakan kode status HTTP 5xx yang dikembalikan untuk menyelesaikan masalah.
Jika terjadi pengecualian, Anda akan dikenakan biaya untuk jumlah permintaan kembali ke asal. Persentase permintaan kembali ke asal yang abnormal sangat rendah dan dapat diabaikan.
Kembangkan dan debug rutin
Masuk ke Konsol DCDN.
Di panel navigasi sisi kiri, klik EdgeRoutine.
Temukan rutin yang Anda buat dan klik Details di kolom Tindakan.
Di halaman rutin yang ditampilkan, klik tab Code untuk mengembangkan rutin menggunakan JavaScript. Dalam kode contoh, skrip HelloWorld digunakan.

Setelah selesai menulis kode, klik Release to Staging Environment. Anda dapat mengasosiasikan alamat IP lingkungan pengujian yang disediakan di halaman dengan mesin yang Anda gunakan untuk men-debug rutin.
CatatanAnda dapat menambahkan alamat IP lingkungan pengujian dan nama domain yang diasosiasikan dengan rutin ke file hosts mesin lokal Anda. Sebagai contoh, tambahkan 10.10.10.10 dan example.com ke file hosts mesin lokal Anda. Ganti alamat IP dengan alamat IP yang disediakan pada gambar sebelumnya, dan ganti nama domain dengan nama domain akselerasi DCDN yang diasosiasikan dengan rutin.
Simpan versi
Setelah debugging selesai, klik Save as Version di tab Code.
Publikasikan versi
Di halaman rutin yang ditampilkan, klik tab Versions, temukan versi yang ingin Anda publikasikan, lalu klik Release di kolom Actions.
Pilih Staging Environment, Production Environment, atau Canary Environment tempat Anda ingin mempublikasikan versi tersebut.
CatatanWe recommend that you release a routine to the canary environments before you release it to the production environments.
Klik OK untuk menerapkan kode ke lingkungan produksi semua POP.
Iterasi
Pada bagian sebelumnya, HelloWorld digunakan untuk menjelaskan proses konfigurasi dan publikasi rutin.
Untuk informasi tentang cara melakukan iterasi rutin, lihat bagian "Kembangkan dan Debug Rutin", "Simpan Versi", dan "Publikasikan Versi".
Jika Anda ingin menyesuaikan konfigurasi, seperti spesifikasi rutin atau daftar putih nama domain, lihat bagian "Buat dan Konfigurasikan Rutin".
Jika Anda ingin menonaktifkan EdgeRoutine untuk nama domain akselerasi DCDN, hapus konfigurasi rutin yang telah diatur dengan mengikuti langkah-langkah di bagian "Asosiasikan Nama Domain dengan Rutin".