kata-containers/docs/design
Fabiano Fidêncio f33f2d09f7 runtime: image-pull: Make it work with nerdctl
Our code for handling images being pulled inside the guest relies on a
containerType ("sandbox" or "container") being set as part of the
container annotations, which is done by the CRI Engine being used, and
depending on the used CRI Engine we check for a specfic annotation
related to the image-name, which is then passed to the agent.

However, when running kata-containers without kubernetes, specifically
when using `nerdctl`, none of those annotations are set at all.

One thing that we can do to allow folks to use `nerdctl`, however, is to
take advantage of the `--label` flag, and document on our side that
users must pass `io.kubernetes.cri.image-name=$image_name` as part of
the label.

By doing this, and changing our "fallback" so we can always look for
such annotation, we ensure that nerdctl will work when using the nydus
snapshotter, with kata-containers, to perform image pulling inside the
pod sandbox / guest.

Signed-off-by: Fabiano Fidêncio <fabiano.fidencio@intel.com>
2024-08-06 17:07:45 +02:00
..
arch-images docs: Add a document for kata guest image management design 2024-03-25 18:17:23 +08:00
architecture docs: Update devmapper docs 2024-07-16 21:07:51 +00:00
architecture_3.0 docs: kata 3.0 Architecture 2022-10-24 11:07:34 +08:00
data agent: Remove dynamic tracing APIs 2021-11-09 08:39:06 +00:00
proposals src: reorg source directories 2021-12-14 10:30:08 +08:00
agent-systemd-cgroup.md agent: support systemd cgroup for kata agent 2022-10-25 13:57:09 +08:00
core-scheduling.md docs: describe kata handling for core-scheduling 2022-05-31 16:17:00 -07:00
direct-blk-device-assignment.md docs: change mount-info.json to mountInfo.json 2022-11-22 14:25:57 +08:00
end-to-end-flow.md docs: Remove table of contents 2021-07-30 10:58:22 +01:00
hooks-handling.md runtime-rs: move pre-start hooks to sandbox_start 2023-02-27 21:56:43 +08:00
host-cgroups.md docs: Update support for host cgroupv2 2022-07-28 10:30:44 +08:00
inotify.md docs: inotify: add initial documentation 2021-06-24 10:07:06 -07:00
kata-2-0-metrics.md kata-monitor: add a README file 2022-04-15 18:03:23 +02:00
kata-api-design.md docs: Remove table of contents 2021-07-30 10:58:22 +01:00
kata-design-requirements.md docs: use containerd to replace cri-containerd 2021-10-19 09:38:56 +08:00
kata-guest-image-management-design.md runtime: image-pull: Make it work with nerdctl 2024-08-06 17:07:45 +02:00
kata-metrics-in-runtime-rs.md runtime-rs: add support for gather metrics in runtime-rs 2023-07-28 17:16:51 +08:00
kata-nydus-design.md docs: Update url links in kata nydus document 2024-07-23 17:49:12 +00:00
kata-vra.md metrics: Fix general check static warnings 2023-09-26 16:30:59 +00:00
README.md runtime-rs: add support for gather metrics in runtime-rs 2023-07-28 17:16:51 +08:00
vcpu-handling-runtime-go.md doc: add vcpu handlint doc for runtime-rs 2023-06-12 19:23:11 +08:00
vcpu-handling-runtime-rs.md doc: add vcpu handlint doc for runtime-rs 2023-06-12 19:23:11 +08:00
vcpu-threads-pinning.md runtime: added vcpus pinning logics 2022-11-04 17:52:42 +08:00
virtualization.md docs: Update docs for new StratoVirt VMM introduction 2024-01-04 14:26:48 +08:00
VSocks.md doc: add vcpu handlint doc for runtime-rs 2023-06-12 19:23:11 +08:00