Add hugo and docsy site by a-mccarthy · Pull Request #1127 · kubernetes-sigs/dra-driver-nvidia-gpu

a-mccarthy · 2026-05-13T14:12:12Z

What type of PR is this?

/kind documentation

What this PR does / why we need it:

adds website infrastructure for hugo and docsy

Moves docs into a new/site folder
adds some skeleton pages to help with reviewing the site, we can remove them before publishing. There are some real concept pages content to help visualize what the pages will look like.
configures netlify.toml builds
adds default hugo builds commands, this should likely be improved to integrate better into CI or testing tooling
uses default docys setup, https://www.docsy.dev/docs/

Which issue(s) this PR is related to:

related to #1111

Special notes for your reviewer:

Does this PR introduce a user-facing change?

NONE

Additional documentation (design docs, usage docs, etc.):

Checklist

make check test passes locally
make check-generate passes if api/ changed (CRDs, deepcopy, informers, listers, clientset)
make check-modules passes if go.mod / go.sum changed
Tests added or updated for the change
Helm chart (deployments/helm) updated if flags, RBAC, or defaults changed

Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>

k8s-ci-robot · 2026-05-13T14:12:25Z

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: a-mccarthy
Once this PR has been reviewed and has the lgtm label, please assign klueska for approval. For more information see the 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:

OWNERS

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

k8s-ci-robot · 2026-05-13T14:12:26Z

Hi @a-mccarthy. Thanks for your PR.

I'm waiting for a kubernetes-sigs member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work.

Tip

We noticed you've done this a few times! Consider joining the org to skip this step and gain /lgtm and other bot rights. We recommend asking approvers on your previous PRs to sponsor you.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

netlify · 2026-05-13T14:12:28Z

✅ Deploy Preview for dra-driver-nvidia-gpu ready!

Name	Link
🔨 Latest commit	`7ca174d`
🔍 Latest deploy log	https://app.netlify.com/projects/dra-driver-nvidia-gpu/deploys/6a048f6663e7120008b1882c
😎 Deploy Preview	https://deploy-preview-1127--dra-driver-nvidia-gpu.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>

a-mccarthy · 2026-05-13T14:47:24Z

@shivamerla here is a PR with updated site tooling. please let me know your thoughts! :D

I think there is still some work to be done around making sure the build process is right and tested.

Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>

bmozaffa

Thanks, Abbie, looks great!

bmozaffa · 2026-05-15T19:12:20Z

