github/kata-containers
1
0
Fork 1
mirror of https://github.com/kata-containers/kata-containers.git synced 2025-04-27 11:31:05 +00:00
Code Issues Projects Releases Wiki Activity
43d70a32df
kata-containers/docs/install/README.md
James O. D. Hunt 43d70a32df docs: Add containerd install guide 
Create a containerd installation guide and a new `kata-manager` script
for 2.0 that automated the steps outlined in the guide.

Also cleaned up and improved the installation documentation in various
ways, the most significant being:

- Added legacy install link for 1.x installs.
- Official packages section:
  - Removed "Contact" column (since it was empty!)
  - Reworded "Versions" column to clarify the versions are a minimum
    (to reduce maintenance burden).
  - Add a column to show which installation methods receive automatic updates.
  - Modified order of installation options in table and document to
    de-emphasise automatic installation and promote official packages
    and snap more.
- Removed sections no longer relevant for 2.0.

Fixes: #738.

Signed-off-by: James O. D. Hunt <james.o.hunt@intel.com>
2020-10-12 17:54:53 +01:00

5.6 KiB
Raw Blame History

Kata Containers installation user guides

The following is an overview of the different installation methods available. All of these methods equally result in a system configured to run Kata Containers.

Prerequisites

Kata Containers requires nested virtualization or bare metal. See the hardware requirements to see if your system is capable of running Kata Containers.

Legacy installation

If you wish to install a legacy 1.x version of Kata Containers, see the Kata Containers 1.x installation documentation.

Packaged installation methods

Notes:

  • Packaged installation methods uses your distribution's native package format (such as RPM or DEB).
  • You are strongly encouraged to choose an installation method that provides automatic updates, to ensure you benefit from security updates and bug fixes.
Installation method Description Automatic updates Use case
Using official distro packages Kata packages provided by Linux distributions official repositories yes Recommended for most users.
Using snap Easy to install yes Good alternative to official distro packages.
Automatic Run a single command to install a full system No! For those wanting the latest release quickly.
Manual Follow a guide step-by-step to install a working system No! For those who want the latest release with more control.
Build from source Build the software components manually No! Power users and developers only.

Official packages

Kata packages are provided by official distribution repositories for:

Distribution (link to installation guide) Minimum versions
CentOS 8
Fedora 32, Rawhide
openSUSE Leap 15.1
Leap 15.2, Tumbleweed
SUSE Linux Enterprise (SLE) SLE 15 SP1, 15 SP2

Note::

All users are encouraged to uses the official distribution versions of Kata Containers unless they understand the implications of alternative methods.

Snap Installation

Note: The snap installation is available for all distributions which support snapd.

Get it from the Snap Store

Use snap to install Kata Containers from https://snapcraft.io.

Automatic Installation

Use kata-manager to automatically install a working Kata Containers system.

Manual Installation

Follow the containerd installation guide.

Build from source installation

Notes:

  • Power users who decide to build from sources should be aware of the implications of using an unpackaged system which will not be automatically updated as new releases are made available.

Building from sources allows power users who are comfortable building software from source to use the latest component versions. This is not recommended for normal users.

Installing on a Cloud Service Platform

Further information