mirror of
https://github.com/aljazceru/kata-containers.git
synced 2025-12-30 20:44:26 +01:00
e9ca4d8d60
Fixes #310. These install instructions are based on the katacontainers repository for Debian. For installation, a newer version of `librbd1` is required. This is available from the `unstable` repo. Tested only on Debian 9 - Stretch (x86_64). - tested with `docker-ce=17.12.0~ce-0~debian` Signed-off-by: zeigerpuppy <zeigerpuppy@users.noreply.github.com>
96 lines
2.7 KiB
Markdown
96 lines
2.7 KiB
Markdown
# Install Docker for Kata Containers on Debian
|
|
|
|
> **Note:**
|
|
>
|
|
> - This guide assumes you have
|
|
> [already installed the Kata Containers packages](../debian-installation-guide.md).
|
|
> - this guide allows for installation with `systemd` or `sysVinit` init systems
|
|
|
|
1. Install the latest version of Docker with the following commands:
|
|
|
|
> **Note:** This step is only required if Docker is not installed on the system.
|
|
|
|
```bash
|
|
$ sudo apt-get -y install apt-transport-https ca-certificates curl gnupg2 software-properties-common
|
|
$ curl -fsSL https://download.docker.com/linux/$(. /etc/os-release; echo "$ID")/gpg | sudo apt-key add -
|
|
$ sudo add-apt-repository "deb https://download.docker.com/linux/$(. /etc/os-release; echo "$ID") $(lsb_release -cs) stable"
|
|
$ sudo apt-get update
|
|
$ sudo apt-get -y install docker-ce
|
|
```
|
|
|
|
For more information on installing Docker please refer to the
|
|
[Docker Guide](https://docs.docker.com/engine/installation/linux/debian).
|
|
|
|
2. Configure Docker to use Kata Containers by default with ONE of the following methods:
|
|
|
|
a. sysVinit
|
|
|
|
- with sysVinit, docker config is stored in `/etc/default/docker`, edit the options similar to the following:
|
|
|
|
```
|
|
$ sudo sh -c "echo '# specify docker runtime for kata-containers
|
|
DOCKER_OPTS=\"-D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime\"' >> /etc/default/docker"
|
|
```
|
|
|
|
b. systemd
|
|
|
|
```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
|
|
```
|
|
|
|
c. systemd Docker `daemon.json`
|
|
|
|
Add the following definitions to `/etc/docker/daemon.json`:
|
|
|
|
```bash
|
|
$ sudo sh -c "echo '{
|
|
\"default-runtime\": \"kata-runtime\",
|
|
\"runtimes\": {
|
|
\"kata-runtime\": {
|
|
\"path\": \"/usr/bin/kata-runtime\"
|
|
}
|
|
}
|
|
}' >> /etc/docker/daemon.json"
|
|
```
|
|
|
|
3. Restart the Docker systemd service with one of the following (depending on init choice):
|
|
|
|
a. sysVinit
|
|
|
|
```bash
|
|
$ sudo /etc/init.d/docker stop
|
|
$ sudo /etc/init.d/docker start
|
|
```
|
|
|
|
to watch for errors:
|
|
|
|
```bash
|
|
tail -f /var/log/docker.log
|
|
```
|
|
|
|
b. systemd
|
|
|
|
```bash
|
|
$ sudo systemctl daemon-reload
|
|
$ sudo systemctl restart docker
|
|
```
|
|
|
|
4. Run Kata Containers
|
|
|
|
You are now ready to run Kata Containers:
|
|
|
|
```bash
|
|
$ sudo docker run busybox uname -a
|
|
```
|
|
|
|
The previous command shows details of the kernel version running inside the
|
|
container, which is different to the host kernel version.
|
|
|
|
|
|
|