Skip to content

Draft Aspire 17.0 release notes against 13.6.4 - #2099

Closed
Mitch Denny (mitchdenny) wants to merge 2 commits into
release/17.0from
mitchdenny-aspire-17-release-notes
Closed

Mitch Denny (mitchdenny) wants to merge 2 commits into
release/17.0from
mitchdenny-aspire-17-release-notes

Conversation

@mitchdenny

@mitchdenny Mitch Denny (mitchdenny) commented Nov 10, 2026 •

Copy link
Copy Markdown
Member

Summary

Expand the existing whats-new/aspire-17.mdx into an evidence-backed initial draft, targeting release/17.0, not main. This is intentionally a draft for continued release work, not a claim of complete 17.0 coverage. Changes are confined to the release-note page and its dashboard screenshot assets.

Pinned comparison: latest published stable patch v13.6.4 (c89352703f78ae46de90fbf751ed8b52b77b89bf) versus microsoft/aspire release/17.0 at cec195f2d0bf3f1d714badf74f205fa855fdf963. Read the 514 target-side commit subjects and inspected selected implementations, source guides, and originating PRs. Explicitly excluded servicing fixes already shipped in 13.6.x, including DCP create recovery, Azure enum-expression publishing, Unix diagnostic-log permissions, and dashboard metric/Fluent UI servicing changes.

Verified initial coverage:

  • Go AppHosts without the experimental language flag, Go 1.26 requirements, scaffolding and generated-SDK workflow.
  • Stable .NET project integration, SDK-style F#/VB support, explicit AppHost package defaults, TypeScript/C# example parity, and experimental TypeScript-authored integrations with unpublished Nuxt caveat.
  • The experimental redesigned dashboard: application-wide health and activity, graph versus summary, resource details, grouping and multi-selection, context shared across logs/traces/metrics, instrument pinning and terminal access.
  • Seven real TestShop views with paired light/dark screenshots: application summary, graph, resource overview, structured logs, trace waterfall, metrics browser and Settings. Set themed resourceImage artwork. The sample's existing activity generator produced actual read-only traffic; no telemetry or UI was fabricated.
  • Exact, runtime-verified opt-out: Settings > Previous dashboard > Skip and switch. Verified persistence after reload and return through Settings > New dashboard. Feedback is optional and none was submitted.
  • Shell completion, native agent plugin setup, masked/environment secret input, and VS Code resource/Go AppHost debugging.
  • Stable Kubernetes package versions, existing AKS environments, Standard-tier cost warning, node-pool callback migration and per-environment deployment secrets.
  • Preview Entra ID and API Management integrations, Web PubSub emulation, Service Bus emulator SQL customization, and the MongoDB 8.3-to-9.0 image change.
  • Actionable .NET baseline, project API, AppHost SDK/bundle, CPM, AKS, secret-store and agent-option migration notes. Preserve the existing RabbitMQ/MongoDB client-package migration.
  • Correct heading hierarchy, highlights, changelog link, community acknowledgment and ReleaseCommunity usage.

Dashboard capture provenance and qualification:

At the user's request, installed the latest daily CLI in session-only storage and ran matching TestShop source with published daily packages and the bundled daily dashboard. Version 17.1.0-preview.1.26559.12, source 031536bc9eea22ee9ce2cc1d31bfd30d0c14cfd2. The article explicitly labels this as the latest development experience, not finalized 17.0 artwork. Shared capabilities and the opt-out flow were separately checked in the pinned release/17.0 source. Main has subsequent UI refinements, notably microsoft/aspire#21943; reconcile artwork and exact navigation against the final release build before sign-off. The scratch sample used isolated ports/secrets and no source-built dashboard. Task-owned TestShop, persistent RabbitMQ and preview/browser helpers were stopped; unrelated running apps and pre-existing generated icon changes were left untouched.