+- **ComputeDomains** (`compute-domain.nvidia.com`) — provisions ephemeral multi-node NVLink fabrics using IMEX, enabling pods on different nodes to share GPU memory at full NVLink bandwidth.
+
+
+The [Kubernetes device plugin framework](https://kubernetes.io/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins/) treats hardware resources as opaque countable integers. A workload either gets a whole unit or it doesn't and there is no way to express sharing, per-workload configuration, capability constraints, or topology requirements within that model.


Suggested change

The [Kubernetes device plugin framework](https://kubernetes.io/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins/) treats hardware resources as opaque countable integers. A workload either gets a whole unit or it doesn't and there is no way to express sharing, per-workload configuration, capability constraints, or topology requirements within that model.

The [Kubernetes device plugin framework](https://kubernetes.io/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins/) treats hardware resources as opaque countable integers. A workload either gets a whole unit or nothing at all. The device plugin model does not provide a way to express sharing, per-workload configuration, capability constraints, or topology requirements.

bmozaffa · 2026-05-15T19:40:41Z

+
+### GPU allocation
+
+Request GPUs, MIG slices, or VFIO passthrough devices in a `ResourceClaim`, with an optional sharing strategy (time-slicing or Multi-Process Service (MPS)).


Suggested change

Request GPUs, MIG slices, or VFIO passthrough devices in a `ResourceClaim`, with an optional sharing strategy (time-slicing or Multi-Process Service (MPS)).

Request GPUs, MIG slices, or VFIO passthrough devices in a ResourceClaim, with an optional sharing strategy such as time-slicing or MPS (Multi-Process Service).

Would be nice to avoid the nested brackets?

bmozaffa · 2026-05-15T19:42:23Z

+description: DRA Driver components and request flows.
+---
+
+This repo ships two independent Kubernetes DRA drivers from one codebase:


@shivamerla is there another way to frame this?

How about something like this

gpu.nvidia.com - manages allocation of GPUs, including GPU sharing through MIG, Time-Slicing, and MPS, across both bare-metal and sandboxed environments.
compute-domain.nvidia.com - manages IMEX daemons and allocation of IMEX channel devices required for GPU memory sharing across OS domains on Multi-Node NVLink systems.

That works for me!

bmozaffa · 2026-05-15T20:12:34Z

+
+VFIO (Virtual Function I/O) passes a full physical GPU directly to a container, bypassing the NVIDIA driver stack in the host kernel. This gives the container raw hardware access and is intended for workloads that manage the GPU driver themselves, such as virtual machine managers or specialized research environments.
+
+VFIO passthrough has no sharing options, one container gets one GPU.


Suggested change

VFIO passthrough has no sharing options, one container gets one GPU.

VFIO passthrough has no sharing options; one container gets one GPU.

shivamerla · 2026-05-22T15:22:54Z

+    "postcss": "^8.4.49",
+    "postcss-cli": "^11.0.0"
+  }
+}


nit: missing newline here

shivamerla · 2026-05-22T15:23:46Z

/lgtm
/hold for resolving comments

shivamerla · 2026-05-22T15:23:53Z

/release-note-none

k8s-ci-robot · 2026-05-22T15:23:55Z

LGTM label has been added.

Details

Git tree hash: 8289181671fa8e9b07cdf3311120d0a0ca57b1b2

k8s-ci-robot · 2026-05-22T15:39:46Z

@a-mccarthy: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name	Commit	Details	Required	Rerun command
pull-dra-driver-nvidia-gpu-e2e-lambda-gpu-gh200	`7ca174d`	link	false	`/test pull-dra-driver-nvidia-gpu-e2e-lambda-gpu-gh200`

Full PR test history. Your PR dashboard. Please help us cut down on flakes by linking to an open issue when you hit one in your PR.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

Add hugo and docsy site

a07c567

Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>

github-project-automation Bot added this to DRA Driver for NVIDIA GPUs May 13, 2026

github-project-automation Bot moved this to Backlog in DRA Driver for NVIDIA GPUs May 13, 2026

k8s-ci-robot requested review from guptaNswati and shivamerla May 13, 2026 14:12

k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label May 13, 2026

k8s-ci-robot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label May 13, 2026

a-mccarthy added 2 commits May 13, 2026 10:25

update netlify

73d3248

Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>

update docs contribute docs

a3028a4

Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>

add better call outs for site tooling

7ca174d

Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>

shivamerla added this to the v0.5.0 milestone May 14, 2026

shivamerla moved this from Backlog to In Progress in DRA Driver for NVIDIA GPUs May 14, 2026

bmozaffa reviewed May 15, 2026

View reviewed changes

shivamerla reviewed May 22, 2026

View reviewed changes

k8s-ci-robot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label May 22, 2026

k8s-ci-robot assigned shivamerla May 22, 2026

k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label May 22, 2026

k8s-ci-robot added release-note-none Denotes a PR that doesn't merit a release note. and removed do-not-merge/release-note-label-needed Indicates that a PR should not merge because it's missing one of the release note labels. labels May 22, 2026

		- ComputeDomains (`compute-domain.nvidia.com`) — provisions ephemeral multi-node NVLink fabrics using IMEX, enabling pods on different nodes to share GPU memory at full NVLink bandwidth.


		The [Kubernetes device plugin framework](https://kubernetes.io/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins/) treats hardware resources as opaque countable integers. A workload either gets a whole unit or it doesn't and there is no way to express sharing, per-workload configuration, capability constraints, or topology requirements within that model.


		### GPU allocation

		Request GPUs, MIG slices, or VFIO passthrough devices in a `ResourceClaim`, with an optional sharing strategy (time-slicing or Multi-Process Service (MPS)).


		VFIO (Virtual Function I/O) passes a full physical GPU directly to a container, bypassing the NVIDIA driver stack in the host kernel. This gives the container raw hardware access and is intended for workloads that manage the GPU driver themselves, such as virtual machine managers or specialized research environments.

		VFIO passthrough has no sharing options, one container gets one GPU.

	VFIO passthrough has no sharing options, one container gets one GPU.
	VFIO passthrough has no sharing options; one container gets one GPU.

Conversation

a-mccarthy commented May 13, 2026

What type of PR is this?

What this PR does / why we need it:

Which issue(s) this PR is related to:

Special notes for your reviewer:

Does this PR introduce a user-facing change?

Additional documentation (design docs, usage docs, etc.):

Checklist

Uh oh!

k8s-ci-robot commented May 13, 2026

Uh oh!

k8s-ci-robot commented May 13, 2026

Uh oh!

netlify Bot commented May 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for dra-driver-nvidia-gpu ready!

Uh oh!

a-mccarthy commented May 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

bmozaffa left a comment

Choose a reason for hiding this comment

Uh oh!

bmozaffa May 15, 2026

Choose a reason for hiding this comment

Uh oh!

bmozaffa May 15, 2026

Choose a reason for hiding this comment

Uh oh!

bmozaffa May 15, 2026

Choose a reason for hiding this comment

Uh oh!

shivamerla May 22, 2026

Choose a reason for hiding this comment

Uh oh!

bmozaffa May 22, 2026

Choose a reason for hiding this comment

Uh oh!

bmozaffa May 15, 2026

Choose a reason for hiding this comment

Uh oh!

shivamerla May 22, 2026

Choose a reason for hiding this comment

Uh oh!

shivamerla commented May 22, 2026

Uh oh!

shivamerla commented May 22, 2026

Uh oh!

k8s-ci-robot commented May 22, 2026

Uh oh!

k8s-ci-robot commented May 22, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

netlify Bot commented May 13, 2026 •

edited

Loading

a-mccarthy commented May 13, 2026 •

edited

Loading