Backend
Caché de almacenamiento y CDN
Cada objeto se reenvía a través del servidor mediante proxy en lugar de redirigirse a una URL firmada — una URL firmada falla con contenido mixto (una página HTTPS, un MinIO por HTTP) y en endpoints a los que solo puede acceder el clúster. Por lo tanto, las cabeceras de respuesta son las que hacen que la caché funcione.
Cada respuesta incluye un ETag débil y Last-Modified, generados a partir del
tamaño del objeto y la hora de modificación. Un cliente que ya tiene el objeto envía
If-None-Match y recibe un 304 sin cuerpo, por lo que una carga repetida cuesta un
viaje de ida y vuelta en lugar de una transferencia completa.
Cache-Control depende de quién puede leer el objeto:
| Objeto | Cabecera |
|---|---|
Bajo el prefijo public/, o publicRead: true |
public, max-age=60, stale-while-revalidate=86400, must-revalidate |
| Cualquier otro caso | private, max-age=60, must-revalidate |
| Transformaciones de imágenes | lo mismo, con max-age=3600 |
private es deliberado: un objeto que requirió credenciales para recuperarse no debe ser
almacenado por una caché compartida, o una CDN podría entregar el archivo de un usuario al siguiente solicitante.
Vary: Authorization se envía por la misma razón.
Nunca se marca nada como immutable. Una clave de almacenamiento se puede sobrescribir — escribir
en una clave existente es una operación ordinaria —, por lo que prometer no volver a validar nunca
haría que un archivo reemplazado fuera invisible hasta que expirase la ventana de tiempo.
Búsqueda y desplazamiento (seeking) en audio y vídeo
Sección titulada «Búsqueda y desplazamiento (seeking) en audio y vídeo»Cada respuesta de objeto incluye Accept-Ranges: bytes, y una solicitud Range se
responde con 206 Partial Content y un Content-Range. Sin esto, un navegador
no permitirá desplazarse en un elemento multimedia servido desde aquí —y Safari se niega
a reproducir un <video> cuya primera respuesta no sea un 206—, por lo que para el contenido multimedia esta es
la diferencia entre un reproductor que funciona y uno roto.
- Un rango por solicitud:
bytes=0-499,bytes=500-,bytes=-500. Eso es lo que envían los navegadores para la reproducción. - Múltiples rangos en una sola cabecera se responden con el objeto completo y un
200, lo cual siempre es válido. Ningún cliente relevante los envía. - Un rango que comienza más allá del final devuelve un
416conContent-Range: bytes */<size>, no una respuesta silenciosa con el archivo completo. - La revalidación prevalece sobre un rango: una solicitud que lleve tanto
If-None-MatchcomoRangerecibe el304.
Solo se leen los bytes solicitados —del disco en el almacenamiento local, y con una
lectura por rangos desde S3 y GCS—, y cada objeto se envía al cliente en streaming a medida
que se lee, en lugar de mantenerlo antes en memoria, así que servir un vídeo grande le cuesta
al servidor la misma memoria que servir una miniatura. Una revalidación que termina en un
304, un HEAD, un 416 y una variante de imagen ya en caché se responden a partir de los
metadatos del objeto sin leer sus bytes en absoluto.
Un StorageController personalizado obtiene lo mismo implementando los métodos opcionales
statObject y getObjectStream. Uno que no los tenga se sirve mediante getObject, que lee
el objeto completo en cada solicitud, rangos incluidos.
Colocar una CDN por delante
Sección titulada «Colocar una CDN por delante»Dado que los objetos públicos son public con una ventana de stale-while-revalidate y un
validador, cualquier proxy inverso o CDN ordinario puede almacenarlos en caché sin ninguna
configuración adicional. Apúntelo al origen de la API y deje que respete las cabeceras.
Dos cosas que debe configurar en la propia CDN:
- Respetar
Vary: Authorization, o no almacenar en caché las rutas autenticadas en absoluto. Una CDN que ignoreVaryy almacene en caché respuestasprivatees el fallo que esta cabecera busca prevenir. - Esperar revalidación. El valor corto de
max-agesignifica que la CDN volverá a preguntar periódicamente; esas solicitudes son 304 económicos, y son lo que evita que un objeto sobrescrito se sirva desactualizado.
Relacionado
Sección titulada «Relacionado»- Configuración de almacenamiento — los backends desde los que se sirven estas cabeceras, y el prefijo
public/ypublicReadque hacenpublica un objeto. - Autorización por objeto — quién puede leer un objeto, que es lo que decide entre
publicyprivate. - Campos de subida de archivos — las propiedades de colección que almacenan archivos.