PinguApps.Aspire.Hosting.Bunny.Storage 1.0.1

PinguApps.Aspire.Hosting.Bunny.Storage

PinguApps.Aspire.Hosting.Bunny.Storage lets an Aspire AppHost publish a normal Azure Blob container to Bunny Storage during aspire deploy.

• Hosting package: PinguApps.Aspire.Hosting.Bunny.Storage
• Runtime package: PinguApps.Bunny.Storage
• Distribution: NuGet for C# and TypeScript AppHosts
• Tested Aspire baseline: 13.4.6
• Local behaviour: Azure Blob Storage through Azurite
• Deploy behaviour: opt-in Bunny Storage create/adopt validation, with optional Pull Zone creation

Install

AppHost:

dotnet add package PinguApps.Aspire.Hosting.Bunny.Storage

Server-side application:

dotnet add package PinguApps.Bunny.Storage

Minimal C# Example

using Aspire.Hosting;
using Aspire.Hosting.Bunny.Storage;

var builder = DistributedApplication.CreateBuilder(args);
var bunnyApiKey = builder.AddParameter("bunny-api-key", secret: true);

var media = builder.AddAzureStorage("storage")
    .RunAsEmulator()
    .AddBlobContainer("media", "media")
    .PublishToBunny("myapp-media", bunnyApiKey, configure: options =>
    {
        options.Region = BunnyStorageRegion.De;
        options.CreatePullZone = true;
        options.PullZoneName = "myapp-media";
    });

builder.AddProject<Projects.Web>("web")
    .WithReference(media)
    .WithObjectStorage(media);

builder.Build().Run();

Register the runtime abstraction in the server-side application:

builder.Services.AddObjectStorage(builder.Configuration);

Application code consumes IObjectStorage or IObjectStorageProvider and stores object keys such as uploads/avatar.png, not absolute URLs.

Minimal TypeScript AppHost Example

TypeScript AppHosts consume the same NuGet package through Aspire's generated module flow:

{
  "packages": {
    "Aspire.Hosting.Azure.Storage": "13.4.6",
    "PinguApps.Aspire.Hosting.Bunny.Storage": "<package version>"
  }
}

aspire restore --non-interactive

import {
  BunnyStorageOwnershipMode,
  BunnyStorageRegion,
  createBuilder,
} from "./.aspire/modules/aspire.mjs";

const builder = await createBuilder();
const zoneName = await builder.addParameter("bunny-storage-zone-name");
const apiKey = await builder.addParameter("bunny-api-key", { secret: true });

const storage = await builder.addAzureStorage("storage").runAsEmulator();
let media = await storage.addBlobContainer("media", { blobContainerName: "media" });
media = await media.publishToBunny(zoneName, apiKey, {
  ownershipMode: BunnyStorageOwnershipMode.CreateOrAdopt,
  region: BunnyStorageRegion.De,
  createPullZone: true,
  pullZoneName: "myapp-media",
});

let web = await builder.addProject("web", "../Web/Web.csproj");
web = await web.withReference(media);
web = await web.withObjectStorage(media);

await (await builder.build()).run();

Deploy Inputs

For parameter-backed non-interactive deploys:

$env:Parameters__bunny_storage_zone_name = "myapp-media"
$env:Parameters__bunny_api_key = $env:BUNNY_API_KEY
aspire deploy --non-interactive --pipeline-log-level debug

The Bunny account API key is never exposed to application resources. Deployed applications receive the storage-zone access key instead.

Behaviour Summary

The built-in AzureBlobStorageContainerResource remains the local resource of record. PublishToBunny(...) or publishToBunny(...) adds deploy-time intent. WithObjectStorage(...) switches application configuration between local Azure Blob Storage and deployed Bunny Storage without inventing an Azure connection string for Bunny.

The package never deletes Bunny resources automatically. Repeated deployments validate cached remote identity, ownership mode, region, replication regions, and Pull Zone linkage before reusing resources.

Documentation

• Overview and product contract
• Installation
• C# AppHost usage
• TypeScript AppHost usage
• Configuration and ownership modes
• Deployment behaviour
• Runtime abstraction
• Outputs and security
• Samples and validation