WIP: NVIDIA-918: Add NVIDIA DPF Operator documentation by Shivank-rh · Pull Request #117002 · openshift/openshift-docs

Shivank-rh · 2026-07-30T18:12:35Z

Summary

Converts the NVIDIA DPF (DOCA Platform Framework) v26.4 installation manual into modular AsciiDoc
DPF enables hardware-accelerated OVN-Kubernetes networking by offloading data plane operations to NVIDIA BlueField-3 DPUs on OpenShift 4.22
7 assemblies in networking/networking_operators/dpf_operator/, 59 modules in modules/, 2 images, topic map entry

Structure

Assembly	Content
`about-dpf-operator`	Architecture overview, component placement, requirements
`dpf-environment-setup`	Management cluster setup, prerequisite operators
`dpf-operator-installation`	DPF Operator install, DPU resources, DPU services
`dpf-hosted-cluster-provisioning`	DPU hosted cluster via dpf-hcp-provisioner
`dpf-worker-nodes-provisioning`	OVN-K CNI adjustments, adding workers, DPU provisioning
`dpf-validation-telemetry`	Traffic validation, DTS observability
`dpf-troubleshooting`	DPU provisioning issues, unsupported OVN-K features

Items for reviewer

TOC bits need to be added by the reviewer
TODO comments flag areas needing engineering verification: BFB registry auth, TP vs GA in Ch 12
Cross-references to existing OCP docs use xref: placeholders — need anchor ID verification
Source uses "management cluster" and "host cluster" interchangeably — standardized on "management cluster"

Test plan

Verify all include:: paths resolve
Verify topic map renders correctly
Review Vale compliance
Cross-check code examples against DPF v26.4 source

🤖 Generated with Claude Code

Convert the NVIDIA DPF (DOCA Platform Framework) v26.4 installation manual into modular AsciiDoc for openshift-docs. DPF enables hardware-accelerated OVN-Kubernetes networking by offloading data plane operations to NVIDIA BlueField-3 DPUs on OpenShift 4.22. Content: - 7 assemblies in networking/networking_operators/dpf_operator/ - 59 modules (44 procedure, 10 reference, 5 concept) in modules/ - 2 architecture diagram images - Topic map entry after the existing DPU Operator section Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

openshift-ci-robot · 2026-07-30T18:12:40Z

@Shivank-rh: This pull request references NVIDIA-918 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the epic to target the "5.0.0" version, but no target version was set.

Details

In response to this:

Summary

Converts the NVIDIA DPF (DOCA Platform Framework) v26.4 installation manual into modular AsciiDoc

DPF enables hardware-accelerated OVN-Kubernetes networking by offloading data plane operations to NVIDIA BlueField-3 DPUs on OpenShift 4.22

7 assemblies in networking/networking_operators/dpf_operator/, 59 modules in modules/, 2 images, topic map entry

Structure

Assembly Content

about-dpf-operator Architecture overview, component placement, requirements

dpf-environment-setup Management cluster setup, prerequisite operators

dpf-operator-installation DPF Operator install, DPU resources, DPU services

dpf-hosted-cluster-provisioning DPU hosted cluster via dpf-hcp-provisioner

dpf-worker-nodes-provisioning OVN-K CNI adjustments, adding workers, DPU provisioning

dpf-validation-telemetry Traffic validation, DTS observability

dpf-troubleshooting DPU provisioning issues, unsupported OVN-K features

Items for reviewer

TOC bits need to be added by the reviewer

TODO comments flag areas needing engineering verification: BFB registry auth, TP vs GA in Ch 12

Cross-references to existing OCP docs use xref: placeholders — need anchor ID verification

Source uses "management cluster" and "host cluster" interchangeably — standardized on "management cluster"

Test plan

Verify all include:: paths resolve

Verify topic map renders correctly

Review Vale compliance

Cross-check code examples against DPF v26.4 source

🤖 Generated with Claude Code

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci · 2026-07-30T18:13:30Z

Hi @Shivank-rh. Thanks for your PR.

I'm waiting for a openshift 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.

Regular contributors should join the org to skip this step.

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.

Shivank-rh · 2026-07-30T18:16:01Z

@gaurav-nelson Took an initial pass at generating reformatted docs!

gaurav-nelson · 2026-07-31T01:19:24Z

/ok-to-test

ocpdocs-previewbot · 2026-07-31T01:30:34Z

🤖 Fri Jul 31 14:19:38 - Prow CI generated the docs preview:

https://117002--ocpdocs-pr.netlify.app/openshift-enterprise/latest/networking/networking_operators/dpf_operator/about-dpf-operator.html
https://117002--ocpdocs-pr.netlify.app/openshift-enterprise/latest/networking/networking_operators/dpf_operator/dpf-environment-setup.html
https://117002--ocpdocs-pr.netlify.app/openshift-enterprise/latest/networking/networking_operators/dpf_operator/dpf-hosted-cluster-provisioning.html
https://117002--ocpdocs-pr.netlify.app/openshift-enterprise/latest/networking/networking_operators/dpf_operator/dpf-operator-installation.html
https://117002--ocpdocs-pr.netlify.app/openshift-enterprise/latest/networking/networking_operators/dpf_operator/dpf-troubleshooting.html
https://117002--ocpdocs-pr.netlify.app/openshift-enterprise/latest/networking/networking_operators/dpf_operator/dpf-validation-telemetry.html
https://117002--ocpdocs-pr.netlify.app/openshift-enterprise/latest/networking/networking_operators/dpf_operator/dpf-worker-nodes-provisioning.html

