Configura un servizio Media CDN

Console

1. Attiva 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 Origini.

3. Fai clic su Crea origine.

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

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 IP e inserisci il nome di dominio completo o l'indirizzo IP.

7. Fai clic su Crea origine.

Dopo circa 10 minuti, la risorsa EdgeCacheOrigin appena creata viene visualizzato nell'elenco delle origini del progetto alla pagina Origini.

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

gcloud

Usa 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: nome del bucket, gs://my-bucket

  Se invece hai un'origine esterna, sostituisci ADDRESS con il nome di dominio completo o un indirizzo IP.

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

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

API

Utilizza la 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: nome del bucket, gs://my-bucket

  Se invece hai un'origine esterna, sostituisci ADDRESS con il nome di dominio completo o un indirizzo IP.

Per visualizzare l'origine appena creata, utilizza la 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, quindi inserisci una regola host. 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. Per Nome specifica x-cache-status e per 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 sezione Servizi nell'elenco dei servizi del tuo progetto.

gcloud

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

   Questo file indica quanto segue:

   • Come funziona il routing: abbinando prima l'host e poi il percorso
   • Funzionamento della memorizzazione nella cache, in base a modalità cache e TTL
   • Il modo in cui vengono modificate richieste e risposte, ad esempio inserendo la variabile cdn_cache_status in un'intestazione di risposta

2. Incolla i seguenti contenuti di esempio nel file e 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: nome del servizio
   • DOMAIN: il dominio del nuovo servizio

   Se specifichi il nome di dominio, Media CDN risponde con un 404 errore per gli altri host. * ORIGIN: il nome dell'origine correlata

3. Usa 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 di EdgeCacheService per le risorse del tuo progetto, utilizza Comando gcloud edge-cache services list.

API

Utilizza la 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 del 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 di EdgeCacheService risorse nel tuo progetto, utilizza 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 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}"
          }
        }
      }
    }
  }
}

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 servizio, vedi la cella Indirizzi.

   Se la cella è vuota, aggiorna il browser.

gcloud

Usa 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 la Metodo edgeCacheServices.get:

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

Sostituisci SERVICE_NAME con il nome completo del completamente gestito di Google Cloud. 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 Origini.

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

gcloud

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

2. Per eliminare il servizio, utilizza il metodo 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 metodo 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 Metodo edgeCacheServices.list e il metodo edgeCacheOrigins.list.

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

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

   Sostituisci SERVICE_NAME con il nome completo del completamente gestito di Google Cloud. 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 Metodo edgeCacheOrigins.delete:

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

   Sostituisci ORIGIN con il nome completo del origine dati. Utilizza il formato seguente:

   projects/PROJECT/locations/global/edgeCacheOrigins/ORIGIN_ID
   

   Sostituisci ORIGIN_ID con il nome breve dell'origine.