Configurare un'origine

Puoi configurare le origini per Media CDN in molti modi. Questa pagina mostra come configurare le origini.

Configura un bucket Cloud Storage come origine

Media CDN supporta i bucket Cloud Storage come backend per i contenuti. Ogni servizio può fare riferimento a più bucket configurando route per host, percorsi e altri attributi della richiesta.

I bucket Cloud Storage vengono configurati utilizzando l'URL del bucket, ad esempio gs://my-bucket, come indirizzo di origine durante la creazione di una risorsa di origine.

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 un nome per l'origine. Ad esempio: cloud-storage-origin.

  5. (Facoltativo) Inserisci una descrizione.

  6. Per Indirizzo di origine, scegli Seleziona un bucket Google Cloud Storage.

  7. Sfoglia i bucket Cloud Storage e seleziona quello che ti interessa.

  8. Per Cloud Storage, mantieni le impostazioni predefinite del protocollo e della porta.

  9. (Facoltativo) Per fare in modo che gli override delle intestazioni della richiesta di origine abbiano la precedenza sulle intestazioni inviate dal client o manipolate dalle azioni sulle intestazioni a livello di route, segui questi passaggi:

    1. Seleziona Abilita override origine.
    2. Nella sezione Intestazioni, specifica le intestazioni aggiungendo una o più coppie nome-valore.
  10. (Facoltativo) Seleziona un'origine del failover da provare nel caso in cui questa origine diventi irraggiungibile. Puoi aggiornare questo campo in un secondo momento.

  11. Seleziona le condizioni di reindirizzamento.

  12. Seleziona le condizioni di nuovo tentativo.

  13. In Numero massimo di tentativi, seleziona il numero massimo di tentativi di compilazione della cache da questa origine.

  14. (Facoltativo) Specifica i seguenti valori di timeout:

    1. In Timeout connessione, seleziona la durata massima di attesa per stabilire la connessione di origine.
    2. In Timeout della risposta, seleziona la durata massima consentita per il completamento di una risposta.
    3. In Timeout di lettura, seleziona la durata massima di attesa tra le letture di una singola connessione HTTP o un singolo flusso di dati.
  15. (Facoltativo) Fai clic su Aggiungi etichetta e specifica una o più coppie chiave-valore.

  16. Fai clic su Crea origine.

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, ad esempio gs://my-bucket

Questo vale sia che il bucket sia multiregionale, a due regioni o regionale.

Quando configuri un servizio, puoi indirizzare i contenuti video on demand a un bucket e i contenuti in live streaming a un secondo bucket. Questo è utile se hai team diversi che gestiscono ogni workflow. Per ridurre la latenza di riempimento della cache, puoi instradare in modo simile la regione eu-media.example.com a un bucket Cloud Storage multiregionale situato nell'UE e la regione us-media.example.com (o la corrispondenza in base al percorso, all'intestazione o al parametro di query) a un bucket di archiviazione con sede negli Stati Uniti.

Bucket Media CDN.
Bucket Media CDN (fai clic per ingrandire).

Per i casi in cui la latenza di scrittura è fondamentale, come il live streaming a bassa latenza, puoi configurare un endpoint Cloud Storage regionale il più vicino possibile ai tuoi utenti.

Autentica le richieste

Per confermare che una richiesta proviene da Media CDN, utilizza uno dei seguenti approcci supportati:

  • Verifica che l'indirizzo IP di connessione provenga dagli intervalli di riempimento della cache di Media CDN. Questi intervalli sono condivisi tra tutti i clienti, ma vengono sempre utilizzati dalle risorse EdgeCacheService durante la connessione a un'origine.
  • Aggiungi un'intestazione della richiesta personalizzata con un valore del token che convalidi nell'origine (ad esempio, un valore casuale di 16 byte). L'origine può quindi rifiutare le richieste che non includono questo valore.

Configura un protocollo di origine

Se l'origine supporta HTTP/2, non è necessario impostare esplicitamente il protocollo. Per le origini che supportano solo HTTPS (HTTP/1.1 su TLS) o HTTP/1.1 (senza TLS), imposta esplicitamente il campo protocol nel seguente modo:

