Skip to content

[docs] Document DCP Kubernetes API timeout configuration - #1862

Draft
aspire-repo-bot[bot] wants to merge 1 commit into
release/17.0from
docs/pr-20752-38010688492-1-80dbe26b0500dc61
Draft

aspire-repo-bot[bot] wants to merge 1 commit into
release/17.0from
docs/pr-20752-38010688492-1-80dbe26b0500dc61

Conversation

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#20752
@danegsta

Target branch: Targeting release/17.0 based on the source PR milestone 17.0.

Why this PR is needed

PR microsoft/aspire#20752 adds a "User-facing usage" section to its description showing a new DcpPublisher configuration block for overriding DCP Kubernetes API timeouts, and src/Aspire.Hosting/Dcp/DcpOptions.cs adds three new configurable options with validation. These are user-facing AppHost settings that were not previously documented on aspire.dev.

What changed

Added a new DCP Kubernetes API timeouts subsection under Advanced orchestration properties in src/frontend/src/content/docs/app-host/configuration.mdx, documenting:

  • DcpPublisher:KubernetesApiTimeout (default 00:00:40) — base per-operation API budget.
  • DcpPublisher:KubernetesInitializationAdditionalTimeout (default 00:00:20) — extra time added until the first successful API operation.
  • DcpPublisher:KubernetesCreateRecoveryTimeout (default 00:02:00) — total budget for recovering ambiguous DCP resource creates (timeouts / HTTP 504s) by checking whether the resource was actually created before retrying.

Includes valid value ranges (1 second–10 minutes, combined budget capped at 10 minutes) and a short note on the new ambiguous-create recovery behavior, sourced from the PR description and DcpOptions.cs validation logic.

Files modified

  • src/frontend/src/content/docs/app-host/configuration.mdx (updated existing page, no new page needed)

No existing page previously covered this configuration, so this is purely additive content.

Generated by PR Documentation Check for #20752 · copilot · auto · 51.2 AIC · ⌖ 9.56 AIC · ⊞ 20.4K · ◷

Documents the new DcpPublisher:KubernetesApiTimeout,
KubernetesInitializationAdditionalTimeout, and
KubernetesCreateRecoveryTimeout options added in
microsoft/aspire#20752, along with the ambiguous-create
recovery behavior they enable.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@aspire-repo-bot aspire-repo-bot Bot added the docs-from-code Copilot initiated issue from dotnet/aspire repo label Oct 10, 2026
@aspire-repo-bot

Copy link
Copy Markdown
Contributor Author

Frontend HTML artifact ready

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

VS Code: Open PR #1862 artifacts

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-from-code Copilot initiated issue from dotnet/aspire repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants