[docs] Document installing the Aspire CLI as a NativeAOT .NET tool#842
Open
radical wants to merge 1 commit intomicrosoft:mainfrom
Open
[docs] Document installing the Aspire CLI as a NativeAOT .NET tool#842radical wants to merge 1 commit intomicrosoft:mainfrom
radical wants to merge 1 commit intomicrosoft:mainfrom
Conversation
Documents the new `dotnet tool install -g Aspire.Cli` install path introduced in Aspire 13.3 (microsoft/aspire#16496, backported in microsoft/aspire#16611). - Adds a new "Install as a NativeAOT .NET tool" H2 to install-cli.mdx with the install command, the .NET SDK 10.0.100 prerequisite, and the matching `dotnet tool update -g Aspire.Cli` update command. - Notes that `aspire update --self` is disabled for .NET tool installs (PR 16496 redirects users to `dotnet tool update` in that case). - Updates the page description to drop "global" — the heading and body use "NativeAOT .NET tool" consistently. Refs: microsoft#837 (item 1) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds documentation for the new Aspire 13.3 installation path that ships the Aspire CLI as a NativeAOT .NET tool, complementing the existing install-script guidance.
Changes:
- Updates page description to reference “NativeAOT .NET tool” instead of “.NET global tool”.
- Adds a new “Install as a NativeAOT .NET tool” section with install/update commands and a note about
aspire update --selfbeing disabled for tool installs.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
1
to
5
| --- | ||
| title: Install Aspire CLI | ||
| description: Learn how to install the Aspire CLI as a native executable or .NET global tool to manage your cloud-native applications. | ||
| description: Learn how to install the Aspire CLI as a native executable or NativeAOT .NET tool to manage your cloud-native applications. | ||
| lastUpdated: true | ||
| tableOfContents: true |
Comment on lines
+46
to
+52
| ## Install as a NativeAOT .NET tool | ||
|
|
||
| <Aside type="note"> | ||
| This install method was introduced in Aspire 13.3. | ||
| </Aside> | ||
|
|
||
| The Aspire CLI is also published as a NativeAOT [.NET tool](https://learn.microsoft.com/dotnet/core/tools/global-tools). This install method requires the .NET SDK 10.0.100 or later. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents the new
dotnet tool install -g Aspire.Cliinstall path introduced in Aspire 13.3.Source PRs: microsoft/aspire#16496 (ships the CLI as a NativeAOT .NET tool) and microsoft/aspire#16611 (servicing backport to
release/13.3).Issue: Addresses item 1 of #837 (CLI conceptual docs gap for 13.3).
What changed
In
src/frontend/src/content/docs/get-started/install-cli.mdx:## Install as a NativeAOT .NET toolsection between the existing install-script section and Validation, with:dotnet tool install -g Aspire.Cliinstall command..NET SDK 10.0.100prerequisite mention.dotnet tool update -g Aspire.Cliupdate command, plus a note thataspire update --selfis disabled for .NET tool installs (permicrosoft/aspire#16496— the CLI prints the equivalentdotnet tool updatecommand instead)..NET global tool→NativeAOT .NET tool, matching the new heading and body.Out of scope
ja/get-started/install-cli.mdx) — left for the translation pipeline.