HTTPDNS:Konfigurasikan resolusi DNS kustom berdasarkan Function Compute

Prasyarat

• Anda telah menambahkan nama domain yang ingin dikonfigurasi untuk resolusi DNS kustom. Untuk informasi selengkapnya, lihat 1. Tambahkan nama domain.

1. Otorisasi peran terkait layanan

Saat HTTPDNS memanggil Function Compute untuk menerapkan resolusi DNS kustom, Anda harus memberikan izin kepada peran terkait layanan di Konsol HTTPDNS agar HTTPDNS dapat menggunakan Function Compute.

2. Buat fungsi resolusi kustom

Pertama, aktifkan Alibaba Cloud Function Compute dan kembangkan fungsi resolusi kustom. Setelah pengembangan selesai, publikasikan layanan dan fungsinya, lalu hasilkan versi formal atau alias.

Untuk memastikan keamanan dan stabilitas kebijakan Function Compute HTTPDNS, jangan gunakan versi Latest default saat mengonfigurasi kebijakan. Anda harus menentukan versi layanan dan fungsi yang telah dipublikasikan.

HTTPDNS mendukung FC 2.0 dan FC 3.0, tetapi FC 3.0 direkomendasikan (FC 2.0 sudah tidak didukung). Untuk informasi selengkapnya mengenai perbedaan keduanya, lihat Perbedaan antara FC 2.0 dan FC 3.0.

Jika Anda masih perlu membuat fungsi FC 2.0, lihat Buat fungsi FC 2.0.

3. Tulis kode fungsi resolusi kustom

1. Tulis kode fungsi

   Pada editor fungsi, masukkan logika resolusi kustom Anda. Fungsi harus menerima parameter konteks yang dikirimkan oleh HTTPDNS, seperti IP klien, wilayah, dan ISP, lalu mengembalikan hasil resolusi yang telah diproses. Contohnya:

   Bahasa pemrograman pada contoh ini adalah nodejs6 atau nodejs8.

   'use strict';
   exports.handler = (event, context, callback) => {
     // Format parameter input menjadi objek.
     const eventObj = JSON.parse(event.toString());
     const {
       location, // Region
       ips, // Hasil resolusi dari server otoritatif
       ttl, // TTL asli
     } = eventObj;
   
     if (location.province === 'zhejiang' && location.isp === 'chinanet') {
       // Saat pengguna dari China Telecom Zhejiang mengakses nama domain, kembalikan alamat IP tertentu.
       callback(null, {
         ips: ips.concat(['1.1.X.X']), // Tambahkan alamat IP tertentu ke array IP yang dikembalikan.
         ttl: event.ttl * 2, // Ubah TTL.
         extra: "", // Bawa parameter tambahan untuk klien.
       });
     } else {
       // Pengembalian default.
       callback(null, {
         ips,
         ttl,
         extra: "",
       });
     }
   };

2. Konfigurasikan parameter input pengujian

   Sebelum mengklik Test Function, atur data parameter input tiruan untuk memverifikasi bahwa fungsi berperilaku sesuai harapan. Event pengujian harus mensimulasikan format panggilan HTTPDNS yang sebenarnya. Contohnya:

   {
     "domainName": "www.aliyun.com", // Nama domain yang sedang di-resolve
     "clientIp": "192.168.1.4", // IP klien
     "location": {
       "continent": "asia", // Benua dari IP klien
       "region": "cn", // Negara atau wilayah dari IP klien
       "isp": "bgp", // Jalur ISP dari IP klien 
       "province": "zhejiang" // Provinsi dari IP klien
     },
     "ips": ["192.168.1.3"], // Daftar hasil resolusi. Hasil ini tidak tersedia pada tahap BEFORE_READ_CACHE.
     "ttl": 60, // TTL dari hasil resolusi. Hasil ini tidak tersedia pada tahap BEFORE_READ_CACHE.
     "hookType": "BEFORE_WRITE_CACHE", // Tahap eksekusi fungsi
     "parameters":{ // Objek parameter yang dibawa dalam permintaan resolusi
       "param1":"p1",   // Sesuai dengan parameter "sdns-param1=p1" pada URL
       "param2":"p2"
      }
   }

3. Jalankan pengujian dan verifikasi hasilnya

   Klik Test Function dan periksa apakah hasil yang dikembalikan berisi bidang ips, ttl, atau extra yang diharapkan serta dalam format yang benar. Contoh respons:

   {
       "ips": event.ips.concat(['192.168.1.2']),
       "ttl": event.ttl * 2,
       "extra": "some-thing-send-to-user"
       // ,"domainName": "www.alibabacloud.com" // Hanya berlaku pada tahap BEFORE_READ_CACHE
       // ,"cacheKey": "cache-key-001" // Hanya berlaku pada tahap BEFORE_READ_CACHE dan BEFORE_WRITE_CACHE
    }

   Catatan

   Untuk informasi selengkapnya mengenai mekanisme fungsi resolusi kustom dan deskripsi lengkap bidang parameter input dan respons, lihat dokumentasi lengkap: Tulis kode fungsi resolusi kustom.

4. Lampirkan layanan Function Compute ke nama domain untuk resolusi

Untuk setiap nama domain yang memerlukan resolusi kustom, Anda dapat mengonfigurasi layanan Function Compute di beberapa wilayah. Anda juga dapat mengonfigurasi layanan Function Compute yang sama untuk kebijakan Function Compute dari beberapa nama domain yang memerlukan resolusi kustom.

Langkah selanjutnya

Setelah Anda mengonfigurasi resolusi DNS kustom berdasarkan Function Compute seperti yang dijelaskan dalam topik ini, lihat Alur kerja keseluruhan untuk menyelesaikan langkah-langkah berikutnya.