Console

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

    Vai a Media CDN

  2. Fai clic sulla scheda Origini.

  3. Seleziona l'origine e fai clic su Modifica.

  4. Per il protocollo, seleziona HTTPS o HTTP. Per HTTP, specifica anche la porta 80.

  5. Fai clic su Aggiorna origine.

gcloud

Utilizza il comando gcloud edge-cache origins update:

gcloud edge-cache origins update LEGACY_ORIGIN \
    --protocol=HTTPS

Sostituisci LEGACY_ORIGIN con il nome dell'origine.

Configura bucket Cloud Storage privati

Media CDN può estrarre contenuti da qualsiasi endpoint HTTP o HTTPS raggiungibile da internet. In alcuni casi, potresti voler richiedere l'autenticazione per consentire solo a Media CDN di estrarre i contenuti e impedire l'accesso non autorizzato. Cloud Storage supporta questa funzionalità tramite le autorizzazioni IAM.

Per le origini Cloud Storage, segui questi passaggi:

  • Concedi al account di servizio Media CDN un ruolo che includa l'autorizzazione IAM storage.objects.get sui bucket Cloud Storage che utilizzi come origini. Ad esempio, concedi il ruolo roles/storage.legacyObjectReader (roles/storage.legacyObjectReader) o un ruolo personalizzato che include l'autorizzazione storage.objects.get. Poiché il ruolo roles/storage.objectViewer (roles/storage.objectViewer) include l'autorizzazione storage.objects.list, non concederlo a meno che tu non voglia che i client possano elencare gli oggetti nel bucket.
  • Rimuovi l'autorizzazione allUsers.
  • (Facoltativo) Rimuovi l'autorizzazione allAuthenticatedUsers.

Per modificare le autorizzazioni di un bucket Cloud Storage, devi disporre del ruolo Storage Admin (roles/storage.admin).

Il account di servizio Media CDN è di proprietà del progetto Media CDN e non verrà visualizzato nell'elenco dei service account del tuo progetto. Il account di servizio concede l'accesso solo alle risorse Media CDN nei progetti che consenti esplicitamente.

Devi creare almeno una risorsa Media CDN per attivare la creazione del account di servizio. Nella maggior parte dei casi, si tratta della risorsa EdgeCacheOrigin collegata al tuo bucket Cloud Storage.

Per concedere a Media CDN l'autorizzazione storage.objects.get su un bucket, assegna al account di servizio il ruolo roles/storage.legacyObjectReader o un ruolo personalizzato che includa l'autorizzazione:

gcloud storage buckets add-iam-policy-binding gs://BUCKET \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-mediaedgefill. \
    --role=roles/storage.legacyObjectReader

Sostituisci quanto segue:

  • BUCKET: il nome del bucket
  • PROJECT_NUMBER: il numero del progetto che contiene le risorse Media CDN.

Prima di rimuovere l'accesso pubblico a un bucket di archiviazione esistente utilizzato come origine di produzione, attendi almeno 10 minuti per consentire la propagazione della configurazione.

Utilizza il comando gcloud storage buckets remove-iam-policy-binding per rimuovere le autorizzazioni concesse al ruolo allUsers per il bucket specificato. Ad esempio, se il bucket concede a allUsers il ruolo objectViewer, rimuovi la concessione utilizzando il seguente comando:

gcloud storage buckets remove-iam-policy-binding gs://BUCKET \
    --member=allUsers --role=roles/storage.objectViewer

Per verificare che l'accesso pubblico sia stato rimosso, apri una finestra del browser in incognito e prova ad accedere a un oggetto del bucket utilizzando https://storage.googleapis.com/BUCKET/object.ext.

Per consentire alle risorse EdgeCacheService di un progetto di accedere a un bucket Cloud Storage in un altro progetto, puoi concedere al account di servizio Media CDN di quel progetto l'accesso al bucket di archiviazione.

