Skip to content

Latest commit

 

History

History
54 lines (36 loc) · 1.84 KB

README.md

File metadata and controls

54 lines (36 loc) · 1.84 KB

toolbox

Small Alpine based toolbox for Docker on CoreOS/Flatcar / RancherOS

Build Status

This toolbox includes general networking and admin tools, nano and vim text editors, rsync for backup, git and many tools geared towards performance metric gathering and debugging: Some of these tools include generic ones like htop, atop; more specific tools like iostat, iotop, pidstat and mpstat; network oriented tools like tcpdump, iftop, iperf and the iproute2 tools; and strace/ltrace for tracing. These are added to the tiny base install of Alpine, keeping the whole image as small as possible.

List of Tools/Packages:

file atop htop ltrace strace
sysstat bridge-utils ca-certificates
iftop iperf iproute2 net-tools nmap tcpdump
bash bash-completion curl gettext logrotate ncurses nano
ncdu hdparm screen pciutils psmisc tree
speedtest-cli shadow pv sslscan
git coreutils grep dig python2

Check the dockerfile for the complete list of tools.

CoreOS/Flatcar - set as the default toolbox:

sudo cat > ~/.toolboxrc << "EOF"
TOOLBOX_DOCKER_IMAGE=ghcr.io/container-projects/linux-toolbox:main
EOF

toolbox

On RancherOS:

Initialize the toolbox:

docker run -it --name toolbox -v /:/media/root --ipc=host --net=host --pid=host ghcr.io/container-projects/linux-toolbox:main

Run a command: docker exec ghcr.io/container-projects/linux-toolbox:main dig Enter the toolbox: docker start -ia ghcr.io/container-projects/linux-toolbox:main

Inside of the toolbox, the machine's filesystem is mounted to /media/root

Links

https://coreos.com/os/docs/latest/install-debugging-tools.html


License:
  • MIT