github/kata-containers
1
0
Fork 2
mirror of https://github.com/kata-containers/kata-containers.git synced 2025-09-20 16:27:52 +00:00
Code Issues Projects Releases Wiki Activity

install: refresh installation guide README

Browse Source 
Refresh installation guide README with a clearer structure, and provide
a list of distribution with official Kata packages. This also updates
the openSUSE Leap versions supported to 15 and 15.1.

Fixes: #533

Signed-off-by: Marco Vedovati <mvedovati@suse.com>
This commit is contained in:
Marco Vedovati
2019-08-19 16:54:34 +02:00
parent 3dadaf64c5
commit c704edbff6
1 changed files with 62 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files

98
install/README.md
View File

@@ -1,14 +1,19 @@
# Kata Containers installation user guides # Kata Containers installation user guides
- [Prerequisites](#prerequisites) * [Prerequisites](#prerequisites)
- [Installing on a Linux System](#installing-on-a-linux-system) * [Packaged installation methods](#packaged-installation-methods)
* [Supported Distributions](#supported-distributions)
* [Official packages](#official-packages)
* [Automatic Installation](#automatic-installation) * [Automatic Installation](#automatic-installation)
* [Snap Installation](#snap-installation)
* [Scripted Installation](#scripted-installation) * [Scripted Installation](#scripted-installation)
* [Manual Installation](#manual-installation) * [Manual Installation](#manual-installation)
+ [Supported Distributions](#supported-distributions) * [Build from source installation](#build-from-source-installation)
* [Snap Installation](#snap-installation) * [Installing on a Cloud Service Platform](#installing-on-a-cloud-service-platform)
- [Installing on a Cloud Service Platform](#installing-on-a-cloud-service-platform) * [Further information](#further-information)
- [Further information](#further-information)
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 ## Prerequisites
Kata Containers requires nested virtualization or bare metal. Kata Containers requires nested virtualization or bare metal.
@@ -16,32 +21,53 @@ See the
[hardware requirements](https://github.com/kata-containers/runtime/blob/master/README.md#hardware-requirements) [hardware requirements](https://github.com/kata-containers/runtime/blob/master/README.md#hardware-requirements)
to see if your system is capable of running Kata Containers. to see if your system is capable of running Kata Containers.
## Installing on a Linux System ## Packaged installation methods
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.
| Installation method | Suggested for | Description | Packaged install | Distributions supported |
|------------------------------------------------------------|-----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|------------------|---------------------------------------|
| [Automatic](#automatic-installation) | Quick start for new users | Run a single command to install a full system. | yes | [see table](#supported-distributions) |
| [Manual](#manual-installation) | Self paced user install | Allows the user to read a brief document and execute the specified commands step-by-step. | yes | [see table](#supported-distributions) |
| [Scripted](#scripted-installation) | Administrators | Generates an installation script which will result in a working system when executed. | yes | [see table](#supported-distributions) |
| [Build from sources](../Developer-Guide.md#initial-setup) | Developers and hackers only | Allows power users who are comfortable building software from source to use the latest component versions. Not recommended for normal users. | no | any distro |
| [Using snap](#snap-installation) | Users and Administrators | Easy to install and automatic updates | yes | any distro that supports snapd |
> **Notes:** > **Notes:**
> >
> - The "Packaged install" column shows if the resulting installation > - Packaged installation methods uses your distribution's native package format (such as RPM or DEB).
> uses your distribution's native package format (such as RPM or DEB).
> | Installation method | Description | Distributions supported |
> - Power users who decide to build from sources should be aware of the |------------------------------------------------------|-----------------------------------------------------------------------------------------|--------------------------------------|
> implications of using an unpackaged system which will not be automatically | [Automatic](#automatic-installation) |Run a single command to install a full system |[see table](#supported-distributions) |
> updated as new [releases](../Releases.md) are made available. | [Using snap](#snap-installation) |Easy to install and automatic updates |any distro that supports snapd |
| [Using official distro packages](#official-packages) |Kata packages provided by Linux distributions official repositories |[see table](#supported-distributions) |
| [Scripted](#scripted-installation) |Generates an installation script which will result in a working system when executed |[see table](#supported-distributions) |
| [Manual](#manual-installation) |Allows the user to read a brief document and execute the specified commands step-by-step |[see table](#supported-distributions) |
### Supported Distributions
Kata is packaged by the Kata community for:
|Distribution (link to installation guide) | Versions |
|-----------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
|[CentOS](centos-installation-guide.md) | 7 |
|[Debian](debian-installation-guide.md) | 9 |
|[Fedora](fedora-installation-guide.md) | 28, 29, 30 |
|[openSUSE](opensuse-installation-guide.md) | [Leap](opensuse-leap-installation-guide.md) (15, 15.1)<br>[Tumbleweed](opensuse-tumbleweed-installation-guide.md) |
|[Red Hat Enterprise Linux (RHEL)](rhel-installation-guide.md) | 7 |
|[SUSE Linux Enterprise Server (SLES)](sles-installation-guide.md)| SLES 12 SP3 |
|[Ubuntu](ubuntu-installation-guide.md) | 16.04, 18.04 |
#### Official packages
Kata packages are provided by official distribution repositories for:
|Distribution (link to packages) | Versions |
|-----------------------------------------------------------------|------------|
|[openSUSE](https://software.opensuse.org/package/katacontainers) | Tumbleweed |
### Automatic Installation ### Automatic Installation
[Use `kata-manager`](installing-with-kata-manager.md) to automatically install Kata packages. [Use `kata-manager`](installing-with-kata-manager.md) to automatically install Kata packages.
### Snap Installation
[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/kata-containers)
[Use snap](snap-installation-guide.md) to install Kata Containers from https://snapcraft.io.
### Scripted Installation ### Scripted Installation
[Use `kata-doc-to-script`](installing-with-kata-doc-to-script.md) to generate installation scripts that can be reviewed before they are executed. [Use `kata-doc-to-script`](installing-with-kata-doc-to-script.md) to generate installation scripts that can be reviewed before they are executed.
@@ -77,22 +103,16 @@ Manual installation instructions are available for [these distributions](#suppor
> - Only trust the signing key and fingerprint listed in the previous bullet point. Do not disable GPG checks, > - Only trust the signing key and fingerprint listed in the previous bullet point. Do not disable GPG checks,
> otherwise packages source and authenticity is not guaranteed. > otherwise packages source and authenticity is not guaranteed.
### Snap Installation ## 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](../Releases.md) are made available.
[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/kata-containers) [Building from sources](../Developer-Guide.md#initial-setup) allows power users
who are comfortable building software from source to use the latest component
[Use snap](snap-installation-guide.md) to install Kata Containers from https://snapcraft.io. versions. This is not recommended for normal users.
#### Supported Distributions
|Distro specific installation instructions | Versions |
|-----------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
|[CentOS](centos-installation-guide.md) | 7 |
|[Debian](debian-installation-guide.md) | 9 |
|[Fedora](fedora-installation-guide.md) | 28, 29, 30 |
|[openSUSE](opensuse-installation-guide.md) | [Leap](opensuse-leap-installation-guide.md) (42.3, 15)<br>[Tumbleweed](opensuse-tumbleweed-installation-guide.md) |
|[Red Hat Enterprise Linux (RHEL)](rhel-installation-guide.md) | 7 |
|[SUSE Linux Enterprise Server (SLES)](sles-installation-guide.md)| SLES 12 SP3 |
|[Ubuntu](ubuntu-installation-guide.md) | 16.04, 18.04 |
## Installing on a Cloud Service Platform ## Installing on a Cloud Service Platform
* [Amazon Web Services (AWS)](aws-installation-guide.md) * [Amazon Web Services (AWS)](aws-installation-guide.md)