Document .NET tool support for Aspire 13.2

[Copilot]

Documents the AddDotnetTool API introduced in dotnet/aspire#13168 for running .NET CLI tools as Aspire resources.

Changes

• New documentation page (app-host/dotnet-tool-resources.mdx):

  • Basic usage and prerequisites (.NET 10 SDK required)
  • Version configuration (WithToolVersion, WithToolPrerelease)
  • Package source configuration (WithToolSource, WithToolIgnoreExistingFeeds, WithToolIgnoreFailedSources)
  • Known limitations (SDK concurrency issues, offline scenarios)
  • Extension methods reference table

• Navigation: Added sidebar entry under AppHost section

• Cross-linking: Updated ASPIREDOTNETTOOL diagnostic page with link to new docs

Example

#pragma warning disable ASPIREDOTNETTOOL
var builder = DistributedApplication.CreateBuilder(args);

var efTool = builder.AddDotnetTool("ef", "dotnet-ef")
    .WithToolVersion("10.0.*")
    .WithArgs("migrations", "list");

builder.Build().Run();
#pragma warning restore ASPIREDOTNETTOOL

Screenshot

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• telemetry.astro.build
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js build (dns block)
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js dev (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Please work on issue #257 for 13.2 release.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[IEvangelist]

Hey @copilot, don't you need to also add a sidebar entry for the diagnostics article?

[Copilot]

@IEvangelist Unfortunately I hit an unexpected error while processing your comment. I've automatically reported this to GitHub.

You can ask me to try again later by mentioning me in a new comment.

If you want to contact GitHub about this error, please mention the following identifier so they can better serve you: 72edda90-4862-46c6-bccf-10a0022ce74e

Sorry for the inconvenience!