Azure Storage for TYPO3

Unternehmen mit Microsoft-Stack brauchen Azure Storage statt lokaler Dateisysteme

Wenn die IT-Landschaft auf Azure läuft, Active Directory die Benutzer verwaltet und SharePoint die Dokumente hält, dann gehört auch das TYPO3-Dateisystem in die Azure Cloud. EXT:azurestorage bindet Azure Blob Storage als FAL-Treiber (File Abstraction Layer) in TYPO3 ein. Redakteure merken keinen Unterschied, die Dateien liegen aber statt auf dem Webserver in Microsofts Cloud-Infrastruktur mit CDN, Geo-Redundanz und praktisch unbegrenztem Speicher.

Diese Extension ist das Azure-Pendant zu EXT:aus_driver_amazon_s3. Die Entscheidung zwischen beiden fällt selten technisch, sondern entlang der bestehenden Cloud-Strategie. Wer bereits Azure nutzt, spart Komplexität, Verträge und Netzwerk-Kosten durch den Verbleib im Microsoft-Ökosystem.

Typical use cases

Enterprise-Websites mit Multi-Server-Setup. Große TYPO3-Installationen laufen auf mehreren Webservern hinter einem Load Balancer. Ohne Cloud-Storage müssen Dateien zwischen den Servern synchronisiert werden, per rsync, NFS oder GlusterFS. Jede dieser Lösungen bringt eigene Probleme. Azure Blob Storage als FAL-Treiber macht die Dateisynchronisation überflüssig: Alle Server greifen auf denselben Blob Container zu. Bei einem Kunden mit 4 Webservern und 180.000 Dateien entfiel durch die Migration auf Azure die gesamte NFS-Infrastruktur.

Medienintensive Portale mit globalem Publikum. Unternehmen mit Kunden in Europa, Asien und Nordamerika brauchen schnelle Ladezeiten weltweit. Azure CDN liefert Bilder und Downloads über Edge-Server in über 130 Städten aus. Die Integration erfolgt über die CDN-Endpunkt-Konfiguration im Azure Portal, TYPO3 generiert automatisch die passenden CDN-URLs.

Compliance-Anforderungen an Datenhaltung. Manche Branchen verlangen, dass Dateien in einem bestimmten Land gespeichert werden. Azure bietet Rechenzentren in Frankfurt, Zürich und Wien. Über die Storage-Account-Konfiguration lässt sich exakt festlegen, wo die Daten physisch liegen. Das ist ein Vorteil gegenüber generischen S3-kompatiblen Anbietern, bei denen die Geo-Konfiguration oft undurchsichtig ist.

Technical architecture

EXT:azurestorage implementiert das TYPO3 FAL Driver Interface. Das bedeutet: Die Extension registriert sich als Treiber im File Abstraction Layer und überschreibt die Standard-Dateisystemoperationen (Lesen, Schreiben, Löschen, Auflisten) mit Azure Blob Storage API-Aufrufen.

Die Konfiguration erfolgt über die TYPO3 File Storage Einstellungen im Backend. Dort wird ein neues Storage-Objekt angelegt mit dem Treiber “Azure Blob Storage”. Die Zugangsdaten (Storage Account Name, Access Key oder SAS Token) werden in der Storage-Konfiguration hinterlegt. Empfohlen: SAS Token mit begrenzter Gültigkeit und Lese-/Schreibrechten statt des Master Access Keys.

Die Kommunikation zwischen TYPO3 und Azure erfolgt über die Azure Storage REST API. Uploads werden als Block Blobs gespeichert, große Dateien (über 256 MB) automatisch in Blöcke aufgeteilt. Für die PHP-seitige Integration nutzt die Extension das Azure SDK for PHP oder eine leichtgewichtige REST-Client-Implementierung.

Bilder werden bei Bedarf von TYPO3s Image Processing (GraphicsMagick/ImageMagick) verarbeitet. Die verarbeiteten Varianten werden ebenfalls in Azure gespeichert, typischerweise in einem separaten Container (processed). Das Caching der Processed Files verkürzt die Verarbeitungszeit bei wiederholten Anfragen.

Common problems and solutions

Langsame Backend-Performance beim Durchsuchen großer Verzeichnisse. Azure Blob Storage hat keine echte Verzeichnisstruktur, sondern emuliert sie über Pfad-Präfixe. Das Auflisten von 10.000 Dateien in einem “Ordner” erfordert API-Paginierung und dauert spürbar länger als auf einem lokalen Dateisystem. Die Lösung: TYPO3s FAL-Indexer korrekt konfigurieren und den Index regelmäßig aktualisieren, statt bei jedem Backend-Zugriff live gegen Azure zu prüfen.

Image Processing schlägt fehl. TYPO3 muss Bilder zum Verarbeiten herunterladen, verarbeiten und wieder hochladen. Bei instabiler Verbindung oder großen Bildern (TIFF-Dateien mit 200 MB) bricht der Prozess ab. Lösung: die Verarbeitung auf dem Server mit lokalem Temp-Verzeichnis durchführen und nur das Ergebnis hochladen. Die Konfiguration processingFolder sollte auf einen lokalen Pfad zeigen.

Kosten-Explosion durch unnötige API-Calls. Jeder Dateizugriff ist ein API-Call, und Azure rechnet pro 10.000 Transaktionen ab. Ein schlecht konfigurierter TYPO3-Indexer kann tausende Calls pro Minute erzeugen. Monitoring über Azure Cost Management einrichten und den FAL-Indexer auf Scheduler-basierte Intervalle (statt Echtzeit) umstellen.

Migration and version compatibility

EXT:azurestorage ist ein Nischenprodukt mit begrenzter Community. Die verfügbaren Versionen im TER und auf Packagist unterstützen TYPO3 v10 und v11. Für v12 existieren Forks auf GitHub mit unterschiedlichem Reifegrad. Für TYPO3 v13 gibt es aktuell keine fertige Lösung.

Die Alternative für v12/v13: EXT:aus_driver_amazon_s3 mit einem S3-kompatiblen Azure-Endpunkt. Azure Blob Storage bietet seit 2020 eine S3-kompatible API-Schicht. Damit lässt sich die bewährtere und besser gepflegte S3-Extension auch mit Azure nutzen. Die Einrichtung erfordert einen Azure Storage Account mit aktiviertem “S3-Compatible API”-Feature und die Konfiguration der S3-Extension mit dem Azure-Endpunkt.

Wer von lokalem Dateisystem auf Azure migriert, sollte den Umzug in drei Phasen planen: erstens die bestehenden Dateien per AzCopy oder Storage Explorer in den Blob Container hochladen, zweitens die TYPO3 File Storage Konfiguration umstellen und drittens den FAL-Index neu aufbauen. Bei 50.000 Dateien dauert der gesamte Prozess typischerweise einen Arbeitstag. Gosign hat Azure-Migrationen für TYPO3-Projekte mit bis zu 400.000 Dateien durchgeführt und berät sowohl zur nativen Extension als auch zum S3-kompatiblen Workaround.