Halaman ini diterjemahkan oleh Cloud Translation API.

Menyiapkan layanan Media CDN

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:

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 dan gcloud 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 API
Mengaktifkan Certificate Manager API.

Mengaktifkan 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.

Buka 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 baru
ADDRESS: 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 format projects/PROJECT/locations/global
ORIGIN_ID: nama pendek dari origin baru
ADDRESS: 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

resource "google_network_services_edge_cache_origin" "default" {
  name           = "cloud-storage-origin"
  origin_address = "gs://my-bucket-${random_id.unique_suffix.hex}"
}

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 (seperti HIT atau MISS)

Anda juga dapat mendaftarkan nama domain untuk layanan ini.

Konsol

Di konsol Google Cloud, buka halaman Media CDN.

Buka 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.
1. Untuk Priority, tentukan 1.
2. Klik Add match condition, untuk Path match, tentukan /, lalu klik Done.
3. Pilih Fetch from an Origin, lalu pilih origin yang Anda konfigurasi.
4. Klik Tindakan add-on.
5. Untuk Tindakan header, klik Tambahkan item. Lalu, lakukan tindakan berikut:
  1. Untuk Type, pilih Response headers to add.
  2. Klik Tambahkan header.
  3. Untuk Name, tentukan x-cache-status, dan untuk Value, tentukan {cdn_cache_status}.
  4. Klik Done.
6. Untuk Tindakan rute, klik Tambahkan item. Lalu, lakukan tindakan berikut:
  1. Untuk Jenis, pilih Kebijakan CDN.
  2. Untuk Mode cache, pilih FORCE_CACHE_ALL.
  3. Klik Done.
7. Klik Save.
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 layanan
DOMAIN: domain untuk layanan baru

Jika Anda menentukan nama domain, Media CDN akan merespons dengan error 404 untuk host lain. * ORIGIN: nama asal terkait

Gunakan 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 perintah gcloud edge-cache services list.

Catatan: Media CDN dapat memerlukan waktu hingga 10 menit untuk membuat layanan

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 format projects/PROJECT/locations/global
SERVICE_ID: nama layanan
DOMAIN: domain untuk layanan baru

Jika 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

resource "google_network_services_edge_cache_service" "default" {
  name = "cloud-media-service"
  routing {
    host_rule {
      hosts        = ["googlecloudexample.com"]
      path_matcher = "routes"
    }
    path_matcher {
      name = "routes"
      route_rule {
        description = "a route rule to match against"
        priority    = 1
        match_rule {
          prefix_match = "/"
        }
        origin = google_network_services_edge_cache_origin.default.name
        route_action {
          cdn_policy {
            cache_mode  = "CACHE_ALL_STATIC"
            default_ttl = "3600s"
          }
        }
        header_action {
          response_header_to_add {
            header_name  = "x-cache-status"
            header_value = "{cdn_cache_status}"
          }
        }
      }
    }
  }
}

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.

Buka 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 layanan
IP_ADDRESS: alamat IP layanan seperti yang terlihat di kolom Alamat dalam daftar layanan
FILE_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.

Buka 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 perintah gcloud 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 metode edgeCacheOrigins.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.

Menyiapkan layanan Media CDN

Sebelum memulai

Membuat bucket Cloud Storage

Aktifkan layanan yang diperlukan

Konsol

gcloud

Membuat resource EdgeCacheOrigin

Konsol

gcloud

API

Terraform

Membuat resource EdgeCacheService

Konsol

gcloud

API

Terraform

Mengambil alamat IP

Konsol

gcloud

API

Menguji apakah respons di-cache atau tidak

Opsional: Pembersihan

Konsol

gcloud

API

Langkah selanjutnya

Membuat resource `EdgeCacheOrigin`

Membuat resource `EdgeCacheService`