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 melalui prosedur berikut:

Buat 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 pemilihan rute permintaan dan caching untuk konten di origin.
Uji apakah respons sedang di-cache.

Sebelum memulai

Pastikan Anda memiliki hal berikut:

Akses ke Media CDN untuk project Anda saat ini.
Google Cloud CLI telah diinstal. 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 diinstal.

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.

Membuat bucket Cloud Storage

Konten CDN media dapat berasal dari lokasi seperti bucket Cloud Storage, lokasi penyimpanan pihak ketiga, atau load balancer.

Dalam panduan memulai ini, kita akan menyimpan konten di bucket Cloud Storage.

Buat bucket Cloud Storage yang dapat diakses publik dan beri nama my-bucket.

Jika Anda memilih untuk tidak membuat bucket Cloud Storage dapat diakses secara publik, Anda harus memberikan izin Media CDN untuk mengakses bucket tersebut. Untuk mengetahui informasi selengkapnya, lihat Menggunakan bucket Cloud Storage pribadi.
Upload file ke bucket.

Mengaktifkan layanan yang diperlukan

Untuk mengonfigurasi dan men-deploy layanan Media CDN, Anda perlu mengaktifkan Network Services API dan Certificate Manager API untuk project Anda.

Konsol

Aktifkan Network Services API.

Mengaktifkan API
Aktifkan 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 informasi selengkapnya 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 Buat asal.
Masukkan nama untuk origin sebagai cloud-storage-origin.
Opsional: Masukkan deskripsi untuk asal.
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 Buat asal.

Setelah sekitar 10 menit, resource EdgeCacheOrigin yang baru dibuat akan muncul dalam daftar origin di project Anda di halaman Origins.

Untuk memperbarui alamat asal, klik asal, 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 origin 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 singkat asal baru
ADDRESS: nama bucket, gs://my-bucket

Jika Anda memiliki origin 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 perutean, sertifikat, dan cache, serta dapat mengarah ke resource EdgeCacheOrigin.

Buat resource EdgeCacheService dasar yang melakukan hal berikut:

Menyimpan semua respons dari origin yang dikonfigurasi selama satu jam
Menetapkan header respons x-cache-status yang menampilkan status cache (seperti HIT atau MISS)

Atau, daftarkan 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 Pemetaan, klik Tambahkan aturan host, lalu masukkan satu atau beberapa nama domain host.
Untuk Hosts, masukkan nama domain host—misalnya, web.example.com.
Klik Tambahkan aturan rute.
1. Untuk Priority, tentukan 1.
2. Klik Tambahkan kondisi pencocokan, untuk Pencocokan jalur, tentukan /, lalu klik Selesai.
3. Pilih Ambil dari Origin, lalu pilih origin yang Anda konfigurasikan.
4. Klik Tindakan add-on.
5. Untuk Tindakan header, klik Tambahkan item. Kemudian, lakukan hal berikut:
  1. Untuk Jenis, pilih Header respons yang akan ditambahkan.
  2. Klik Tambahkan header.
  3. Untuk Nama, tentukan x-cache-status, dan untuk Nilai, tentukan {cdn_cache_status}.
  4. Klik Done.
6. Untuk Tindakan rute, klik Tambahkan item. Kemudian, lakukan hal berikut:
  1. Untuk Jenis, pilih Kebijakan CDN.
  2. Untuk Mode cache, pilih FORCE_CACHE_ALL.
  3. Klik Done.
7. Klik Simpan.
Klik Create service.

Resource EdgeCacheService yang baru dibuat akan muncul di halaman Services dalam daftar layanan di project Anda.

gcloud

Di Cloud Shell, gunakan editor teks untuk membuat file lokal bernama my-service.yaml.

File tersebut menunjukkan hal berikut:
- Cara kerja pemilihan rute—dengan mencocokkan host terlebih dahulu, lalu jalurnya
- Cara kerja penyimpanan dalam cache—berdasarkan mode cache dan TTL
- Cara permintaan dan respons diubah—misalnya, dengan menyisipkan variabel cdn_cache_status ke dalam header respons

Tempelkan contoh konten 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 origin 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 origin 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}"
          }
        }
      }
    }
  }
}

Mungkin perlu waktu beberapa menit agar layanan pertama Anda dibuat. Media CDN menyediakan alamat IP khusus dan mengirimkan konfigurasi Anda ke ribuan lokasi edge. Pembaruan berikutnya pada layanan, seperti mengubah konfigurasi rute atau parameter pencocokan, 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 Addresses.

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.

Output 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 singkat layanan.

Detail yang diambil mencakup alamat IP yang ditetapkan ke layanan:

ipv4Addresses:
    IPV4_ADDRESS
ipv6Addresses:
    IPV6_ADDRESS

Menguji apakah respons sedang di-cache

Sebelum menguji layanan, pastikan Anda memiliki konten yang dapat disimpan dalam cache yang disimpan di origin sehingga Media CDN dapat mengambilnya.

Untuk menguji apakah layanan Anda dikonfigurasi dengan benar untuk meng-cache konten, gunakan alat command line curl untuk mengeluarkan permintaan dan memeriksa respons. curl juga tersedia di Cloud Shell di konsol Google Cloud.

Jika ingin menggunakan EdgeCacheService dengan domain, 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 untuk 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 Addresses 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 origin:

< HTTP/2 200 OK
...
< x-cache-status: den;miss
...

Jika Anda mengirimkan permintaan yang sama lagi sebanyak mungkin, permintaan tersebut akan menghasilkan output yang mirip dengan berikut, 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 caching konten.
Origin tidak menetapkan perintah cache yang mencegah penyimpanan dalam cache. Untuk informasi selengkapnya, lihat Konfigurasi cache.

Anda kini telah menguji resource EdgeCacheService dasar yang dapat menayangkan 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 asal Anda, lalu klik Hapus.

gcloud

Untuk mencantumkan 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 origin.

API

Untuk mencantumkan 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 singkat 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 singkat asal.

Ulangi proses ini untuk resource lain yang Anda buat dan tidak ingin digunakan lagi, seperti bucket Cloud Storage.

Langkah selanjutnya

Tetapkan dan lampirkan sertifikat SSL (TLS) ke EdgeCacheService Anda.
Lihat log permintaan dengan Cloud Logging.
Mengonfigurasi permintaan yang ditandatangani untuk melindungi konten Anda.
Optimalkan kunci cache dan TTL serta tingkat hit cache.
Mengonfigurasi pencocokan rute lanjutan dan membuat origin tambahan.

Menyiapkan layanan Media CDN

Sebelum memulai

Membuat bucket Cloud Storage

Mengaktifkan 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 sedang di-cache

Opsional: Pembersihan

Konsol

gcloud

API

Langkah selanjutnya

Membuat resource `EdgeCacheOrigin`

Membuat resource `EdgeCacheService`