mirror of https://github.com/kata-containers/kata-containers.git synced 2025-04-27 19:35:32 +00:00

History

Fabiano Fidêncio 8b4fc847d7 kata-manager: Accept only "lts" or "active" as containerd versions kata-manager is a very nice tool, but we shouldn't be trying to take care of "everything" in "all possible scenarios", and we should focus on installing Kata Containers dependencies that are supported. With this in mind, let's limit a little bit the scope of which versions of containerd can be installed, limitting to "active" and "lts", which will then install the latest version of those "flavours". The default value will always be "lts" as that's supposed to be the stable one. NOTE: This is a breaking change, as it changes the behaviour of what the script takes in its `-c` parameter. I'm assuming here we're safe to do so as the majority of the users should / would only be using the full installation by default. Fixes: #8356 Signed-off-by: Fabiano Fidêncio <fabiano.fidencio@intel.com>	2023-11-03 10:30:37 +01:00
..
kata-manager.sh	kata-manager: Accept only "lts" or "active" as containerd versions	2023-11-03 10:30:37 +01:00
README.md	utils: Update kata manager docs	2022-02-15 16:05:54 +00:00

Fabiano Fidêncio 8b4fc847d7 kata-manager: Accept only "lts" or "active" as containerd versions

kata-manager is a very nice tool, but we shouldn't be trying to take
care of "everything" in "all possible scenarios", and we should focus on
installing Kata Containers dependencies that are supported.

With this in mind, let's limit a little bit the scope of which versions
of containerd can be installed, limitting to "active" and "lts", which
will then install the latest version of those "flavours".  The default
value will always be "lts" as that's supposed to be the stable one.

NOTE: This is a breaking change, as it changes the behaviour of what the
script takes in its `-c` parameter.  I'm assuming here we're safe to do
so as the majority of the users should / would only be using the full
installation by default.

Fixes: #8356

Signed-off-by: Fabiano Fidêncio <fabiano.fidencio@intel.com>

2023-11-03 10:30:37 +01:00

kata-manager.sh

kata-manager: Accept only "lts" or "active" as containerd versions

2023-11-03 10:30:37 +01:00

README.md

utils: Update kata manager docs

2022-02-15 16:05:54 +00:00

README.md

Utilities

Kata Manager

Warning:

Kata Manager will not work for Fedora 31 and higher since those distribution versions only support cgroups version 2 by default. However, Kata Containers currently requires cgroups version 1 (on the host side). See https://github.com/kata-containers/kata-containers/issues/927 for further details.

Note:

We recommend users install Kata Containers using official distribution packages, where available.

The kata-manager.sh script automatically installs and configures Kata Containers and containerd.

This scripted method installs the latest versions of Kata Containers and containerd. However, be aware of the following before proceeding:

Packages will not be automatically updated

Since a package manager is not being used, it is your responsibility to ensure these packages are kept up-to-date when new versions are released to ensure you are using a version that includes the latest security and bug fixes.
Potentially untested versions or version combinations

This script installs the newest versions of Kata Containers and containerd from binary release packages. These versions may not have been tested with your distribution version.

If you still wish to continue, but prefer a manual installation, see the containerd installation guide.

Install a minimal Kata Containers system

By default, the script will attempt to install Kata Containers and containerd, and then configure containerd to use Kata Containers. However, the script provides a number of options to allow you to change its behaviour.

Note:

Before running the script to install Kata Containers, we recommend that you review the available options.

Show available options

To show the available options without installing anything, run:

$ bash -c "$(curl -fsSL https://raw.githubusercontent.com/kata-containers/kata-containers/main/utils/kata-manager.sh) -h"

To install Kata Containers only

If your system already has containerd installed, to install Kata Containers and only configure containerd, run:

$ bash -c "$(curl -fsSL https://raw.githubusercontent.com/kata-containers/kata-containers/main/utils/kata-manager.sh) -o"

To install Kata Containers and containerd

To install and configure a system with Kata Containers and containerd, run:

$ bash -c "$(curl -fsSL https://raw.githubusercontent.com/kata-containers/kata-containers/main/utils/kata-manager.sh)"