f8e44172f6
Updated the `kata-manager.sh` script to make it run all the checks on the host system before attempting to create a container. If any checks fail, they will indicate to the user what the problem is in a clearer manner than those reported by the container manager. Fixes: #6281. Signed-off-by: tg5788re <jfokugas@gmail.com>
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)"