davidfowl

Aspire Resource Model: Concepts, Design, and Authoring Guidance

Audience – Aspire integrators, advanced users, and contributors who are defining custom resource types, implementing publishers, or working across both runtime and publish workflows.
Just getting started? Jump straight to Quick Start and come back later for the deep‑dive.

---

Quick Start

A two‑minute "hello‑world" that shows the happy path.

davidfowl

using System;
using System.Collections.Generic;
using CliWrap;

namespace GitCLIWrapper;

public static class Git
{
    public static Command Clone(
        string repository,

davidfowl

using Microsoft.Extensions.DependencyInjection;

var builder = DistributedApplication.CreateBuilder(args);

builder.AddContainer("redis", "redis").WithExplicitStart();

builder.Build().Run();

public static class ExplicitStartupExtensions
{

davidfowl

Me using copilot

Copilot_Aspire.mp4

davidfowl

using System.Text.Json;
using System.Text.Json.Serialization;

var data = new[]
{
    "Hello"u8.ToArray(),
    "Twitter"u8.ToArray(),
    "Optimize"u8.ToArray()
}
.Select(m => new Message(m)).ToArray();

davidfowl

using System.Diagnostics;
using System.Net.Sockets;
using System.Security.Authentication;
using Yarp.Telemetry.Consumption;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddTelemetryConsumer<TelemetryConsumer>();

var app = builder.Build();

davidfowl

public static class ConfigurationBinderExtensions
{
    public static ValidateOptionsResult BindAndValidate<TOptions>(this IConfiguration configuration, TOptions instance) where TOptions : class, new()
    {
        configuration.Bind(instance);
        var validateOptions = new DataAnnotationValidateOptions<TOptions>(Options.DefaultName);
        return validateOptions.Validate(Options.DefaultName, instance);
    }
}

davidfowl

using System.Data.Common;
using System.Runtime.CompilerServices;
using System.Text;
using Npgsql;

GetCatalogItemsSql(null, null, null, 10);

void GetCatalogItemsSql(int? catalogBrandId, int? before, int? after, int pageSize)
{
    // This looks like it would be susceptible to SQL injection, but it's not.

davidfowl

using System.Collections.Concurrent;
using System.Threading.Channels;

var channel = Channel.CreateUnbounded<int>();

var syncContext = new SingleThreadedSyncContext();

syncContext.Post(async _ =>
{
    await foreach (var item in channel.Reader.ReadAllAsync())

davidfowl

using Microsoft.Extensions.Configuration.Memory;

var builder = WebApplication.CreateBuilder(args);

builder.Configuration.AddConfigurationDefaults(new()
{
    { "request:timeout", "60" }
});

var app = builder.Build();