Per farlo, verifica che PROJECT_NUMBER in service-PROJECT_NUMBER@gcp-sa-mediaedgefill. sia il numero di progetto con le risorse EdgeCacheService che richiedono l'accesso. Puoi ripetere questa operazione per più progetti, soprattutto se alcuni di questi ospitano ambienti Media CDN diversi (ad esempio sviluppo, gestione temporanea o produzione) e un progetto separato contiene i tuoi asset video o multimediali.

Puoi proteggere l'accesso all'origine Cloud Storage senza abilitare le richieste firmate per quella route.

La configurazione di Cloud Storage privato non impedisce l'accesso diretto ai contenuti memorizzati nella cache da Media CDN. Per informazioni su come inviare richieste firmate a singoli utenti, consulta Richieste firmate.

Configura un bilanciatore del carico delle applicazioni esterno come origine

Se hai bisogno di un controllo di integrità attivo, di un round robin o di un indirizzamento sensibile al carico tra origini Compute Engine, GKE o on-premise, puoi configurare un bilanciatore del carico delle applicazioni esterno come origine.

In questo modo puoi configurare, ad esempio, i tuoi pacchettizzatori di live streaming dietro Media CDN o un gruppo di proxy Envoy gestiti da Cloud Service Mesh per la connessione alla tua infrastruttura on-premise.

I bilanciatori del carico consentono di configurare i backend per:

Un'architettura che combina un'origine del bilanciatore del carico delle applicazioni esterno per la pubblicazione dei manifest video e un'origine Cloud Storage per l'archiviazione dei segmenti è simile alla seguente, con due origini mappate a route diverse.

Deployment di Edge Cache.
Deployment della cache perimetrale (fai clic per ingrandire).

Per configurare un bilanciatore del carico delle applicazioni esterno come origine, devi creare una risorsa di origine con l'indirizzo IP o il nome host pubblico che punta alle regole di forwarding del bilanciatore del carico. È preferibile un nome host pubblico (nome di dominio) perché è necessario per un certificato SSL (TLS) e per le versioni HTTP moderne (HTTP/2 e HTTP/3).

Devi inoltre confermare quanto segue:

  • Il bilanciatore del carico ha una route che corrisponde al nome host utilizzato per la risorsa EdgeCacheService o hai configurato un urlRewrite.hostRewrite per le route in cui il bilanciatore del carico è configurato come origine.
  • Il bilanciatore del carico ha un certificato SSL (TLS) pubblicamente attendibile configurato per questi nomi host.

Ad esempio, se il nome di dominio pubblico che punta alla regola di forwarding del bilanciatore del carico è origin-packager.example.com, devi creare un'origine con originAddress impostato su questo nome.

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 un nome per l'origine. Ad esempio: load-balancer-origin.

  5. (Facoltativo) Inserisci una descrizione.

  6. In Indirizzo origine, scegli Specifica un FQDN o un indirizzo IP.

  7. Inserisci il nome di dominio completo o l'indirizzo IP del bilanciatore del carico Google Cloud .

  8. (Facoltativo) Seleziona un'origine del failover da provare nel caso in cui questa origine diventi irraggiungibile. Puoi aggiornare questo campo in un secondo momento.

  9. Seleziona le condizioni di nuovo tentativo.

  10. In Numero massimo di tentativi, seleziona il numero massimo di tentativi di compilazione della cache da questa origine.

  11. (Facoltativo) Specifica i seguenti valori di timeout:

    1. In Timeout connessione, seleziona la durata massima di attesa per stabilire la connessione di origine.
    2. In Timeout della risposta, seleziona la durata massima consentita per il completamento di una risposta.
    3. In Timeout di lettura, seleziona la durata massima di attesa tra le letture di una singola connessione HTTP o un singolo flusso di dati.
  12. (Facoltativo) Fai clic su Aggiungi etichetta e specifica una o più coppie chiave-valore.

  13. Fai clic su Crea origine.

gcloud

Utilizza il comando gcloud edge-cache origins create:

gcloud edge-cache origins create LB_ORIGIN \
    --origin-address=LB_ADDRESS

Sostituisci quanto segue:

  • LB_ORIGIN: il nome dell'origine
  • LB_ADDRESS: il nome di dominio completo o l'indirizzo IP, ad esempio origin-packager.example.com

