Anda dapat mengonfigurasi origin untuk Media CDN dengan berbagai cara. Halaman ini menunjukkan cara mengonfigurasi origin.
Mengonfigurasi bucket Cloud Storage sebagai server asal
Media CDN mendukung bucket Cloud Storage sebagai backend untuk konten. Setiap layanan dapat mereferensikan beberapa bucket dengan mengonfigurasi rute untuk host, jalur, dan atribut permintaan lainnya.
Bucket Cloud Storage dikonfigurasi menggunakan URL bucket, seperti
gs://my-bucket, sebagai alamat origin saat membuat resource origin.
Konsol
Di konsol Google Cloud , buka halaman Media CDN.
Klik tab Origins.
Klik Create origin.
Masukkan nama untuk origin. Misalnya:
cloud-storage-origin.Opsional: Masukkan deskripsi.
Untuk Origin address, pilih Select a Google Cloud Storage bucket.
Cari bucket Cloud Storage Anda, lalu pilih.
Untuk Cloud Storage, pertahankan setelan protokol dan port default.
Opsional: Agar penggantian header permintaan asal lebih diprioritaskan daripada header yang dikirim oleh klien atau dimanipulasi oleh tindakan header tingkat rute, lakukan hal berikut:
- Pilih Enable origin override.
- Di bagian Headers, tentukan header dengan menambahkan satu atau beberapa pasangan nama-nilai.
Opsional: Pilih origin failover untuk dicoba jika origin ini tidak dapat dijangkau. Anda dapat memperbarui kolom ini nanti.
Pilih kondisi pengalihan.
Pilih kondisi percobaan ulang.
Untuk Max attempts, pilih jumlah maksimum upaya untuk mengisi cache dari origin ini.
Opsional: Tentukan nilai waktu tunggu berikut:
- Untuk Connect timeout, pilih durasi maksimum untuk menunggu koneksi origin dibuat.
- Untuk Response timeout, pilih durasi maksimum yang diizinkan untuk menyelesaikan respons.
- Untuk Read timeout, pilih durasi maksimum untuk menunggu di antara pembacaan satu koneksi atau aliran data HTTP.
Opsional: Klik Add label dan tentukan satu atau beberapa pasangan nilai kunci.
Klik Create origin.
gcloud
Gunakan perintah gcloud edge-cache origins create:
gcloud edge-cache origins create ORIGIN \
--origin-address=ADDRESS
Ganti kode berikut:
ORIGIN: nama origin baruADDRESS: nama bucket—misalnya,gs://my-bucket
Hal ini sama, baik bucket bersifat multi-regional, dual-region, atau regional.
Saat mengonfigurasi layanan, Anda dapat mengarahkan konten video on demand ke satu bucket dan konten live streaming ke bucket kedua. Hal ini berguna jika Anda memiliki
tim yang berbeda untuk mengelola setiap alur kerja. Untuk mengurangi latensi pengisian cache, Anda juga dapat merutekan region eu-media.example.com ke bucket Cloud Storage multiregional yang terletak di Uni Eropa dan region us-media.example.com (atau mencocokkan pada jalur, header, atau parameter kueri) ke bucket penyimpanan yang berbasis di AS.
Untuk kasus yang mengutamakan latensi tulis, seperti live streaming latensi rendah, Anda dapat mengonfigurasi endpoint Cloud Storage regional sedekat mungkin dengan pengguna.
Mengautentikasi permintaan
Untuk mengonfirmasi bahwa permintaan berasal dari Media CDN, gunakan salah satu pendekatan yang didukung berikut:
- Validasi bahwa alamat IP yang terhubung berasal dari rentang pengisian cache Media CDN. Rentang ini digunakan bersama oleh semua pelanggan, tetapi selalu digunakan oleh resource
EdgeCacheServicesaat terhubung ke origin. - Tambahkan header permintaan kustom dengan nilai token yang Anda validasi di origin (misalnya, nilai 16 byte acak). Server asal Anda kemudian dapat menolak permintaan yang tidak menyertakan nilai ini.
Mengonfigurasi protokol origin
Jika origin Anda mendukung HTTP/2, Anda tidak perlu menetapkan protokol secara eksplisit.
Untuk origin yang hanya mendukung HTTPS (HTTP/1.1 melalui TLS) atau HTTP/1.1 (tanpa TLS), tetapkan kolom protocol secara eksplisit dengan melakukan hal berikut:
Konsol
Di konsol Google Cloud , buka halaman Media CDN.
Klik tab Origins.
Pilih origin Anda, lalu klik Edit.
Untuk protokol, pilih HTTPS atau HTTP. Untuk HTTP, tentukan juga port sebagai
80.Klik Update origin.
gcloud
Gunakan perintah gcloud edge-cache origins update:
gcloud edge-cache origins update LEGACY_ORIGIN \
--protocol=HTTPS
Ganti LEGACY_ORIGIN dengan nama origin.
Mengonfigurasi bucket Cloud Storage pribadi
Media CDN dapat mengambil konten dari endpoint HTTP atau HTTPS yang dapat dijangkau internet. Dalam beberapa kasus, Anda mungkin ingin mewajibkan autentikasi, agar hanya mengizinkan Media CDN mengambil konten, dan mencegah akses yang tidak sah. Cloud Storage mendukung hal ini melalui izin IAM.
Untuk origin Cloud Storage, lakukan hal berikut:
- Berikan peran kepada akun layanan Media CDN yang menyertakan
izin IAM
storage.objects.getdi bucket Cloud Storage yang Anda gunakan sebagai origin. Misalnya, berikan peran roles/storage.legacyObjectReader (roles/storage.legacyObjectReader) atau peran khusus yang mencakup izinstorage.objects.get. Karena peran roles/storage.objectViewer (roles/storage.objectViewer) menyertakan izinstorage.objects.list, jangan berikan peran ini kecuali jika Anda ingin klien dapat mencantumkan objek dalam bucket. - Hapus izin
allUsers. - Opsional: Hapus izin
allAuthenticatedUsers.
Untuk mengubah izin bucket Cloud Storage, Anda memerlukan
peran Storage Admin
(roles/storage.admin).
Akun layanan Media CDN dimiliki oleh project Media CDN, dan tidak akan muncul dalam daftar akun layanan project Anda. Akun layanan hanya memberikan akses ke resource Media CDN dalam project yang Anda izinkan secara eksplisit.
Anda harus membuat setidaknya satu resource Media CDN untuk memicu pembuatan akun layanan. Pada umumnya, ini adalah resource EdgeCacheOrigin yang terhubung ke bucket Cloud Storage Anda.
Untuk memberi Media CDN izin storage.objects.get pada
bucket, berikan peran roles/storage.legacyObjectReader atau
peran khusus yang menyertakan izin tersebut kepada akun layanan:
gcloud storage buckets add-iam-policy-binding gs://BUCKET \
--member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-mediaedgefill. \
--role=roles/storage.legacyObjectReader
Ganti kode berikut:
BUCKET: nama bucketPROJECT_NUMBER: nomor project yang berisi resource Media CDN Anda.
Sebelum menghapus akses publik ke bucket penyimpanan yang ada yang digunakan sebagai origin produksi, tunggu setidaknya 10 menit hingga konfigurasi diterapkan.
Gunakan perintah gcloud storage buckets remove-iam-policy-binding
untuk menghapus izin yang diberikan ke peran allUsers untuk bucket tertentu. Misalnya, jika bucket memberikan peran objectViewer kepada allUsers, hapus pemberian tersebut menggunakan perintah berikut:
gcloud storage buckets remove-iam-policy-binding gs://BUCKET \
--member=allUsers --role=roles/storage.objectViewer
Untuk memvalidasi bahwa akses publik telah dihapus, buka jendela browser samaran dan coba akses objek bucket menggunakan https://storage.googleapis.com/BUCKET/object.ext.
Untuk mengizinkan resource EdgeCacheService dalam satu project mengakses
bucket Cloud Storage di project lain, Anda dapat memberikan akses ke bucket penyimpanan
kepada akun layanan Media CDN dalam project tersebut.
Untuk melakukannya, pastikan bahwa PROJECT_NUMBER di
service-PROJECT_NUMBER@gcp-sa-mediaedgefill. adalah
nomor project dari project dengan resource EdgeCacheService yang memerlukan
akses. Anda dapat mengulangi langkah ini untuk beberapa project, terutama jika beberapa di antaranya
menampung lingkungan Media CDN yang berbeda (seperti pengembangan,
staging, atau produksi) dan project terpisah berisi aset video atau media
Anda.
Anda dapat melindungi akses ke origin Cloud Storage tanpa mengaktifkan permintaan bertanda tangan untuk rute tersebut.
Mengonfigurasi Cloud Storage pribadi tidak mencegah konten yang di-cache diakses langsung dari Media CDN. Untuk mengetahui informasi tentang cara mengeluarkan permintaan bertanda tangan kepada setiap pengguna, lihat permintaan bertanda tangan.
Mengonfigurasi Load Balancer Aplikasi eksternal sebagai origin
Jika Anda memerlukan health check aktif, round-robin, atau pengarahan berbasis beban di seluruh origin Compute Engine, GKE, atau lokal, Anda dapat mengonfigurasi Load Balancer Aplikasi eksternal sebagai origin.
Hal ini memungkinkan Anda mengonfigurasi (misalnya) pengemas live streaming di belakang Media CDN atau sekelompok proxy Envoy yang dikelola oleh Cloud Service Mesh untuk terhubung kembali ke infrastruktur lokal Anda.
Load balancer memungkinkan Anda mengonfigurasi backend untuk hal berikut:
- Grup instance virtual machine (VM) Compute Engine.
- Grup endpoint jaringan (termasuk VM Compute Engine dan cluster Google Kubernetes Engine).
- Grup endpoint jaringan serverless (Cloud Run, App Engine, dan Cloud Run Functions).
Arsitektur yang menggabungkan origin Load Balancer Aplikasi eksternal untuk menyajikan manifes video dan origin Cloud Storage untuk penyimpanan segmen menyerupai berikut, dengan dua origin yang dipetakan ke rute yang berbeda.
Untuk mengonfigurasi Load Balancer Aplikasi eksternal sebagai origin, Anda harus membuat resource origin dengan alamat IP atau nama host publik yang mengarah ke aturan penerusan load balancer. Nama host publik (nama domain) lebih disukai karena diperlukan untuk sertifikat SSL (TLS) dan untuk versi HTTP modern (HTTP/2 dan HTTP/3).
Anda juga harus mengonfirmasi hal berikut:
- Load balancer Anda memiliki rute yang cocok dengan nama host yang digunakan untuk resource
EdgeCacheServiceatau Anda telah mengonfigurasiurlRewrite.hostRewriteuntuk rute tempat load balancer dikonfigurasi sebagai origin. - Load balancer Anda memiliki sertifikat SSL (TLS) tepercaya publik yang dikonfigurasi untuk nama host ini.
Misalnya, jika nama domain publik yang mengarah ke aturan penerusan load balancer Anda adalah origin-packager.example.com, Anda harus membuat origin dengan originAddress yang ditetapkan ke nama ini.
Konsol
Di konsol Google Cloud , buka halaman Media CDN.
Klik tab Origins.
Klik Create origin.
Masukkan nama untuk origin. Misalnya:
load-balancer-origin.Opsional: Masukkan deskripsi.
Untuk Origin address, pilih Specify a FQDN or alamat IP.
Masukkan FQDN atau alamat IP untuk load balancer Google Cloud Anda.
Opsional: Pilih origin failover untuk dicoba jika origin ini tidak dapat dijangkau. Anda dapat memperbarui kolom ini nanti.
Pilih kondisi percobaan ulang.
Untuk Max attempts, pilih jumlah maksimum upaya untuk mengisi cache dari origin ini.
Opsional: Tentukan nilai waktu tunggu berikut:
- Untuk Connect timeout, pilih durasi maksimum untuk menunggu koneksi origin dibuat.
- Untuk Response timeout, pilih durasi maksimum yang diizinkan untuk menyelesaikan respons.
- Untuk Read timeout, pilih durasi maksimum untuk menunggu di antara pembacaan satu koneksi atau aliran data HTTP.
Opsional: Klik Add label dan tentukan satu atau beberapa pasangan nilai kunci.
Klik Create origin.
gcloud
Gunakan perintah gcloud edge-cache origins create:
gcloud edge-cache origins create LB_ORIGIN \
--origin-address=LB_ADDRESS
Ganti kode berikut:
LB_ORIGIN: nama originLB_ADDRESS: FQDN atau alamat IP—misalnya,origin-packager.example.com
Jika Anda menggunakan alamat IP aturan penerusan sebagai alamat origin, atau Anda tidak memiliki sertifikat SSL yang terpasang ke load balancer, Anda dapat menetapkan protokol ke HTTP untuk beralih ke koneksi yang tidak dienkripsi. Sebaiknya
lakukan ini hanya untuk pengembangan atau pengujian.
Mengonfigurasi region untuk perlindungan fleksibel
Anda dapat mengonfigurasi region untuk shielding fleksibel saat membuat atau memperbarui origin.
Konsol
Di konsol Google Cloud , buka halaman Media CDN.
Klik tab Origins.
Klik nama origin yang ingin Anda perbarui.
Untuk beralih ke mode edit, klik tombol Edit.
Di bagian Origin controls, untuk Origin shielding, pilih Flexible shielding (custom). Region terdekat akan dipilih secara otomatis. Jika region terdekat tidak tersedia dalam daftar, pilih nilai secara manual dari daftar region yang tersedia. Nilai yang valid adalah
africa-south1,europe-west3,me-central1, danus-east5.Untuk menyimpan perubahan, klik Update origin.
Untuk menyetel kembali perlindungan ke perlindungan server asal default, perbarui server asal untuk memilih Origin shielding (default).
gcloud
Untuk mengonfigurasi perlindungan fleksibel untuk region di origin yang ada, gunakan
perintah gcloud edge-cache origins update:
gcloud edge-cache origins update ORIGIN \
--origin-address=ADDRESS \
--flex-shielding=REGION
Ganti kode berikut:
ORIGIN: nama originADDRESS: alamat originREGION: region untuk origin shielding. Nilai yang valid adalahafrica-south1,europe-west3,me-central1, danus-east5. Untuk menyetel shielding kembali ke shielding origin default, jalankan perintah yang sama setelah menyetel opsiflex-shieldingke kosong.
yaml
Untuk mengonfigurasi origin shielding untuk region di origin yang ada, tambahkan
bagian flexShielding ke konfigurasi resource EdgeCacheOrigin Anda:
name: ORIGIN
originAddress: ADDRESS
# ... Other fields
flexShielding:
flexShieldingRegions:
- REGION
# ... Other fields
Ganti kode berikut:
ORIGIN: nama originADDRESS: alamat originREGION: region untuk origin shielding. Nilai yang valid adalahafrica-south1,europe-west3,me-central1, danus-east5.
Untuk menyetel origin shielding kembali ke default, hapus bagian flexShielding.
Mengonfigurasi failover server asal
Bagian berikut menunjukkan cara mengonfigurasi perilaku failover origin.
Failover server asal tanpa mengikuti pengalihan
Berikut adalah konfigurasi EdgeCacheOrigin failover dasar:
name: FAILOVER_ORIGIN
originAddress: FAILOVER_DOMAIN_NAME
Media CDN mencoba ulang origin utama rute maksimal tiga kali sebelum mencoba origin failover. Dalam konfigurasi ini, setelah mencoba
origin utama tiga kali, Media CDN akan mencoba satu
permintaan terhadap FAILOVER_ORIGIN. Jika
origin failover juga gagal merespons dengan berhasil, Media CDN akan menampilkan seluruh respons origin atau, jika tidak ada
kode status yang diterima, respons HTTP 502 Bad Gateway.
Latensi pengisian cache meningkat seiring dengan jumlah percobaan ulang dan peristiwa failover.
Meningkatkan nilai waktu tunggu server asal (seperti connectTimeout) akan lebih
berdampak pada latensi pengisian cache karena meningkatkan waktu yang dihabiskan untuk menunggu
server asal yang kelebihan beban atau sibuk merespons.
Contoh berikut menunjukkan konfigurasi yang mengirim permintaan pengisian ke
MY_ORIGIN. Konfigurasi ini menyebabkan
Media CDN mencoba ulang saat terjadi error koneksi (seperti error DNS, TCP, atau
TLS), respons HTTP 5xx dari origin, atau HTTP
404 Not Found. Setelah dua kali percobaan, tugas akan gagal beralih ke
FAILOVER_ORIGIN.
Upaya maksimum total yang dilakukan di seluruh origin yang dikonfigurasi adalah empat: upaya awal ditambah hingga tiga upaya percobaan ulang. Anda dapat mengonfigurasi nilai maxAttempts per origin untuk menentukan jumlah percobaan ulang yang dilakukan sebelum mencoba melakukan failover.
name: MY_ORIGIN
originAddress: DOMAIN_NAME
maxAttempts: 2 # the number of attempts to make before trying the failoverOrigin
failoverOrigin: FAILOVER_ORIGIN
# what conditions trigger a retry or failover
retryConditions:
- CONNECT_FAILURE
- HTTP_5xx # any HTTP 5xx response
- NOT_FOUND # retry on a HTTP 404
timeout:
maxAttemptsTimeout: 10s # set a deadline for all retries and failover
Failover server asal dengan mengikuti pengalihan
Misalnya, Anda telah mengonfigurasi resource EdgeCacheOrigin berikut dan rute resource EdgeCacheService Anda dikonfigurasi untuk menggunakan PrimaryOrigin untuk pengisian cache:
name: PrimaryOrigin
originAddress: "primary.example.com"
maxAttempts: 2
failoverOrigin: "SecondaryOrigin"
retryConditions: [CONNECT_FAILURE]
originRedirect:
redirectConditions: [FOUND, TEMPORARY_REDIRECT]
name: SecondaryOrigin
originAddress: "secondary.example.com"
maxAttempts: 3
originRedirect:
redirectConditions: [FOUND, TEMPORARY_REDIRECT]
Dalam contoh ini, saat Media CDN melakukan pengisian cache,
Media CDN membaca konfigurasi PrimaryOrigin dan
meresponsnya.
Misalkan Media CDN terhubung ke primary.example.com sebagai
upaya #1 untuk menghubungi origin. Jika primary.example.com menampilkan respons yang berhasil, Media CDN akan menggunakan respons tersebut untuk pengisian cache.
Sekarang, misalkan primary.example.com menampilkan HTTP 302 Found Redirect ke
Location: b.example.com. Kemudian, sebagai upaya ke-2 untuk menghubungi server asal,
Media CDN mengikuti pengalihan ke b.example.com. Dalam hal ini,
Media CDN melakukan hal berikut:
- Jika
b.example.commenampilkan respons yang berhasil, Media CDN akan menggunakan respons tersebut untuk pengisian cache. - Jika
b.example.commenampilkan respons pengalihan atau kegagalan, Media CDN akan melakukan failover keSecondaryOriginyang dikonfigurasi. Hal ini karena, dalam contoh ini,PrimaryOrigindikonfigurasi untuk duamaxAttempts.
Jika Media CDN gagal beralih ke SecondaryOrigin,
Media CDN akan menggunakan konfigurasi SecondaryOrigin dan mencoba
terhubung ke secondary.example.com. Ini adalah upaya #1 untuk menghubungi server asal,
dan upaya #3 secara keseluruhan.
Dalam hal ini, Media CDN melakukan hal berikut:
- Jika
secondary.example.commenampilkan respons yang berhasil, Media CDN akan menggunakan respons tersebut untuk pengisian cache. - Jika
secondary.example.commenampilkan HTTP302 Found RedirectkeLocation: c.example.com, Media CDN akan mencoba menghubungic.example.com. Dalam contoh ini, ini adalah upaya ke-2 untukSecondaryOrigindan upaya ke-4 secara keseluruhan.
Jika upaya untuk menghubungi c.example.com menampilkan respons yang berhasil,
Media CDN akan menggunakan respons tersebut untuk pengisian cache. Jika upaya tersebut
menampilkan pengalihan yang dikonfigurasi untuk diikuti oleh Media CDN,
Media CDN akan menampilkan kode status HTTP 502 Bad Gateway karena telah
mencapai batas maksimum upaya untuk menghubungi origin.
Media CDN melakukan maksimal empat upaya di semua origin,
terlepas dari konfigurasi EdgeCacheOrigin. Terakhir, jika
Media CDN gagal menghubungi c.example.com,
Media CDN akan menampilkan respons 504 Gateway Timeout atau
respons 502 Bad Gateway.
Jika Anda memerlukan health check, round-robin, atau pemilihan rute berbasis beban di seluruh origin, Anda dapat mengonfigurasi Load Balancer Aplikasi eksternal sebagai origin utama.
Mengonfigurasi pengalihan origin berikut
Media CDN mendukung pengalihan berikut yang ditampilkan oleh origin Anda secara internal selama pengisian cache, bukan menampilkan respons pengalihan secara langsung ke klien. Jika Media CDN dikonfigurasi untuk mengikuti pengalihan origin, Media CDN akan mengambil konten dari lokasi pengalihan sebelum meng-cache dan menampilkan respons yang dialihkan ke klien. Media CDN mengikuti pengalihan di seluruh domain.
Sebagai praktik terbaik, konfigurasikan pengalihan origin hanya untuk origin yang Anda percayai
dan kontrol. Pastikan Anda memercayai setiap origin dalam rantai pengalihan karena
setiap origin menghasilkan konten yang disajikan oleh EdgeCacheService Anda.
Untuk mengaktifkan pengalihan origin, tambahkan konfigurasi berikut ke resource EdgeCacheOrigin Anda:
name: MY_ORIGIN
originAddress: DOMAIN_NAME
maxAttempts: 2
originRedirect:
redirectConditions: [FOUND, TEMPORARY_REDIRECT]
Media CDN menggunakan protokol yang ditentukan dalam pengalihan untuk menjangkau semua server. Pastikan semua server yang mungkin dialihkan oleh Media CDN memberikan dukungan untuk protokol yang Anda perlukan.
Secara khusus, jika protokol ditetapkan ke HTTPS, HTTP/2, atau HTTP/3,
Media CDN tidak akan beralih ke koneksi HTTP/1.1 untuk mengikuti
pengalihan yang tidak aman. Header host yang dikirim ke origin yang dialihkan cocok dengan URL yang dialihkan. Media CDN mengikuti satu pengalihan per
upaya EdgeCacheOrigin sebelum menampilkan respons akhir atau mengevaluasi
kondisi percobaan ulang atau failover.
Setelan redirectConditions menentukan kode respons HTTP yang menyebabkan
Media CDN mengikuti pengalihan untuk setiap origin.
| Kondisi | Deskripsi |
|---|---|
| MOVED_PERMANENTLY | Ikuti pengalihan untuk kode respons HTTP 301 |
| FOUND | Ikuti pengalihan untuk kode respons HTTP 302 |
| SEE_OTHER | Ikuti pengalihan untuk kode respons HTTP 303 |
| TEMPORARY_REDIRECT | Ikuti pengalihan untuk kode respons HTTP 307 |
| PERMANENT_REDIRECT | Ikuti pengalihan untuk kode respons HTTP 308 |
Mengonfigurasi penulisan ulang host atau modifikasi header khusus origin
Jika origin Anda memerlukan penulisan ulang host atau modifikasi header khusus origin,
gunakan contoh konfigurasi originOverrideAction berikut untuk menetapkannya:
name: FAILOVER_ORIGIN
originAddress: FAILOVER_ORIGIN_HOST"
originOverrideAction:
urlRewrite:
hostRewrite: FAILOVER_ORIGIN_HOST"
headerAction:
requestHeadersToAdd:
- headerName: "Authorization"
headerValue: "AUTH-KEY"
replace: true
Setelan originOverrideAction.hostRewrite lebih diutamakan daripada penulisan ulang header yang ada yang dikonfigurasi pada rute yang mengarah ke origin ini.
Anda dapat menggunakan requestHeadersToAdd header unik per origin yang diminta oleh origin tertentu tersebut. Kasus penggunaan umum menambahkan header Authorization statis.
Karena manipulasi header ini dijalankan selama permintaan origin, header yang ditambahkan per origin akan menggantikan atau menambahkan header yang ada dengan nama kolom yang sama. Secara default, Media CDN menambahkan header yang ada. Untuk
mengganti header yang ada, tetapkan headerAction.replace ke true.
Modifikasi header khusus origin hanya menggunakan nilai header statis.
Variabel header dinamis seperti {client_region} tidak didukung.
Untuk mengetahui informasi tentang cara menetapkan header permintaan per rute, lihat Menetapkan header kustom.
Memecahkan masalah origin
Jika origin tidak berfungsi seperti yang diharapkan, lihat cara memecahkan masalah origin.