Configura un servizio Media CDN

Console

1. Abilita l'API Network Services.

   Abilitare l'API

2. Abilita l'API Certificate Manager.

   Abilitare l'API

gcloud

1. Abilita l'API Network Services:

   gcloud services enable networkservices.googleapis.com
   

2. Abilita l'API Certificate Manager:

   gcloud services enable certificatemanager.googleapis.com
   

Console

1. Nella console Google Cloud , vai alla pagina Media CDN.

   Vai a Media CDN

2. Fai clic sulla scheda Origins.

3. Fai clic su Crea origine.

4. Inserisci il nome dell'origine come cloud-storage-origin.

5. (Facoltativo) Inserisci una descrizione per l'origine.

6. Per Indirizzo di origine, scegli Seleziona un bucket Google Cloud Storage, accedi al bucket Cloud Storage denominato my-bucket e fai clic su Seleziona.

   Se invece hai un'origine esterna, scegli Specifica un FQDN o un indirizzo IP e poi inserisci il FQDN o l'indirizzo IP.

7. Fai clic su Crea origine.

Dopo circa 10 minuti, la risorsa EdgeCacheOrigin appena creata viene visualizzata nell'elenco delle origini del progetto nella pagina Origins.

Per aggiornare un indirizzo di origine, fai clic sull'origine e poi su editModifica.

gcloud

Utilizza il comando gcloud edge-cache origins create:

gcloud edge-cache origins create ORIGIN \
    --origin-address="ADDRESS"

Sostituisci quanto segue:

• ORIGIN: il nome della nuova origine

• ADDRESS: il nome del bucket, gs://my-bucket

  Se invece hai un'origine esterna, sostituisci ADDRESS con l'FQDN o l'indirizzo IP.

Per visualizzare l'origine appena creata, utilizza il comando gcloud edge-cache origins list.

Per aggiornare l'indirizzo di origine, utilizza il comando gcloud edge-cache origins update.

API

Utilizza il metodo edgeCacheOrigins.create:

POST https://networkservices.googleapis.com/v1/PARENT/edgeCacheOrigins?edgeCacheOriginId=ORIGIN_ID
{
  "name": "ORIGIN_ID",
  "originAddress: "ADDRESS"
}

Sostituisci quanto segue:

• PARENT: la risorsa padre nel formato projects/PROJECT/locations/global
• ORIGIN_ID: il nome breve della nuova origine

• ADDRESS: il nome del bucket, gs://my-bucket

  Se invece hai un'origine esterna, sostituisci ADDRESS con l'FQDN o l'indirizzo IP.

Per visualizzare l'origine appena creata, utilizza il metodo edgeCacheOrigins.list.

Per aggiornare l'indirizzo di origine, utilizza il metodo 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}"
}

Console

1. Nella console Google Cloud , vai alla pagina Media CDN.

   Vai a Media CDN

2. Fai clic sulla scheda Services (Servizi).

3. Fai clic su Crea servizio.

4. Inserisci un nome univoco per il tuo servizio, ad esempio my-service, poi fai clic su Avanti.

5. Nella sezione Routing, fai clic su Aggiungi regola host e poi inserisci uno o più nomi di dominio host.

6. In Host inserisci un nome di dominio dell'host, ad esempio web.example.com.

7. Fai clic su Aggiungi regola di percorso.

   1. In Priorità, specifica 1.
   2. Fai clic su Aggiungi condizione di corrispondenza, per Corrispondenza del percorso specifica /, quindi fai clic su Fine.
   3. Seleziona Recupera da un'origine, quindi seleziona l'origine che hai configurato.
   4. Fai clic su Azioni aggiuntive.
   5. In Azione intestazione, fai clic su Aggiungi un elemento. Poi:
      1. Per Tipo, seleziona Intestazioni di risposta da aggiungere.
      2. Fai clic su Aggiungi intestazione.
      3. In Nome, specifica x-cache-status e in Valore specifica {cdn_cache_status}.
      4. Fai clic su Fine.
   6. In Azione del percorso, fai clic su Aggiungi un elemento. Poi:
      1. In Tipo, seleziona Criterio CDN.
      2. Per Modalità cache, seleziona FORCE_CACHE_ALL.
      3. Fai clic su Fine.
   7. Fai clic su Salva.

8. Fai clic su Crea servizio.

La risorsa EdgeCacheService appena creata viene visualizzata nella pagina Servizi nell'elenco dei servizi del progetto.

gcloud

1. In Cloud Shell, utilizza un editor di testo per creare un file locale denominato my-service.yaml.

   Un file di questo tipo indica quanto segue:

   • Come funziona il routing: prima viene abbinato l'host e poi il percorso
   • Come funziona la memorizzazione nella cache in base alla modalità cache e al TTL
   • Come vengono modificate le richieste e le risposte, ad esempio inserendo la variabile cdn_cache_status in un'intestazione di risposta