ocpdocs-vale-bot · 2026-07-31T01:32:13Z

+include::modules/nw-dpf-management-cluster-setup.adoc[leveloffset=+1]
+
+[id="configuring-worker-nodes_{context}"]
+== Configuring worker nodes


🤖 [error] AsciiDocDITA.AssemblyContents: Content other than additional resources cannot follow include directives.

ocpdocs-vale-bot · 2026-07-31T01:32:16Z

+toc::[]
+
+[role="_abstract"]
+The `dpf-hcp-provisioner-operator` automates the creation and lifecycle management of a HyperShift hosted cluster for DPU nodes. This operator abstracts the complexity of setting up a hosted control plane for the DPU cluster.


🤖 [error] RedHat.TermsErrors: Use 'hosted control planes' rather than 'HyperShift'. For more information, see RedHat.TermsErrors.

ocpdocs-vale-bot · 2026-07-31T01:32:19Z

+include::modules/nw-dpf-installing-dpf-operator.adoc[leveloffset=+1]
+
+[id="creating-dpf-resources_{context}"]
+== Creating DPF resources


🤖 [error] AsciiDocDITA.AssemblyContents: Content other than additional resources cannot follow include directives.

ocpdocs-vale-bot · 2026-07-31T01:32:24Z

+include::modules/nw-dpf-running-traffic-validation.adoc[leveloffset=+2]
+
+[id="dpu-telemetry_{context}"]
+== Configuring DPU telemetry


🤖 [error] AsciiDocDITA.AssemblyContents: Content other than additional resources cannot follow include directives.

ocpdocs-vale-bot · 2026-07-31T01:32:27Z

+include::modules/nw-dpf-enabling-ovnk-dpu-host-mode.adoc[leveloffset=+2]
+
+[id="adding-worker-nodes_{context}"]
+== Adding worker nodes


🤖 [error] AsciiDocDITA.AssemblyContents: Content other than additional resources cannot follow include directives.

Move inline section headings from 4 assembly files into dedicated concept modules to satisfy AsciiDocDITA.AssemblyContents rule. Replace 'HyperShift' with 'hosted control planes' in dpf-hosted-cluster-provisioning.adoc. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

openshift-ci · 2026-07-31T14:22:16Z

@Shivank-rh: all tests passed!

Full PR test history. Your PR dashboard.

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.

gaurav-nelson · 2026-08-03T02:38:31Z

Closing this in favor of #117142

I wasn't able to push to this branch, even though i have maintainer rights:

git push Shivank-rh NVIDIA-918-dpf-operator-docs -f
error: Authentication error: Authentication required: You must have push access to verify locks
error: failed to push some refs to 'github.com:Shivank-rh/openshift-docs.git'

openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label Jul 30, 2026

openshift-ci Bot added ok-to-test Indicates a non-member PR verified by an org member that is safe to test. and removed needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels Jul 31, 2026

ocpdocs-vale-bot reviewed Jul 31, 2026

View reviewed changes

gaurav-nelson mentioned this pull request Aug 3, 2026

NVIDIA-918: Add NVIDIA DPF Operator documentation #117142

Open

4 tasks

gaurav-nelson closed this Aug 3, 2026

Uh oh!

Conversation

Shivank-rh commented Jul 30, 2026

Summary

Structure

Items for reviewer

Test plan

Uh oh!

openshift-ci-robot commented Jul 30, 2026 • edited by openshift-ci Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Structure

Items for reviewer

Test plan

Uh oh!

openshift-ci Bot commented Jul 30, 2026

Uh oh!

Shivank-rh commented Jul 30, 2026

Uh oh!

gaurav-nelson commented Jul 31, 2026

Uh oh!

ocpdocs-previewbot commented Jul 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ocpdocs-vale-bot Jul 31, 2026

Choose a reason for hiding this comment

Uh oh!

ocpdocs-vale-bot Jul 31, 2026

Choose a reason for hiding this comment

Uh oh!

ocpdocs-vale-bot Jul 31, 2026

Choose a reason for hiding this comment

Uh oh!

ocpdocs-vale-bot Jul 31, 2026

Choose a reason for hiding this comment

Uh oh!

ocpdocs-vale-bot Jul 31, 2026

Choose a reason for hiding this comment

Uh oh!

openshift-ci Bot commented Jul 31, 2026

Uh oh!

gaurav-nelson commented Aug 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

openshift-ci-robot commented Jul 30, 2026 •

edited by openshift-ci Bot

Loading

ocpdocs-previewbot commented Jul 31, 2026 •

edited

Loading