kata-containers/docs/install/snap-installation-guide.md
Julio Montes 68a77a7dec workflows: release kata 2.x snap through the stable channel
kata 1.x has been deprecated, now kata 2.x can be released through
the stable channel

fixes #1909

Signed-off-by: Julio Montes <julio.montes@intel.com>
2021-05-21 15:47:50 -05:00

2.1 KiB

Kata Containers snap package

Install Kata Containers

Kata Containers can be installed in any Linux distribution that supports snapd.

Run the following command to install Kata Containers:

$ sudo snap install kata-containers --stable --classic

Configure Kata Containers

By default Kata Containers snap image is mounted at /snap/kata-containers as a read-only file system, therefore default configuration file can not be edited. Fortunately Kata Containers supports loading a configuration file from another path than the default.

$ sudo mkdir -p /etc/kata-containers
$ sudo cp /snap/kata-containers/current/usr/share/defaults/kata-containers/configuration.toml /etc/kata-containers/
$ $EDITOR /etc/kata-containers/configuration.toml

Integration with shim v2 Container Engines

The Container engine daemon (cri-o, containerd, etc) needs to be able to find the containerd-shim-kata-v2 binary to allow Kata Containers to be created. Run the following command to create a symbolic link to the shim v2 binary.

$ sudo ln -sf /snap/kata-containers/current/usr/bin/containerd-shim-kata-v2 /usr/local/bin/containerd-shim-kata-v2

Once the symbolic link has been created and the engine daemon configured, io.containerd.kata.v2 can be used as runtime.

Read the following documents to know how to run Kata Containers 2.x with containerd.

Remove Kata Containers snap package

Run the following command to remove the Kata Containers snap:

$ sudo snap remove kata-containers