github/kata-containers
1
0
Fork 1
mirror of https://github.com/kata-containers/kata-containers.git synced 2025-08-13 05:36:13 +00:00
Code Issues Projects Releases Wiki Activity

Merge pull request #447 from jodh-intel/fix-debian-docker-install

Browse Source 
Fix debian docker install
This commit is contained in:
GabyCT 2019-04-26 08:53:59 -05:00 committed by GitHub
commit 1deb4d2d80
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
8 changed files with 130 additions and 132 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
install/debian-installation-guide.md
View File

@ -2,30 +2,30 @@
1. Install the unsatisfied dependencies 1. Install the unsatisfied dependencies
Kata Containers packages depends on a version of `librbd1` that's not yet available in the `stable` repo. Kata Containers packages depends on a version of `librbd1` that's not yet available in the `stable` repo.
A more recent version of `librbd1` can be installed from the `unstable` repo: https://packages.debian.org/sid/librbd1 A more recent version of `librbd1` can be installed from the `unstable` repo: https://packages.debian.org/sid/librbd1
Add `unstable` repo to `/etc/apt/sources.list.d/unstable.list` sources list: Add `unstable` repo to `/etc/apt/sources.list.d/unstable.list` sources list:
```bash
$ sudo sh -c "echo '# for unstable packages
deb http://ftp.debian.org/debian/ unstable main contrib non-free
deb-src http://ftp.debian.org/debian/ unstable main contrib non-free' > /etc/apt/sources.list.d/unstable.list"
```
Set the repository to a lower priority than stable, to ensures that APT will prefer stable packages over unstable ones. This can be specified in `/etc/apt/preferences.d/unstable`:
```bash
$ sudo sh -c "echo 'Package: *
Pin: release a=unstable
Pin-Priority: 10' >> /etc/apt/preferences.d/unstable"
```
Finally, install `librbd1`: ```bash
$ sudo sh -c "echo '# for unstable packages
deb http://ftp.debian.org/debian/ unstable main contrib non-free
deb-src http://ftp.debian.org/debian/ unstable main contrib non-free' > /etc/apt/sources.list.d/unstable.list"
```
```bash Set the repository to a lower priority than stable, to ensures that APT will prefer stable packages over unstable ones. This can be specified in `/etc/apt/preferences.d/unstable`:
$ sudo apt-get update && sudo apt-get install -y -t unstable librbd1
``` ```bash
$ sudo sh -c "echo 'Package: *
Pin: release a=unstable
Pin-Priority: 10' >> /etc/apt/preferences.d/unstable"
```
Finally, install `librbd1`:
```bash
$ sudo apt-get update && sudo apt-get install -y -t unstable librbd1
```
2. Install the Kata Containers components with the following commands: 2. Install the Kata Containers components with the following commands:

62
install/docker/centos-docker-install.md
View File

@ -23,46 +23,46 @@
2. Configure Docker to use Kata Containers by default with one of the following methods: 2. Configure Docker to use Kata Containers by default with one of the following methods:
1. systemd 1. systemd
```bash ```bash
$ sudo mkdir -p /etc/systemd/system/docker.service.d/ $ sudo mkdir -p /etc/systemd/system/docker.service.d/
$ cat <<EOF | sudo tee /etc/systemd/system/docker.service.d/kata-containers.conf $ cat <<EOF | sudo tee /etc/systemd/system/docker.service.d/kata-containers.conf
[Service] [Service]
ExecStart= ExecStart=
ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime
EOF EOF
``` ```
2. Docker `daemon.json` 2. Docker `daemon.json`
Add the following definitions to `/etc/docker/daemon.json`: Add the following definitions to `/etc/docker/daemon.json`:
```json ```json
{ {
"default-runtime": "kata-runtime", "default-runtime": "kata-runtime",
"runtimes": { "runtimes": {
"kata-runtime": { "kata-runtime": {
"path": "/usr/bin/kata-runtime" "path": "/usr/bin/kata-runtime"
} }
} }
} }
``` ```
3. Restart the Docker systemd service with the following commands: 3. Restart the Docker systemd service with the following commands:
```bash ```bash
$ sudo systemctl daemon-reload $ sudo systemctl daemon-reload
$ sudo systemctl restart docker $ sudo systemctl restart docker
``` ```
4. Run Kata Containers 4. Run Kata Containers
You are now ready to run Kata Containers: You are now ready to run Kata Containers:
```bash ```bash
$ sudo docker run busybox uname -a $ sudo docker run busybox uname -a
``` ```
The previous command shows details of the kernel version running inside the The previous command shows details of the kernel version running inside the
container, which is different from the host kernel version. container, which is different to the host kernel version.

