aljaz/kata-containers
1
0
Fork 0
mirror of https://github.com/aljazceru/kata-containers.git synced 2026-02-21 06:24:23 +01:00
Code Issues Packages Projects Releases Wiki Activity

docs: Add RHEL installation guide.

Browse Source 
This will add the RHEL installation guide for the OBS packages for
kata runtime.

Fixes #86

Signed-off-by: Gabriela Cervantes <gabriela.cervantes.tellez@intel.com>
This commit is contained in:
Gabriela Cervantes
2018-06-12 03:47:35 -05:00
parent a0a0a7b4ac
commit 8bc69ec8cf
6 changed files with 94 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

55
install/docker/rhel-docker-install.md Normal file
View File

@@ -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.