Premiers pas

Cette page vous aide à commencer à utiliser l'optimisation des images Cloud CDN. Elle explique comment configurer l'optimisation des images et fournit une liste des opérations compatibles avec des exemples.

Prérequis

Pour que l'optimisation des images Cloud CDN fonctionne, assurez-vous que les prérequis suivants sont remplis :

  • La règle de cache Cloud CDN doit être activée sur la route d'URL ou sur le service ou bucket de backend associé, et la fonctionnalité d'optimisation des images doit être active sur cette route de mappage d'URL.

  • L'optimisation des images n'est compatible qu'avec les équilibreurs de charge d'application externes mondiaux. Les équilibreurs de charge d'application classiques ne sont pas compatibles.

  • La requête client doit inclure un en-tête Accept indiquant qu'elle peut recevoir du contenu d'image, tel que image/webp, image/avif, image/* ou */*.

  • Le serveur d'origine doit répondre avec un code d'état HTTP 200 et un en-tête Content-Type d'image compatible.

  • Le paramètre de requête imop doit être inclus dans l'URL et contenir une ou plusieurs opérations de transformation valides.

Configurer l'optimisation des images

Pour utiliser l'optimisation des images, vous devez activer Cloud CDN sur la route, le service de backend ou le bucket backend approprié.

gcloud

Vous devez ajouter des configurations à votre fichier YAML et l'importer dans le mappage d'URL, car les règles d'optimisation des images sont définies dans l'objet routeAction.

Exportez la configuration de votre mappage d'URL existant dans un fichier YAML local :

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

Modifiez le fichier my-url-map.yaml dans un éditeur de texte et ajoutez le champ cachePolicy aux sections routeAction ou defaultRouteAction sélectionnées.

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

Importer le mappage d'URL mis à jour

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

Formats d'image compatibles

L'optimisation des images Cloud CDN est compatible avec des formats d'entrée et de sortie spécifiques en fonction de la configuration de la requête et des en-têtes de type de contenu d'origine.

Formats d'entrée compatibles

Les formats suivants sont compatibles en tant qu'entrée depuis votre serveur d'origine :

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

Formats de sortie compatibles

Le périphérique Cloud CDN peut traiter, mettre en cache et diffuser des dérivés d'images optimisés dans les formats suivants :

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

Types de contenu d'origine compatibles

L'optimisation des images est tentée lorsque votre serveur d'origine répond avec l'un des en-têtes Content-Type suivants :

  • 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, ou image/vnd.microsoft.icon

URL de transformation d'image

Pour effectuer des transformations d'image dynamiques, ajoutez le paramètre de requête imop à votre URL d'image. Ce paramètre contient une chaîne de transformation, qui se compose d'une ou de plusieurs opérations appliquées de manière séquentielle.

La chaîne de transformation utilise les règles de format suivantes :

  • Utilisez un point-virgule (;) pour séparer chaque opération individuelle.
  • Utilisez une virgule (,) pour séparer les paramètres internes de chaque opération individuelle.
  • Un seul type d'opération donné peut être inclus dans une seule chaîne de requête.

La syntaxe de base utilise la structure suivante :

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

Pour effectuer plusieurs actions simultanément sur une image, ajoutez une chaîne de paramètres enchaînée à l'URL de l'image. Par exemple, pour redimensionner une image à 800 pixels de large, définissez la qualité de compression sur 85 et convertissez le format en WebP, ajoutez la chaîne de paramètres.

Par exemple,

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

Structure d'une stratégie

La règle d'optimisation des images fait office de wrapper de configuration de base contenant toutes les propriétés pertinentes pour la fonctionnalité d'optimisation des images.

Nom

Description

Configuration

queryParameterInterpretation

Valeur d'énumération qui détermine si le paramètre de requête pour l'optimisation des images sera interprété dans le plan de données.

Obligatoire. Si la valeur est définie sur DISABLED, les paramètres de requête pour la transformation seront ignorés par la règle, ce qui désactivera cette fonctionnalité. Si la valeur est définie sur ENABLED, cette fonctionnalité sera activée.

Dépendances et validation des règles

La règle d'optimisation des images dépend de la mise en cache Cloud CDN. Pour que cette fonctionnalité fonctionne, une règle de cache doit être explicitement définie dans l'un des deux emplacements suivants :

  • La même route de mappage d'URL où la règle d'optimisation des images est configurée.

  • Un service de backend ou un bucket backend associé à cette route exacte.

La règle d'optimisation des images est appliquée strictement en conjonction avec la règle de cache sous-jacente active.

Règles d'ordre d'optimisation des images

Les opérations listées dans le paramètre de requête imop sont traitées de gauche à droite, à l'exception des remplacements absolus suivants du système :

  • Les opérations metadata et scale sont toujours exécutées en premier.
  • Les opérations canvas sont toujours exécutées en dernier.

Tous les composants d'entrée sont soumis à une normalisation automatique avant l'exécution de ces transformations. Les marqueurs d'orientation EXIF et les profils de couleurs ICC sont appliqués directement aux pixels de l'image avant la suppression des métadonnées, ce qui garantit que l'intégrité des coordonnées reste précise pour les actions structurelles ultérieures.

Étape suivante