// Aspire skill covering the Aspire CLI, Aspire SDK, and coding guidelines for how we use Aspire. Use when the user asks to create, run, debug, configure, or troubleshoot an Aspire distributed application.
| name | aspire |
| description | Aspire skill covering the Aspire CLI, Aspire SDK, and coding guidelines for how we use Aspire. Use when the user asks to create, run, debug, configure, or troubleshoot an Aspire distributed application. |
| metadata | {"author":"Rainer Stropek"} |
We only use Aspire for local development, testing, and debugging. We do not use Aspire for deployment.
For all CLI commands (start, stop, ps, describe, logs) see references/aspire-cli.md.
Get https://aspire.dev/llms.txt for links to Aspire documentation.
You can create Aspire C# projects using dotnet templates. Get a list of installed Aspire templates using dotnet new --list aspire. Here are the most important ones:
dotnet new aspire-apphost ...dotnet new aspire-servicedefaults ...New Aspire projects in our team always consist of the following components:
AppHost).ServiceDefaults).WebApi; dotnet new webapi ...)WebApiTests). Add the nuget package Aspire.Hosting.Testing for testing.
IAsyncLifetime fixture class (WebApiTestFixture.cs) that uses Aspire's DistributedApplicationTestingBuilder to provide a HttpClient for testing the Web API.DataAccess)DataAccessTests)Frontend)
Add the necessary .NET project references using dotnet add reference ....
All .NET projects are added to a common solution. We use the new slnx format, not sln (research if you are unsure how to convert).
Retrieve Microsoft Entra access tokens with Azure Identity's DefaultAzureCredential. Use when agents need to get a bearer token in Python or TypeScript, choose a tenant explicitly, understand scopes versus resources, or troubleshoot local developer authentication through Azure CLI and other developer credentials.
Work with Azure Container Apps dynamic sessions through their REST API. Use when agents need to authenticate with Entra ID, create or reuse code interpreter sessions via identifiers, execute Python code inside a session, inspect session metadata, and upload, list, or download files independent of the client programming language.
Guidelines for creating and configuring Angular projects. Use when creating a new Angular project or when asked to configure an existing one.
Guidelines for creating and configuring a new ASP.NET Core Minimal API project. Use when creating a new web API project or when asked to configure an existing one.