kata-containers/README.md
James O. D. Hunt 09373bd2b4 docs: Fix anchor for osbuilder
The HTML anchor generated by github for "osbuilder" wasn't working, so
removed the slash from the title.

Signed-off-by: James O. D. Hunt <james.o.hunt@intel.com>
2018-02-02 10:16:34 +00:00

3.8 KiB

Kata Containers


Welcome to Kata Containers!

The purpose of this repository is to act as a "top level" site for the project. Specifically it is used:

Raising issues

This repository is used for raising issues:

  • That might affect multiple code repositories.

  • Where the raiser is unsure which repositories are affected.

Note:

  • If an issue affects only a single component, it should be raised in that components repository.

Kata Containers repositories

Community

The Community repository is the first place to go if you want to use or contribute to the project.

Code Repositories

Kata Containers-developed components

Agent

The kata-agent runs inside the virtual machine and sets up the container environment.

KSM throttler

The kata-ksm-throttler is an optional utility that monitors containers and deduplicates memory to maximize container density on a host.

Proxy

The kata-proxy is a process that runs on the host and co-ordinates access to the agent running inside the virtual machine.

Runtime

The kata-runtime is usually invoked by a container manager and provides high-level verbs to manage containers.

Shim

The kata-shim is a process that runs on the host. It acts as though it is the workload (which actually runs inside the virtual machine). This shim is required to be compliant with the expectations of the OCI runtime specification.

Additional

Hypervisor

The qemu hypervisor is used to create virtual machines for hosting the containers.

Kernel

The Linux* kernel is used by the hypervisor to boot the guest image.

Documentation

The documentation repository hosts documentation common to all code components.

Test code

The tests repository hosts all test code except the unit testing code (which is kept in the same repository as the component it tests).

Utilities

OS builder

The osbuilder tool can create a rootfs and a "mini O/S" image. This image is used by the hypervisor to setup the environment before switching to the workload.

Web content

The www.katacontainers.io repository contains all sources for the https://www.katacontainers.io site.