Remaining before release sign-off:

  • Finish exhaustive commit categorization and the complete breaking-change review. This initial draft does not yet cover named configuration/template/integration/skill sources, browser-facing origins/CORS, TypeScript Azure Functions, native tray support, optional/programmatic parameters, all Azure changes or every API graduation.
  • Reconcile daily dashboard artwork against the final 17.0 release build; the latest daily requested for this pass is a 17.1 preview, not a matching-17.0 runtime qualification.
  • Confirm the release date before setting publishDate; replace the moving branch-comparison link with final release metadata when available.
  • Refresh the full contributor aggregate when 17.0 release metadata exists. The component currently supplies the core-team roster, with the verified Service Bus community credit inline; this is not a complete contributor inventory.
  • Reconcile downstream docs that still describe older .NET integration/agent bundle behavior. Pinned 17.0 source guides and PRs accompany those links in this draft.
  • Execute the remaining scenarios against a matching 17.0 build. No source-access blockers were encountered.

Third-party links and affiliations

Added https://github.com/thomhurst solely for attribution of the originating Service Bus emulator contribution; no material affiliation declared. Existing RabbitMQ and MongoDB migration-guide links are unchanged. Other new external references point to the Microsoft Aspire source repository and its pull requests.

Validation

Latest dashboard pass:

  • pnpm --dir src/frontend exec prettier --write src/content/docs/whats-new/aspire-17.mdx — passed, unchanged by formatting.
  • pnpm --dir src/frontend exec vitest run --config vitest.config.ts tests/unit/whats-new.vitest.test.ts tests/unit/whats-new-sidebar.vitest.test.ts tests/unit/custom-components.vitest.test.ts — passed, 3 files / 118 tests.
  • git diff --check — passed.
  • Daily aspire start --isolated --non-interactive --apphost <session-owned TestShop.AppHost.csproj> — passed after standalone SDK setup; sample built with 0 warnings / 0 errors. aspire wait frontend and aspire wait activity-generator — passed. Resource selection across telemetry views, metrics pinning, and the full opt-out/return flow — passed in the actual daily dashboard.
  • curl -fsSL on the new pinned TestShop source link — passed, HTTP 200.
  • Ad hoc Sharp metadata check — passed, all 14 screenshots are 1440x1080 PNGs with no EXIF.
  • pnpm --dir src/frontend exec astro dev --host 127.0.0.1 --port 4387 plus playwright-cli checks — passed: all 14 optimized image URLs return images; all 7 ThemeImage components switch correctly in both themes; all 5 screenshot tabs operate; image zoom works; article fragments resolve; no skipped heading levels or page overflow at 390px mobile width. Visually inspected desktop/mobile renders and both-theme captures. Temporary preview was stopped. Standalone Astro's unavailable /api/live/ endpoint and initial dev-toolbar optimize-cache 504 remain preview-only limitations.

Initial draft validation, before the dashboard follow-up:

  • pnpm --dir ./src/frontend exec prettier --check src/content/docs/whats-new/aspire-17.mdx — passed.
  • pnpm --dir ./src/frontend exec vitest run --config vitest.config.ts tests/unit/whats-new.vitest.test.ts tests/unit/whats-new-sidebar.vitest.test.ts tests/unit/release-contributors.vitest.test.ts tests/unit/seo-lengths.vitest.test.ts tests/unit/twoslash-blocks.vitest.test.ts — passed, 5 files / 15 tests, including the two-slash TypeScript example.
  • Ad hoc fetch-based link audit — passed, all 49 then-present unique page links returned HTTP 200; local fragments resolved.
  • Local Astro/Playwright preview — passed for TypeScript-first/C# tab switching, no duplicate article IDs, zero rendered TypeScript errors and community rendering.

No local production build or complete matching-17.0 runtime qualification was run. Pre-existing generated icon-cache changes are not included.

Expand the existing draft against Aspire 13.6.4 with verified feature coverage, migration guidance, and release-note closing sections.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Frontend HTML artifact ready

The latest frontend build uploaded the frontend-dist artifact for PR #2099. Use the VS Code button below to open this PR with GitHub Artifacts Explorer and browse the built HTML locally.

VS Code: Open PR #2099 artifacts

This comment updates automatically when a new frontend build artifact is uploaded.

Explain application and resource context, scoped telemetry views, and the verified previous-dashboard opt-out flow. Include paired light/dark screenshots with explicit daily-build provenance.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@mitchdenny

Copy link
Copy Markdown
Member Author

