Files
kata-containers/install/debian-installation-guide.md
zeigerpuppy e9ca4d8d60 docs: Add Debian installation guides
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>
2018-12-29 14:45:33 +11:00

1.9 KiB

Install Kata Containers on Debian

  1. Install the unsatisfied dependencies

Kata Containers packages depends on a version of librdbd1 that's not yet available in the stable repo. A more recent version of librdbd1 can be installed from the unstable repo: https://packages.debian.org/sid/librbd1

Add unstable repo to /etc/apt/sources.list.d/unstable.list sources list:

$ sudo sh -c "echo '# for unstable packages
deb http://ftp.debian.org unstable main contrib non-free
deb-src http://ftp.debian.org unstable main contrib non-free' > /etc/apt/sources.list.d/unstable.list"

Set the repository to a lower priority than stable, to ensures that APT will prefer stable packages over unstable ones. This can be specified in /etc/apt/preferences.d/unstable:

$ sudo sh -c "echo 'Package: *
Pin: release a=unstable
Pin-Priority: 10' >> /etc/apt/preferences.d/unstable"

Finally, install librbd1:

$ sudo apt-get update && sudo apt-get install -y -t unstable librbd1
  1. Install the Kata Containers components with the following commands:

    $ ARCH=$(arch)
    $ source /etc/os-release
    $ sudo sh -c "echo 'deb http://download.opensuse.org/repositories/home:/katacontainers:/releases:/${ARCH}:/master/Debian_9/$(lsb_release -rs)/ /' > /etc/apt/sources.list.d/kata-containers.list"
    $ curl -sL  http://download.opensuse.org/repositories/home:/katacontainers:/releases:/${ARCH}:/master/Debian_9/$(lsb_release -rs)/Release.key | sudo apt-key add -
    $ sudo -E apt-get update
    $ sudo -E apt-get -y install kata-runtime kata-proxy kata-shim
    
  2. Decide which container manager to use and select the corresponding link that follows: