Cómo empezar

En esta página, se explica cómo comenzar a usar la optimización de imágenes de Cloud CDN, cómo configurar la optimización de imágenes y se incluye una lista de las operaciones admitidas con ejemplos.

Requisitos previos

Para que funcione la optimización de imágenes de Cloud CDN, asegúrate de que se cumplan los siguientes requisitos previos:

  • La política de caché de Cloud CDN debe estar habilitada en la ruta de URL o en el servicio de backend o bucket asociado, y la función de optimización de imágenes debe estar activa en esa ruta de mapa de URL.

  • La optimización de imágenes solo es compatible con los balanceadores de cargas de aplicaciones externos globales. No se admiten los balanceadores de cargas de aplicaciones clásicos.

  • La solicitud del cliente debe incluir un encabezado Accept que indique que puede recibir contenido de imagen, como image/webp, image/avif, image/* o */*.

  • El servidor de origen debe responder con un código de estado HTTP 200 y un encabezado Content-Type de imagen compatible.

  • El parámetro de consulta imop debe incluirse en la URL y contener una o más operaciones de transformación válidas.

Configura la optimización de imágenes

Para usar la optimización de imágenes, debes habilitar Cloud CDN en la ruta, el servicio de backend o el bucket de backend pertinentes.

gcloud

Debes agregar configuraciones a tu archivo YAML y, luego, importarlo al mapa de URL, ya que las políticas de optimización de imágenes se definen dentro del objeto routeAction.

Exporta la configuración del mapa de URL existente a un archivo YAML local:

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

Edita el archivo my-url-map.yaml en un editor de texto y agrega el campo cachePolicy a las secciones routeAction o defaultRouteAction seleccionadas.

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

Importa el mapa de URL actualizado

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

Formatos de imagen compatibles

La optimización de imágenes de Cloud CDN admite formatos de entrada y salida específicos según la configuración de la solicitud y los encabezados de tipo de contenido de origen.

Formatos de entrada admitidos

Se admiten los siguientes formatos como entrada desde tu servidor de origen:

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

Formatos de salida admitidos

El perímetro de Cloud CDN puede procesar, almacenar en caché y entregar derivados de imágenes optimizadas en los siguientes formatos:

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

Tipos de contenido de origen admitidos

Se intenta la optimización de imágenes cuando el servidor de origen responde con uno de los siguientes encabezados 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 de transformación de imágenes

Para realizar transformaciones de imagen dinámicas, agrega el parámetro de consulta imop a la URL de la imagen. Este parámetro contiene una cadena de transformación, que consta de una o más operaciones aplicadas en secuencia.

La cadena de transformación usa las siguientes reglas de formato:

  • Usa un punto y coma (;) para separar cada operación individual.
  • Usa una coma (,) para separar los parámetros internos dentro de cada operación individual.
  • Solo se puede incluir una operación de un tipo determinado en una sola cadena de consulta.

La sintaxis de referencia usa la siguiente estructura:

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

Para realizar varias acciones en una imagen de forma simultánea, agrega una cadena de parámetros encadenada a la URL de la imagen. Por ejemplo, para cambiar el tamaño de una imagen a 800 píxeles de ancho, establecer la calidad de compresión en 85 y convertir el formato a WebP, agrega la cadena de parámetros.

Por ejemplo:

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

Estructura de políticas

La política de optimización de imágenes actúa como el wrapper de configuración principal que contiene todas las propiedades relevantes para la funcionalidad de la función de optimización de imágenes.

Nombre

Descripción

Configuration

queryParameterInterpretation

Valor de enumeración que determina si el parámetro de consulta para la optimización de imágenes se interpretará en el plano de datos.

Obligatorio. Si se establece en DISABLED, la política ignorará los parámetros de consulta para la transformación, lo que inhabilitará esta función. Si se establece en ENABLED, se habilitará esta función.

Validación y dependencias de políticas

La política de optimización de imágenes tiene una dependencia del almacenamiento en caché de Cloud CDN. Para que esta función funcione, se debe establecer de forma explícita una política de caché en una de las dos ubicaciones siguientes:

  • La misma ruta de mapa de URL en la que se configura la política de optimización de imágenes

  • Un servicio de backend o bucket de backend relacionado con esa ruta exacta

La política de optimización de imágenes se aplica estrictamente en conjunto con la política de caché activa y subyacente.

Reglas de ordenamiento de la optimización de imágenes

Las operaciones que se muestran en el parámetro de consulta imop se procesan de izquierda a derecha, con la excepción de las siguientes anulaciones absolutas del sistema:

  • Las operaciones metadata y scale siempre se ejecutan primero.
  • Las operaciones canvas siempre se ejecutan en último lugar.

Todos los recursos de entrada se someten a una normalización automática antes de que se ejecuten estas transformaciones. Los marcadores de orientación EXIF y los perfiles de color ICC se aplican directamente a los píxeles de la imagen antes de que se quite cualquier metadato, lo que garantiza que la integridad de las coordenadas siga siendo precisa para las acciones estructurales posteriores.

¿Qué sigue?