Guler.Editor.Storage.AzureBlob 0.2.0-alpha.0

Stylus.Storage.AzureBlob

Stylus için Azure Blob Storage tabanlı IStylusFileStorage adapter'ı.

Stylus.Core abstraction'ı üstüne inşa edilmiştir.

Hızlı başlangıç

dotnet add package Stylus.Storage.AzureBlob

using Stylus.Core.FileManager;
using Stylus.Storage.AzureBlob;

builder.Services.AddStylus();

// Connection string ile (local dev / hızlı setup)
builder.Services.AddSingleton<IStylusFileStorage>(sp =>
    new AzureBlobFileStorage(new AzureBlobFileStorageOptions
    {
        ContainerName = "stylus-uploads",
        ConnectionString = builder.Configuration.GetConnectionString("AzureBlob"),
        KeyPrefix = "uploads/",
    }));

Auth pattern'leri (öncelik sırası)

1. ConnectionString (local dev / hızlı setup)

new AzureBlobFileStorageOptions
{
    ContainerName = "stylus",
    ConnectionString = "DefaultEndpointsProtocol=https;AccountName=...;AccountKey=...",
}

Local Azurite emulator için: ConnectionString = "UseDevelopmentStorage=true".

2. AccountName + AccountKey (explicit credentials)

new AzureBlobFileStorageOptions
{
    ContainerName = "stylus",
    AccountName = "mystorageaccount",
    AccountKey = "...",
}

3. Managed identity / DefaultAzureCredential (production önerilen)

AzureBlobFileStorage bu paketin transitif yükünü hafif tutmak için Azure.Identity paketini içermez. Managed identity kullanmak için tüketici proje kendisi ekler ve ikinci constructor'a BlobContainerClient geçirir:

using Azure.Identity;
using Azure.Storage.Blobs;
using Stylus.Storage.AzureBlob;

var serviceClient = new BlobServiceClient(
    new Uri("https://mystorage.blob.core.windows.net"),
    new DefaultAzureCredential());
var container = serviceClient.GetBlobContainerClient("stylus");

builder.Services.AddSingleton<IStylusFileStorage>(sp =>
    new AzureBlobFileStorage(
        new AzureBlobFileStorageOptions { ContainerName = "stylus" },
        container));

Konfig opsiyonları

Mimari

Azure Blob storage'ta native "klasör" yok — Stylus klasör semantiği / delimiter + GetBlobsByHierarchy ile simüle edilir:

• List: GetBlobsByHierarchyAsync(prefix='folder/', delimiter='/') → IsPrefix (klasörler) + IsBlob (dosyalar)
• CreateDirectory: No-op
• Move: StartCopyFromUriAsync (server-side copy) + DeleteIfExists (kaynak)
• Delete recursive: Prefix altındaki tüm blob'ları DeleteBlobIfExists

Bağımlılıklar

• Stylus.Core (≥ 0.1.0-alpha.0)
• Azure.Storage.Blobs (≥ 12.22)

Lisans

MIT — Stylus open core taahhüdü (decisions/ADR-003).