Skip to content

docs: add generic xpu topology-aware scheduling design - #5965

Open
miantalha45 wants to merge 4 commits into
volcano-sh:masterfrom
miantalha45:docs/generic-xpu-topology-aware-scheduling-design
Open

miantalha45 wants to merge 4 commits into
volcano-sh:masterfrom
miantalha45:docs/generic-xpu-topology-aware-scheduling-design

Conversation

@miantalha45

Copy link
Copy Markdown
Contributor

What type of PR is this?

/kind documentation

What this PR does / why we need it:

Adds a design proposal for generic xPU topology-aware scheduling in Volcano.

It defines the proposed topology provider, canonical topology cache, workload API, scheduling behavior, adapter contract, readiness and freshness handling, security model, compatibility boundaries, rollout plan, and validation strategy.

AI assistance was used to help structure and edit this design document. I reviewed the final content and take responsibility for it.

Which issue(s) this PR fixes:

Related to #5751

Special notes for your reviewer:

Does this PR introduce a user-facing change?

NONE

Copilot AI balanced review requested due to automatic review settings September 11, 2026 05:58
@volcano-sh-bot volcano-sh-bot added the kind/documentation Categorizes issue or PR as related to documentation. label Sep 11, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review any files in this pull request.


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@volcano-sh-bot

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign k82cn for approval. For more information see the Kubernetes Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@volcano-sh-bot volcano-sh-bot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label Sep 11, 2026
Signed-off-by: Talha Amjad <myown4500@gmail.com>
@miantalha45
miantalha45 force-pushed the docs/generic-xpu-topology-aware-scheduling-design branch from ad7b82c to 3269577 Compare September 11, 2026 05:59
@miantalha45

Copy link
Copy Markdown
Contributor Author

/cc @JesseStutler @hajnalmt @devzizu

@devzizu devzizu left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for this @miantalha45‚it's a serious piece of work, and the level of detail is well beyond what I expected at this stage. I've done a first pass and left comments inline, but I still have some sections to go through in the next few days.

Comment thread docs/design/generic-xpu-topology-aware-scheduling.md Outdated
Comment thread docs/design/generic-xpu-topology-aware-scheduling.md Outdated
Comment thread docs/design/generic-xpu-topology-aware-scheduling.md Outdated
Comment thread docs/design/generic-xpu-topology-aware-scheduling.md Outdated
Comment thread docs/design/generic-xpu-topology-aware-scheduling.md Outdated
Comment thread docs/design/generic-xpu-topology-aware-scheduling.md Outdated
Comment thread docs/design/generic-xpu-topology-aware-scheduling.md Outdated
Comment thread docs/design/generic-xpu-topology-aware-scheduling.md
Comment thread docs/design/generic-xpu-topology-aware-scheduling.md Outdated
Comment thread docs/design/generic-xpu-topology-aware-scheduling.md Outdated
Align the topology view with SchedulerCache snapshots, clarify
provider and canonical identity contracts, define policy lifecycle
and failure reporting, and refine compact allocation behavior.

Signed-off-by: Talha Amjad <myown4500@gmail.com>
@miantalha45

Copy link
Copy Markdown
Contributor Author

thank you so much @devzizu for this detailed review. I have addressed all your comments and also made a lot of changes in document. Kindly have a look on it again now.

Signed-off-by: Talha Amjad <myown4500@gmail.com>
@miantalha45
miantalha45 requested a review from devzizu September 18, 2026 11:58
Signed-off-by: Talha Amjad <myown4500@gmail.com>
@miantalha45

Copy link
Copy Markdown
Contributor Author

Hi @JesseStutler @hajnalmt @devzizu @wangyang0616
I have added the proposed subgroup xPU topology design, including policy API, scheduling flow, and reservation semantics. the document is ready for review from my side. Please share any feedback before I begin implementation.

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

Labels

kind/documentation Categorizes issue or PR as related to documentation. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants