Skip to content

Update Aspire documentation from version 9.5.0 to 9.5.1 #4985

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Oct 6, 2025
Merged

Update Aspire documentation from version 9.5.0 to 9.5.1 #4985

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2bc99f9
Initial plan
Copilot Oct 4, 2025
fc635a2
Update Aspire documentation from version 9.5.0 to 9.5.1
Copilot Oct 4, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/deployment/aspire-deploy/aca-deployment-aspire-cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ To configure your project for Azure Container Apps deployment, add a package ref
```xml
<Project Sdk="Microsoft.NET.Sdk">

<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.0" />
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.1" />

<PropertyGroup>
<OutputType>Exe</OutputType>
Expand All @@ -67,8 +67,8 @@ To configure your project for Azure Container Apps deployment, add a package ref
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.0" />
<PackageReference Include="Aspire.Hosting.Azure.AppContainers" Version="9.5.0" />
<PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.1" />
<PackageReference Include="Aspire.Hosting.Azure.AppContainers" Version="9.5.1" />
</ItemGroup>

</Project>
Expand Down
4 changes: 2 additions & 2 deletions docs/fundamentals/app-host-overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ The AppHost project handles running all of the projects that are part of the Asp
```xml
<Project Sdk="Microsoft.NET.Sdk">

<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.0" />
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.1" />

<PropertyGroup>
<OutputType>Exe</OutputType>
Expand All @@ -60,7 +60,7 @@ The AppHost project handles running all of the projects that are part of the Asp
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.0" />
<PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.1" />
</ItemGroup>

