diff --git a/install/README.md b/install/README.md index 40430b74df..a8be305d23 100644 --- a/install/README.md +++ b/install/README.md @@ -7,6 +7,7 @@ Select your preferred distribution: * [CentOS](https://github.com/kata-containers/documentation/blob/master/install/centos-installation-guide.md) * [Fedora](https://github.com/kata-containers/documentation/blob/master/install/fedora-installation-guide.md) +* [Red Hat](https://github.com/kata-containers/documentation/blob/master/install/rhel-installation-guide.md) * [Ubuntu](https://github.com/kata-containers/documentation/blob/master/install/ubuntu-installation-guide.md) For further information, see: diff --git a/install/centos-installation-guide.md b/install/centos-installation-guide.md index b5688d0470..75db0cb1c3 100644 --- a/install/centos-installation-guide.md +++ b/install/centos-installation-guide.md @@ -1,4 +1,4 @@ -# Installing Kata Containers on CentOS +# Install Kata Containers on CentOS > **Notes:** > @@ -27,7 +27,7 @@ $ sudo -E yum -y install kata-runtime kata-proxy kata-shim ``` -2. Decide which container manager you will use and select the corresponding link that follows: +2. Decide which container manager to use and select the corresponding link that follows: - [Docker](docker/centos-docker-install.md) - [Kubernetes](https://github.com/kata-containers/documentation/blob/master/Developer-Guide.md#if-you-want-to-run-kata-containers-with-kubernetes) diff --git a/install/docker/rhel-docker-install.md b/install/docker/rhel-docker-install.md new file mode 100644 index 0000000000..3c637fd81e --- /dev/null +++ b/install/docker/rhel-docker-install.md @@ -0,0 +1,55 @@ +# Install Docker for Kata Containers on RHEL + +> **Note:** +> +> - This guide assumes you have +> [already installed the Kata Containers packages](../rhel-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 + $ export rhel_devtoolset_version="7" + $ sudo subscription-manager repos --enable=rhel-${rhel_devtoolset_version}-server-extras-rpms + $ sudo yum -y install docker && systemctl enable --now docker + ``` + + For more information on installing Docker please refer to the + [Docker Guide](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux_atomic_host/7/html-single/getting_started_with_containers/#getting_docker_in_rhel_7). + +2. Configure Docker to use Kata Containers by default with the following commands: + + ```bash + $ sudo mkdir -p /etc/systemd/system/docker.service.d/ + $ cat < **Notes:** > @@ -27,7 +27,7 @@ $ sudo -E dnf -y install kata-runtime kata-proxy kata-shim ``` -2. Decide which container manager you will use and select the corresponding link that follows: +2. Decide which container manager to use and select the corresponding link that follows: - [Docker](docker/fedora-docker-install.md) - [Kubernetes](https://github.com/kata-containers/documentation/blob/master/Developer-Guide.md#if-you-want-to-run-kata-containers-with-kubernetes) diff --git a/install/rhel-installation-guide.md b/install/rhel-installation-guide.md new file mode 100644 index 0000000000..2aa4606a00 --- /dev/null +++ b/install/rhel-installation-guide.md @@ -0,0 +1,32 @@ +# Install Kata Containers on RHEL + +> **Notes:** +> +> - Kata Containers packages are available for [RHEL\*](https://www.redhat.com) +> version 7 (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 yum-config-manager --add-repo "http://download.opensuse.org/repositories/home:/katacontainers:/release/RHEL_${VERSION_ID}/home:katacontainers:release.repo" + $ sudo -E yum -y install kata-runtime kata-proxy kata-shim + ``` + +2. Decide which container manager to use and select the corresponding link that follows: + + - [Docker](docker/rhel-docker-install.md) + - [Kubernetes](https://github.com/kata-containers/documentation/blob/master/Developer-Guide.md#if-you-want-to-run-kata-containers-with-kubernetes) diff --git a/install/ubuntu-installation-guide.md b/install/ubuntu-installation-guide.md index 583f103b36..c6fe204960 100644 --- a/install/ubuntu-installation-guide.md +++ b/install/ubuntu-installation-guide.md @@ -1,4 +1,4 @@ -# Installing Kata Containers on Ubuntu +# Install Kata Containers on Ubuntu > **Notes:** > @@ -27,7 +27,7 @@ $ sudo -E apt-get -y install kata-runtime kata-proxy kata-shim ``` -2. Decide which container manager you will use and select the corresponding link that follows: +2. Decide which container manager to use and select the corresponding link that follows: - [Docker](docker/ubuntu-docker-install.md) - [Kubernetes](https://github.com/kata-containers/documentation/blob/master/Developer-Guide.md#if-you-want-to-run-kata-containers-with-kubernetes)