Skip to content

Commit

Permalink
docs: Update snap install guide
Browse files Browse the repository at this point in the history
As this repo is specific to the kata-containers 2.x, let's stop
mentioning / referring to the 1.x here, including how to setup and use
the snap package for 1.x.

Fixes: kata-containers#1601

Signed-off-by: Fabiano Fidêncio <[email protected]>
  • Loading branch information
fidencio committed Mar 31, 2021
1 parent 3cc2761 commit 4a38ff4
Showing 1 changed file with 1 addition and 66 deletions.
67 changes: 1 addition & 66 deletions docs/install/snap-installation-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 2,6 @@

* [Install Kata Containers](#install-kata-containers)
* [Configure Kata Containers](#configure-kata-containers)
* [Integration with non-compatible shim v2 Container Engines](#integration-with-non-compatible-shim-v2-container-engines)
* [Integration with Docker](#integration-with-docker)
* [Integration with Podman](#integration-with-podman)
* [Integration with shim v2 Container Engines](#integration-with-shim-v2-container-engines)
* [Remove Kata Containers snap package](#remove-kata-containers-snap-package)

Expand All @@ -14,20 11,7 @@
Kata Containers can be installed in any Linux distribution that supports
[snapd](https://docs.snapcraft.io/installing-snapd).

> NOTE: From Kata Containers 2.x, only the [Containerd Runtime V2 (Shim API)](https://github.com/containerd/containerd/tree/master/runtime/v2)
> is supported, note that some container engines (`docker`, `podman`, etc) may not
> be able to run Kata Containers 2.x.
Kata Containers 1.x is released through the *stable* channel while Kata Containers
2.x is available in the *candidate* channel.

Run the following command to install **Kata Containers 1.x**:

```sh
$ sudo snap install kata-containers --classic
```

Run the following command to install **Kata Containers 2.x**:
Run the following command to install **Kata Containers**:

```sh
$ sudo snap install kata-containers --candidate --classic
Expand All @@ -46,55 30,6 @@ $ sudo cp /snap/kata-containers/current/usr/share/defaults/kata-containers/confi
$ $EDITOR /etc/kata-containers/configuration.toml
```

## Integration with non-compatible shim v2 Container Engines

At the time of writing this document, `docker` and `podman` **do not support Kata
Containers 2.x, therefore Kata Containers 1.x must be used instead.**

The path to the runtime provided by the Kata Containers 1.x snap package is
`/snap/bin/kata-containers.runtime`, it should be used to run Kata Containers 1.x.

### Integration with Docker

`/etc/docker/daemon.json` is the configuration file for `docker`, use the
following configuration to add a new runtime (`kata`) to `docker`.

```json
{
"runtimes": {
"kata": {
"path": "/snap/bin/kata-containers.runtime"
}
}
}
```

Once the above configuration has been applied, use the
following commands to restart `docker` and run Kata Containers 1.x.

```sh
$ sudo systemctl restart docker
$ docker run -ti --runtime kata busybox sh
```

### Integration with Podman

`/usr/share/containers/containers.conf` is the configuration file for `podman`,
add the following configuration in the `[engine.runtimes]` section.

```toml
kata = [
"/snap/bin/kata-containers.runtime"
]
```

Once the above configuration has been applied, use the following command to run
Kata Containers 1.x with `podman`

```sh
$ sudo podman run -ti --runtime kata docker.io/library/busybox sh
```

## Integration with shim v2 Container Engines

The Container engine daemon (`cri-o`, `containerd`, etc) needs to be able to find the
Expand Down

0 comments on commit 4a38ff4

Please sign in to comment.