Skip to content

Update docs for coco GA release#365

Open
a-mccarthy wants to merge 6 commits intoNVIDIA:mainfrom
a-mccarthy:coco-26.3.0
Open

Update docs for coco GA release#365
a-mccarthy wants to merge 6 commits intoNVIDIA:mainfrom
a-mccarthy:coco-26.3.0

Conversation

@a-mccarthy
Copy link
Copy Markdown
Collaborator

No description provided.

@github-actions
Copy link
Copy Markdown

Documentation preview

https://nvidia.github.io/cloud-native-docs/review/pr-365

Comment thread gpu-operator/kata-containers-deploy.rst Outdated
Comment thread gpu-operator/kata-containers-deploy.rst Outdated
Comment thread gpu-operator/kata-containers-deploy.rst Outdated
Comment thread gpu-operator/kata-containers-deploy.rst Outdated
Comment thread confidential-containers/overview.rst
Comment thread confidential-containers/overview.rst
Comment thread confidential-containers/overview.rst Outdated
Comment thread confidential-containers/overview.rst Outdated
Comment thread confidential-containers/overview.rst Outdated
Comment thread confidential-containers/overview.rst Outdated
Comment thread confidential-containers/overview.rst Outdated
Comment thread confidential-containers/overview.rst Outdated
Comment thread confidential-containers/overview.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread confidential-containers/confidential-containers-deploy.rst Outdated
Comment thread confidential-containers/confidential-containers-deploy.rst Outdated
Comment thread confidential-containers/confidential-containers-deploy.rst
Comment thread confidential-containers/confidential-containers-deploy.rst Outdated
Comment thread confidential-containers/attestation.rst Outdated
Comment thread confidential-containers/overview.rst
Comment thread confidential-containers/confidential-containers-deploy.rst Outdated
Copy link
Copy Markdown

@fitzthum fitzthum left a comment

Choose a reason for hiding this comment

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

A few comments on the attestation stuff.

Comment thread confidential-containers/attestation.rst Outdated
Comment thread confidential-containers/attestation.rst Outdated
Comment thread confidential-containers/attestation.rst Outdated
Comment thread confidential-containers/attestation.rst Outdated
@zvonkok zvonkok requested review from Copilot and removed request for Hema-Bontha-NV April 2, 2026 21:20
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the documentation set to reflect the Confidential Containers (CoCo) GA / Reference Architecture release, including new pages and updated navigation/redirects to surface the new content.

Changes:

  • Updated GPU Operator docs navigation and redirects to point to new Confidential Containers deployment content.
  • Added new Confidential Containers documentation pages (deploy guide, attestation, licensing, supported platforms).
  • Refreshed the Confidential Containers overview content to remove Early Access framing and expand details.

Reviewed changes

Copilot reviewed 9 out of 10 changed files in this pull request and generated 13 comments.

Show a summary per file
File Description
repo.toml Updates redirect rules related to Confidential Containers pages.
gpu-operator/index.rst Adds a nav entry to the new GPU Operator Confidential Containers page.
gpu-operator/getting-started.rst Minor formatting-only adjustment in a table row.
gpu-operator/confidential-containers-deploy.rst New GPU Operator page linking out to the Confidential Containers RA docs.
confidential-containers/index.rst Updates Confidential Containers landing page nav and cards for GA structure.
confidential-containers/overview.rst Reworks overview content to GA/RA framing and expands sections.
confidential-containers/supported-platforms.rst New supported platforms and component versions page.
confidential-containers/confidential-containers-deploy.rst New end-to-end deployment guide for CoCo with GPU Operator + Kata.
confidential-containers/attestation.rst New attestation configuration page (Trustee + NVIDIA verifier).
confidential-containers/licensing.rst New licensing info page for NVIDIA Confidential Computing capability.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread confidential-containers/confidential-containers-deploy.rst
Comment thread confidential-containers/attestation.rst
Comment thread confidential-containers/licensing.rst
Comment thread confidential-containers/supported-platforms.rst
Comment thread confidential-containers/confidential-containers-deploy.rst Outdated
Comment thread confidential-containers/attestation.rst Outdated
Comment thread confidential-containers/supported-platforms.rst
Comment thread confidential-containers/overview.rst Outdated
Comment thread confidential-containers/overview.rst
Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>
Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>
Comment thread confidential-containers/overview.rst
* Image signature verification for signed multi-arch images is currently not supported.
* For both single and multi GPU Passthrough, all GPUs on the host must be configured for Confidential Computing and all GPUs must be assigned to one Confidential Container virtual machine.
Configuring only some GPUs on a node for Confidential Computing is not supported.

Copy link
Copy Markdown

@dcmiddle dcmiddle Apr 10, 2026

Choose a reason for hiding this comment

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

