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 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 globaux. L'équilibreur de charge d'application classique n'est pas compatible.

• 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

L'optimisation des images nécessite la mise en cache active. Assurez-vous de configurer au moins l'un des éléments suivants :

• Mise en cache basée sur le backend : assurez-vous que la case Activer Cloud CDN est cochée pour le backend.

• Mise en cache au niveau du mappage d'URL : assurez-vous qu'une règle de cache est configurée au niveau du mappage d'URL pour le chemin d'accès spécifique où vous prévoyez d'activer l'optimisation des images.

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

Formats d'image compatibles

L'optimisation des images Cloud CDN est compatible avec un large éventail de formats d'entrée provenant de votre serveur d'origine. Bien que la plupart des formats puissent être utilisés pour le traitement et la sortie, certains formats sont _uniquement en entrée_ et ne peuvent pas être utilisés comme formats de sortie cibles.

Les formats d'image suivants sont compatibles avec votre serveur d'origine :

URL de transformation d'image

Pour effectuer des transformations d'image dynamiques, ajoutez le paramètre de requête imop à l'URL de votre 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 même 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.

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 de système absolus suivants :

• 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

• Formats compatibles
• Limites
• Cas d'utilisation de l'optimisation des images
• Sécuriser les requêtes de transformation d'image
• Dépannage et bonnes pratiques