Se utilizzi l'indirizzo IP della regola di forwarding come indirizzo di origine o se non hai un certificato SSL collegato al bilanciatore del carico, puoi impostare il protocollo su HTTP per utilizzare connessioni non criptate. Ti consigliamo di farlo solo per lo sviluppo o i test.

Configura una regione per la protezione flessibile

Puoi configurare una regione per la schermatura flessibile quando crei o aggiorni un'origine.

Console

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

    Vai a Media CDN

  2. Fai clic sulla scheda Origini.

  3. Fai clic sul nome dell'origine da aggiornare.

  4. Per passare alla modalità di modifica, fai clic sul pulsante Modifica.

  5. Nella sezione Controlli dell'origine, per Schermatura dell'origine, seleziona Schermatura flessibile (personalizzata). La regione più vicina viene selezionata automaticamente. Se la regione più vicina non è disponibile nell'elenco, seleziona manualmente un valore dall'elenco delle regioni disponibili. I valori validi sono africa-south1, europe-west3, me-central1 e us-east5.

  6. Per salvare le modifiche, fai clic su Aggiorna origine.

Per reimpostare la protezione predefinita, aggiorna l'origine selezionando Protezione origine (impostazione predefinita).

gcloud

Per configurare la schermatura flessibile per una regione in un'origine esistente, utilizza il comando gcloud edge-cache origins update:

gcloud edge-cache origins update ORIGIN \
    --origin-address=ADDRESS \
    --flex-shielding=REGION

Sostituisci quanto segue:

  • ORIGIN: il nome dell'origine
  • ADDRESS: l'indirizzo dell'origine
  • REGION: la regione per l'origine schermata. I valori validi sono africa-south1, europe-west3, me-central1 e us-east5. Per reimpostare la schermatura su quella predefinita, esegui lo stesso comando dopo aver impostato l'opzione flex-shielding su vuoto.

yaml

Per configurare l'Origin Shielding per una regione in un'origine esistente, aggiungi una sezione flexShielding alla configurazione della risorsa EdgeCacheOrigin:

name: ORIGIN
originAddress: ADDRESS
# ... Other fields
flexShielding:
  flexShieldingRegions:
    - REGION
# ... Other fields

Sostituisci quanto segue:

  • ORIGIN: il nome dell'origine
  • ADDRESS: l'indirizzo dell'origine
  • REGION: la regione per l'origine schermata. I valori validi sono africa-south1, europe-west3, me-central1 e us-east5.

Per ripristinare l'impostazione predefinita di Origin Shielding, rimuovi la sezione flexShielding.

Configura il failover dell'origine

Le sezioni seguenti mostrano come configurare il comportamento di failover dell'origine.

Failover dell'origine senza seguire i reindirizzamenti

Di seguito è riportata una configurazione di failover EdgeCacheOrigin di base:

name: FAILOVER_ORIGIN
originAddress: FAILOVER_DOMAIN_NAME

Media CDN riprova l'origine principale della route per un massimo di tre volte prima di tentare un'origine del failover. In questa configurazione, dopo aver provato l'origine principale tre volte, Media CDN tenta una singola richiesta per FAILOVER_ORIGIN. Se anche l'origine del failover non risponde correttamente, Media CDN restituisce l'intera risposta dell'origine o, se non viene ricevuto alcun codice di stato, una risposta HTTP 502 Bad Gateway.

La latenza di riempimento della cache aumenta con il numero di nuovi tentativi e di eventi di failover. L'aumento dei valori di timeout dell'origine (ad esempio connectTimeout) influisce ulteriormente sulla latenza di riempimento della cache, perché aumenta il tempo di attesa per la risposta di un server di origine sovraccarico o occupato.

L'esempio seguente mostra una configurazione che invia richieste di riempimento a MY_ORIGIN. La configurazione fa sì che Media CDN riprovi in caso di errori di connessione (ad esempio errori DNS, TCP o TLS), risposte HTTP 5xx dall'origine o HTTP 404 Not Found. Dopo due tentativi, viene eseguito il failover su FAILOVER_ORIGIN.

