mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-08-28 13:45:43 +00:00
Kevin Putnam
102 lines
3.0 KiB
ReStructuredText
102 lines
3.0 KiB
ReStructuredText
.. _kata:
|
|
|
|
Install Kata Containers\*
|
|
#######################
|
|
|
|
This tutorial describes how to install, configure and run Kata Containers\* on
|
|
|CLOSIA|. Kata Containers is an open source project dedicated to the
|
|
development of a lightweight implementation of Virtual Machines (VMs)
|
|
offering the speed of containers and the security of VMs.
|
|
|
|
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
|
|
|
|
.. note::
|
|
|
|
In cases where it is necessary to use a proxy server and your proxy
|
|
environment variables are already set, run the following commands as
|
|
a shell script to configure Docker:
|
|
|
|
.. code-block:: bash
|
|
|
|
docker_service_dir="/etc/systemd/system/docker.service.d/"
|
|
sudo mkdir -p "$docker_service_dir"
|
|
cat <<EOF | sudo tee "$docker_service_dir/proxy.conf"
|
|
[Service]
|
|
Environment="HTTP_PROXY=$http_proxy"
|
|
Environment="HTTPS_PROXY=$https_proxy"
|
|
EOF
|
|
echo "Reloading unit files and starting docker service"
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl restart docker
|
|
sudo docker info
|
|
|
|
**Congratulations!**
|
|
|
|
You have 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 s/cc-runtime/kata-runtime depending on
|
|
the environment:
|
|
|
|
If you are running |CL| on bare metal or on a VM with Nested
|
|
Virtualization activated, Docker will use s/cc-runtime/kata-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 manually configure the runtime for Docker, since Docker itself
|
|
will automatically use the one supported by the system.
|
|
|
|
To check which runtime your system is using, run:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo docker info | grep runtime
|