Suggested change
Security Considerations
Application Security Defects: Confidential Computing does not protect against threats within the confidential VM including vulnerabilities in the Application itself. Applications must still follow security best practices such as input validation.
Control Plane: CoCo provides a number of protections to limit the influence of the K8s Control Plane. Applications may expose themselves to attack if they rely upon control plane managed configuration.
Environment Variables and ConfigMaps: Unless provisioned as sealed secrets using Trustee, orchestrator-provided environment variables and ConfigMaps remain untrusted and susceptible to manipulation.
Storage and Volume Mounts: Manipulating volume mounts can expose the workload to malicious untrusted host storage or deny access to required persistent data.
Physical Attacks: Confidential Computing considers most physical attacks out of scope. Your kubernetes hosts should be in physically secure datacenters.
Availability: Confidential Computing does not provide availability guarantees. Availability is achieved through replication which is a common aspect of k8s deployments.

* NFD doesn't label all Confidential Container capable nodes as such automatically. In some cases, users must manually label nodes to deploy the NVIDIA Confidential Computing Manager for Kubernetes operand onto these nodes as described in the deployment guide.
* Image signature verification for signed multi-arch images is currently not supported.
* For both single and multi GPU Passthrough, all GPUs on the host must be configured for Confidential Computing and all GPUs must be assigned to one Confidential Container virtual machine.
Configuring only some GPUs on a node for Confidential Computing is not supported.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Suggested change
Configuring only some GPUs on a node for Confidential Computing is not supported.
Configuring only some GPUs on a node for Confidential Computing is not supported.
CoCo provides its own virtualization based on Kata Containers. CoCo cannot run within an existing virtualized environment, i.e., nested virtualization is not supported. CoCo must be installed on the host not within a guest VM.

Comment thread confidential-containers/overview.rst Outdated
Copy link
Copy Markdown
Collaborator Author

@a-mccarthy a-mccarthy left a comment

Choose a reason for hiding this comment

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

test

Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Copy link
Copy Markdown
Collaborator Author

@a-mccarthy a-mccarthy left a comment

Choose a reason for hiding this comment

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

test

Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Copy link
Copy Markdown
Collaborator

@chenopis chenopis left a comment

Choose a reason for hiding this comment

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

Documentation Review — 13 findings (1 critical)

Critical issues must be resolved before merge.

Review generated with AI assistance.

Comment thread gpu-operator/confidential-containers-deploy.rst Outdated
Comment thread confidential-containers/confidential-containers-deploy.rst Outdated
Comment thread confidential-containers/supported-platforms.rst
Comment thread confidential-containers/supported-platforms.rst Outdated
Comment thread confidential-containers/confidential-containers-deploy.rst Outdated
Comment thread confidential-containers/confidential-containers-deploy.rst Outdated
Comment thread gpu-operator/confidential-containers-deploy.rst
Comment thread confidential-containers/confidential-containers-deploy.rst
Comment thread confidential-containers/overview.rst Outdated
.. note::

The following topics in the deployment guide apply to a cloud-native environment:
For both single and multi GPU Passthrough, all GPUs on the host must be configured for Confidential Computing and all GPUs must be assigned to one Confidential Container virtual machine.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Low — Duplicate content: This same limitation note ("all GPUs on the host must be configured...") also appears verbatim in the Limitations section at line 213 below. Consider removing one instance to avoid duplication within the same page. (The note also appears in supported-platforms.rst, which is fine for cross-page emphasis.)

Comment thread confidential-containers/overview.rst Outdated
Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>
Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>
You must assign all the GPUs and NVSwitches on the node in your manifest to the same Confidential Container virtual machine.

On the NVIDIA Hopper architecture multi-GPU passthrough uses protected PCIe (PPCIE) which claims exclusive use of the NVSwitches for a single Confidential Container virtual machine (CVM).
When using NVIDIA Hopper nodes for multi-GPU passthrough, transition your relevant node's GPU Confidential Computing mode to ``ppcie`` mode by adding the ``nvidia.com/cc.mode=ppcie`` label.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

nit

Suggested change
When using NVIDIA Hopper nodes for multi-GPU passthrough, transition your relevant node's GPU Confidential Computing mode to ``ppcie`` mode by adding the ``nvidia.com/cc.mode=ppcie`` label.
When using NVIDIA Hopper nodes for multi-GPU passthrough, transition your relevant node's GPU Confidential Computing mode to ``ppcie`` mode by applying the ``nvidia.com/cc.mode=ppcie`` label.

- Disable Confidential Containers.
- cluster-wide default, node-level override
* - ``ppcie``
- Enable Confidential Containers with multi-GPU passthrough on HGX GPUs.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

HGX is a platform type which can have hopper or blackwell.

Suggested change
- Enable Confidential Containers with multi-GPU passthrough on HGX GPUs.
- Enable Confidential Containers with multi-GPU passthrough for Hopper GPUs.

Comment on lines +484 to +490
- Enable Confidential Containers.
- cluster-wide default, node-level override
* - ``off``
- Disable Confidential Containers.
- cluster-wide default, node-level override
* - ``ppcie``
- Enable Confidential Containers with multi-GPU passthrough on HGX GPUs.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

/Containers/Computing

The CC mode is the Confidential Computing mode of the GPU

Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>
Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants