Azure Storage para TYPO3

Las empresas con stack Microsoft necesitan Azure Storage en lugar de sistemas de archivos locales

Cuando el panorama TI funciona sobre Azure, Active Directory gestiona los usuarios y SharePoint aloja los documentos, entonces el sistema de archivos de TYPO3 también pertenece a la nube Azure. EXT:azurestorage integra Azure Blob Storage como driver FAL (File Abstraction Layer) en TYPO3. Los redactores no notan diferencia, pero los archivos residen en la infraestructura cloud de Microsoft con CDN, geo-redundancia y almacenamiento prácticamente ilimitado en lugar del servidor web.

Esta extensión es el equivalente Azure de EXT:aus_driver_amazon_s3. La decisión entre ambas rara vez es técnica, sino que se toma en función de la estrategia cloud existente. Quien ya utiliza Azure ahorra complejidad, contratos y costes de red permaneciendo en el ecosistema Microsoft.

Escenarios de uso habituales

Sitios web enterprise con configuración multi-servidor. Las grandes instalaciones TYPO3 funcionan en varios servidores web detrás de un balanceador de carga. Sin almacenamiento cloud, los archivos deben sincronizarse entre servidores mediante rsync, NFS o GlusterFS. Cada una de estas soluciones trae sus propios problemas. Azure Blob Storage como driver FAL hace innecesaria la sincronización de archivos: todos los servidores acceden al mismo Blob Container. En un cliente con 4 servidores web y 180.000 archivos, la migración a Azure eliminó toda la infraestructura NFS.

Portales con contenido multimedia y audiencia global. Empresas con clientes en Europa, Asia y Norteamérica necesitan tiempos de carga rápidos en todo el mundo. Azure CDN entrega imágenes y descargas a través de servidores edge en más de 130 ciudades. La integración se realiza mediante la configuración del endpoint CDN en el portal Azure, TYPO3 genera automáticamente las URLs CDN correspondientes.

Requisitos de cumplimiento sobre almacenamiento de datos. Algunos sectores exigen que los archivos se almacenen en un país determinado. Azure ofrece centros de datos en Frankfurt, Zúrich y Viena. A través de la configuración del Storage Account se puede definir exactamente dónde residen físicamente los datos. Esto es una ventaja frente a proveedores genéricos compatibles con S3, donde la configuración geográfica suele ser opaca.

Arquitectura técnica

EXT:azurestorage implementa la interfaz TYPO3 FAL Driver. La extensión se registra como driver en el File Abstraction Layer y sobrescribe las operaciones estándar del sistema de archivos (lectura, escritura, eliminación, listado) con llamadas a la API de Azure Blob Storage.

La configuración se realiza a través de los ajustes de File Storage de TYPO3 en el backend. Se crea un nuevo objeto Storage con el driver “Azure Blob Storage”. Las credenciales de acceso (Storage Account Name, Access Key o SAS Token) se almacenan en la configuración del Storage. Recomendado: SAS Token con validez limitada y permisos de lectura/escritura en lugar del Master Access Key.

La comunicación entre TYPO3 y Azure se produce a través de la Azure Storage REST API. Las subidas se almacenan como Block Blobs, los archivos grandes (más de 256 MB) se dividen automáticamente en bloques. Para la integración del lado PHP, la extensión utiliza el Azure SDK for PHP o una implementación ligera de cliente REST.

Las imágenes se procesan según sea necesario mediante el Image Processing de TYPO3 (GraphicsMagick/ImageMagick). Las variantes procesadas también se almacenan en Azure, normalmente en un contenedor separado (processed). El almacenamiento en caché de los archivos procesados reduce el tiempo de procesamiento en solicitudes repetidas.

Problemas frecuentes y soluciones

Rendimiento lento del backend al navegar directorios grandes. Azure Blob Storage no tiene una estructura de directorios real, sino que la emula mediante prefijos de ruta. Listar 10.000 archivos en una “carpeta” requiere paginación de API y tarda notablemente más que en un sistema de archivos local. La solución: configurar correctamente el indexador FAL de TYPO3 y actualizar el índice regularmente, en lugar de consultar Azure en vivo con cada acceso al backend.

El procesamiento de imágenes falla. TYPO3 debe descargar imágenes para procesarlas, procesarlas y volver a subirlas. Con una conexión inestable o imágenes grandes (archivos TIFF de 200 MB), el proceso se interrumpe. Solución: realizar el procesamiento en el servidor con un directorio temporal local y subir solo el resultado. La configuración processingFolder debe apuntar a una ruta local.

Explosión de costes por llamadas API innecesarias. Cada acceso a archivos es una llamada API, y Azure factura por cada 10.000 transacciones. Un indexador TYPO3 mal configurado puede generar miles de llamadas por minuto. Configurar monitorización a través de Azure Cost Management y cambiar el indexador FAL a intervalos basados en Scheduler (en lugar de tiempo real).

Migración y compatibilidad de versiones

EXT:azurestorage es un producto nicho con comunidad limitada. Las versiones disponibles en el TER y en Packagist soportan TYPO3 v10 y v11. Para v12 existen forks en GitHub con diferentes niveles de madurez. Para TYPO3 v13 no hay actualmente una solución lista.

La alternativa para v12/v13: EXT:aus_driver_amazon_s3 con un endpoint Azure compatible con S3. Azure Blob Storage ofrece desde 2020 una capa API compatible con S3. Así se puede utilizar la extensión S3, más consolidada y mejor mantenida, también con Azure. La configuración requiere un Azure Storage Account con la función “S3-Compatible API” activada y la configuración de la extensión S3 con el endpoint Azure.

Quien migre de un sistema de archivos local a Azure debe planificar la mudanza en tres fases: primero subir los archivos existentes al Blob Container mediante AzCopy o Storage Explorer, segundo cambiar la configuración de File Storage de TYPO3, y tercero reconstruir el índice FAL. Con 50.000 archivos, todo el proceso dura típicamente un día laborable. Gosign ha realizado migraciones Azure para proyectos TYPO3 con hasta 400.000 archivos y asesora tanto sobre la extensión nativa como sobre la solución compatible con S3.