29
install/docker/debian-docker-install.md
View File

@ -31,7 +31,7 @@ a. sysVinit
- with sysVinit, docker config is stored in `/etc/default/docker`, edit the options similar to the following: - with sysVinit, docker config is stored in `/etc/default/docker`, edit the options similar to the following:
``` ```sh
$ sudo sh -c "echo '# specify docker runtime for kata-containers $ sudo sh -c "echo '# specify docker runtime for kata-containers
DOCKER_OPTS=\"-D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime\"' >> /etc/default/docker" DOCKER_OPTS=\"-D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime\"' >> /etc/default/docker"
``` ```
@ -47,34 +47,34 @@ b. systemd
EOF EOF
``` ```
c. systemd Docker `daemon.json` c. Docker `daemon.json`
Add the following definitions to `/etc/docker/daemon.json`: Add the following definitions to `/etc/docker/daemon.json`:
```bash ```json
$ sudo sh -c "echo '{ {
\"default-runtime\": \"kata-runtime\", "default-runtime": "kata-runtime",
\"runtimes\": { "runtimes": {
\"kata-runtime\": { "kata-runtime": {
\"path\": \"/usr/bin/kata-runtime\" "path": "/usr/bin/kata-runtime"
} }
} }
}' >> /etc/docker/daemon.json" }
``` ```
3. Restart the Docker systemd service with one of the following (depending on init choice): 3. Restart the Docker systemd service with one of the following (depending on init choice):
a. sysVinit a. sysVinit
```bash ```sh
$ sudo /etc/init.d/docker stop $ sudo /etc/init.d/docker stop
$ sudo /etc/init.d/docker start $ sudo /etc/init.d/docker start
``` ```
to watch for errors: To watch for errors:
```bash ```sh
tail -f /var/log/docker.log $ tail -f /var/log/docker.log
``` ```
b. systemd b. systemd
@ -94,6 +94,3 @@ c. systemd Docker `daemon.json`
The previous command shows details of the kernel version running inside the The previous command shows details of the kernel version running inside the
container, which is different to the host kernel version. container, which is different to the host kernel version.

42
install/docker/fedora-docker-install.md
View File

@ -25,31 +25,31 @@
2. Configure Docker to use Kata Containers by default with one of the following methods: 2. Configure Docker to use Kata Containers by default with one of the following methods:
1. systemd 1. systemd
```bash ```bash
$ sudo mkdir -p /etc/systemd/system/docker.service.d/ $ sudo mkdir -p /etc/systemd/system/docker.service.d/
$ cat <<EOF | sudo tee /etc/systemd/system/docker.service.d/kata-containers.conf $ cat <<EOF | sudo tee /etc/systemd/system/docker.service.d/kata-containers.conf
[Service] [Service]
ExecStart= ExecStart=
ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime
EOF EOF
``` ```
2. Docker `daemon.json` 2. Docker `daemon.json`
Add the following definitions to `/etc/docker/daemon.json`: Add the following definitions to `/etc/docker/daemon.json`:
```json ```json
{ {
"default-runtime": "kata-runtime", "default-runtime": "kata-runtime",
"runtimes": { "runtimes": {
"kata-runtime": { "kata-runtime": {
"path": "/usr/bin/kata-runtime" "path": "/usr/bin/kata-runtime"
} }
} }
} }
``` ```
3. Restart the Docker systemd service with the following commands: 3. Restart the Docker systemd service with the following commands:

42
install/docker/rhel-docker-install.md
View File

@ -24,31 +24,31 @@
2. Configure Docker to use Kata Containers by default with one of the following methods: 2. Configure Docker to use Kata Containers by default with one of the following methods:
1. systemd 1. systemd
```bash ```bash
$ sudo mkdir -p /etc/systemd/system/docker.service.d/ $ sudo mkdir -p /etc/systemd/system/docker.service.d/
$ cat <<EOF | sudo tee /etc/systemd/system/docker.service.d/kata-containers.conf $ cat <<EOF | sudo tee /etc/systemd/system/docker.service.d/kata-containers.conf
[Service] [Service]
ExecStart= ExecStart=
ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime
EOF EOF
``` ```
2. Docker `daemon.json` 2. Docker `daemon.json`
Add the following definitions to `/etc/docker/daemon.json`: Add the following definitions to `/etc/docker/daemon.json`:
```json ```json
{ {
"default-runtime": "kata-runtime", "default-runtime": "kata-runtime",
"runtimes": { "runtimes": {
"kata-runtime": { "kata-runtime": {
"path": "/usr/bin/kata-runtime" "path": "/usr/bin/kata-runtime"
} }
} }
} }
``` ```
3. Restart the Docker systemd service with the following commands: 3. Restart the Docker systemd service with the following commands:

2
install/docker/sles-docker-install.md
View File

@ -20,7 +20,7 @@
For more information on installing Docker please refer to the For more information on installing Docker please refer to the
[Docker Guide](https://www.suse.com/documentation/sles-12/singlehtml/book_sles_docker/book_sles_docker.html). [Docker Guide](https://www.suse.com/documentation/sles-12/singlehtml/book_sles_docker/book_sles_docker.html).
2. Configure Docker to use Kata Containers with one of the following methods: 2. Configure Docker to use Kata Containers by default with one of the following methods:
1. systemd 1. systemd

42
install/docker/ubuntu-docker-install.md
View File

@ -27,31 +27,31 @@
2. Configure Docker to use Kata Containers by default with one of the following methods: 2. Configure Docker to use Kata Containers by default with one of the following methods:
1. systemd 1. systemd
```bash ```bash
$ sudo mkdir -p /etc/systemd/system/docker.service.d/ $ sudo mkdir -p /etc/systemd/system/docker.service.d/
$ cat <<EOF | sudo tee /etc/systemd/system/docker.service.d/kata-containers.conf $ cat <<EOF | sudo tee /etc/systemd/system/docker.service.d/kata-containers.conf
[Service] [Service]
ExecStart= ExecStart=
ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime ExecStart=/usr/bin/dockerd -D --add-runtime kata-runtime=/usr/bin/kata-runtime --default-runtime=kata-runtime
EOF EOF
``` ```
2. Docker `daemon.json` 2. Docker `daemon.json`
Add the following definitions to `/etc/docker/daemon.json`: Add the following definitions to `/etc/docker/daemon.json`:
```json ```json
{ {
"default-runtime": "kata-runtime", "default-runtime": "kata-runtime",
"runtimes": { "runtimes": {
"kata-runtime": { "kata-runtime": {
"path": "/usr/bin/kata-runtime" "path": "/usr/bin/kata-runtime"
} }
} }
} }
``` ```
3. Restart the Docker systemd service with the following commands: 3. Restart the Docker systemd service with the following commands:

1
install/ubuntu-installation-guide.md
View File

@ -1,6 +1,7 @@
# Install Kata Containers on Ubuntu # Install Kata Containers on Ubuntu
1. Install the Kata Containers components with the following commands: 1. Install the Kata Containers components with the following commands:
```bash ```bash
$ ARCH=$(arch) $ ARCH=$(arch)
$ BRANCH="${BRANCH:-master}" $ BRANCH="${BRANCH:-master}"