From 42afbf9030fe2cbe00c0e8b6b988874f69fd13da Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 20 Oct 2025 15:40:21 +0000
Subject: [PATCH 01/15] Initial plan
From 2f08ee064883935efb97f7973b31bea2e3ef6186 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 20 Oct 2025 15:45:06 +0000
Subject: [PATCH 02/15] Add Aspire VS Code extension documentation
Co-authored-by: alistairmatthews <41286777+alistairmatthews@users.noreply.github.com>
---
docs/fundamentals/aspire-vscode-extension.md | 228 +++++++++++++++++++
docs/toc.yml | 3 +
2 files changed, 231 insertions(+)
create mode 100644 docs/fundamentals/aspire-vscode-extension.md
diff --git a/docs/fundamentals/aspire-vscode-extension.md b/docs/fundamentals/aspire-vscode-extension.md
new file mode 100644
index 0000000000..de9c3a24a3
--- /dev/null
+++ b/docs/fundamentals/aspire-vscode-extension.md
@@ -0,0 +1,228 @@
+---
+title: Aspire Visual Studio Code extension
+description: Learn how to use the Aspire Visual Studio Code extension to create, configure, run, and deploy Aspire solutions.
+ms.date: 10/20/2025
+ms.topic: how-to
+uid: dotnet/aspire/vscode-extension
+ai-usage: ai-assisted
+---
+
+# Aspire Visual Studio Code extension
+
+The Aspire Visual Studio Code extension provides a set of commands and tools to help you work with Aspire and Aspire AppHost projects directly from Visual Studio Code. The extension streamlines development workflows by offering commands to create projects, add integrations, configure solutions, and manage deployments.
+
+## Prerequisites
+
+Before installing the Aspire Visual Studio Code extension, ensure you have the following prerequisites:
+
+- [Visual Studio Code](https://code.visualstudio.com/) installed
+- [.NET 8.0](https://dotnet.microsoft.com/download/dotnet/8.0) or [.NET 9.0](https://dotnet.microsoft.com/download/dotnet/9.0) installed
+- [Aspire CLI](../cli/install.md) installed and available on your PATH
+- An OCI compliant container runtime, such as [Docker Desktop](https://www.docker.com/products/docker-desktop) or [Podman](https://podman.io/)
+
+### Optional extensions
+
+Some features require additional VS Code extensions:
+
+| Feature | Required Extension | Notes |
+|---------|-------------------|-------|
+| Debug C# projects | [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit) or [C# for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp) | The C# extension is required for debugging .NET projects. Apphosts are built in VS Code if C# Dev Kit is available. |
+| Debug Python projects | [Python extension](https://marketplace.visualstudio.com/items?itemName=ms-python.python) | Required for debugging Python projects hosted in Aspire |
+
+## Install the Aspire extension
+
+To install the Aspire Visual Studio Code extension:
+
+1. Open Visual Studio Code.
+1. Open the Extensions view by selecting **View** > **Extensions** or pressing Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (macOS).
+1. Search for "Aspire" in the Extensions marketplace.
+1. Select the **Aspire** extension published by **microsoft-aspire**.
+1. Select **Install**.
+
+Alternatively, you can install the extension directly from the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=microsoft-aspire.aspire-vscode).
+
+## Access extension commands
+
+All Aspire extension commands are available from the Visual Studio Code Command Palette:
+
+1. Open the Command Palette by pressing Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS).
+1. Type "Aspire" to filter and display all available Aspire commands.
+1. Select the desired command from the list.
+
+All commands are grouped under the **Aspire** category in the Command Palette for easy discovery.
+
+## Available commands
+
+The Aspire Visual Studio Code extension provides the following commands:
+
+| Command | Description | Status |
+|---------|-------------|--------|
+| **Aspire: New Aspire project** | Create a new Aspire apphost or starter app from a template | Available |
+| **Aspire: Add an integration** | Add a hosting integration package (`Aspire.Hosting.*`) to the Aspire apphost | Available |
+| **Aspire: Configure launch.json** | Add the default Aspire debugger launch configuration to your workspace's `launch.json` file | Available |
+| **Aspire: Manage configuration settings** | Manage Aspire configuration settings including feature flags | Available |
+| **Aspire: Open Aspire terminal** | Open an Aspire terminal for working with Aspire projects using CLI commands | Available |
+| **Aspire: Publish deployment artifacts** | Generate deployment artifacts for an Aspire apphost | Preview |
+| **Aspire: Deploy app** | Deploy the contents of an Aspire apphost to its defined deployment targets | Preview |
+| **Aspire: Update integrations** | Update hosting integrations and Aspire SDK in the apphost | Preview |
+
+## Create a new Aspire solution
+
+To create a new Aspire solution using the extension:
+
+1. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P).
+1. Run the **Aspire: New Aspire project** command.
+1. Select the desired template:
+ - **Aspire Empty App**: Creates a minimal Aspire project with an AppHost and ServiceDefaults project.
+ - **Aspire Starter App**: Creates a full solution with a sample UI and backing API included.
+1. Specify the project name and location.
+1. The extension creates the project and opens it in Visual Studio Code.
+
+## Add an integration to the Aspire solution
+
+Aspire integrations provide pre-configured connections to various cloud services and dependencies. To add an integration:
+
+1. Open the Command Palette.
+1. Run the **Aspire: Add an integration** command.
+1. Browse or search for the desired integration package.
+1. Select the integration to add it to your AppHost project.
+
+The extension adds the appropriate NuGet package reference to your AppHost project.
+
+## Configure an Aspire solution
+
+### Configure launch.json for debugging
+
+To run and debug your Aspire application in Visual Studio Code, you need to configure the `launch.json` file:
+
+1. Open the Command Palette.
+1. Run the **Aspire: Configure launch.json** command.
+1. The extension adds a default Aspire debugger configuration to your workspace's `launch.json` file.
+
+The default configuration looks like this:
+
+```json
+{
+ "type": "aspire",
+ "request": "launch",
+ "name": "Aspire: Launch AppHost",
+ "program": "${workspaceFolder}"
+}
+```
+
+You can customize the `program` field to point to a specific AppHost project file:
+
+```json
+{
+ "type": "aspire",
+ "request": "launch",
+ "name": "Aspire: Launch MyAppHost",
+ "program": "${workspaceFolder}/MyAppHost/MyAppHost.csproj"
+}
+```
+
+### Customize debugger attributes for resources
+
+The `debuggers` property in the launch configuration allows you to specify common debug configuration properties for different types of Aspire services:
+
+| Language | Debugger entry |
+|----------|---------------|
+| C# | `project` |
+| Python | `python` |
+| AppHost | `apphost` |
+
+For example, to customize debugging properties for C# projects and the AppHost:
+
+```json
+{
+ "type": "aspire",
+ "request": "launch",
+ "name": "Aspire: Launch MyAppHost",
+ "program": "${workspaceFolder}/MyAppHost/MyAppHost.csproj",
+ "debuggers": {
+ "project": {
+ "console": "integratedTerminal",
+ "logging": {
+ "moduleLoad": false
+ }
+ },
+ "apphost": {
+ "stopAtEntry": true
+ }
+ }
+}
+```
+
+### Manage configuration settings
+
+Use the **Aspire: Manage configuration settings** command to manage Aspire CLI configuration settings and feature flags. This command provides an interface to toggle features on or off and adjust CLI behavior.
+
+## Run an Aspire solution in development mode
+
+To run your Aspire application in development mode:
+
+1. Ensure you have configured `launch.json` as described in the [Configure launch.json for debugging](#configure-launchjson-for-debugging) section.
+1. Open the Run and Debug view by selecting **View** > **Run** or pressing Ctrl+Shift+D (Windows/Linux) or Cmd+Shift+D (macOS).
+1. Select your Aspire launch configuration from the dropdown.
+1. Select the green **Start Debugging** button or press F5.
+
+The extension builds and starts the AppHost project, launches the Aspire dashboard in your browser, and enables debugging for all resources in your solution.
+
+### Run or debug from the editor
+
+When an AppHost project is detected in your workspace, you can also run or debug directly from the editor:
+
+- Right-select on a file named `AppHost.cs` in the Explorer view and select **Aspire: Run AppHost** or **Aspire: Debug AppHost**.
+- Use the run buttons in the editor title bar when viewing an AppHost file.
+
+## Publish deployment artifacts
+
+> [!IMPORTANT]
+> This feature is in **Preview**.
+
+The **Aspire: Publish deployment artifacts** command generates deployment artifacts for your Aspire apphost. This command serializes resources to disk, allowing them to be consumed by deployment tools.
+
+To publish deployment artifacts:
+
+1. Open the Command Palette.
+1. Run the **Aspire: Publish deployment artifacts** command.
+1. Select the output location for the generated artifacts.
+
+The command invokes registered publishing callback annotations to generate artifacts such as:
+
+- Bicep files for Azure resources
+- Docker Compose YAML files
+- Kubernetes Helm charts
+
+## Deploy an Aspire solution
+
+> [!IMPORTANT]
+> This feature is in **Preview**.
+
+The **Aspire: Deploy app** command deploys the contents of an Aspire apphost to its defined deployment targets.
+
+To deploy an Aspire solution:
+
+1. Open the Command Palette.
+1. Run the **Aspire: Deploy app** command.
+1. Follow the prompts to select deployment targets and provide any required configuration.
+
+The command publishes deployment artifacts and then invokes deployment callback annotations to deploy resources to the specified targets.
+
+## Open Aspire terminal
+
+The **Aspire: Open Aspire terminal** command opens a terminal window configured for working with Aspire projects. This terminal provides easy access to Aspire CLI commands and is preconfigured with the appropriate environment variables.
+
+## Feedback and issues
+
+To report issues or request features for the Aspire Visual Studio Code extension:
+
+1. Visit the [Aspire GitHub repository](https://github.com/dotnet/aspire/issues).
+1. Create a new issue and add the `area-extension` label.
+
+## See also
+
+- [Aspire setup and tooling](setup-tooling.md)
+- [Aspire CLI Overview](../cli/overview.md)
+- [Aspire templates](aspire-sdk-templates.md)
+- [Aspire Visual Studio Code extension on the marketplace](https://marketplace.visualstudio.com/items?itemName=microsoft-aspire.aspire-vscode)
diff --git a/docs/toc.yml b/docs/toc.yml
index ae30c9bd56..1ddc02cb08 100644
--- a/docs/toc.yml
+++ b/docs/toc.yml
@@ -27,6 +27,9 @@ items:
href: fundamentals/dotnet-aspire-sdk.md
- name: Aspire templates
href: fundamentals/aspire-sdk-templates.md
+ - name: Aspire Visual Studio Code extension
+ href: fundamentals/aspire-vscode-extension.md
+ displayName: vscode,visual studio code,extension,vs code
- name: GitHub Codespaces
href: get-started/github-codespaces.md
- name: Dev Containers
From 7df95f1c704fdbc1b9a4bcf2afbd8f76f89d3080 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 20 Oct 2025 15:46:08 +0000
Subject: [PATCH 03/15] Add link to VS Code extension from setup-tooling.md
Co-authored-by: alistairmatthews <41286777+alistairmatthews@users.noreply.github.com>
---
docs/fundamentals/setup-tooling.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/docs/fundamentals/setup-tooling.md b/docs/fundamentals/setup-tooling.md
index ee48e8a002..c574c3a243 100644
--- a/docs/fundamentals/setup-tooling.md
+++ b/docs/fundamentals/setup-tooling.md
@@ -251,6 +251,8 @@ Once you create a new Aspire project, you run and debug the app, stepping throug
:::image type="content" source="media/setup-tooling/vscode-debugging.png" lightbox="media/setup-tooling/vscode-debugging.png" alt-text="A screenshot showing how to debug an Aspire project in Visual Studio Code.":::
+The [Aspire Visual Studio Code extension](aspire-vscode-extension.md) provides additional commands and tooling to streamline working with Aspire projects, including commands to add integrations, configure launch settings, publish deployment artifacts, and deploy applications.
+
:::zone-end
## Aspire CLI
From d5f3ce3009ac65f3eae297ee7f98e377a477e722 Mon Sep 17 00:00:00 2001
From: Alistair Matthews
Date: Tue, 21 Oct 2025 16:42:24 +0100
Subject: [PATCH 04/15] Update docs/fundamentals/aspire-vscode-extension.md
---
docs/fundamentals/aspire-vscode-extension.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/fundamentals/aspire-vscode-extension.md b/docs/fundamentals/aspire-vscode-extension.md
index de9c3a24a3..b8e9ccf2f4 100644
--- a/docs/fundamentals/aspire-vscode-extension.md
+++ b/docs/fundamentals/aspire-vscode-extension.md
@@ -2,7 +2,7 @@
title: Aspire Visual Studio Code extension
description: Learn how to use the Aspire Visual Studio Code extension to create, configure, run, and deploy Aspire solutions.
ms.date: 10/20/2025
-ms.topic: how-to
+ms.topic: overview
uid: dotnet/aspire/vscode-extension
ai-usage: ai-assisted
---
From 9bb317c180542e7ab3db3352605c27a7568a9032 Mon Sep 17 00:00:00 2001
From: Alistair Matthews
Date: Tue, 21 Oct 2025 16:42:43 +0100
Subject: [PATCH 05/15] Update docs/fundamentals/aspire-vscode-extension.md
---
docs/fundamentals/aspire-vscode-extension.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/fundamentals/aspire-vscode-extension.md b/docs/fundamentals/aspire-vscode-extension.md
index b8e9ccf2f4..e8b4add9b0 100644
--- a/docs/fundamentals/aspire-vscode-extension.md
+++ b/docs/fundamentals/aspire-vscode-extension.md
@@ -9,7 +9,7 @@ ai-usage: ai-assisted
# Aspire Visual Studio Code extension
-The Aspire Visual Studio Code extension provides a set of commands and tools to help you work with Aspire and Aspire AppHost projects directly from Visual Studio Code. The extension streamlines development workflows by offering commands to create projects, add integrations, configure solutions, and manage deployments.
+The Aspire Visual Studio Code extension provides a set of commands and tools to streamline your work with Aspire within Visual Studio Code. The extension includes commands to create projects, add integrations, configure solutions, and manage deployments. The extension requires the Aspire CLI and provides similar functionality on the Visual Studio Code command palette.
## Prerequisites
From 34cfd571874a3f3f1bdc4b57bfd8be09db044e43 Mon Sep 17 00:00:00 2001
From: Alistair Matthews
Date: Tue, 21 Oct 2025 16:42:57 +0100
Subject: [PATCH 06/15] Update docs/fundamentals/aspire-vscode-extension.md
---
docs/fundamentals/aspire-vscode-extension.md | 9 ++-------
1 file changed, 2 insertions(+), 7 deletions(-)
diff --git a/docs/fundamentals/aspire-vscode-extension.md b/docs/fundamentals/aspire-vscode-extension.md
index e8b4add9b0..d22a6741db 100644
--- a/docs/fundamentals/aspire-vscode-extension.md
+++ b/docs/fundamentals/aspire-vscode-extension.md
@@ -11,14 +11,9 @@ ai-usage: ai-assisted
The Aspire Visual Studio Code extension provides a set of commands and tools to streamline your work with Aspire within Visual Studio Code. The extension includes commands to create projects, add integrations, configure solutions, and manage deployments. The extension requires the Aspire CLI and provides similar functionality on the Visual Studio Code command palette.
-## Prerequisites
+[!INCLUDE [aspire-prereqs](../includes/aspire-prereqs.md)]
-Before installing the Aspire Visual Studio Code extension, ensure you have the following prerequisites:
-
-- [Visual Studio Code](https://code.visualstudio.com/) installed
-- [.NET 8.0](https://dotnet.microsoft.com/download/dotnet/8.0) or [.NET 9.0](https://dotnet.microsoft.com/download/dotnet/9.0) installed
-- [Aspire CLI](../cli/install.md) installed and available on your PATH
-- An OCI compliant container runtime, such as [Docker Desktop](https://www.docker.com/products/docker-desktop) or [Podman](https://podman.io/)
+In addition, before you can use the Aspire Visual Studio Code extension, you must have the [Aspire CLI](../cli/install.md) installed and available on your PATH.
### Optional extensions
From ec9e3dc1030205000e88384436193d065bcc7c03 Mon Sep 17 00:00:00 2001
From: Alistair Matthews
Date: Tue, 21 Oct 2025 16:43:22 +0100
Subject: [PATCH 07/15] Update docs/fundamentals/aspire-vscode-extension.md
---
docs/fundamentals/aspire-vscode-extension.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/fundamentals/aspire-vscode-extension.md b/docs/fundamentals/aspire-vscode-extension.md
index d22a6741db..f6b03ba8d5 100644
--- a/docs/fundamentals/aspire-vscode-extension.md
+++ b/docs/fundamentals/aspire-vscode-extension.md
@@ -59,7 +59,7 @@ The Aspire Visual Studio Code extension provides the following commands:
| **Aspire: Open Aspire terminal** | Open an Aspire terminal for working with Aspire projects using CLI commands | Available |
| **Aspire: Publish deployment artifacts** | Generate deployment artifacts for an Aspire apphost | Preview |
| **Aspire: Deploy app** | Deploy the contents of an Aspire apphost to its defined deployment targets | Preview |
-| **Aspire: Update integrations** | Update hosting integrations and Aspire SDK in the apphost | Preview |
+| **Aspire: Update Aspire CLI** | Install the latest version of the Aspire CLI. | Preview |
## Create a new Aspire solution
From 8d62b7c42135b95c2f4d207567dae233afca739a Mon Sep 17 00:00:00 2001
From: Alistair Matthews
Date: Tue, 21 Oct 2025 16:43:51 +0100
Subject: [PATCH 08/15] Update docs/fundamentals/aspire-vscode-extension.md
---
docs/fundamentals/aspire-vscode-extension.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/fundamentals/aspire-vscode-extension.md b/docs/fundamentals/aspire-vscode-extension.md
index f6b03ba8d5..5c2ec7bb04 100644
--- a/docs/fundamentals/aspire-vscode-extension.md
+++ b/docs/fundamentals/aspire-vscode-extension.md
@@ -53,7 +53,7 @@ The Aspire Visual Studio Code extension provides the following commands:
| Command | Description | Status |
|---------|-------------|--------|
| **Aspire: New Aspire project** | Create a new Aspire apphost or starter app from a template | Available |
-| **Aspire: Add an integration** | Add a hosting integration package (`Aspire.Hosting.*`) to the Aspire apphost | Available |
+| **Aspire: Add an integration** | Add a [hosting integration package](./integrations-overview.md) (`Aspire.Hosting.*`) to the Aspire apphost | Available |
| **Aspire: Configure launch.json** | Add the default Aspire debugger launch configuration to your workspace's `launch.json` file | Available |
| **Aspire: Manage configuration settings** | Manage Aspire configuration settings including feature flags | Available |
| **Aspire: Open Aspire terminal** | Open an Aspire terminal for working with Aspire projects using CLI commands | Available |
From dbeba35441d2096cdfc07a714b8c765f594a8fca Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 21 Oct 2025 15:52:16 +0000
Subject: [PATCH 09/15] Address all PR review feedback for VS Code extension
docs
---
docs/fundamentals/aspire-vscode-extension.md | 66 +++++++++-----------
1 file changed, 31 insertions(+), 35 deletions(-)
diff --git a/docs/fundamentals/aspire-vscode-extension.md b/docs/fundamentals/aspire-vscode-extension.md
index 5c2ec7bb04..568511620d 100644
--- a/docs/fundamentals/aspire-vscode-extension.md
+++ b/docs/fundamentals/aspire-vscode-extension.md
@@ -15,30 +15,21 @@ The Aspire Visual Studio Code extension provides a set of commands and tools to
In addition, before you can use the Aspire Visual Studio Code extension, you must have the [Aspire CLI](../cli/install.md) installed and available on your PATH.
-### Optional extensions
-
-Some features require additional VS Code extensions:
-
-| Feature | Required Extension | Notes |
-|---------|-------------------|-------|
-| Debug C# projects | [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit) or [C# for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp) | The C# extension is required for debugging .NET projects. Apphosts are built in VS Code if C# Dev Kit is available. |
-| Debug Python projects | [Python extension](https://marketplace.visualstudio.com/items?itemName=ms-python.python) | Required for debugging Python projects hosted in Aspire |
-
## Install the Aspire extension
-To install the Aspire Visual Studio Code extension:
+To install the Aspire VS Code extension:
-1. Open Visual Studio Code.
+1. Open VS Code.
1. Open the Extensions view by selecting **View** > **Extensions** or pressing Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (macOS).
1. Search for "Aspire" in the Extensions marketplace.
-1. Select the **Aspire** extension published by **microsoft-aspire**.
+1. Select the **Aspire** extension published by **Microsoft**.
1. Select **Install**.
-Alternatively, you can install the extension directly from the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=microsoft-aspire.aspire-vscode).
+Alternatively, you can install the extension directly from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=microsoft-aspire.aspire-vscode).
## Access extension commands
-All Aspire extension commands are available from the Visual Studio Code Command Palette:
+All Aspire extension commands are available from the VS Code Command Palette:
1. Open the Command Palette by pressing Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS).
1. Type "Aspire" to filter and display all available Aspire commands.
@@ -48,17 +39,17 @@ All commands are grouped under the **Aspire** category in the Command Palette fo
## Available commands
-The Aspire Visual Studio Code extension provides the following commands:
+The Aspire VS Code extension provides the following commands:
| Command | Description | Status |
|---------|-------------|--------|
-| **Aspire: New Aspire project** | Create a new Aspire apphost or starter app from a template | Available |
-| **Aspire: Add an integration** | Add a [hosting integration package](./integrations-overview.md) (`Aspire.Hosting.*`) to the Aspire apphost | Available |
-| **Aspire: Configure launch.json** | Add the default Aspire debugger launch configuration to your workspace's `launch.json` file | Available |
-| **Aspire: Manage configuration settings** | Manage Aspire configuration settings including feature flags | Available |
-| **Aspire: Open Aspire terminal** | Open an Aspire terminal for working with Aspire projects using CLI commands | Available |
-| **Aspire: Publish deployment artifacts** | Generate deployment artifacts for an Aspire apphost | Preview |
-| **Aspire: Deploy app** | Deploy the contents of an Aspire apphost to its defined deployment targets | Preview |
+| **Aspire: New Aspire project** | Create a new Aspire AppHost or starter app from a template. | Available |
+| **Aspire: Add an integration** | Add a [hosting integration package](integrations-overview.md#hosting-integrations) (`Aspire.Hosting.*`) to the Aspire AppHost. | Available |
+| **Aspire: Configure launch.json file** | Add the default Aspire debugger launch configuration to your workspace's `launch.json` file. | Available |
+| **Aspire: Manage configuration settings** | Manage Aspire configuration settings including feature flags. | Available |
+| **Aspire: Open Aspire terminal** | Open a terminal to use Aspire CLI commands. | Available |
+| **Aspire: Publish deployment artifacts** | Generate deployment artifacts for an Aspire AppHost. | Preview |
+| **Aspire: Deploy app host** | Deploy the contents of an Aspire AppHost to its defined deployment targets. | Preview |
| **Aspire: Update Aspire CLI** | Install the latest version of the Aspire CLI. | Preview |
## Create a new Aspire solution
@@ -68,10 +59,11 @@ To create a new Aspire solution using the extension:
1. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P).
1. Run the **Aspire: New Aspire project** command.
1. Select the desired template:
- - **Aspire Empty App**: Creates a minimal Aspire project with an AppHost and ServiceDefaults project.
+ - **Aspire Empty App**: Creates a minimal Aspire project with AppHost and ServiceDefaults projects.
- **Aspire Starter App**: Creates a full solution with a sample UI and backing API included.
1. Specify the project name and location.
-1. The extension creates the project and opens it in Visual Studio Code.
+
+The extension creates the project and opens it in VS Code.
## Add an integration to the Aspire solution
@@ -86,9 +78,11 @@ The extension adds the appropriate NuGet package reference to your AppHost proje
## Configure an Aspire solution
+The Aspire extension includes several commands that configure the behavior of Aspire and the Aspire CLI during development:
+
### Configure launch.json for debugging
-To run and debug your Aspire application in Visual Studio Code, you need to configure the `launch.json` file:
+To run and debug your Aspire application in VS Code, you need to configure the `launch.json` file:
1. Open the Command Palette.
1. Run the **Aspire: Configure launch.json** command.
@@ -120,7 +114,7 @@ You can customize the `program` field to point to a specific AppHost project fil
The `debuggers` property in the launch configuration allows you to specify common debug configuration properties for different types of Aspire services:
-| Language | Debugger entry |
+| Environment | Debugger entry |
|----------|---------------|
| C# | `project` |
| Python | `python` |
@@ -150,7 +144,7 @@ For example, to customize debugging properties for C# projects and the AppHost:
### Manage configuration settings
-Use the **Aspire: Manage configuration settings** command to manage Aspire CLI configuration settings and feature flags. This command provides an interface to toggle features on or off and adjust CLI behavior.
+The **Aspire: Manage configuration settings** command executes `aspire config` in the VS Code terminal to display its usage. Use this information to formulate `get` and `set` commands to configure the Aspire CLI. Use `aspire configure list` to show current configuration values.
## Run an Aspire solution in development mode
@@ -165,7 +159,7 @@ The extension builds and starts the AppHost project, launches the Aspire dashboa
### Run or debug from the editor
-When an AppHost project is detected in your workspace, you can also run or debug directly from the editor:
+When an AppHost project is detected in your workspace, you can also run or debug it directly from the editor:
- Right-select on a file named `AppHost.cs` in the Explorer view and select **Aspire: Run AppHost** or **Aspire: Debug AppHost**.
- Use the run buttons in the editor title bar when viewing an AppHost file.
@@ -185,32 +179,34 @@ To publish deployment artifacts:
The command invokes registered publishing callback annotations to generate artifacts such as:
-- Bicep files for Azure resources
-- Docker Compose YAML files
-- Kubernetes Helm charts
+- Bicep files for Azure resources.
+- Docker Compose YAML files.
+- Kubernetes Helm charts.
## Deploy an Aspire solution
> [!IMPORTANT]
> This feature is in **Preview**.
-The **Aspire: Deploy app** command deploys the contents of an Aspire apphost to its defined deployment targets.
+The **Aspire: Deploy app host** command deploys the contents of an Aspire AppHost to its defined deployment targets.
To deploy an Aspire solution:
1. Open the Command Palette.
-1. Run the **Aspire: Deploy app** command.
+1. Run the **Aspire: Deploy app host** command.
1. Follow the prompts to select deployment targets and provide any required configuration.
The command publishes deployment artifacts and then invokes deployment callback annotations to deploy resources to the specified targets.
+For more information about Aspire deployment, see [Aspire publishing and deployment overview](../deployment/overview.md).
+
## Open Aspire terminal
The **Aspire: Open Aspire terminal** command opens a terminal window configured for working with Aspire projects. This terminal provides easy access to Aspire CLI commands and is preconfigured with the appropriate environment variables.
## Feedback and issues
-To report issues or request features for the Aspire Visual Studio Code extension:
+To report issues or request features for the Aspire VS Code extension:
1. Visit the [Aspire GitHub repository](https://github.com/dotnet/aspire/issues).
1. Create a new issue and add the `area-extension` label.
@@ -220,4 +216,4 @@ To report issues or request features for the Aspire Visual Studio Code extension
- [Aspire setup and tooling](setup-tooling.md)
- [Aspire CLI Overview](../cli/overview.md)
- [Aspire templates](aspire-sdk-templates.md)
-- [Aspire Visual Studio Code extension on the marketplace](https://marketplace.visualstudio.com/items?itemName=microsoft-aspire.aspire-vscode)
+- [Aspire VS Code extension on the marketplace](https://marketplace.visualstudio.com/items?itemName=microsoft-aspire.aspire-vscode)
From c3a323c948e16c28cb04919cb6ca80456a250967 Mon Sep 17 00:00:00 2001
From: AJ Matthews
Date: Wed, 22 Oct 2025 16:01:30 +0100
Subject: [PATCH 10/15] Adding a screenshot of the extension installation.
---
docs/fundamentals/aspire-vscode-extension.md | 2 ++
.../media/install-aspire-code-extension.png | Bin 0 -> 450818 bytes
2 files changed, 2 insertions(+)
create mode 100644 docs/fundamentals/media/install-aspire-code-extension.png
diff --git a/docs/fundamentals/aspire-vscode-extension.md b/docs/fundamentals/aspire-vscode-extension.md
index 568511620d..8a25e1cbae 100644
--- a/docs/fundamentals/aspire-vscode-extension.md
+++ b/docs/fundamentals/aspire-vscode-extension.md
@@ -25,6 +25,8 @@ To install the Aspire VS Code extension:
1. Select the **Aspire** extension published by **Microsoft**.
1. Select **Install**.
+ :::image type="content" source="../media/install-aspire-code-extension.png" lightbox="../media/install-aspire-code-extension.png" alt-text="A screenshot of VS Code showing how to install the Aspire extension.":::
+
Alternatively, you can install the extension directly from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=microsoft-aspire.aspire-vscode).
## Access extension commands
diff --git a/docs/fundamentals/media/install-aspire-code-extension.png b/docs/fundamentals/media/install-aspire-code-extension.png
new file mode 100644
index 0000000000000000000000000000000000000000..602f7584933b058eeaa94895123065c2d4917ee8
GIT binary patch
literal 450818
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�*7~Y=?mz^9L_wA>x3r}Bt8$i0cZMO=iQ@6>A
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