From c021c2ead2970ba474eba9f68a7bc230e3c29b93 Mon Sep 17 00:00:00 2001 From: Jose Lamego Date: Fri, 8 Jun 2018 13:47:25 -0500 Subject: [PATCH 1/3] kata-containers: add tutorial This tutorial describes how to install, configure and run Kata Containers on Clear Linux. Signed-off-by: Jose Lamego --- source/clear-linux/tutorials/kata.rst | 81 ++++++++++++++++++++++ source/clear-linux/tutorials/tutorials.rst | 1 + 2 files changed, 82 insertions(+) create mode 100644 source/clear-linux/tutorials/kata.rst diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst new file mode 100644 index 00000000..7f886e58 --- /dev/null +++ b/source/clear-linux/tutorials/kata.rst @@ -0,0 +1,81 @@ + .. _kata: + +Install Kata Containers +####################### + +This tutorial describes how to install, configure and run Kata Containers on +|CLOSIA|. Kata Containers is an open source project and community working to +build a standard implementation of lightweight Virtual Machines (VMs) that feel +and perform like containers, but provide the workload isolation and security +advantages of VMs. Kata Containers is available in Clear Linux versions above 22860. + +Prerequisites +************* + +This tutorial assumes you have installed |CL| on your host system. +For detailed instructions on installing |CL| on a bare metal system, visit +the :ref:`bare metal installation tutorial`. + +Before you install any new packages, update |CL| with the following command: + +.. code-block:: bash + + sudo swupd update + +Install Kata Containers +*********************** + +Kata Containers is included in the :file:`containers-virt` bundle. To install the +framework, enter: + +.. code-block:: bash + + sudo swupd bundle-add containers-virt + +Configure Docker to use Kata Containers by default + +.. code-block:: bash + + sudo mkdir -p /etc/systemd/system/docker.service.d/ + cat < Date: Mon, 11 Jun 2018 13:48:00 -0500 Subject: [PATCH 2/3] Update kata.rst --- source/clear-linux/tutorials/kata.rst | 34 +++++++++++++-------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index 7f886e58..841dc083 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -1,13 +1,13 @@ .. _kata: -Install Kata Containers +Install Kata Containers\* ####################### -This tutorial describes how to install, configure and run Kata Containers on -|CLOSIA|. Kata Containers is an open source project and community working to +This tutorial describes how to install, configure and run Kata Containers\* on +|CLOSIA|. Kata Containers\* is an open source project and community working to build a standard implementation of lightweight Virtual Machines (VMs) that feel and perform like containers, but provide the workload isolation and security -advantages of VMs. Kata Containers is available in Clear Linux versions above 22860. +advantages of VMs. Kata Containers\* is available in Clear Linux versions above 22860. Prerequisites ************* @@ -22,17 +22,17 @@ Before you install any new packages, update |CL| with the following command: sudo swupd update -Install Kata Containers +Install Kata Containers\* *********************** -Kata Containers is included in the :file:`containers-virt` bundle. To install the +Kata Containers\* is included in the :file:`containers-virt` bundle. To install the framework, enter: .. code-block:: bash sudo swupd bundle-add containers-virt -Configure Docker to use Kata Containers by default +Configure Docker to use Kata Containers\* by default .. code-block:: bash @@ -43,14 +43,14 @@ Configure Docker to use Kata Containers by default ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime EOF -Restart the Docker\* and Kata Containers systemd services +Restart the Docker\* and Kata Containers\* systemd services .. code-block:: bash sudo systemctl daemon-reload sudo systemctl restart docker -Run Kata Containers +Run Kata Containers\* ******************* .. code-block:: bash @@ -59,19 +59,19 @@ Run Kata Containers **Congratulations!** -You successfully installed and set up Kata Containers on |CLOSIA|. +You successfully installed and set up Kata Containers\* on |CLOSIA|. -More information about Docker in |CLOSIA|. +More information about Docker\* in |CLOSIA|. ############################################# -Docker on |CLOSIA| provides a docker.service service file to start the docker +Docker\* on |CLOSIA| provides a docker.service service file to start the Docker\* daemon. The daemon will use runc or cc-runtime depending on the environment: -If you are running Clear Linux on baremetal or on a VM with Nested -Virtualization activated, docker will use cc-runtime as the default runtime. -If you are running Clear Linux on a VM without Nested Virtualization, docker -will use runc as the default runtime. It is not necessary to configure Docker -to use cc-runtime manually since Docker itself will automatically use this +If you are running |CL| on baremetal or on a VM with Nested +Virtualization activated, Docker\* will use cc-runtime as the default runtime. +If you are running |CL| on a VM without Nested Virtualization, Docker\* +will use runc as the default runtime. It is not necessary to configure Docker\* +to use cc-runtime manually since Docker\* itself will automatically use this runtime on systems that support it. To check which runtime your system is using, run: From dea47748b551341e814aceca49d6067effb99208 Mon Sep 17 00:00:00 2001 From: Jose Lamego Date: Mon, 2 Jul 2018 11:08:03 -0500 Subject: [PATCH 3/3] Update kata.rst --- source/clear-linux/tutorials/kata.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/tutorials/kata.rst b/source/clear-linux/tutorials/kata.rst index 841dc083..615f9e1e 100644 --- a/source/clear-linux/tutorials/kata.rst +++ b/source/clear-linux/tutorials/kata.rst @@ -7,7 +7,7 @@ This tutorial describes how to install, configure and run Kata Containers\* on |CLOSIA|. Kata Containers\* is an open source project and community working to build a standard implementation of lightweight Virtual Machines (VMs) that feel and perform like containers, but provide the workload isolation and security -advantages of VMs. Kata Containers\* is available in Clear Linux versions above 22860. +advantages of VMs. Kata Containers\* is available in Clear Linux versions above 23380. Prerequisites *************