Guida introduttiva

Questa pagina ti aiuta a iniziare a utilizzare l'ottimizzazione delle immagini di Cloud CDN, spiegando come configurare l'ottimizzazione delle immagini e l'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 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. Il bilanciatore del carico delle applicazioni classico non è supportato.

• 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

L'ottimizzazione delle immagini richiede che la memorizzazione nella cache sia attiva. Assicurati di configurare almeno una delle seguenti opzioni:

• Memorizzazione nella cache basata sul backend: assicurati che il backend abbia selezionato Abilita Cloud CDN.

• Memorizzazione nella cache a livello di mappa URL: assicurati che sia configurata una policy di memorizzazione nella cache at the livello di mappa URL per il percorso specifico in cui prevedi di abilitare l'ottimizzazione delle immagini.

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

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

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 un'ampia gamma di formati di input dal server di origine. Sebbene la maggior parte dei formati possa essere utilizzata per l'elaborazione e l'output, alcuni formati sono solo di input e non possono essere utilizzati come formati di output di destinazione.

I seguenti formati di immagine sono supportati dal server di origine:

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 della 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.

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 in modo esplicito una policy di memorizzazione nella cache in una delle due posizioni:

• 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

• Formati supportati
• Limitazioni
• Casi d'uso dell'ottimizzazione delle immagini
• Proteggere le richieste di trasformazione delle immagini
• Risoluzione dei problemi e best practice