Optimizar imágenes de producto subidas para Azure Blob Storage

Modela la identidad de origen, de procesamiento y de almacenamiento

Una foto de producto subida es la entrada de un flujo de trabajo, no un evento de publicación en el catálogo. Autentica a quien la sube, autoriza el registro del producto, valida el tipo de imagen detectado y el tamaño en bytes, y crea una operación de procesamiento duradera antes de aceptar el resultado de la Assembly. Conserva el archivo de origen editable o de alta resolución bajo una política de retención explícita, en lugar de suponer que el derivado WebP puede sustituirlo.

Asigna a cada derivado una versión del flujo de trabajo. El registro de la aplicación debería asociar el producto y la versión de origen con ese flujo de trabajo, con el ID de la Assembly correspondiente y con el contenedor de Azure y la ruta del blob resultantes. Así, un cambio posterior de calidad puede crear un nuevo derivado sin sobrescribir la versión revisada ni perder el camino de vuelta a su origen.

Construye el Template de imágenes de producto en Azure

El Template acepta un solo archivo mediante :original, lo envía a /image/resize y exporta únicamente el WebP resultante mediante /azure/store. El redimensionado fit mantiene la imagen completa dentro del recuadro solicitado, mientras que zoom con valor false evita que se amplíe un origen pequeño. La ruta con versión contiene un identificador de producto que solo se proporciona tras la autorización de la aplicación, además de la unicidad de la Assembly.

Configura allow_steps_override con el valor false para que un cliente de subida no pueda reemplazar el destino, solicitar una carga de trabajo mayor ni omitir el procesamiento. El objeto auth del Template limita la cantidad y el tamaño total de las subidas aceptadas. Esos límites reducen la carga de trabajo accidental, pero la aplicación debe seguir aplicando la pertenencia al inquilino, el estado de producto permitido, los límites de tasa y un valor de product_id permitido.

{
  "allow_steps_override": false,
  "auth": {
    "max_number_of_files": 1,
    "max_size": 52428800
  },
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "product_webp": {
      "use": ":original",
      "robot": "/image/resize",
      "width": 1600,
      "height": 1600,
      "resize_strategy": "fit",
      "zoom": false,
      "format": "webp",
      "quality": 82,
      "strip": true
    },
    "azure_review": {
      "use": "product_webp",
      "robot": "/azure/store",
      "credentials": "azure-product-images",
      "path": "catalog/web-v1/${fields.product_id}/${assembly.id}/${file.url_name}",
      "content_type": "image/webp",
      "cache_control": "private, no-store",
      "metadata": {
        "workflow": "catalog-web-v1",
        "source_id": "${fields.product_id}"
      },
      "sas_expires_in": 900,
      "sas_permissions": "r",
      "result": true
    }
  }
}

Define las propiedades y los metadatos del blob como parte del contrato del recurso

Un WebP versionado debería salir del flujo de trabajo con un Content-Type explícito. El ejemplo utiliza almacenamiento en caché private, no-store durante la revisión para que una caché compartida no conserve una respuesta SAS con expiración. Como /azure/store escribe cache_control en el blob almacenado, ese valor private, no-store persiste en el objeto. Entregar más adelante ese mismo blob con una política de caché exige restablecer su Cache-Control o generar un nuevo derivado, en lugar de suponer que el valor usado durante la revisión se borra solo. Guarda metadatos estables y no sensibles, como el nombre del flujo de trabajo y el identificador del registro de origen, cuando los operadores necesiten rastrear un blob sin abrir la base de datos de la aplicación.

No coloques secretos, información personal ni un valor del navegador sin límites en los metadatos ni en las rutas de Azure. Trata product_id como un identificador de aplicación validado, con un límite documentado de caracteres y longitud. /azure/store convierte los valores de metadatos de tipo string, number y boolean en cadenas, por lo que los consumidores no deberían esperar que se conserven los tipos JSON originales.

Usa una URL SAS solo para una revisión efímera

/azure/store devuelve la URL firmada en el campo sas_url del resultado; el campo url común no está firmado. La subida crea una SAS incluso cuando se omite sas_expires_in, con una duración predeterminada del servidor. Omitir sas_permissions aplica un valor predeterminado con capacidad de escritura, no un acceso de solo lectura. Este ejemplo establece explícitamente sas_permissions en r y sas_expires_in en 900 segundos. Establece ambos valores en lugar de depender de los valores predeterminados para el acceso de revisión.

El Robot no configura el acceso anónimo. Mantén privado el contenedor de destino y revisa la opción AllowBlobPublicAccess de la cuenta de almacenamiento; si se prohíbe el acceso anónimo en el nivel de la cuenta, esa configuración prevalece sobre la del contenedor. Cualquiera que obtenga la URL SAS puede usar su acceso delegado durante el periodo de validez, así que no la guardes en los registros, no la incluyas en analíticas, no la envíes a clientes ajenos ni la almacenes como URL permanente del recurso del catálogo.

Conserva el contenedor y la ruta del blob como identidad duradera. Cuando un revisor necesite acceso más adelante, la aplicación debería autorizar esa solicitud y emitir u obtener el acceso conforme a su diseño de entrega actual. Una obtención exitosa de la SAS demuestra que el objeto se puede leer con ese token; no aprueba el recurso, no otorga la publicación en el catálogo ni sustituye la autorización a nivel de producto.

Verifica el comportamiento de las imágenes antes del cambio definitivo del catálogo

El Step de redimensionado establece strip en true, lo que elimina del derivado todos los metadatos incrustados, incluido el perfil de color ICC. Prueba la orientación EXIF, las imágenes anchas y altas, las entradas transparentes, el comportamiento del perfil de color, los orígenes muy pequeños, las dimensiones muy grandes, la animación y los datos con formato incorrecto. Compara la salida renderizada, así como su tipo MIME, sus dimensiones, su tamaño en bytes y sus metadatos de almacenamiento. Tanto la eliminación del perfil como la conversión a WebP pueden afectar al color renderizado o a otro comportamiento requerido.

Verifica que la configuración de la cuenta y del contenedor de Azure impida las lecturas anónimas del blob de revisión. Concilia la exportación exitosa con la operación de producto esperada y, después, haz avanzar el registro del catálogo mediante una transición autorizada aparte. Despliega primero una cohorte de tráfico pequeña, observa el comportamiento de entrega y de caché, y conserva el derivado anterior hasta que se cierre la ventana de reversión.

Realiza la recuperación sin publicar duplicados

Un tiempo de espera agotado o un webhook perdido es un resultado incierto, no una prueba de que el blob no se haya escrito. Guarda la operación antes de crear la Assembly y procesa de forma idempotente las notificaciones de finalización firmadas. Si quien realiza la llamada pierde la respuesta, revisa la Assembly existente y el registro de la aplicación antes de iniciar otra ejecución.

Clasifica los fallos por recepción, procesamiento de imágenes, autenticación de Azure, contenedor inexistente y exportación. Ofrece a los operadores acciones de recuperación estables y mantén protegidos los detalles sin procesar del proveedor. Una nueva ejecución del flujo de trabajo debería crear un objeto versionado nuevo y actualizar el catálogo solo después de la revisión; la eliminación del blob antiguo corresponde a una tarea de retención posterior.