Guida introduttiva

Questa pagina ti aiuta a iniziare a utilizzare l'ottimizzazione delle immagini di Cloud CDN, spiegando come configurarla e fornendo un elenco delle operazioni supportate con esempi.

Prerequisiti

Affinché l'ottimizzazione delle immagini di Cloud CDN funzioni, assicurati che siano soddisfatti i seguenti prerequisiti:

  • La policy di memorizzazione nella cache di Cloud CDN deve essere abilitata sulla route URL o sul servizio di backend o sul bucket associato e la funzionalità di ottimizzazione delle immagini deve essere attiva sulla route della mappa URL.

  • L'ottimizzazione delle immagini è supportata solo per i bilanciatori del carico delle applicazioni esterni globali. I bilanciatori del carico delle applicazioni classici non sono supportati.

  • La richiesta del client deve includere un'intestazione Accept che indichi che può ricevere contenuti immagine, ad esempio image/webp, image/avif, image/* o */*.

  • Il server di origine deve rispondere con un codice di stato HTTP 200 e un'intestazione Content-Type dell'immagine supportata.

  • Il parametro di query imop deve essere incluso nell'URL e contenere una o più operazioni di trasformazione valide.

Configurare l'ottimizzazione delle immagini

Per utilizzare l'ottimizzazione delle immagini, devi abilitare Cloud CDN sulla route, sul servizio di backend o sul bucket di backend pertinenti.

gcloud

Devi aggiungere le configurazioni al file YAML e importarlo nella mappa URL, poiché le policy di ottimizzazione delle immagini sono definite all'interno dell'oggetto routeAction.

Esporta la configurazione della mappa URL esistente in un file YAML locale:

gcloud beta compute url-maps export YOUR_URL_MAP_NAME \
    --global \
    --destination my-url-map.yaml

Modifica il file my-url-map.yaml in un editor di testo e aggiungi il campo cachePolicy alle sezioni routeAction o defaultRouteAction selezionate.

name: image-matcher
routeRules:
  --description: ImageOptimizationService
    matchRules:
       --prefixMatch: /images/
    priority: 1
    routeAction:
       imageOptimizationPolicy:
         queryParameterInterpretation: ENABLED

Importa la mappa URL aggiornata

gcloud beta compute url-maps import YOUR_URL_MAP_NAME \
    --global \
    --source my-url-map.yaml

Formati di immagine supportati

L'ottimizzazione delle immagini di Cloud CDN supporta formati di input e output specifici in base alla configurazione della richiesta e alle intestazioni dei tipi di contenuti di origine.

Formati di input supportati

I seguenti formati sono supportati come input dal server di origine:

  • HEIF
  • ICO
  • BMP
  • JP2K (JPEG 2000)

Formati di output supportati

L'edge di Cloud CDN può elaborare, memorizzare nella cache e pubblicare derivati di immagini ottimizzate nei seguenti formati:

  • JPEG
  • GIF
  • PNG
  • TIFF
  • WEBP
  • AVIF
  • BRUNSLI

Tipi di contenuti di origine supportati

L'ottimizzazione delle immagini viene tentata quando il server di origine risponde con una delle seguenti intestazioni Content-Type:

  • image/jpeg
  • image/png
  • image/webp
  • image/gif
  • image/bmp
  • image/tiff
  • image/avif
  • image/heif
  • image/jp2
  • image/x-j (brunsli)
  • text/ico, image/ico, image/icon, application/ico, image/x-icon, o image/vnd.microsoft.icon

URL di trasformazione delle immagini

Per eseguire trasformazioni dinamiche delle immagini, aggiungi il parametro di query imop all'URL dell'immagine. Questo parametro contiene una stringa di trasformazione, composta da una o più operazioni applicate in sequenza.

La stringa di trasformazione utilizza le seguenti regole di formato:

  • Utilizza un punto e virgola (;) per separare ogni singola operazione.
  • Utilizza una virgola (,) per separare i parametri interni all'interno di ogni singola operazione.
  • In una singola stringa di query può essere inclusa una sola operazione di un determinato tipo.

La sintassi di base utilizza la seguente struttura:

?imop=[OPERATION_1];[OPERATION_2];...[OPERATION_N]

Per eseguire più azioni su un'immagine contemporaneamente, aggiungi una stringa di parametri concatenata all'URL dell'immagine. Ad esempio, per ridimensionare un'immagine a 800 pixel di larghezza, impostare la qualità di compressione su 85 e convertire il formato in WebP, aggiungi la stringa di parametri.

Ad esempio,

https://www.example.com/image.jpg?imop=Resize,width=800;Compress,quality=85;Convert,format=webp;

Struttura delle policy

La policy di ottimizzazione delle immagini funge da wrapper di configurazione principale contenente ogni proprietà pertinente alla funzionalità della funzionalità di ottimizzazione delle immagini.

Nome

Descrizione

Configurazione

queryParameterInterpretation

Valore enum che determina se il parametro di query per l'ottimizzazione delle immagini verrà interpretato nel piano dati.

Obbligatorio. Se impostato su DISABLED, parametri di ricerca per la trasformazione verranno ignorati dalla policy, disabilitando di fatto questa funzionalità. Se impostato su ENABLED, questa funzionalità verrà abilitata.

Dipendenze e convalida delle policy

La policy di ottimizzazione delle immagini dipende dalla memorizzazione nella cache di Cloud CDN. Affinché questa funzionalità funzioni, è necessario impostare esplicitamente una policy di memorizzazione nella cache in una delle due posizioni seguenti:

  • La stessa route della mappa URL in cui è configurata la policy di ottimizzazione delle immagini.

  • Un servizio di backend o un bucket di backend correlato a quella route specifica.

La policy di ottimizzazione delle immagini viene applicata rigorosamente in combinazione con la policy di memorizzazione nella cache sottostante attiva.

Regole di ordinamento dell'ottimizzazione delle immagini

Le operazioni elencate nel parametro di query imop vengono elaborate da sinistra a destra, ad eccezione dei seguenti override di sistema assoluti:

  • Le operazioni metadata e scale vengono sempre eseguite per prime.
  • Le operazioni canvas vengono sempre eseguite per ultime.

Tutti gli asset di input vengono sottoposti a normalizzazione automatica prima dell'esecuzione di queste trasformazioni. I marcatori di orientamento EXIF e i profili colore ICC vengono applicati direttamente ai pixel dell'immagine prima che vengano rimossi i metadati, garantendo che l'integrità delle coordinate rimanga accurata per le successive azioni strutturali.

Passaggi successivi