Merge pull request #153 from GabyCT/topic/addrhel

docs: Add RHEL installation guide.

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:

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)

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 <<EOF | sudo tee /etc/systemd/system/docker.service.d/kata-containers.conf
+   [Service]
+   ExecStart=
+   ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime
+   EOF
+   ```
+
+3. Restart the Docker systemd service with the following commands:
+
+   ```bash
+   $ sudo systemctl daemon-reload
+   $ sudo systemctl restart docker
+   ```
+
+4. Run Kata Containers
+
+   You are now ready to run Kata Containers:
+
+   ```bash
+   $ sudo docker run -ti busybox uname -a
+   ```
+
+   The previous command shows details of the kernel version running inside the
+   container, which is different to the host kernel version.

install/fedora-installation-guide.md

@@ -1,4 +1,4 @@
-# Installing Kata Containers on Fedora
+# Install Kata Containers on Fedora
 
 > **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)

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)

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)