Azure Storage para TYPO3

Empresas com stack Microsoft precisam de Azure Storage em vez de sistemas de arquivos locais

Quando a infraestrutura de TI roda no Azure, o Active Directory gerencia os usuários e o SharePoint mantém os documentos, o sistema de arquivos do TYPO3 também pertence à nuvem Azure. EXT:azurestorage integra o Azure Blob Storage como driver FAL (File Abstraction Layer) no TYPO3. Editores não percebem diferença, mas os arquivos ficam na infraestrutura de nuvem da Microsoft com CDN, geo-redundância e armazenamento praticamente ilimitado, em vez do servidor web.

Essa extensão é o equivalente Azure do EXT:aus_driver_amazon_s3. A decisão entre ambos raramente é técnica, mas segue a estratégia de nuvem existente. Quem já usa Azure economiza complexidade, contratos e custos de rede ao permanecer no ecossistema Microsoft.

Cenários típicos de uso

Websites enterprise com setup multi-servidor. Grandes instalações TYPO3 rodam em vários servidores web atrás de um load balancer. Sem cloud storage, os arquivos precisam ser sincronizados entre servidores via rsync, NFS ou GlusterFS. Cada uma dessas soluções traz problemas próprios. Azure Blob Storage como driver FAL torna a sincronização de arquivos desnecessária: todos os servidores acessam o mesmo Blob Container. Em um cliente com 4 servidores web e 180.000 arquivos, a migração para Azure eliminou toda a infraestrutura NFS.

Portais com conteúdo multimídia e público global. Empresas com clientes na Europa, Ásia e América do Norte precisam de tempos de carregamento rápidos mundialmente. Azure CDN entrega imagens e downloads por servidores edge em mais de 130 cidades. A integração ocorre pela configuração do endpoint CDN no Azure Portal, o TYPO3 gera automaticamente as URLs CDN correspondentes.

Requisitos de compliance para armazenamento de dados. Alguns setores exigem que arquivos sejam armazenados em um país específico. O Azure oferece data centers em diversas localidades. Pela configuração da conta de armazenamento, é possível definir exatamente onde os dados ficam fisicamente. Para organizações brasileiras, isso é especialmente relevante em relação à LGPD e à soberania de dados.

Arquitetura técnica

EXT:azurestorage implementa a interface de driver TYPO3 FAL. Isso significa que a extensão se registra como driver no File Abstraction Layer e sobrescreve as operações padrão do sistema de arquivos (leitura, escrita, exclusão, listagem) com chamadas à API Azure Blob Storage.

A configuração é feita pelas configurações de File Storage do TYPO3 no backend. Um novo objeto de armazenamento é criado com o driver “Azure Blob Storage”. As credenciais de acesso (Storage Account Name, Access Key ou SAS Token) são configuradas na Storage. Recomendado: SAS Token com validade limitada e permissões de leitura/escrita em vez do Master Access Key.

A comunicação entre TYPO3 e Azure ocorre pela Azure Storage REST API. Uploads são armazenados como Block Blobs, arquivos grandes (acima de 256 MB) são automaticamente divididos em blocos. Para a integração PHP, a extensão usa o Azure SDK for PHP ou uma implementação REST client leve.

Imagens são processadas conforme necessário pelo Image Processing do TYPO3 (GraphicsMagick/ImageMagick). As variantes processadas também são armazenadas no Azure, tipicamente em um container separado (processed). O cache dos Processed Files reduz o tempo de processamento em requisições repetidas.

Problemas frequentes e soluções

Performance lenta no backend ao navegar diretórios grandes. Azure Blob Storage não tem uma estrutura de diretórios real, mas a emula via prefixos de caminho. Listar 10.000 arquivos em uma “pasta” requer paginação da API e demora perceptivelmente mais que em um sistema de arquivos local. A solução: configurar corretamente o indexador FAL do TYPO3 e atualizar o índice regularmente, em vez de consultar o Azure ao vivo em cada acesso ao backend.

Processamento de imagem falha. TYPO3 precisa baixar imagens para processá-las e depois enviá-las novamente. Com conexão instável ou imagens grandes (arquivos TIFF com 200 MB), o processo aborta. Solução: realizar o processamento no servidor com diretório temp local e enviar apenas o resultado. A configuração processingFolder deve apontar para um caminho local.

Explosão de custos por chamadas de API desnecessárias. Cada acesso a arquivo é uma chamada de API, e o Azure cobra por 10.000 transações. Um indexador TYPO3 mal configurado pode gerar milhares de chamadas por minuto. Configurar monitoramento via Azure Cost Management e mudar o indexador FAL para intervalos baseados em scheduler (em vez de tempo real).

Migração e compatibilidade de versões

EXT:azurestorage é um produto de nicho com comunidade limitada. As versões disponíveis no TER e no Packagist suportam TYPO3 v10 e v11. Para v12, existem forks no GitHub com diferentes graus de maturidade. Para TYPO3 v13, não há solução pronta atualmente.

A alternativa para v12/v13: EXT:aus_driver_amazon_s3 com um endpoint Azure compatível com S3. Azure Blob Storage oferece desde 2020 uma camada de API compatível com S3. Assim, a extensão S3 mais bem mantida pode ser usada com Azure. A configuração requer uma conta Azure Storage com o recurso “S3-Compatible API” ativado e a configuração da extensão S3 com o endpoint Azure.

Quem migra de sistema de arquivos local para Azure deve planejar a mudança em três fases: primeiro, enviar os arquivos existentes para o Blob Container via AzCopy ou Storage Explorer; segundo, alterar a configuração de File Storage do TYPO3; e terceiro, reconstruir o índice FAL. Com 50.000 arquivos, todo o processo leva tipicamente um dia de trabalho. A Gosign realizou migrações Azure para projetos TYPO3 com até 400.000 arquivos e orienta tanto sobre a extensão nativa quanto sobre o workaround compatível com S3.