From c021c2ead2970ba474eba9f68a7bc230e3c29b93 Mon Sep 17 00:00:00 2001
From: Jose Lamego <jose.a.lamego@intel.com>
Date: Fri, 8 Jun 2018 13:47:25 -0500
Subject: [PATCH] kata-containers: add tutorial

This tutorial describes how to install, configure and run Kata Containers on
Clear Linux.

Signed-off-by: Jose Lamego <jose.a.lamego@intel.com>
---
 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<bare-metal-install>`.
+
+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 <<EOF | sudo tee /etc/systemd/system/docker.service.d/kata-containers.conf
+   [Service]
+   ExecStart=
+   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
+
+.. code-block:: bash
+
+   sudo systemctl daemon-reload
+   sudo systemctl restart docker
+
+Run Kata Containers
+*******************
+
+.. code-block:: bash
+
+   sudo docker run -ti busybox sh
+
+**Congratulations!**
+
+You successfully installed and set up Kata Containers on |CLOSIA|.
+
+More information about Docker in |CLOSIA|.
+#############################################
+
+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
+runtime on systems that support it.
+
+To check which runtime your system is using, run:
+
+.. code-block:: bash
+
+   sudo docker info | grep runtime
diff --git a/source/clear-linux/tutorials/tutorials.rst b/source/clear-linux/tutorials/tutorials.rst
index 3cbb1f17..37a9221f 100644
--- a/source/clear-linux/tutorials/tutorials.rst
+++ b/source/clear-linux/tutorials/tutorials.rst
@@ -20,3 +20,4 @@ specific |CLOSIA| use cases.
    telemetry-backend/telemetry-backend
    smb/smb
    spark
+   kata