Panduan memulai ini menunjukkan cara menyiapkan layanan Media CDN di depan bucket Cloud Storage. Anda dapat menggunakan konfigurasi ini untuk pengujian atau sebagai dasar untuk lingkungan produksi.
Jika ingin mengikuti panduan langkah demi langkah untuk tugas ini langsung di Konsol Google Cloud, klik Pandu saya:
Halaman ini akan memandu Anda melakukan prosedur berikut:
- Membuat bucket Cloud Storage untuk menyimpan konten Anda.
- Aktifkan layanan yang diperlukan.
- Buat resource
EdgeCacheOrigin
untuk menghubungkan Media CDN ke bucket Anda. - Buat resource
EdgeCacheService
untuk mengonfigurasi perutean dan penyimpanan permintaan dalam cache untuk konten di asal. - Menguji apakah respons di-cache.
Sebelum memulai
Pastikan Anda memiliki hal berikut:
Akses ke Media CDN untuk project saat ini.
Google Cloud CLI yang sudah terinstal. Gunakan versi 345.0.0 atau yang lebih baru.
Jika diperlukan, gunakan
gcloud version
untuk memeriksa versi dangcloud components update
untuk mengupdate gcloud CLI yang Anda instal.gcloud CLI menyediakan grup sub-perintah
gcloud edge-cache
untuk mengelola konfigurasi Media CDN baru dan yang sudah ada.Izin Identity and Access Management (IAM) yang diperlukan untuk membuat resource Media CDN. Media CDN memiliki peran IAM bawaan berikut:
roles/networkservices.edgeCacheAdmin
roles/networkservices.edgeCacheUser
roles/networkservices.edgeCacheViewer
Membuat bucket Cloud Storage
Konten Media CDN dapat berasal dari lokasi seperti bucket Cloud Storage, lokasi penyimpanan pihak ketiga, atau load balancer.
Dalam panduan memulai ini, kami akan menyimpan konten di bucket Cloud Storage.
Buat bucket Cloud Storage yang dapat diakses secara publik, lalu beri nama
my-bucket
.Jika memilih untuk tidak membuat bucket Cloud Storage dapat diakses secara publik, Anda harus memberikan izin kepada Media CDN untuk mengakses bucket. Untuk mengetahui informasi selengkapnya, baca artikel Menggunakan bucket Cloud Storage pribadi.
Upload file ke dalam bucket.
Aktifkan layanan yang diperlukan
Untuk mengonfigurasi dan men-deploy layanan Media CDN, Anda harus mengaktifkan Network Services API dan Certificate Manager API untuk project Anda.
Konsol
Mengaktifkan Network Services API.
Mengaktifkan Certificate Manager API.
gcloud
Aktifkan Network Services API:
gcloud services enable networkservices.googleapis.com
Aktifkan Certificate Manager API:
gcloud services enable certificatemanager.googleapis.com
Untuk mengetahui informasi lebih lanjut tentang cara mengaktifkan dan menonaktifkan layanan, lihat dokumentasi Penggunaan Layanan.
Membuat resource EdgeCacheOrigin
Buat origin yang mengarah ke bucket Cloud Storage Anda.
Konsol
Di konsol Google Cloud, buka halaman Media CDN.
Klik tab Origins.
Klik Create origin.
Masukkan nama untuk origin sebagai
cloud-storage-origin
.Opsional: Masukkan deskripsi untuk origin.
Untuk Origin address, pilih Select a Google Cloud Storage bucket, cari bucket Cloud Storage bernama
my-bucket
, lalu klik Select.Jika Anda memiliki origin eksternal, pilih Tentukan FQDN atau alamat IP, lalu masukkan FQDN atau alamat IP.
Klik Create origin.
Setelah sekitar 10 menit, resource EdgeCacheOrigin
yang baru dibuat
akan muncul dalam daftar origin dalam project Anda di halaman Origins.
Untuk memperbarui alamat asal, klik origin, lalu klik
Edit.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,gs://my-bucket
Jika Anda memiliki asal eksternal, ganti
ADDRESS
dengan FQDN atau alamat IP.
Untuk melihat origin yang baru dibuat, gunakan
perintah gcloud edge-cache origins list
.
Untuk memperbarui alamat asal, gunakan
perintah gcloud edge-cache origins update
.
API
Gunakan
metode edgeCacheOrigins.create
:
POST https://networkservices.googleapis.com/v1/PARENT/edgeCacheOrigins?edgeCacheOriginId=ORIGIN_ID { "name": "ORIGIN_ID", "originAddress: "ADDRESS" }
Ganti kode berikut:
PARENT
: resource induk dalam formatprojects/PROJECT/locations/global
ORIGIN_ID
: nama pendek dari origin baruADDRESS
: nama bucket,gs://my-bucket
Jika Anda memiliki asal eksternal, ganti
ADDRESS
dengan FQDN atau alamat IP.
Untuk melihat origin yang baru dibuat, gunakan
metode edgeCacheOrigins.list
.
Untuk memperbarui alamat asal, gunakan
metode edgeCacheOrigins.patch
.
Terraform
Membuat resource EdgeCacheService
Resource EdgeCacheService
Anda mengonfigurasi setelan pemilihan rute, sertifikat, dan penyimpanan dalam cache, serta dapat mengarah ke resource EdgeCacheOrigin
.
Buat resource EdgeCacheService
dasar yang melakukan hal berikut:
- Menyimpan cache semua respons dari origin yang dikonfigurasi selama satu jam
- Menetapkan header respons
x-cache-status
yang menampilkan status cache (sepertiHIT
atauMISS
)
Anda juga dapat mendaftarkan nama domain untuk layanan ini.
Konsol
Di konsol Google Cloud, buka halaman Media CDN.
Klik tab Services.
Klik Create service.
Masukkan nama unik untuk layanan Anda—misalnya,
my-service
—lalu klik Next.Di bagian Routing, klik Add host rule, lalu masukkan satu atau beberapa nama domain host.
Untuk Host, masukkan nama domain host—misalnya,
web.example.com
.Klik Tambahkan aturan rute.
- Untuk Priority, tentukan
1
. - Klik Add match condition, untuk Path match, tentukan
/
, lalu klik Done. - Pilih Fetch from an Origin, lalu pilih origin yang Anda konfigurasi.
- Klik Tindakan add-on.
- Untuk Tindakan header, klik Tambahkan item. Lalu, lakukan tindakan berikut:
- Untuk Type, pilih Response headers to add.
- Klik Tambahkan header.
- Untuk Name, tentukan
x-cache-status
, dan untuk Value, tentukan{cdn_cache_status}
. - Klik Done.
- Untuk Tindakan rute, klik Tambahkan item. Lalu, lakukan tindakan berikut:
- Untuk Jenis, pilih Kebijakan CDN.
- Untuk Mode cache, pilih FORCE_CACHE_ALL.
- Klik Done.
- Klik Save.
- Untuk Priority, tentukan
Klik Create service.
Resource EdgeCacheService
yang baru dibuat akan muncul di halaman Layanan
dalam daftar layanan di project Anda.
gcloud
Di Cloud Shell, gunakan editor teks untuk membuat file lokal bernama
my-service.yaml
.File tersebut akan menunjukkan hal berikut:
- Cara kerja pemilihan rute—dengan mencocokkan host terlebih dahulu, lalu jalurnya
- Cara kerja penyimpanan cache—berdasarkan mode cache dan TTL
- Cara permintaan dan respons diubah—misalnya, dengan menyisipkan
variabel
cdn_cache_status
ke header respons
Tempel konten contoh berikut ke dalam file, lalu simpan:
name: SERVICE routing: hostRules: - hosts: - DOMAIN pathMatcher: routes pathMatchers: - name: routes routeRules: - priority: 1 matchRules: - prefixMatch: / origin: ORIGIN routeAction: cdnPolicy: cacheMode: CACHE_ALL_STATIC defaultTtl: 3600s headerAction: responseHeadersToAdd: - headerName: "x-cache-status" headerValue: "{cdn_cache_status}"
Ganti kode berikut:
SERVICE
: nama layananDOMAIN
: domain untuk layanan baru
Jika Anda menentukan nama domain, Media CDN akan merespons dengan error
404
untuk host lain. *ORIGIN
: nama asal terkaitGunakan perintah
gcloud edge-cache services import
dengan file.yaml
:gcloud edge-cache services import SERVICE \ --source=my-service.yaml
Untuk melihat layanan yang baru dibuat dalam daftar resource
EdgeCacheService
di project Anda, gunakan perintahgcloud edge-cache services list
.
API
Gunakan
metode edgeCacheServices.create
:
POST https://networkservices.googleapis.com/v1/PARENT/edgeCacheServices?edgeCacheServiceId=SERVICE_ID { "name": "SERVICE_ID", "routing": { "hostRules": [ { "hosts": ["DOMAIN"], "pathMatcher": "routes" } ], "pathMatchers": [ { "name": "routes", "routeRules": [ { "priority": "1", "matchRules": [ { "prefixMatch": "/" } ], "origin": "ORIGIN", "routeAction": { "cdnPolicy": { "cacheMode": "CACHE_ALL_STATIC", "defaultTtl": "3600s" } } "headerAction": { "responseHeadersToAdd": [ { "headerName": "x-cache-status", "headerValue": "{cdn_cache_status}" } ] }, } ] } ] } }
Ganti kode berikut:
PARENT
: resource induk dalam formatprojects/PROJECT/locations/global
SERVICE_ID
: nama layananDOMAIN
: domain untuk layanan baruJika Anda menentukan nama domain, Media CDN akan merespons dengan error
404
untuk host lain.ORIGIN_NAME
: nama asal terkait
Untuk melihat layanan yang baru dibuat dalam daftar resource EdgeCacheService
di project Anda, gunakan
metode edgeCacheServices.list
.
Terraform
Diperlukan waktu beberapa menit untuk membuat layanan pertama Anda. Media CDN menyediakan alamat IP khusus dan mengirim konfigurasi Anda ke ribuan lokasi edge. Update berikutnya pada layanan, seperti mengubah konfigurasi rute atau parameter yang cocok, akan lebih cepat.
Mengambil alamat IP
Untuk melihat alamat IP layanan yang baru dibuat, ikuti langkah-langkah berikut:
Konsol
Di konsol Google Cloud, buka halaman Media CDN.
Klik tab Services.
Untuk alamat IP layanan Anda, lihat sel Alamat.
Jika sel kosong, muat ulang browser.
gcloud
Gunakan perintah gcloud edge-cache services describe
:
gcloud edge-cache services describe SERVICE
Ganti SERVICE dengan nama layanan.
Outputnya akan menampilkan alamat IP yang ditetapkan ke layanan Anda:
ipv4Addresses:
IPV4_ADDRESS
ipv6Addresses:
IPV6_ADDRESS
name: projects/my-project/locations/global/edgeCacheServices/SERVICE
...
API
Gunakan
metode edgeCacheServices.get
:
GET https://networkservices.googleapis.com/v1/SERVICE_NAME
Ganti SERVICE_NAME
dengan nama lengkap
layanan. Gunakan format berikut:
projects/PROJECT/locations/global/edgeCacheServices/SERVICE_ID
Ganti SERVICE_ID
dengan nama pendek layanan.
Detail yang diambil mencakup alamat IP yang ditetapkan ke layanan:
ipv4Addresses:
IPV4_ADDRESS
ipv6Addresses:
IPV6_ADDRESS
Menguji apakah respons di-cache atau tidak
Sebelum menguji layanan, pastikan Anda memiliki konten yang dapat di-cache yang disimpan di asal sehingga Media CDN dapat mengambilnya.
Untuk menguji apakah layanan Anda dikonfigurasi dengan benar untuk menyimpan konten dalam cache, gunakan
alat command line curl
untuk mengeluarkan permintaan dan memeriksa respons. curl
juga tersedia di Cloud Shell pada Konsol Google Cloud.
Jika ingin menggunakan EdgeCacheService
dengan domain Anda, Anda dapat menetapkan alamat IP EdgeCacheService
ke data domain. Untuk mengetahui petunjuknya, lihat Menyiapkan domain menggunakan Cloud DNS.
Setelah menyiapkan domain, akses konten Anda dengan perintah curl
berikut:
curl -svo /dev/null "http://DOMAIN_NAME/FILE_NAME"
Jika Anda tidak mengonfigurasi DNS agar mengarah ke alamat IP yang disediakan, gunakan opsi resolve
untuk mengganti alamat yang digunakan curl
.
curl -svo /dev/null --resolve DOMAIN_NAME:80:IP_ADDRESS "http://DOMAIN_NAME/FILE_NAME"
Ganti kode berikut:
DOMAIN_NAME
: domain host yang Anda tentukan saat membuat layananIP_ADDRESS
: alamat IP layanan seperti yang terlihat di kolom Alamat dalam daftar layananFILE_NAME
: nama file yang Anda upload ke bucket
Contoh:
curl -svo /dev/null --resolve web.example.com:80:34.104.37.129 "http://web.example.com/file.mp4"
Perintah ini awalnya menghasilkan output yang mirip dengan berikut ini, dengan status miss
, karena Media CDN tidak memiliki data yang diminta yang sudah diambil dari asal:
< HTTP/2 200 OK
...
< x-cache-status: den;miss
...
Jika Anda mengirimkan kembali permintaan yang sama beberapa kali, permintaan tersebut akan menghasilkan output yang mirip dengan berikut ini, dengan status hit
:
< HTTP/2 200 OK
...
< x-cache-status: den;hit
...
Jika tidak menampilkan status hit
, periksa hal berikut:
- Respons dapat di-cache.
- Mode cache yang dikonfigurasi memungkinkan penyimpanan konten di cache.
- Asal tidak menyetel perintah cache yang mencegah penyimpanan cache. Untuk mengetahui informasi selengkapnya, lihat Konfigurasi cache.
Sekarang Anda telah menguji resource EdgeCacheService
dasar yang dapat menyajikan
konten secara global. Layanan tingkat produksi mungkin memerlukan sertifikat SSL (TLS), beberapa origin, dan kebijakan keamanan Google Cloud Armor.
Opsional: Pembersihan
Hapus resource yang tidak ingin Anda gunakan lagi.
Konsol
Di konsol Google Cloud, buka halaman Media CDN.
Klik tab Services.
Pilih layanan Anda, lalu klik Hapus.
Klik tab Origins.
Pilih origin Anda, lalu klik Delete.
gcloud
Untuk menampilkan daftar resource yang Anda buat, gunakan perintah
gcloud edge-cache origins list
dan perintahgcloud edge-cache services list
.Untuk menghapus layanan, gunakan perintah
gcloud edge-cache services delete
:gcloud edge-cache services delete SERVICE
Ganti
SERVICE
dengan nama layanan.Untuk menghapus origin, gunakan perintah
gcloud edge-cache origins delete
:gcloud edge-cache origins delete ORIGIN
Ganti
ORIGIN
dengan nama asal.
API
Untuk menampilkan daftar resource yang Anda buat, gunakan metode
edgeCacheServices.list
dan metodeedgeCacheOrigins.list
.Untuk menghapus layanan, gunakan metode
edgeCacheServices.delete
:DELETE https://networkservices.googleapis.com/v1/SERVICE_NAME
Ganti
SERVICE_NAME
dengan nama lengkap layanan. Gunakan format berikut:projects/PROJECT/locations/global/edgeCacheServices/SERVICE_ID
Ganti
SERVICE_ID
dengan nama pendek layanan.Untuk menghapus origin, gunakan metode
edgeCacheOrigins.delete
:DELETE https://networkservices.googleapis.com/v1/ORIGIN
Ganti
ORIGIN
dengan nama lengkap asal. Gunakan format berikut:projects/PROJECT/locations/global/edgeCacheOrigins/ORIGIN_ID
Ganti
ORIGIN_ID
dengan nama pendek asal.
Ulangi proses ini untuk resource lain yang Anda buat dan tidak ingin digunakan lagi, seperti bucket Cloud Storage.
Langkah selanjutnya
- Terbitkan dan lampirkan sertifikat SSL (TLS)
ke
EdgeCacheService
. - Lihat log permintaan dengan Cloud Logging.
- Konfigurasi permintaan yang ditandatangani untuk melindungi konten Anda.
- Optimalkan kunci cache dan TTL serta tingkatkan rasio cache ditemukan.
- Mengonfigurasi pencocokan rute lanjutan dan membuat origin tambahan.