[docs] Document partial Linux certificate trust behavior for aspire certs trust - #1528
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 2fc23d00-db43-47fd-a3aa-290b772db576
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
There was a problem hiding this comment.
Pull request overview
Updates the Aspire CLI command reference for aspire certs trust to document the Linux-specific behavior change where non-interactive runs can exit successfully even if certificate trust is only partial (OpenSSL trust succeeds but browser/NSS trust via certutil is incomplete).
Changes:
- Adds a note describing “partial trust treated as success” behavior for
aspire certs trust --non-interactiveon Linux, with example warning/exit-code output. - Adds a
--non-interactiveexample to the Examples section. - Adds cross-references to
aspire doctorfor related diagnostics.
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 2fc23d00-db43-47fd-a3aa-290b772db576
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.
Suppressed comments (1)
src/frontend/src/content/docs/reference/cli/commands/aspire-certs-trust.mdx:39
EXIT:0in this output snippet comes from the surrounding shell wrapper rather than fromaspire certs trustitself. To avoid readers interpreting it as literal CLI output, consider making that line explicitly descriptive (or removing it) so it's clear it's metadata about the invocation.
EXIT:0
Documents changes from microsoft/aspire#17447
@davidfowlTargeting
release/13.5— the latest release branch onmicrosoft/aspire.dev— becauserelease/13.4(from the source PR milestone13.4) does not exist there.Why this PR is needed
microsoft/aspire#17447 changes
aspire certs trust --non-interactivebehavior on Linux CI runners: when the certificate ends up only partially trusted (OpenSSL trust succeeds but browser/NSS trust can't complete), the command now exits successfully with a warning instead of failing hard. This is a user-facing CLI behavior/output change to an already-documented command (aspire certs trust) with no existing docs coverage, so a docs update is required.What changed
Updated
src/frontend/src/content/docs/reference/cli/commands/aspire-certs-trust.mdx:--non-interactiveexample to the Examples section.aspire doctor(which already documents the OpenSSL/SSL_CERT_DIRdiagnostic checks related to this scenario).Files modified
src/frontend/src/content/docs/reference/cli/commands/aspire-certs-trust.mdx(updated)No new pages were created; this update fits naturally into the existing command reference page.