FonsecaFramework.Aspire 2026.6.18.1

FonsecaFramework.Aspire

Extensions and helpers for .NET Aspire distributed applications.

Overview

FonsecaFramework.Aspire is a .NET 9 library that provides extension methods for the .NET Aspire IDistributedApplicationBuilder to simplify working with SQL Server resources. It supports connecting to existing SQL Server instances, adding SQL Server Docker containers, and registering SqlExecuter instances in the Aspire service defaults pipeline.

Installation

dotnet add package FonsecaFramework.Aspire

Features

Examples

Connect to an Existing SQL Server

using FonsecaFramework.Aspire.Mssql;

var builder = DistributedApplication.CreateBuilder(args);

var sqlServer = builder.AddExistingSqlServer(
 name: "production-sql",
 connectionString: "Server=prod-server;Integrated Security=True;TrustServerCertificate=True;");

var myDatabase = sqlServer.AddExistingSqlDatabase(
 name: "my-database",
 databaseName: "AppDb");

builder.AddProject<Projects.MyWebApi>("api")
 .WithReference(myDatabase);

builder.Build().Run();

Add a SQL Server Docker Container

using FonsecaFramework.Aspire.Mssql;

var builder = DistributedApplication.CreateBuilder(args);

var sqlServer = builder.AddSqlServerDocker(
 name: "dev-sql",
 port: 1433);

var database = sqlServer.AddDatabase("appdb");

builder.AddProject<Projects.MyWebApi>("api")
 .WithReference(database);

builder.Build().Run();

Requirements

• .NET 9.0
• .NET Aspire workload installed

License

Copyright 2025 Steven Fonseca / VLR Creations

Licensed under the . You may use this library free of charge, provided you include the required attribution notices. See the file for full terms.