Skip to content

Init pass at restructuring CoCo TOC#385

Open
a-mccarthy wants to merge 2 commits into
NVIDIA:mainfrom
a-mccarthy:coco-strucutre
Open

Init pass at restructuring CoCo TOC#385
a-mccarthy wants to merge 2 commits into
NVIDIA:mainfrom
a-mccarthy:coco-strucutre

Conversation

@a-mccarthy
Copy link
Copy Markdown
Collaborator

@a-mccarthy a-mccarthy commented Apr 30, 2026

The deployment guide has grown quite long. this is a draft attempt at splitting up the content into a more useable form.

@a-mccarthy a-mccarthy marked this pull request as draft April 30, 2026 15:27
@github-actions
Copy link
Copy Markdown

Documentation preview

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

@a-mccarthy a-mccarthy changed the title Init pass at restructuring TOC Init pass at restructuring CoCo TOC Apr 30, 2026
Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>
Signed-off-by: Abigail McCarthy <20771501+a-mccarthy@users.noreply.github.com>
@a-mccarthy a-mccarthy marked this pull request as ready for review May 12, 2026 15:41

resources:
limits:
nvidia.com/GH100_H200_141GB: "1"
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

confirm this is a valid gpu name on a node

If you need a timeout of more than 1200 seconds, you will also need to adjust Kata Agent Policy's ``image_pull_timeout`` value which controls the agent-side timeout for guest-image pull.
To do this, add the ``agent.image_pull_timeout`` kernel parameter to your shim configuration, or pass an explicit value in a pod annotation in the ``io.katacontainers.config.hypervisor.kernel_params: "..."`` annotation.

"nvidia.com/GH100_H200_141GB": "1"
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

confirm this output.

@a-mccarthy a-mccarthy requested a review from manuelh-dev May 18, 2026 20:23
This page is an educational overview of attestation with Confidential Containers, not a complete configuration guide.
The attestation workflow is fully documented in the upstream `Confidential Containers documentation <https://confidentialcontainers.org/docs/attestation/>`_, which is the source of truth for setup and configuration details.

Attestation is not required to deploy Confidential Containers, but is required for features that rely on secrets in your cluster.
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.

nit/thought: would we say it's not required to deploy workloads for evaluation purposes but it is required for ensuring/proving the confidentiality guarantees?

As of now, it sounds a bit like: As long as you don't need secrets, you don't need attestation. That is a bit odd.

*****************************************

Confidential Containers enables sensible default attestation policies for NVIDIA Confidential Computing GPUs.
In most cases, the default policy is appropriate and you only need to provide reference values.
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.

"In most cases, the default policy is appropriate and you only need to provide reference values." - this is unclear to me. Can we say what the default policy is - or ... remove this?


*****************************************************
#####################################################
NVIDIA Confidential Containers Reference Architecture
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.

I am thinking of whether it is possible to make the aspects
"Supported Features and Deployment Scenarios" and "Limitations and Restrictions" a bit more prominent. These get a bit buried in the already lengthy overview page. Maybe we can relocate these two into a different main page (or even create a separate main page)?

Copy link
Copy Markdown
Contributor

@manuelh-dev manuelh-dev left a comment

Choose a reason for hiding this comment

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

LGTM, left just a few comments, feel free to resolve these if these don't seem immediately helpful

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.

2 participants