Viene effettuato un numero massimo di quattro tentativi in totale tra le origini configurate: il tentativo originale più un massimo di tre nuovi tentativi. Puoi configurare un valore maxAttempts per origine per determinare il numero di nuovi tentativi prima di provare a eseguire il failover.

name: MY_ORIGIN
originAddress: DOMAIN_NAME
maxAttempts: 2 # the number of attempts to make before trying the failoverOrigin
failoverOrigin: FAILOVER_ORIGIN
# what conditions trigger a retry or failover
retryConditions:
- CONNECT_FAILURE
- HTTP_5xx # any HTTP 5xx response
- NOT_FOUND # retry on a HTTP 404
timeout:
  maxAttemptsTimeout: 10s # set a deadline for all retries and failover

Failover dell'origine con follow-up del reindirizzamento

Ad esempio, supponiamo che tu abbia configurato le seguenti risorse EdgeCacheOrigin e che le route della risorsa EdgeCacheService siano configurate per utilizzare PrimaryOrigin per il riempimento della cache:

name: PrimaryOrigin
originAddress: "primary.example.com"
maxAttempts: 2
failoverOrigin: "SecondaryOrigin"
retryConditions: [CONNECT_FAILURE]
originRedirect:
  redirectConditions: [FOUND, TEMPORARY_REDIRECT]
name: SecondaryOrigin
originAddress: "secondary.example.com"
maxAttempts: 3
originRedirect:
  redirectConditions: [FOUND, TEMPORARY_REDIRECT]

In questo esempio, quando Media CDN esegue un riempimento della cache, Media CDN legge la configurazione di PrimaryOrigin e risponde di conseguenza.

Supponiamo che Media CDN si connetta a primary.example.com come tentativo n. 1 di contattare l'origine. Se primary.example.com restituisce una risposta corretta, Media CDN la utilizza per il riempimento della cache.

Supponiamo ora che primary.example.com restituisca un codice HTTP 302 Found Redirect a Location: b.example.com. Quindi, come secondo tentativo di contattare l'origine, Media CDN segue il reindirizzamento a b.example.com. In questo caso, Media CDN esegue le seguenti operazioni:

  • Se b.example.com restituisce una risposta positiva, Media CDN utilizza questa risposta per il riempimento della cache.
  • Se b.example.com restituisce un reindirizzamento o una risposta di errore, Media CDN esegue il failover sul SecondaryOrigin configurato. Questo perché, in questo esempio, PrimaryOrigin è configurato per due maxAttempts.

Se Media CDN esegue il failover su SecondaryOrigin, Media CDN utilizza la configurazione SecondaryOrigin e tenta di connettersi a secondary.example.com. Questo è il primo tentativo di contattare l'origine e il terzo tentativo in totale.

In questo caso, Media CDN esegue le seguenti operazioni:

  • Se secondary.example.com restituisce una risposta corretta, Media CDN utilizza questa risposta per il riempimento della cache.
  • Se secondary.example.com restituisce un codice HTTP 302 Found Redirect a Location: c.example.com, Media CDN tenta di contattare c.example.com. In questo esempio, si tratta del secondo tentativo per SecondaryOrigin e del quarto tentativo in totale.

Se il tentativo di contattare c.example.com restituisce una risposta positiva, Media CDN utilizza questa risposta per il riempimento della cache. Se il tentativo restituisce un reindirizzamento che Media CDN è configurato per seguire, Media CDN restituisce un codice di stato HTTP 502 Bad Gateway perché ha esaurito i tentativi massimi di contattare un'origine. Media CDN effettua al massimo quattro tentativi in tutte le origini, indipendentemente dalle configurazioni EdgeCacheOrigin. Infine, se Media CDN non riesce a contattare c.example.com, Media CDN restituisce una risposta 504 Gateway Timeout o 502 Bad Gateway.

Se hai bisogno di controlli di integrità, round robin o routing basato sul carico tra le origini, puoi configurare un bilanciatore del carico delle applicazioni esterno come origine principale.

Configura i reindirizzamenti dell'origine seguenti

