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 compatibles 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 admite el balanceador de cargas de aplicaciones clásico.

• 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

La optimización de imágenes requiere que el almacenamiento en caché activo esté habilitado. Asegúrate de configurar al menos una de las siguientes opciones:

• Almacenamiento en caché basado en backend: Asegúrate de que el backend tenga marcada la opción Habilitar Cloud CDN.

• Almacenamiento en caché a nivel del mapa de URL: Asegúrate de que se configure una política de caché a nivel del mapa de URL para la ruta de acceso específica en la que planeas habilitar la optimización de imágenes.

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

Formatos de imagen compatibles

La optimización de imágenes de Cloud CDN admite una amplia variedad de formatos de entrada desde tu servidor de origen. Si bien la mayoría de los formatos se pueden usar para el procesamiento y la salida, algunos formatos son solo de entrada y no se pueden usar como formatos de salida de destino.

Se admiten los siguientes formatos de imagen desde tu servidor de origen:

URL de transformación de imágenes

Para realizar transformaciones de imágenes 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, establece la calidad de compresión en 85 y convierte 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.

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 junto con la política de caché activa y subyacente.

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

Las operaciones que se enumeran 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?

• Formatos admitidos
• Limitaciones
• Casos de uso de la optimización de imágenes
• Protege las solicitudes de transformación de imágenes
• Solución de problemas y prácticas recomendadas