mirror of
https://github.com/aljazceru/kata-containers.git
synced 2025-12-30 20:44:26 +01:00
e7d2141648
The OpenSUSE and SLES install guide for Docker used the --containerd
option. When this option is used on OpenSUSE Leap 15 or SLES 15, the
following error occurs when starting Docker:
Failed to connect to containerd: failed to dial
"/run/containerd/containerd.sock": context deadline exceeded
Removing the --containerd option from the configuration file allows the
Docker daemon to start successfully and a Kata container to be created.
Fixes: #350
Signed-off-by: John L. Jolly <jjolly@suse.com>
65 lines
1.7 KiB
Markdown
65 lines
1.7 KiB
Markdown
# Install Docker for Kata Containers on openSUSE Leap
|
|
|
|
> **Note:**
|
|
>
|
|
> - This guide assumes you have
|
|
> [already installed the Kata Containers packages](../opensuse-installation-guide.md).
|
|
|
|
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 zypper -n install libcgroup1
|
|
$ sudo zypper -n install docker
|
|
```
|
|
|
|
For more information on installing Docker please refer to the
|
|
[Docker Guide](https://software.opensuse.org/package/docker).
|
|
|
|
2. Configure Docker to use Kata Containers by default with one of the following methods:
|
|
|
|
1. 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
|
|
```
|
|
|
|
2. Docker `daemon.json`
|
|
|
|
Add the following definitions to `/etc/docker/daemon.json`:
|
|
|
|
```json
|
|
{
|
|
"default-runtime": "kata-runtime",
|
|
"runtimes": {
|
|
"kata-runtime": {
|
|
"path": "/usr/bin/kata-runtime"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
3. Restart the Docker systemd service with the following commands:
|
|
|
|
```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.
|