Media CDN supporta i reindirizzamenti restituiti dall'origine internamente durante il riempimento della cache, anziché restituire le risposte di reindirizzamento direttamente al client. Quando Media CDN è configurato per seguire i reindirizzamenti dell'origine, recupera i contenuti dalla posizione di reindirizzamento prima di memorizzarli nella cache e restituire la risposta reindirizzata al client. Media CDN segue i reindirizzamenti tra domini.

Come best practice, configura il reindirizzamento dell'origine solo per le origini che consideri attendibili e che controlli. Assicurati di considerare attendibile ogni origine in una catena di reindirizzamento, perché ogni origine produce contenuti pubblicati dal tuo EdgeCacheService.

Per abilitare i reindirizzamenti dell'origine, aggiungi la seguente configurazione alla risorsa EdgeCacheOrigin:

name: MY_ORIGIN
originAddress: DOMAIN_NAME
maxAttempts: 2
originRedirect:
  redirectConditions: [FOUND, TEMPORARY_REDIRECT]

Media CDN utilizza il protocollo specificato nei reindirizzamenti per raggiungere tutti i server. Verifica che tutti i server a cui Media CDN potrebbe essere reindirizzato supportino i protocolli richiesti. In particolare, se il protocollo è impostato su HTTPS, HTTP/2 o HTTP/3, Media CDN non esegue il fallback alle connessioni HTTP/1.1 per seguire i reindirizzamenti non protetti. L'intestazione host inviata all'origine reindirizzata corrisponde all'URL reindirizzato. Media CDN segue un singolo reindirizzamento per tentativo EdgeCacheOrigin prima di restituire la risposta finale o valutare le condizioni di nuovo tentativo o failover.

L'impostazione redirectConditions specifica quali codici di risposta HTTP fanno sì che Media CDN segua un reindirizzamento per ogni origine.

Condizione Descrizione
MOVED_PERMANENTLY Segui il reindirizzamento per il codice di risposta HTTP 301
FOUND Segui il reindirizzamento per il codice di risposta HTTP 302
SEE_OTHER Segui il reindirizzamento per il codice di risposta HTTP 303
TEMPORARY_REDIRECT Segui il reindirizzamento per il codice di risposta HTTP 307
PERMANENT_REDIRECT Segui il reindirizzamento per il codice di risposta HTTP 308

Configura riscritture dell'host o modifiche delle intestazioni specifiche per l'origine

Se l'origine richiede una riscrittura dell'host o una modifica dell'intestazione specifica per l'origine, utilizza il seguente esempio di configurazione originOverrideAction per impostarle:

name: FAILOVER_ORIGIN
originAddress: FAILOVER_ORIGIN_HOST"
originOverrideAction:
  urlRewrite:
    hostRewrite: FAILOVER_ORIGIN_HOST"
  headerAction:
    requestHeadersToAdd:
    - headerName: "Authorization"
      headerValue: "AUTH-KEY"
      replace: true

L'impostazione originOverrideAction.hostRewrite ha la precedenza su qualsiasi riscrittura delle intestazioni esistente configurata sulle route che puntano a questa origine.

Puoi utilizzare requestHeadersToAdd intestazioni univoche per origine richieste da quella specifica origine. Un caso d'uso comune è l'aggiunta di intestazioni Authorization statiche. Poiché queste manipolazioni delle intestazioni vengono eseguite durante la richiesta di origine, le intestazioni aggiunte per origine sostituiscono o vengono aggiunte alle intestazioni esistenti con lo stesso nome campo. Per impostazione predefinita, Media CDN aggiunge le intestazioni a quelle esistenti. Per sostituire le intestazioni esistenti, imposta headerAction.replace su true.

Le modifiche alle intestazioni specifiche dell'origine utilizzano solo valori di intestazione statici. Le variabili di intestazione dinamiche come {client_region} non sono supportate.

Per informazioni su come impostare le intestazioni della richiesta per route, consulta Imposta intestazioni personalizzate.

Risoluzione dei problemi relativi alle origini

Se un'origine non si comporta come previsto, scopri come risolvere i problemi relativi alle origini.

Passaggi successivi