Abandoning this draft at the author’s request. Replacement work will use the repository whatsnew skill and preserve Eric Erhardt’s curated sections.

Mitch Denny (mitchdenny) added a commit that referenced this pull request Nov 16, 2026
…#2166)

## Summary

<!-- Describe what this pull request changes and why. -->

Replacement **draft** for closed #2099, starting from the existing
`release/17.0` page, not abandoned changes. Uses the `whatsnew`
research/authoring/critique/validation lifecycle; the user-selected
working branch targets **release/17.0**, overriding generic skill
branching guidance. No site-wide banner/version/data/localization edits.

**TestShop dashboard tour:** four H3 stops with concise explanations and
matching light/dark `ThemeImage` pairs:

| View | Captured subject | Assets |
| --- | --- | --- |
| All resources | Resource list, live request activity, latency and
slowest endpoints | New `testshop-all-resources(-light).png`, 1280×800 |
| Resource graph | Service/infrastructure dependencies | Existing
`testshop-dashboard(-light).png` reused byte-identically, 1280×800 |
| Resource details | Storefront `frontend`: status, endpoint, logs and
telemetry | New `testshop-resource(-light).png`, 1280×800 |
| Distributed traces | One real ten-span waterfall across
frontend/catalog/PostgreSQL/basket/Redis | New
`testshop-traces(-light).png`, 1280×540 crop from full-height viewport |

**Real activity:** browsed catalog pages, added hoodie and mug,
submitted the sample checkout form and verified the cart changed from
two items to zero. TestShop's activity generator supplemented user
actions. The selected trace is explicitly generator traffic, not
misrepresented as the checkout trace. Overview includes actual checkout
endpoints. No fabricated telemetry, payment details or external
purchase.

**Version provenance:** product `microsoft/aspire release/17.0` at
`a509f094e0ee87d17dc0e1cc9bca84f7ca2623da`, compared with published
13.6.5 at `b33d222049f1ecc3bc7257ec07b622fe550b2580`. Installed CLI
`17.0.0+a509f094e0ee87d17dc0e1cc9bca84f7ca2623da`; bundled new dashboard
reports 17.0.0. Scoped TestShop copy replaces repository-only references
with staging packages whose nuspec commits all match `a509f094`,
preserving actual resource declarations. No 17.1 UI. Dashboard
executable SHA-256:
`032300cf23b332da62d168e9628e7f48b79ab9bc1b3df2fee06df93a54b75c6f`.

All six new PNGs optimized and visually reviewed. Application resources
were healthy; genuine missing unused parameters, frontend HTTP-redirect
warning and six failed internal event traces remain visible. Sample
checkout completed. Banners/toasts dismissed; no exposed secrets.
Task-owned apps/browser/containers stopped; unrelated apps and existing
documentation preview untouched.

