diff --git a/Aspire.slnx b/Aspire.slnx
index 15240a498ee..d18652e2976 100644
--- a/Aspire.slnx
+++ b/Aspire.slnx
@@ -275,6 +275,9 @@
+
+
+
diff --git a/extension/README.md b/extension/README.md
index 7d8442ae1e8..0f2f490c3c3 100644
--- a/extension/README.md
+++ b/extension/README.md
@@ -15,6 +15,7 @@ The extension adds the following commands to VS Code:
| Aspire: Update integrations | Update hosting integrations and Aspire SDK in the apphost. |
| Aspire: Publish deployment artifacts | Generate deployment artifacts for an Aspire apphost. |
| Aspire: Deploy app | Deploy the contents of an Aspire apphost to its defined deployment targets. |
+| Aspire: Execute pipeline step (aspire do) | Execute a specific pipeline step and its dependencies. |
| Aspire: Configure launch.json file | Add the default Aspire debugger launch configuration to your workspace's `launch.json`. |
| Aspire: Extension settings | Open Aspire extension settings. |
| Aspire: Open local Aspire settings | Open the local `.aspire/settings.json` file for the current workspace. |
@@ -43,6 +44,31 @@ To run and debug your Aspire application, add an entry to the workspace `launch.
}
```
+You can also use the `command` property to run deploy, publish, or pipeline step commands with the debugger attached:
+
+```json
+{
+ "type": "aspire",
+ "request": "launch",
+ "name": "Aspire: Deploy MyAppHost",
+ "program": "${workspaceFolder}/MyAppHost/MyAppHost.csproj",
+ "command": "deploy"
+}
+```
+
+Supported values for `command` are `run` (default), `deploy`, `publish`, and `do`. When using `do`, you can optionally set the `step` property to specify the pipeline step to execute:
+
+```json
+{
+ "type": "aspire",
+ "request": "launch",
+ "name": "Aspire: Run pipeline step",
+ "program": "${workspaceFolder}/MyAppHost/MyAppHost.csproj",
+ "command": "do",
+ "step": "my-custom-step"
+}
+```
+
## Requirements
### Aspire CLI
diff --git a/extension/loc/xlf/aspire-vscode.xlf b/extension/loc/xlf/aspire-vscode.xlf
index 935b07ee76f..4b741264196 100644
--- a/extension/loc/xlf/aspire-vscode.xlf
+++ b/extension/loc/xlf/aspire-vscode.xlf
@@ -28,15 +28,33 @@
Aspire VSCode
+
+ Aspire helps you build observable, production-ready distributed apps — orchestrating front ends, APIs, containers, and databases from code.
It works with **any language**: C#, Python, JavaScript, Go, Java, and more.
+ Aspire launch configuration already exists in launch.json.Aspire terminal
+
+ Aspire: Error
+ Aspire: Launch default apphost
+
+ Aspire: Stopped
+
+
+ Aspire: {0} apphost
+
+
+ Aspire: {0} apphosts
+
+
+ Aspire: {0}/{1} running
+ Attempted to start unsupported resource type: {0}.
@@ -76,6 +94,9 @@
Configure launch.json file
+
+ Create a new project
+ DCP server not initialized - cannot forward debug output.
@@ -127,6 +148,12 @@
Encountered an exception ({0}) while running the following command: {1}.
+
+ Enter the pipeline step to execute
+
+
+ Error fetching Aspire apphost status. Click to open the Aspire panel.
+ Error getting Aspire config info: {0}. Try updating the Aspire CLI with: aspire update
@@ -136,9 +163,15 @@
Error: {0}
+
+ Execute pipeline step (aspire do)
+ Execute resource command
+
+ Explore the dashboard
+ Extension context is not initialized.
@@ -172,12 +205,24 @@
Failed to start project: {0}.
+
+ Get started with Aspire
+ Include environment variables when logging debug session configurations. This can help diagnose environment-related issues but may expose sensitive information in logs.Initialize Aspire
+
+ Install Aspire CLI (daily)
+
+
+ Install Aspire CLI (stable)
+
+
+ Install the Aspire CLI
+ Invalid launch configuration for {0}.
@@ -211,15 +256,24 @@
Launching Aspire debug session using directory {0}: attempting to determine effective apphost...
+
+ Learn how to create, run, and monitor distributed applications with Aspire.
+ New Aspire project
+
+ Next steps
+ NoNo
+
+ No Aspire apphosts running. Click to open the Aspire panel.
+ No C# Dev Kit build task found, defaulting to dotnet CLI. Maybe the workspace hasn't finished loading?
@@ -292,30 +346,54 @@
Run Aspire apphost
+
+ Run your app
+ Run {0}Running apphosts
+
+ Scaffold a new Aspire project from a starter template. The template includes an apphost orchestrator, a sample API, and a web frontend.
[Create new project](command:aspire-vscode.new)
+ See CLI installation instructions
+
+ Select directory
+
+
+ Select file
+ Select the default apphost to launch when starting an Aspire debug sessionStart
+
+ Start your Aspire app to launch all services and open the real-time dashboard.
[Run apphost](command:aspire-vscode.runAppHost)
[Debug apphost](command:aspire-vscode.debugAppHost)
+ StopStop
+
+ The Aspire CLI command to execute (run, deploy, publish, or do)
+
+
+ The Aspire CLI creates, runs, and manages your applications. Install it using the commands in the panel, then verify your installation.
[Verify installation](command:aspire-vscode.verifyCliInstalled)
+ The Aspire CLI is not installed or does not support this feature. Install or update the Aspire CLI to get started.
[Update Aspire CLI](command:aspire-vscode.updateSelf)
[Refresh](command:aspire-vscode.refreshRunningAppHosts)
+
+ The Aspire Dashboard shows your resources, endpoints, logs, traces, and metrics — all in one place.
[Open dashboard](command:aspire-vscode.openDashboard)
+ The apphost is not compatible. Consider upgrading the apphost or Aspire CLI.
@@ -325,6 +403,9 @@
The path to the Aspire CLI executable. If not set, the extension will attempt to use 'aspire' from the system PATH.
+
+ The pipeline step name to execute when command is 'do'
+ This field is required.
@@ -334,6 +415,8 @@
Update integrations
+
+ Verify Aspire CLI installationUse the system default browser (cannot auto-close).
@@ -343,17 +426,23 @@
Watch {0} ({1})
+
+ Welcome to Aspire
+ YesYes
-
- Select directory
+
+ You're all set! Add integrations for databases, messaging, and cloud services, or deploy your app to production.
[Add an integration](command:aspire-vscode.add)
[Open Aspire docs](https://aspire.dev/docs/)
-
- Select file
+
+ {0} Aspire apphost running. Click to open the Aspire panel.
+
+
+ {0} Aspire apphosts running. Click to open the Aspire panel.