bocker README

The project's README from github.com/p8952/bocker. As one markdown file: README.md.

Bocker

Docker implemented in around 100 lines of bash.

Prerequisites

The following packages are needed to run bocker.

Because most distributions do not ship a new enough version of util-linux you will probably need to grab the sources from here and compile it yourself.

Additionally your system will need to be configured with the following:

For ease of use a Vagrantfile is included which will build the needed environment.

Even if you meet the above prerequisites you probably still want to run bocker in a virtual machine. Bocker runs as root and among other things needs to make changes to your network interfaces, routing table, and firewall rules. I can make no guarantees that it won't trash your system.

Example Usage

$ bocker pull centos 7
######################################################################## 100.0%
######################################################################## 100.0%
######################################################################## 100.0%
Created: img_42150

$ bocker images
IMAGE_ID        SOURCE
img_42150       centos:7

$ bocker run img_42150 cat /etc/centos-release
CentOS Linux release 7.1.1503 (Core)

$ bocker ps
CONTAINER_ID       COMMAND
ps_42045           cat /etc/centos-release

$ bocker logs ps_42045
CentOS Linux release 7.1.1503 (Core)

$ bocker rm ps_42045
Removed: ps_42045

$ bocker run img_42150 which wget
which: no wget in (/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin)

$ bocker run img_42150 yum install -y wget
Installing : wget-1.14-10.el7_0.1.x86_64                                  1/1
Verifying  : wget-1.14-10.el7_0.1.x86_64                                  1/1
Installed  : wget.x86_64 0:1.14-10.el7_0.1
Complete!

$ bocker ps
CONTAINER_ID       COMMAND
ps_42018           yum install -y wget
ps_42182           which wget

$ bocker commit ps_42018 img_42150
Removed: img_42150
Created: img_42150

$ bocker run img_42150 which wget
/usr/bin/wget

$ bocker run img_42150 cat /proc/1/cgroup
...
4:memory:/ps_42152
3:cpuacct,cpu:/ps_42152

$ cat /sys/fs/cgroup/cpu/ps_42152/cpu.shares
512

$ cat /sys/fs/cgroup/memory/ps_42152/memory.limit_in_bytes
512000000

$ BOCKER_CPU_SHARE=1024 \
	BOCKER_MEM_LIMIT=1024 \
	bocker run img_42150 cat /proc/1/cgroup
...
4:memory:/ps_42188
3:cpuacct,cpu:/ps_42188

$ cat /sys/fs/cgroup/cpu/ps_42188/cpu.shares
1024

$ cat /sys/fs/cgroup/memory/ps_42188/memory.limit_in_bytes
1024000000

Functionality: Currently Implemented

† bocker init provides a very limited implementation of docker build

Functionality: Not Yet Implemented

License

Copyright (C) 2015 Peter Wilmott

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

bocker (p8952/bocker)

Searching Database…

12.7K ·GitHub
Что это такое?Bocker — минимальная переработка Docker, написанная примерно на 100 строках bash. Она создана, чтобы показать, как устроена основная функциональность контейнеров изнутри.
Это настоящая замена Docker или скорее учебный проект?Это bash-скрипт, который повторяет команды CLI Docker, используя примитивы Linux, такие как снимки btrfs, cgroups и сетевые мосты. Это учебная демонстрация внутреннего устройства Docker, а не среда выполнения контейнеров для продакшена.
Как это запустить?Склонируйте репозиторий и запустите скрипт bocker напрямую или используйте входящий в состав Vagrantfile, чтобы поднять предварительно настроенную виртуальную машину со всеми нужными пакетами и уже готовой сетевой конфигурацией.
Что нужно установить перед запуском?Нужны btrfs-progs, curl, iproute2, iptables, libcgroup-tools, util-linux >= 2.25.2 и coreutils >= 7.5. Кроме того, требуется файловая система btrfs, смонтированная в /var/bocker, и сетевой мост bridge0 с IP-адресом 10.0.0.1/24.
Какие части Docker отсутствуют?Контейнеры с томами данных, сами тома данных и проброс портов пока не реализованы. Поддержка docker build описана как очень ограниченная реализация.
Безопасно ли запускать это на моей обычной машине?Нет. Bocker работает от имени root и напрямую меняет сетевые интерфейсы, таблицу маршрутизации и правила файервола. Поэтому в README рекомендуется запускать его внутри виртуальной машины, даже если система уже соответствует требованиям.
Какие команды Docker поддерживает Bocker?Bocker реализует build (ограниченно), pull, images, ps, run, exec, logs, commit, rm и rmi, а также базовую сеть и поддержку квот через cgroups.
Зачем Bocker нужна файловая система btrfs?Копируемые при записи снимки btrfs используются для реализации слоёв контейнеров и коммитов образов. Это похоже на то, как сам Docker может использовать btrfs в качестве драйвера хранилища.
Есть ли простой способ попробовать это, не настраивая собственный Linux?Да, входящий в состав Vagrantfile создаёт виртуальную машину со всеми нужными пакетами, файловой системой и сетевым мостом, уже настроенными.
What are similar projects?ProxmoxVE, distrobox, webhook, hadolint, skopeo, Linux-, neofetch, Proxmox
Creator
p8952
Size
0.4 MB
Stars
12.7K
Updated
CommitAug 12
Age
11y
Commits · 90 Days