Files
kata-containers/install/docker/opensuse-docker-install.md
James O. D. Hunt ceae7b48e0 docs: Pin docker to version 18.06
Docker 18.09 removed devicemapper support but did not provide an
alternative. This can cause problems for users so update the install
docs to install Docker at version 18.06 (the last version that supports
devicemapper).

This is a temporary solution until either docker provide an alternative
or we find a way to work around the Docker feature being removed.

Note the extra logic required for Fedora since 18.06 is not available
for that release.

Fixes #373.

Signed-off-by: James O. D. Hunt <james.o.hunt@intel.com>
2019-02-18 08:55:41 +00:00

2.1 KiB

Install Docker for Kata Containers on openSUSE Leap

Note:

  1. Install Docker with the following commands:

    Notes:

    • This step is only required if Docker is not installed on the system.
    • Newer versions of Docker have removed devicemapper support so the commands below install the latest version which includes devicemapper support.
    • To remove the lock on the docker package to allow it to be updated:
      $ sudo zypper removelock docker
      
    $ sudo zypper -n install libcgroup1
    $ sudo zypper -n install 'docker<18.09'
    $ sudo zypper addlock docker
    

    For more information on installing Docker please refer to the Docker Guide.

  2. Configure Docker to use Kata Containers by default with one of the following methods:

    1. systemd

      $ 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:

      {
        "default-runtime": "kata-runtime",
        "runtimes": {
          "kata-runtime": {
            "path": "/usr/bin/kata-runtime"
          }
        }
      }
      
  3. Restart the Docker systemd service with the following commands:

    $ sudo systemctl daemon-reload
    $ sudo systemctl restart docker
    
  4. Run Kata Containers

    You are now ready to run Kata Containers:

    $ 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.