From c669a1926402fac877ae04db97e87781e2273087 Mon Sep 17 00:00:00 2001 From: "Andy De George (adegeo)" Date: Tue, 10 Jun 2025 11:33:25 -0700 Subject: [PATCH 1/3] migrate dev env from 8 to 9 --- docs/get-started/upgrade-to-aspire-9.md | 52 ++++++++++++++++++------- 1 file changed, 38 insertions(+), 14 deletions(-) diff --git a/docs/get-started/upgrade-to-aspire-9.md b/docs/get-started/upgrade-to-aspire-9.md index 435a307eb8..e32a8cd694 100644 --- a/docs/get-started/upgrade-to-aspire-9.md +++ b/docs/get-started/upgrade-to-aspire-9.md @@ -1,13 +1,13 @@ --- -title: Upgrade to .NET Aspire 9.0 -description: Learn how to upgrade all your .NET Aspire 8.x projects to .NET Aspire 9.0. -ms.date: 11/11/2024 +title: Upgrade to .NET Aspire 9 +description: Learn how to upgrade all your .NET Aspire 8 projects to .NET Aspire 9. +ms.date: 06/02/2025 zone_pivot_groups: dev-environment --- -# Upgrade to .NET Aspire 9.0 +# Upgrade to .NET Aspire 9 -.NET Aspire 9.0 is now generally available. In this article, you learn the steps involved in updating your existing .NET Aspire 8.x projects to .NET Aspire 9.0. There are a few ways in which you can update your projects to .NET Aspire 9.0: +In this article, you learn the steps involved in updating your existing .NET Aspire 8 projects to .NET Aspire 9. There are a few ways in which you can update your projects to .NET Aspire 9: - Manually upgrade your projects to .NET Aspire 9.0. - Use the **Upgrade Assistant** to upgrade your projects to .NET Aspire 9.0. @@ -21,17 +21,41 @@ Before you upgrade your projects to .NET Aspire 9.0, ensure that you have the fo - [Install the latest tooling](../fundamentals/setup-tooling.md). - [Use the .NET Aspire SDK](../fundamentals/dotnet-aspire-sdk.md). +- If you have an older major version of .NET Aspire installed, [remove it](#upgrade-to-net-aspire-9). -> [!NOTE] -> Feel free to uninstall the .NET Aspire workload as you'll no longer need it. -> -> ```dotnetcli -> dotnet workload uninstall aspire -> ``` -> -> For more information, see [dotnet workload uninstall](/dotnet/core/tools/dotnet-workload-uninstall). +## Upgrade your development environment -If you don't uninstall the .NET Aspire workload, and you're using the new [.NET Aspire SDK](../fundamentals/dotnet-aspire-sdk.md) and templates, you see both .NET Aspire 8.0 and .NET Aspire 9.0 templates. +Before you can use .NET Aspire 9, you need to remove outdated components and upgrade your tooling. + +### .NET Aspire workload + +Previously the **aspire** workload was required to create and run .NET Aspire projects. But, with .NET Aspire 9 the workload is no longer required and should be removed from your .NET environment. + +> [!IMPORTANT] +> You must remove .NET Aspire 8 (the **aspire** workload) to enable the .NET Aspire 9 templates. + +01. Find the installation source by opening a terminal and running the `dotnet workload list` command. + + The preceding command lists the workloads installed in the .NET environment. The method used to install .NET Aspire is listed under the **Installation Source** column of the output, and is either _VS_ for Visual Studio or _SDK_ for the .NET tooling. For example, the following snippet indicates that Visual Studio was used to install .NET Aspire: + + ``` + Installed Workload Id Manifest Version Installation Source + -------------------------------------------------------------------- + aspire 8.2.2/8.0.100 VS 17.14.36109.1 + ``` + +01. Remove .NET Aspire 8. + + - If the **Installation Source** starts with _VS_: + + 01. Open the **Visual Studio Installer** app. + 01. **Modify** the installation instance of Visual Studio. + 01. Select **Individual Components**. + 01. Search for `aspire`. + 01. Unselect **.NET Aspire SDK**. + 01. Select the **Modify** button to apply the changes. + + - If the **Installation Source** starts with _SDK_, run `dotnet workload uninstall aspire` to remove .NET Aspire. ## Manually upgrade to .NET Aspire 9.0 From cfba0a3a49d094781c16416f3b2f749f51cb6a8d Mon Sep 17 00:00:00 2001 From: "Andy De George (adegeo)" Date: Tue, 10 Jun 2025 11:49:54 -0700 Subject: [PATCH 2/3] Minor --- docs/get-started/upgrade-to-aspire-9.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/get-started/upgrade-to-aspire-9.md b/docs/get-started/upgrade-to-aspire-9.md index e32a8cd694..bb6fe84c7e 100644 --- a/docs/get-started/upgrade-to-aspire-9.md +++ b/docs/get-started/upgrade-to-aspire-9.md @@ -21,7 +21,7 @@ Before you upgrade your projects to .NET Aspire 9.0, ensure that you have the fo - [Install the latest tooling](../fundamentals/setup-tooling.md). - [Use the .NET Aspire SDK](../fundamentals/dotnet-aspire-sdk.md). -- If you have an older major version of .NET Aspire installed, [remove it](#upgrade-to-net-aspire-9). +- If you have a version of .NET Aspire older than 9.0, [remove it](#upgrade-your-development-environment). ## Upgrade your development environment @@ -57,6 +57,8 @@ Previously the **aspire** workload was required to create and run .NET Aspire pr - If the **Installation Source** starts with _SDK_, run `dotnet workload uninstall aspire` to remove .NET Aspire. +01. Install the .NET Aspire 9.0 templates with the `dotnet new install Aspire.ProjectTemplates` command. + ## Manually upgrade to .NET Aspire 9.0 To upgrade your projects to .NET Aspire 9.0, you need to update your project files. The following steps guide you through the process: From 3cc374fbf198d40c1c8b5ac0bd160a9af2578542 Mon Sep 17 00:00:00 2001 From: "Andy De George (adegeo)" Date: Tue, 10 Jun 2025 11:51:35 -0700 Subject: [PATCH 3/3] Minor --- docs/get-started/upgrade-to-aspire-9.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/get-started/upgrade-to-aspire-9.md b/docs/get-started/upgrade-to-aspire-9.md index bb6fe84c7e..d3e1f7a8c5 100644 --- a/docs/get-started/upgrade-to-aspire-9.md +++ b/docs/get-started/upgrade-to-aspire-9.md @@ -29,14 +29,14 @@ Before you can use .NET Aspire 9, you need to remove outdated components and upg ### .NET Aspire workload -Previously the **aspire** workload was required to create and run .NET Aspire projects. But, with .NET Aspire 9 the workload is no longer required and should be removed from your .NET environment. +Previously the **aspire workload** was required to create and run .NET Aspire projects. But, with .NET Aspire 9 the workload is no longer required and should be removed from your .NET environment. > [!IMPORTANT] -> You must remove .NET Aspire 8 (the **aspire** workload) to enable the .NET Aspire 9 templates. +> You must remove .NET Aspire 8 (the **aspire workload**) to enable the .NET Aspire 9 templates. 01. Find the installation source by opening a terminal and running the `dotnet workload list` command. - The preceding command lists the workloads installed in the .NET environment. The method used to install .NET Aspire is listed under the **Installation Source** column of the output, and is either _VS_ for Visual Studio or _SDK_ for the .NET tooling. For example, the following snippet indicates that Visual Studio was used to install .NET Aspire: + The preceding command lists the workloads installed in the .NET environment. The method used to install .NET Aspire is listed under the **Installation Source** column of the output, and is either _VS_ for Visual Studio or _SDK_ for the .NET SDK. For example, the following snippet indicates that Visual Studio was used to install .NET Aspire: ``` Installed Workload Id Manifest Version Installation Source