diff --git a/Limitations.md b/Limitations.md index 5a4ff50ee..b82676d9f 100644 --- a/Limitations.md +++ b/Limitations.md @@ -138,7 +138,7 @@ these commands is potentially challenging. See issue https://github.com/clearcontainers/runtime/issues/341 and [the constraints challenge](#the-constraints-challenge) for more information. For CPUs resource management see -[cpu-constraints](constraints/cpu.md). +[cpu-constraints](design/cpu-constraints.md). ### docker run and shared memory diff --git a/README.md b/README.md index e017ef2ab..81bc07abf 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ For details of the other Kata Containers repositories, see the [`runc`](https://github.com/opencontainers/runc). * HOWTO: [Kata Containers with k8s and cri-containerd](./how-to/how-to-use-k8s-with-cri-containerd-and-kata.md) -* HOWTO: [OpenStack Zun with Kata Containers](zun/zun_kata.md) +* HOWTO: [OpenStack Zun with Kata Containers](./use-cases/zun_kata.md) * HOWTO: [Kata Containers with Firecracker](https://github.com/kata-containers/documentation/wiki/Initial-release-of-Kata-Containers-with-Firecracker-support) * HOWTO: [Sysctls with Kata Containers](./how-to/how-to-use-sysctls-with-kata.md) * HOWTO: [VM Templating](./how-to/what-is-vm-cache-and-how-do-I-use-it.md) and [VM Cache](./how-to/what-is-vm-cache-and-how-do-I-use-it.md) @@ -35,7 +35,7 @@ Documents that help to understand and contribute to Kata Containers. ### Design and Implementations -* [Kata Containers Architecture](architecture.md): Architectural overview of Kata Containers +* [Kata Containers Architecture](design/architecture.md): Architectural overview of Kata Containers * [Kata Containers design](./design/README.md): More Kata Containers design documents ### How to Contribute diff --git a/Upgrading.md b/Upgrading.md index 7379ff926..26fec2187 100644 --- a/Upgrading.md +++ b/Upgrading.md @@ -142,7 +142,7 @@ standard package management tools for your distribution. Kata Containers requires additional resources to create a virtual machine container. These resources are called -[Kata Containers assets](https://github.com/kata-containers/documentation/blob/master/architecture.md#assets), +[Kata Containers assets](./design/architecture.md#assets), which comprise a guest kernel and a root filesystem or initrd image. This section describes when these components are updated. diff --git a/design/README.md b/design/README.md index 6c4bb3289..fb0000c5f 100644 --- a/design/README.md +++ b/design/README.md @@ -2,7 +2,7 @@ Kata Containers design documentations, include the -- [Kata Containers architecture](../architecture.md) +- [Kata Containers architecture](architecture.md) - Working scenarios of Kata Containers - [API Design of Kata Containers](kata-api-design.md) - Kata Containers lifecycle diff --git a/VSocks.md b/design/VSocks.md similarity index 97% rename from VSocks.md rename to design/VSocks.md index 302531592..4383bc167 100644 --- a/VSocks.md +++ b/design/VSocks.md @@ -130,5 +130,5 @@ the containers are removed automatically. [2]: https://github.com/kata-containers/proxy [3]: https://github.com/hashicorp/yamux [4]: https://wiki.qemu.org/Features/VirtioVsock -[5]: https://github.com/kata-containers/documentation/blob/master/constraints/cpu.md#virtual-cpus-and-kubernetes-pods +[5]: ./cpu-constraints.md#virtual-cpus-and-kubernetes-pods [6]: https://github.com/kata-containers/shim diff --git a/arch-images/CNM_detailed_diagram.png b/design/arch-images/CNM_detailed_diagram.png similarity index 100% rename from arch-images/CNM_detailed_diagram.png rename to design/arch-images/CNM_detailed_diagram.png diff --git a/arch-images/CNM_overall_diagram.png b/design/arch-images/CNM_overall_diagram.png similarity index 100% rename from arch-images/CNM_overall_diagram.png rename to design/arch-images/CNM_overall_diagram.png diff --git a/arch-images/DAX.png b/design/arch-images/DAX.png similarity index 100% rename from arch-images/DAX.png rename to design/arch-images/DAX.png diff --git a/arch-images/docker-kata.png b/design/arch-images/docker-kata.png similarity index 100% rename from arch-images/docker-kata.png rename to design/arch-images/docker-kata.png diff --git a/arch-images/kata-containers-network-hotplug-uml.txt b/design/arch-images/kata-containers-network-hotplug-uml.txt similarity index 100% rename from arch-images/kata-containers-network-hotplug-uml.txt rename to design/arch-images/kata-containers-network-hotplug-uml.txt diff --git a/arch-images/kata-containers-network-hotplug.png b/design/arch-images/kata-containers-network-hotplug.png similarity index 100% rename from arch-images/kata-containers-network-hotplug.png rename to design/arch-images/kata-containers-network-hotplug.png diff --git a/arch-images/kata-crio-uml.png b/design/arch-images/kata-crio-uml.png similarity index 100% rename from arch-images/kata-crio-uml.png rename to design/arch-images/kata-crio-uml.png diff --git a/arch-images/kata-crio-uml.txt b/design/arch-images/kata-crio-uml.txt similarity index 100% rename from arch-images/kata-crio-uml.txt rename to design/arch-images/kata-crio-uml.txt diff --git a/arch-images/kata-oci-create.svg b/design/arch-images/kata-oci-create.svg similarity index 100% rename from arch-images/kata-oci-create.svg rename to design/arch-images/kata-oci-create.svg diff --git a/arch-images/kata-oci-create.txt b/design/arch-images/kata-oci-create.txt similarity index 100% rename from arch-images/kata-oci-create.txt rename to design/arch-images/kata-oci-create.txt diff --git a/arch-images/kata-oci-exec.svg b/design/arch-images/kata-oci-exec.svg similarity index 100% rename from arch-images/kata-oci-exec.svg rename to design/arch-images/kata-oci-exec.svg diff --git a/arch-images/kata-oci-exec.txt b/design/arch-images/kata-oci-exec.txt similarity index 100% rename from arch-images/kata-oci-exec.txt rename to design/arch-images/kata-oci-exec.txt diff --git a/arch-images/kata-oci-start.svg b/design/arch-images/kata-oci-start.svg similarity index 100% rename from arch-images/kata-oci-start.svg rename to design/arch-images/kata-oci-start.svg diff --git a/arch-images/kata-oci-start.txt b/design/arch-images/kata-oci-start.txt similarity index 100% rename from arch-images/kata-oci-start.txt rename to design/arch-images/kata-oci-start.txt diff --git a/arch-images/network.png b/design/arch-images/network.png similarity index 100% rename from arch-images/network.png rename to design/arch-images/network.png diff --git a/arch-images/qemu.png b/design/arch-images/qemu.png similarity index 100% rename from arch-images/qemu.png rename to design/arch-images/qemu.png diff --git a/arch-images/shimv2.svg b/design/arch-images/shimv2.svg similarity index 100% rename from arch-images/shimv2.svg rename to design/arch-images/shimv2.svg diff --git a/architecture.md b/design/architecture.md similarity index 99% rename from architecture.md rename to design/architecture.md index 7e0b1105e..f7d07b490 100644 --- a/architecture.md +++ b/design/architecture.md @@ -544,8 +544,7 @@ dedicated master node) calls into a compute kubelet. This kubelet instance is responsible for managing the lifecycle of pods within the nodes and eventually relies on a container runtime to handle execution. The kubelet architecture decouples lifecycle management from container execution through the dedicated -[`gRPC`](https://github.com/kubernetes/kubernetes/blob/master/pkg/kubelet/apis/cri/runtime/v1alpha2/api.proto) -based [Container Runtime Interface (CRI)](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/node/container-runtime-interface-v1.md). +`gRPC` based [Container Runtime Interface (CRI)](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/node/container-runtime-interface-v1.md). In other words, a kubelet is a CRI client and expects a CRI implementation to handle the server side of the interface. diff --git a/constraints/cpu.md b/design/cpu-constraints.md similarity index 100% rename from constraints/cpu.md rename to design/cpu-constraints.md diff --git a/zun/kata-zun1.png b/use-cases/images/kata-zun1.png similarity index 100% rename from zun/kata-zun1.png rename to use-cases/images/kata-zun1.png diff --git a/zun/kata-zun2.png b/use-cases/images/kata-zun2.png similarity index 100% rename from zun/kata-zun2.png rename to use-cases/images/kata-zun2.png diff --git a/zun/kata-zun3.png b/use-cases/images/kata-zun3.png similarity index 100% rename from zun/kata-zun3.png rename to use-cases/images/kata-zun3.png diff --git a/zun/kata-zun4.png b/use-cases/images/kata-zun4.png similarity index 100% rename from zun/kata-zun4.png rename to use-cases/images/kata-zun4.png diff --git a/zun/kata-zun5.png b/use-cases/images/kata-zun5.png similarity index 100% rename from zun/kata-zun5.png rename to use-cases/images/kata-zun5.png diff --git a/zun/zun_kata.md b/use-cases/zun_kata.md similarity index 94% rename from zun/zun_kata.md rename to use-cases/zun_kata.md index 0faa3651c..e0101b147 100644 --- a/zun/zun_kata.md +++ b/use-cases/zun_kata.md @@ -101,22 +101,22 @@ sudo systemctl daemon-reload sudo systemctl restart docker ``` -![kata zun image 1](kata-zun1.png) +![kata zun image 1](./images/kata-zun1.png) Figure 1: Create a busybox container image -![kata zun image 2](kata-zun2.png) +![kata zun image 2](./images/kata-zun2.png) Figure 2: Select `kata-runtime` to use -![kata zun image 3](kata-zun3.png) +![kata zun image 3](./images/kata-zun3.png) Figure 3: Two busybox containers successfully launched -![kata zun image 4](kata-zun4.png) +![kata zun image 4](./images/kata-zun4.png) Figure 4: Test connectivity between Kata Containers -![kata zun image 5](kata-zun5.png) +![kata zun image 5](./images/kata-zun5.png) Figure 5: CLI for Zun