<!-- Omitted for brevity -->
Expand Down
4 changes: 2 additions & 2 deletions docs/fundamentals/dotnet-aspire-sdk.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The [📦 Aspire.AppHost.Sdk](https://www.nuget.org/packages/Aspire.AppHost.Sdk)
```xml
<Project Sdk="Microsoft.NET.Sdk">

<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.0" />
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.1" />

<PropertyGroup>
<OutputType>Exe</OutputType>
Expand All @@ -25,7 +25,7 @@ The [📦 Aspire.AppHost.Sdk](https://www.nuget.org/packages/Aspire.AppHost.Sdk)
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.0" />
<PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.1" />
</ItemGroup>

<!-- Omitted for brevity -->
Expand Down
56 changes: 28 additions & 28 deletions docs/get-started/upgrade-to-aspire-9.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,23 +1,23 @@
---
title: Upgrade to Aspire 9.5.0
description: Learn how to upgrade all your Aspire projects to Aspire 9.5.0.
title: Upgrade to Aspire 9.5.1
description: Learn how to upgrade all your Aspire projects to Aspire 9.5.1.
ms.date: 10/01/2025
zone_pivot_groups: dev-environment
---

# Upgrade to Aspire 9.5.0
# Upgrade to Aspire 9.5.1

In this article, you learn the steps involved in updating your existing Aspire projects to the latest version: Aspire 9.5.0. There are a few ways in which you can update your projects to Aspire 9.5.0:
In this article, you learn the steps involved in updating your existing Aspire projects to the latest version: Aspire 9.5.1. There are a few ways in which you can update your projects to Aspire 9.5.1:

- Manually upgrade your projects to Aspire 9.5.0.
- Use the **Upgrade Assistant** to upgrade your projects to Aspire 9.5.0.
- Manually upgrade your projects to Aspire 9.5.1.
- Use the **Upgrade Assistant** to upgrade your projects to Aspire 9.5.1.

> [!TIP]
> If you're new to Aspire, there's no reason to upgrade anything. For more information, see [Aspire setup and tooling](../fundamentals/setup-tooling.md).

## Prerequisites

Before you upgrade your projects to Aspire 9.5.0, ensure that you have the following prerequisites:
Before you upgrade your projects to Aspire 9.5.1, ensure that you have the following prerequisites:

- [Install the latest tooling](../fundamentals/setup-tooling.md).
- [Use the Aspire SDK](../fundamentals/dotnet-aspire-sdk.md).
Expand All @@ -34,22 +34,22 @@ dotnet new install Aspire.ProjectTemplates
> [!TIP]
> If you have the legacy Aspire workload installed, you need to pass the `--force` flag to overwrite the existing templates. For instructions on uninstalling the legacy workload, see [Remove the Aspire workload (first-time upgrades from version 8 only)](#remove-the-aspire-workload-first-time-upgrades-from-version-8-only).

## Manually upgrade a solution to Aspire 9.5.0
## Manually upgrade a solution to Aspire 9.5.1

To upgrade your projects to Aspire 9.5.0, you need to update your project files. The following steps guide you through the process:
To upgrade your projects to Aspire 9.5.1, you need to update your project files. The following steps guide you through the process:

- Edit your [AppHost](xref:dotnet/aspire/app-host) project file to use the new Aspire 9.5.0 SDK (`Aspire.AppHost.Sdk`).
- Edit your [AppHost](xref:dotnet/aspire/app-host) project file to use the new Aspire 9.5.1 SDK (`Aspire.AppHost.Sdk`).
- Update the NuGet packages in your project files to the latest versions.
- Adjust your _Program.cs_ file to use the new APIs and remove any obsolete APIs.

### Edit your AppHost project file

To upgrade your AppHost project to Aspire 9.5.0, you need to update your project file to use the new [📦 Aspire.AppHost.Sdk](https://www.nuget.org/packages/Aspire.AppHost.Sdk):
To upgrade your AppHost project to Aspire 9.5.1, you need to update your project file to use the new [📦 Aspire.AppHost.Sdk](https://www.nuget.org/packages/Aspire.AppHost.Sdk):

```diff
<Project Sdk="Microsoft.NET.Sdk">

+ <Sdk Name="Aspire.AppHost.Sdk" Version="9.5.0" />
+ <Sdk Name="Aspire.AppHost.Sdk" Version="9.5.1" />

<PropertyGroup>
<OutputType>Exe</OutputType>
Expand All @@ -61,20 +61,20 @@ To upgrade your AppHost project to Aspire 9.5.0, you need to update your project
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.0" />
<PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.1" />
</ItemGroup>

</Project>
```

### Optionally upgrade the target framework moniker (TFM)

Aspire 9.5.0 runs on .NET 9.0, but you can also run it on .NET 8.0. In other words, just because you're using the Aspire SDK, and pointing to version 9.5.0 packages, you can still target .NET 8.0. If you want to run your Aspire 9.5.0 project on .NET 9.0, you need to update the `TargetFramework` property in your project file:
Aspire 9.5.1 runs on .NET 9.0, but you can also run it on .NET 8.0. In other words, just because you're using the Aspire SDK, and pointing to version 9.5.1 packages, you can still target .NET 8.0. If you want to run your Aspire 9.5.1 project on .NET 9.0, you need to update the `TargetFramework` property in your project file:

```diff
<Project Sdk="Microsoft.NET.Sdk">

<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.0" />
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.1" />

<PropertyGroup>
<OutputType>Exe</OutputType>
Expand All @@ -87,7 +87,7 @@ Aspire 9.5.0 runs on .NET 9.0, but you can also run it on .NET 8.0. In other wor
</PropertyGroup>

<ItemGroup>
<PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.0" />
<PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.1" />
</ItemGroup>

</Project>
Expand All @@ -102,7 +102,7 @@ If you followed all of the preceding steps, your AppHost project file should loo
```diff
<Project Sdk="Microsoft.NET.Sdk">

+ <Sdk Name="Aspire.AppHost.Sdk" Version="9.5.0" />
+ <Sdk Name="Aspire.AppHost.Sdk" Version="9.5.1" />

<PropertyGroup>
<OutputType>Exe</OutputType>
Expand All @@ -116,13 +116,13 @@ If you followed all of the preceding steps, your AppHost project file should loo

<ItemGroup>
- <PackageReference Include="Aspire.Hosting.AppHost" Version="8.0.0" />
+ <PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.0" />
+ <PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.1" />
</ItemGroup>

</Project>
```

The changes include the addition of the `Aspire.AppHost.Sdk`, the update of the `TargetFramework` property to `net9.0`, and the update of the `Aspire.Hosting.AppHost` package to version `9.5.0`.
The changes include the addition of the `Aspire.AppHost.Sdk`, the update of the `TargetFramework` property to `net9.0`, and the update of the `Aspire.Hosting.AppHost` package to version `9.5.1`.

### Adjust your _Program.cs_ file

Expand All @@ -131,7 +131,7 @@ The changes include the addition of the `Aspire.AppHost.Sdk`, the update of the

With the introduction of Aspire 9.5, there are some _breaking changes_. Some APIs were originally marked as experimental (with the <xref:System.Diagnostics.CodeAnalysis.ExperimentalAttribute>) and are now removed, while other APIs are now attributed as <xref:System.ObsoleteAttribute> with details on new replacement APIs. You need to adjust your _Program.cs_ file (and potentially other affected APIs) to use the new APIs. If you're using the Upgrade Assistant to upgrade your projects, it automatically adjusts your _Program.cs_ file in most cases.

For the complete list of breaking changes in Aspire 9.5.0, see [Breaking changes in Aspire 9.5](../compatibility/9.5/index.md).
For the complete list of breaking changes in Aspire 9.5.1, see [Breaking changes in Aspire 9.5](../compatibility/9.5/index.md).

> [!IMPORTANT]
> Be sure to review breaking changes for all versions of Aspire after the one you're upgrading from. For example, if you're upgrading from Aspire 9.0, you must address breaking changes for versions [9.1](../compatibility/9.1/index.md), [9.2](../compatibility/9.2/index.md), [9.3](../compatibility/9.3/index.md), [9.4](../compatibility/9.4/index.md), and [9.5](../compatibility/9.5/index.md).
Expand All @@ -143,11 +143,11 @@ The [Upgrade Assistant](/dotnet/core/porting/upgrade-assistant-overview) is a to
- [The Visual Studio extension version](/dotnet/core/porting/upgrade-assistant-install#visual-studio-extension).
- [The .NET CLI global tool version](/dotnet/core/porting/upgrade-assistant-install#net-global-tool).

Regardless of how you install the Upgrade Assistant, you can use it to upgrade your Aspire projects to Aspire 9.5.0.
Regardless of how you install the Upgrade Assistant, you can use it to upgrade your Aspire projects to Aspire 9.5.1.

:::zone pivot="visual-studio"

To upgrade the Aspire AppHost project to Aspire 9.5.0 with Visual Studio, right-click the project in **Solution Explorer** and select **Upgrade**.
To upgrade the Aspire AppHost project to Aspire 9.5.1 with Visual Studio, right-click the project in **Solution Explorer** and select **Upgrade**.

> [!IMPORTANT]
> If the **Upgrade Assistant** isn't already installed, you'll be prompted to install it.
Expand Down Expand Up @@ -228,7 +228,7 @@ Complete: 3 succeeded, 0 failed, 7 skipped.

### Update the NuGet packages

To take advantage of the latest updates in your Aspire solution, update all NuGet packages to version `9.5.0`.
To take advantage of the latest updates in your Aspire solution, update all NuGet packages to version `9.5.1`.

:::zone pivot="visual-studio"

Expand All @@ -237,10 +237,10 @@ To take advantage of the latest updates in your Aspire solution, update all NuGe
:::zone-end
:::zone pivot="vscode,dotnet-cli"

To update your AppHost project, use the following .NET CLI command to update the `Aspire.Hosting.AppHost` package to version `9.5.0`:
To update your AppHost project, use the following .NET CLI command to update the `Aspire.Hosting.AppHost` package to version `9.5.1`:

```dotnetcli
dotnet add package Aspire.Hosting.AppHost --version 9.5.0
dotnet add package Aspire.Hosting.AppHost --version 9.5.1
```

When a package reference already exists, the `dotnet add package` command updates the reference to the specified version. For more information, see [dotnet add package](/dotnet/core/tools/dotnet-add-package).
Expand All @@ -252,7 +252,7 @@ With the AppHost project updated, your project file should look like this:
```diff
<Project Sdk="Microsoft.NET.Sdk">

<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.0" />
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.1" />

<PropertyGroup>
<OutputType>Exe</OutputType>
Expand All @@ -265,7 +265,7 @@ With the AppHost project updated, your project file should look like this:

<ItemGroup>
- <PackageReference Include="Aspire.Hosting.AppHost" Version="8.0.0" />
+ <PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.0" />
+ <PackageReference Include="Aspire.Hosting.AppHost" Version="9.5.1" />
</ItemGroup>

</Project>
Expand All @@ -276,7 +276,7 @@ With the AppHost project updated, your project file should look like this:

## Remove the Aspire workload (first-time upgrades from version 8 only)

If you're upgrading from Aspire 8 to Aspire 9 for the first time, you need to remove the legacy workload. This step is not needed for upgrades between Aspire 9 versions (such as from 9.4.0 to 9.5.0).
If you're upgrading from Aspire 8 to Aspire 9 for the first time, you need to remove the legacy workload. This step is not needed for upgrades between Aspire 9 versions (such as from 9.4.0 to 9.5.1).

Previously the **aspire workload** was required to create and run Aspire projects. But, with Aspire 9 the workload is no longer required and should be removed from your .NET environment.

Expand Down
6 changes: 3 additions & 3 deletions docs/whats-new/dotnet-aspire-9.5.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,10 +37,10 @@ Moving between minor releases of Aspire is simple:
iex "& { $(irm https://aspire.dev/install.ps1) }"
```

1. In your AppHost project file (that is, _MyApp.AppHost.csproj_), update the [📦 Aspire.AppHost.Sdk](https://www.nuget.org/packages/Aspire.AppHost.Sdk) package to version `9.5.0`:
1. In your AppHost project file (that is, _MyApp.AppHost.csproj_), update the [📦 Aspire.AppHost.Sdk](https://www.nuget.org/packages/Aspire.AppHost.Sdk) package to version `9.5.1`:

```xml
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.0" />
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.1" />
```

For more information, see [Aspire SDK](xref:dotnet/aspire/sdk).
Expand Down Expand Up @@ -114,7 +114,7 @@ For more information, see [aspire config set command](../cli-reference/aspire-co
You can use `aspire new` to create a new, blank file-based AppHost. Select the _Single-file AppHost (experimental)_ option from the project template list:

```csharp
#:sdk Aspire.AppHost.Sdk@9.5.0
#:sdk Aspire.AppHost.Sdk@9.5.1

var builder = DistributedApplication.CreateBuilder(args);

Expand Down
Loading