2. Incolla i seguenti contenuti di esempio nel file, quindi salvalo:

   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}"
   

   Sostituisci quanto segue:

   • SERVICE: il nome del servizio

   • DOMAIN: il dominio per il nuovo servizio

     Se specifichi il nome di dominio, Media CDN risponde con un errore 404 per gli altri host.

   • ORIGIN: il nome dell'origine correlata

3. Utilizza il comando gcloud edge-cache services import con il file YAML:

   gcloud edge-cache services import SERVICE \
       --source=my-service.yaml
   

   Per visualizzare il servizio appena creato nell'elenco delle risorse EdgeCacheService nel tuo progetto, utilizza il comando gcloud edge-cache services list.

API

Utilizza il metodo 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}"
                }
              ]
            },
          }
        ]
      }
    ]
  }
}

Sostituisci quanto segue:

• PARENT: la risorsa padre nel formato projects/PROJECT/locations/global
• SERVICE_ID: il nome del servizio

• DOMAIN: il dominio per il nuovo servizio

  Se specifichi il nome di dominio, Media CDN risponde con un errore 404 per gli altri host.

• ORIGIN_NAME: il nome dell'origine correlata

Per visualizzare il servizio appena creato nell'elenco delle risorse EdgeCacheService nel tuo progetto, utilizza il metodo 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 default route rule, priority=10 (low)"
        priority    = 10
        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}"
          }
        }
      }
    }
  }
}

Console

1. Nella console Google Cloud , vai alla pagina Media CDN.

   Vai a Media CDN

2. Fai clic sulla scheda Services (Servizi).

3. Per gli indirizzi IP del tuo servizio, consulta la cella Indirizzi.

   Se la cella è vuota, aggiorna il browser.

gcloud

Utilizza il comando gcloud edge-cache services describe:

gcloud edge-cache services describe SERVICE

Sostituisci SERVICE con il nome del servizio.

L'output mostra gli indirizzi IP assegnati al tuo servizio:

ipv4Addresses:
    IPV4_ADDRESS
ipv6Addresses:
    IPV6_ADDRESS
name: projects/my-project/locations/global/edgeCacheServices/SERVICE
...

API

Utilizza il metodo edgeCacheServices.get:

GET https://networkservices.googleapis.com/v1/SERVICE_NAME

Sostituisci SERVICE_NAME con il nome completo del servizio. Utilizza il formato seguente:

projects/PROJECT/locations/global/edgeCacheServices/SERVICE_ID

Sostituisci SERVICE_ID con il nome breve del servizio.

I dettagli recuperati includono gli indirizzi IP assegnati al servizio:

ipv4Addresses:
    IPV4_ADDRESS
ipv6Addresses:
    IPV6_ADDRESS

Console

1. Nella console Google Cloud , vai alla pagina Media CDN.

   Vai a Media CDN

2. Fai clic sulla scheda Services (Servizi).

3. Seleziona il tuo servizio e fai clic su Elimina.

4. Fai clic sulla scheda Origins.

5. Seleziona l'origine e fai clic su Elimina.

gcloud

1. Per elencare le risorse che hai creato, utilizza il comando gcloud edge-cache origins list e il comando gcloud edge-cache services list.

2. Per eliminare il servizio, utilizza il comando gcloud edge-cache services delete:

   gcloud edge-cache services delete SERVICE
   

   Sostituisci SERVICE con il nome del servizio.

3. Per eliminare l'origine, utilizza il comando gcloud edge-cache origins delete:

   gcloud edge-cache origins delete ORIGIN
   

   Sostituisci ORIGIN con il nome dell'origine.

API

1. Per elencare le risorse che hai creato, utilizza il metodo edgeCacheServices.list e il metodo edgeCacheOrigins.list.

2. Per eliminare il servizio, utilizza il metodo edgeCacheServices.delete:

   DELETE https://networkservices.googleapis.com/v1/SERVICE_NAME
   

   Sostituisci SERVICE_NAME con il nome completo del servizio. Utilizza il formato seguente:

   projects/PROJECT/locations/global/edgeCacheServices/SERVICE_ID
   

   Sostituisci SERVICE_ID con il nome breve del servizio.

3. Per eliminare l'origine, utilizza il metodo edgeCacheOrigins.delete:

   DELETE https://networkservices.googleapis.com/v1/ORIGIN
   

   Sostituisci ORIGIN con il nome completo dell'origine. Utilizza il formato seguente:

   projects/PROJECT/locations/global/edgeCacheOrigins/ORIGIN_ID
   

   Sostituisci ORIGIN_ID con il nome breve dell'origine.