Skip to content

Aspire 17.0.0

Latest

Choose a tag to compare

@aspire-repo-bot aspire-repo-bot released this 18 Nov 06:50
Immutable release. Only release title and notes can be modified.
2d325b1

Aspire 17.0.0

Aspire 17.0 brings a resource-first dashboard, Go AppHosts in preview, stable .NET project hosting and Kubernetes deployment packages, and new Microsoft Entra ID and Azure API Management integrations. Shell completion, shared team configuration, environment-specific secrets, richer editor tooling, and a preview tray companion make it easier to build, inspect, and deploy applications across languages.

Highlights

  • 📊 Resource-first dashboard — A resource table home page and shared resource pane keep services in view as you navigate logs, traces, and metrics. Search, filters, multi-selection, grouping, and pinnable metric cards with live sparklines help focus investigations. Interactive terminals get a dedicated page, first-run guidance helps connect telemetry, and the dashboard and aspire describe --format mermaid can export your resource graph.
  • 🐹 Go AppHosts in preview — Create Go AppHosts with aspire new or aspire init --language go, with no experimental feature flag required. Go templates, VS Code launch and debugging, aspire doctor tooling checks, generated SDK documentation, and aspire sdk export --language go round out the preview.
  • 🛠️ Stable .NET project hosting and more stable APIs — Aspire.Hosting.Dotnet now ships as a stable package, with path-based AddDotnetProject, SDK-style C#, F#, and Visual Basic support, and parallel builds within compatible project groups. Deno hosting, Next.js hosting and JavaScript publishing, core pipeline and deployment-state APIs, HTTP probes, and MCP endpoint declarations also graduate from experimental.
  • ⌨️ Sharper CLI and agent workflows — Shell completion supports Bash, Fish, PowerShell, and Zsh. Environment-specific secrets keep deployment values separate, and masked prompts or --envvar avoid putting secret values on the command line. Agent setup selects clients and project or global scope, configuring plugins instead of copying bundled skill folders.
  • 🧩 Reusable team customization — Create apps from local or Git-backed templates, discover hosting packages through named integration sources, and configure team skill sources. Opt-in Git-backed initialization configuration supplies shared defaults, with explicit source acceptance and refresh through aspire update --config-source.
  • 🖥️ Tray companion in preview — aspire tray start keeps local AppHosts within reach from the macOS menu bar, Windows notification area, or a supported Linux desktop tray. The companion requires a native CLI installation; Linux support also requires a graphical desktop session and GTK 3.
  • 💻 More capable VS Code tooling — Attach a debugger to already-running .NET and Go resources without restarting them, and launch and debug Go AppHosts. New language model tools help coding agents inspect debug status, discover AppHosts, explain launch failures, check Hot Reload applicability, and open the dashboard or Aspire output channel.
  • ☁️ New Azure integrations — Preview Microsoft Entra ID hosting models application registrations, service principals, credentials, permissions, and workload references. Preview Azure API Management hosting models deployment-time gateways, APIs, backends, policies, and OpenAPI imports. New Aspire.Azure.AI.Extensions.OpenAI and Aspire.Azure.AI.Projects client integrations support Azure OpenAI and Foundry using the updated SDKs.
  • ☸️ Stable Kubernetes deployment packages — Kubernetes and AKS hosting packages now ship stable versions, while persistent-volume APIs remain experimental. Target existing AKS clusters, choose node-pool OS SKUs, configure cert-manager External Account Binding, and preserve per-image registries in Helm charts. Experimental Azure Front Door Private Link origins support Container Apps and App Service environments.
  • 🔌 More flexible AppHosts and integrations — Optional parameters can remain unset without prompting or blocking supported publishing flows, while browser-origin references simplify CORS and authentication redirects. Experimental TypeScript and JavaScript Azure Functions hosting adds Node.js debugging in VS Code. Azure Web PubSub gains a local emulator, and the Service Bus emulator can reuse an existing SQL Server resource.

⚠️ Breaking changes

Aspire's minimum supported .NET version is now .NET 10; this does not require every orchestrated workload to retarget. AddProject, AddCSharpApp, and Aspire.AppHost.Sdk remain available but are deprecated in favor of path-based .NET project registration and standard Microsoft.NET.Sdk AppHosts. C# AppHosts also require the Aspire CLI bundle.

Other notable changes include removal of the legacy RabbitMQ v6 and MongoDB v2 client integrations, replacement of the Azure AI OpenAI and Inference packages, service-provider-aware Cosmos DB client callbacks, renamed polyglot feature flags, and rejection of empty required parameter values. Kubernetes deployment requires Helm 4.0.0 or later, and AKS defaults to the paid Standard control-plane tier with separate user-assigned identities; review existing-cluster updates and custom permissions. MongoDB's default container image advances to 9.0, so review persistent-data compatibility or pin the previous tag.

See the full list and migration guidance in the Aspire 17.0 breaking changes.

📖 Learn more

For complete details, examples, migration guidance, and everything new in this release, read What's new in Aspire 17.0.

Thank you to all the community contributors who helped make Aspire 17.0 possible! 💜


Full Changelog: v13.6.5...v17.0.0

Full commit: 2d325b13709752ba6d9a943635c5e2940a2530c0