Skip to content

Conversation

@lauralorenz
Copy link
Contributor

Add code docs describing kubelet sync loops with code deep links, as well as testing information. Words and thoughts are actually all plagiarized from @tallclair.

Which issue(s) this PR fixes:

No specific issue.

Signed-off-by: lauralorenz <[email protected]>
Signed-off-by: lauralorenz <[email protected]>
@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Jan 28, 2026
@lauralorenz
Copy link
Contributor Author

/assign @tallclair

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: lauralorenz
Once this PR has been reviewed and has the lgtm label, please assign dchen1107 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:

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 k8s-ci-robot added the area/developer-guide Issues or PRs related to the developer guide label Jan 28, 2026
@k8s-ci-robot k8s-ci-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. sig/contributor-experience Categorizes an issue or PR as relevant to SIG Contributor Experience. sig/node Categorizes an issue or PR as relevant to SIG Node. labels Jan 28, 2026

The Kubelet **orchestrates** the Pod spec into running processes on the host via
the **Container Runtime Interface (CRI)**. The runtime (e.g., containerd)
translates these requests into OCI specs for `runc`, which handles the low-level
Copy link
Contributor

Choose a reason for hiding this comment

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

for an OCI runtime (e.g. runc) maybe?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Updated in 1e0356e

The Kubelet **orchestrates** the Pod spec into running processes on the host via
the **Container Runtime Interface (CRI)**. The runtime (e.g., containerd)
translates these requests into OCI specs for `runc`, which handles the low-level
host syscalls.
Copy link
Contributor

Choose a reason for hiding this comment

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

hm host syscalls doesn't feel fully correct here. Maybe which handles the low-level operating system setup for the container or something

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I looked around OCI website and https://github.com/opencontainers/runtime-spec for a more precise way to say this but I can't (the word container is so overused 😓 ). Updated to use your wording in ba96155.

@haircommander
Copy link
Contributor

this is excellent! a couple of notes, but it's a great addition overall!

Signed-off-by: lauralorenz <[email protected]>
Signed-off-by: lauralorenz <[email protected]>
@haircommander
Copy link
Contributor

/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jan 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/developer-guide Issues or PRs related to the developer guide cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. lgtm "Looks good to me", indicates that a PR is ready to be merged. sig/contributor-experience Categorizes an issue or PR as relevant to SIG Contributor Experience. sig/node Categorizes an issue or PR as relevant to SIG Node. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants