cara mengonfigurasi pengalihan 301/302 origin - ApsaraVideo VOD

Fitur pengalihan 301/302 origin memungkinkan point of presence (POPs) CDN untuk memproses respons 301 dan 302 dari origin server. Saat diaktifkan, POPs menangani pengalihan secara langsung alih-alih mengembalikan respons 301/302 ke klien. Hal ini menyederhanakan pertukaran data dan mempercepat pengiriman resource.

Prasyarat

Pengalihan 301/302 telah diaktifkan pada origin server Anda.

Informasi latar belakang

Kode status HTTP 301 dan 302 menunjukkan bahwa sebuah resource telah dipindahkan. Dalam situasi ini, server biasanya menyertakan header Location dalam responsnya. Ketika klien menerima respons 301 atau 302 yang disertai header Location, klien akan mengirim permintaan baru ke alamat yang ditentukan dalam header tersebut untuk mengambil resource.

Cara kerja

Dengan fitur pengalihan 301/302, jika node CDN menerima kode status 301 atau 302 dari origin server selama proses origin fetch, node tersebut akan mengikuti pengalihan tersebut untuk mengambil resource dari lokasi baru. Kode status 301 atau 302 tidak dikembalikan ke klien.

Klien meminta file http://example.com/examplefile.txt.
File tersebut belum di-cache pada node CDN. Node tersebut mengambil file dari origin server.
Origin server mengembalikan kode status 301/302 dengan alamat Location http://www.example.org/examplefile.txt.
Node CDN menerima respons tersebut dan mengirim permintaan ke alamat Location http://www.example.org/examplefile.txt untuk mengambil resource.
Node CDN berhasil mengambil resource dan menyimpannya di cache pada node CDN.
Node CDN mengembalikan resource tersebut ke klien.

Jika klien lain kemudian meminta file http://example.com/examplefile.txt, file tersebut akan langsung disajikan dari cache pada node CDN.

Catatan penggunaan

Sebelum mengonfigurasi pengalihan 301/302 origin, periksa apakah origin host telah dikonfigurasi untuk nama domain yang dipercepat di ApsaraVideo VOD:

Jika tidak ada origin host default atau origin host spesifik yang dikonfigurasi: Ketika origin server mengembalikan respons 301 atau 302 ke node CDN, header HOST pada permintaan origin fetch berikutnya akan menggunakan nama domain dari header Location.
Jika origin host telah dikonfigurasi untuk nama domain yang dipercepat: Ketika origin server mengembalikan kode status 301/302 beserta URL Location ke POP CDN, header Host dalam permintaan origin-fetch ke URL Location tersebut akan menggunakan origin host yang dikonfigurasi untuk nama domain yang dipercepat di ApsaraVideo VOD. Origin host default adalah nama domain yang dipercepat. Jika origin server Anda mensyaratkan bahwa header Host untuk URL Location harus berupa nama domain dari URL Location tersebut, akses dapat gagal. Jika Anda memiliki persyaratan ini, kirimkan tiket untuk meminta konfigurasi backend ini. Untuk informasi lebih lanjut, lihat Hubungi kami.

Prosedur

Masuk ke Konsol ApsaraVideo VOD.
Pada panel navigasi sebelah kiri, pilih Configuration Management > CDN Configuration > Domain Names.
Temukan nama domain yang ingin Anda kelola, lalu klik Configure di kolom Actions.
Pada panel navigasi sebelah kiri halaman detail domain, klik Back-to-Origin.

Pada tab Configuration, di bagian Origin 301/302 Redirection, aktifkan sakelar Origin 301/302 Redirection dan konfigurasikan parameter-parameternya.

Parameter	Deskripsi
Maximum 301/302 Redirects	Jumlah maksimum kali node CDN dapat mengikuti pengalihan ke alamat Location selama satu permintaan pengguna. Jika batas ini terlampaui, node akan langsung mengembalikan kode status 301/302 ke pengguna. Nilai yang valid: 1 hingga 5. Nilai default: 2. Catatan Jumlah maksimum pengalihan 301/302 memengaruhi jumlah maksimum origin fetch. Jumlah maksimum origin fetch adalah jumlah maksimum kali node CDN dapat mengakses origin server selama satu permintaan pengguna. Jumlah maksimum origin fetch = Jumlah maksimum pengalihan 301/302 + 1. Nilai default jumlah maksimum origin fetch adalah 3. Nilai yang valid: 2 hingga 6.
Retain Parameters in 301/302 Redirects	Retain: Mempertahankan parameter permintaan asli saat mengikuti pengalihan 301/302. Parameter tersebut diteruskan ke server di alamat Location. Do not retain: Menghapus parameter permintaan asli saat mengikuti pengalihan 301/302.
Retain Request Headers in 301/302 Redirects	Retain: Mempertahankan header permintaan asli saat mengikuti pengalihan 301/302. Header tersebut diteruskan ke server di alamat Location. Do not retain: Menghapus header permintaan asli saat mengikuti pengalihan 301/302.

Klik OK untuk menyelesaikan konfigurasi.

Contoh konfigurasi

Skenario: Resource pada origin server Anda dipindahkan ke alamat lain. Anda ingin pengguna tetap dapat mengakses resource tersebut menggunakan nama domain asli tanpa menyadari perubahan tersebut.

Konfigurasi: Aktifkan pengalihan 301/302 origin untuk nama domain example.com dengan pengaturan berikut:

Maximum Number of 301/302 Redirects: 2
Retain Parameters in 301/302 Redirects: Do not retain
Retain Request Headers in 301/302 Redirects: Do not retain

Hasil: Klien meminta file http://example.com/examplefile.txt. Jika file tersebut belum di-cache pada node CDN, node tersebut meminta resource dari origin server. Origin server mengembalikan kode status 301/302 beserta alamat pengalihan http://www.example.org/examplefile.txt.

Setelah node CDN menerima kode status 301/302, node tersebut mengirim permintaan ke alamat pengalihan tersebut. Permintaan ini dapat dialihkan hingga dua kali. Jika permintaan gagal, kode status 301/302 dikembalikan ke klien.
Node CDN berhasil mengambil resource, mengembalikannya ke client, dan menyimpannya di cache pada node CDN.
Ketika klien lain meminta file tersebut, CDN langsung mengembalikan resource yang telah di-cache.