**Earlier follow-ups retained:** custom CLI H3 with four H4s, minimal
examples and site references or permitted TODO complete guides. Exact
`ASPIRE_INIT_SOURCE_URL` repository selection, consent, allowed
settings, template inheritance, optional path/ref and refresh
documented. Entra links to [Eric's complete site
guide](https://aspire.dev/integrations/security/microsoft-entra-id/); no
guides changed. Earlier dashboard/CLI/AppHost/integration/deployment
additions remain.

**Eric's curation unchanged:** five original complete blocks remain
byte-identical, unique and ordered against docs baseline
`681cdfeddfa290dbe94cea0830ec1ea885bf1ed1`. New imports stay after the
complete protected Upgrade block. Original imports/frontmatter,
preservation verifier and curated assets remain untouched. Existing
graph pair hashes unchanged.

| Protected block | Bytes | SHA-256 |
| --- | ---: | --- |
| Frontmatter, imports, introduction | 832 |
`31ac8676532deafef31c5faaff2708e7aad23cb135f6c1deac0aa1dadd9cce0c` |
| Upgrade | 779 |
`982aaf4fae694641d1fddb1116252a4f59774fd5e40d0f3b13cfd26c0b5c892c` |
| Go AppHost | 911 |
`0da96321cb1a4e1c9bde7b502b38dee71a94e11a99c628e70392f083a18f4840` |
| Default container images | 687 |
`c92445350ad9a562ba7ccec9fb2f7cb3daf899e77e9d42e414a5abf6c960add6` |
| Entire breaking-changes section | 4,978 |
`3689f54fbf7828a6cca7cafde9728b7b08ec4e7031ddd678137aaf9122dbc84c` |

**Remaining gaps; not release-complete:** three permitted TODO complete
guides and illustrative team inputs; release-wide coverage/contributors,
migration/diagnostic/image-tag details, data ingestion and
CI/build/sign-off. Protected `resourceImage`, publish date and original
summaries unchanged; no date invented. Article artwork is present but
resource-card frontmatter gate remains incomplete.
Secrets/cloud/team-source scenarios are not fully runtime-certified. No
remaining dashboard capture blocker.

## Third-party links and affiliations

<!--
List any third-party links added or changed by this pull request and
disclose any
material affiliation with the linked organizations, such as employment,
sponsorship, or ownership. Write "None" if this pull request doesn't add
or
change third-party links.
-->

Originating `microsoft/aspire` PR links and three exact 17.0 source
documents (migration, Web PubSub emulator, Service Bus emulator); Entra
uses the site guide. Team repository examples are explicit placeholders.
Material affiliation disclosure was not provided. No unrelated
third-party sites added.

## Validation

<!-- List the checks you ran or explain why validation isn't needed. -->

- `git diff --check` — **passed**.
- `python3
/Users/midenn/.copilot/session-state/819dd6e8-33ab-4dbb-ae69-455637977e2a/files/verify-preservation.py`
— **passed on final committed tour**, all five original blocks exact,
unique and ordered; original verifier/baseline unchanged, session-only.
- From `src/frontend`: `npm exec --yes --package=bun@1.4.3 -- bun x
vitest run --config vitest.config.ts tests/unit/whats-new.vitest.test.ts
tests/unit/whats-new-sidebar.vitest.test.ts
tests/unit/dev-resource-catalog.vitest.test.ts` — **passed after tour**,
29 tests in three suites.
- `node --input-type=module` using `parseFrontmatter`,
`@mdx-js/mdx.compile`, `sharp.metadata` and SHA-256 — **passed**, final
MDX, four H3 tour stops, four `ThemeImage` instances/eight matching
assets, expected dimensions and unchanged graph hashes. Prior CLI
JSON/H4/link checks passed.
- `ASTRO_TELEMETRY_DISABLED=1 npm exec --yes --package=bun@1.4.3 -- bun
run dev -- --host 127.0.0.1 --port 4368` — **refused**, existing
same-worktree server registered. Did not force-replace it; reused
`http://localhost:15623/` on IPv6 loopback.
- `playwright-cli -s=tour17-doc-check run-code` — **passed**, all four
images decoded and selected the actual correct asset through both native
site themes at 1440px and 390px; expected dimensions and no page/image
overflow. Desktop/light/mobile visually inspected. Only task browser
closed; existing server untouched.
- Capture: `aspire start --non-interactive --isolated --apphost
TestShop/TestShop.AppHost/TestShop.AppHost.csproj --launch-profile http
--format Json`, `aspire wait frontend`, `aspire wait activity-generator`
— **passed**. Actual catalog/cart/sample-checkout UI actions and
ten-span propagated service/database trace verified. Task capture
tools/apps stopped; original source clone untouched.
- Earlier independent blind follow-up: **0 critical issues, 2 warnings**
for placeholders/permitted TODOs. Six site destinations, skills anchor,
Entra navigation and original artwork theme/mobile checks passed. Frozen
report remains historical, not relabeled as independent review of the
later tour. Initial source review: 36 claims; custom follow-up: 18
grouped claims verified at pinned SHA. Tour captions match actual
captured UI/state.
- Matching `aspire --version`, `aspire template source add --help`,
`aspire new --help`, `aspire agent init --help`, `aspire init --help`,
`aspire update --help` — **passed**, help-only. Initial Bash completion
generation/sourcing — **passed**; secret help — **passed**, storage
scenario unexecuted.
- **Not run:** local `bun run build` (prohibited), cloud
provisioning/deployment, full data ingestion or release sign-off. No
twoslash introduced. Unrelated pre-existing icon delta excluded from
commits.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants