diff --git a/install/README.md b/install/README.md index 3b26a239f178..91af940def4f 100644 --- a/install/README.md +++ b/install/README.md @@ -22,6 +22,7 @@ Select your preferred distribution or cloud service: * [CentOS](centos-installation-guide.md) * [Fedora](fedora-installation-guide.md) * [Red Hat](rhel-installation-guide.md) +* [OpenSuse] (opensuse-installation-guide.md) * [Ubuntu](ubuntu-installation-guide.md) ### Cloud services diff --git a/install/docker/opensuse-docker-install.md b/install/docker/opensuse-docker-install.md new file mode 100644 index 000000000000..3c6f9526d605 --- /dev/null +++ b/install/docker/opensuse-docker-install.md @@ -0,0 +1,71 @@ +# Install Docker for Kata Containers on openSUSE Leap + +> **Note:** +> +> - This guide assumes you have +> [already installed the Kata Containers packages](../opensuse-installation-guide.md). +> +> - If you do not want to copy or type all these instructions by hand, you can use the +> [`kata-manager`](https://github.com/kata-containers/tests/blob/master/cmd/kata-manager/kata-manager.sh) +> script to install the packaged system including your chosen container +> manager. Alternatively, you can generate a runnable shell script from +> individual documents using the +> [`kata-doc-to-script`](https://github.com/kata-containers/tests/blob/master/.ci/kata-doc-to-script.sh) script. + +1. Install the latest version of Docker with the following commands: + + > **Note:** This step is only required if Docker is not installed on the system. + + ```bash + $ sudo zypper -n install libcgroup1 + $ sudo zypper -n install docker + ``` + + For more information on installing Docker please refer to the + [Docker Guide](https://software.opensuse.org/package/docker). + +2. Configure Docker to use Kata Containers by default with one of the following methods: + + 1. systemd + + ```bash + $ sudo mkdir -p /etc/systemd/system/docker.service.d/ + $ cat < **Notes:** +> +> - Kata Containers packages are available for [openSUSE\*](https://www.opensuse.org/) +> version 43.2 (currently `x86_64` only). +> +> - If you are installing on a system that already has Clear Containers or `runv` installed, +> first read [the upgrading document](../Upgrading.md). +> +> - If you do not want to copy or type all these instructions by hand, you can use the +> [`kata-manager`](https://github.com/kata-containers/tests/blob/master/cmd/kata-manager/kata-manager.sh) +> script to install the packaged system including your chosen container +> manager. Alternatively, you can generate a runnable shell script from +> individual documents using the +> [`kata-doc-to-script`](https://github.com/kata-containers/tests/blob/master/.ci/kata-doc-to-script.sh) script. + +1. Install the Kata Containers components with the following commands: + + > **Note:** This installation channel is not secure since the repository currently + > redirects download URLs to `http`. + + ```bash + $ source /etc/os-release + $ sudo -E VERSION_ID=$VERSION_ID zypper addrepo "http://download.opensuse.org/repositories/home:/katacontainers:/release/openSUSE_Leap_${VERSION_ID}/home:katacontainers:release.repo" + $ sudo -E zypper -n --no-gpg-checks install kata-runtime kata-proxy kata-shim + ``` + +2. Decide which container manager to use and select the corresponding link that follows: + + - [Docker](docker/opensuse-docker-install.md) + - [Kubernetes](https://github.com/kata-containers/documentation/blob/master/Developer-Guide.md#run-kata-containers-with-kubernetes)