Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve CDH docs #518

Merged
merged 3 commits into from
Mar 25, 2024
Merged

Improve CDH docs #518

merged 3 commits into from
Mar 25, 2024

Conversation

wainersm
Copy link
Member

Sending a few improvements to the CDH docs:

  • CDH: document the configuration heuristic
  • CDH: document resources services

Cc @fitzthum @Xynnn007

@wainersm wainersm requested a review from sameo as a code owner March 22, 2024 20:49
Copy link
Member

@Xynnn007 Xynnn007 left a comment

Choose a reason for hiding this comment

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

Thanks @wainersm for this guide. I think the link ci error will be green once this merged.

Copy link
Member

@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.

Two nits but otherwise looks good


## Example: offline_fs_kbc

In this example we will use the `offline_fs_kbc` KBC to get resouces from the local filesystem.
Copy link
Member

Choose a reason for hiding this comment

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

Maybe mention here that this example is not running with k8s or a VM or anything. Also minor typo resouces -> resources.

Copy link
Member Author

Choose a reason for hiding this comment

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

good idea

* **agent.aa_kbc_params** parameter from the Kernel command-line (`/proc/cmdline`)

There is a special case which is when running from [peer pods](http://github.com/confidential-containers/cloud-api-adaptor). It
will try to read from the kata-agent file (**/etc/agent-config.toml** or **KATA_AGENT_CONFIG_PATH** environment variable) pior
Copy link
Member

Choose a reason for hiding this comment

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

nit: pior -> prior.

Copy link
Member Author

Choose a reason for hiding this comment

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

curiosity: PT_BR("pior") == EN_US("worst")

@wainersm wainersm force-pushed the cdh_docs branch 2 times, most recently from 894cb23 to 77f147f Compare March 25, 2024 15:00
@wainersm
Copy link
Member Author

addressed @fitzthum 's comments

Created docs/RESOURCES_SERVICES.md to document the resources API and services.
Added an example of how to run locally with `offline_fs_kbc`.

Signed-off-by: Wainer dos Santos Moschetta <[email protected]>
Complement the CDH's README.md with information about the logic it uses
to get configured on the absence of an explicity configuration file passed.

Signed-off-by: Wainer dos Santos Moschetta <[email protected]>
It is missing CDH from the list of components on the main README.

Signed-off-by: Wainer dos Santos Moschetta <[email protected]>
@fitzthum fitzthum merged commit d14c013 into confidential-containers:main Mar 25, 2024
4 checks passed
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.

3 participants