cgars / docker-admin-toolkit

Administration and troubleshooting tools inside a docker container

Docker System Admin and Troubleshooting Toolkit

This project focus on providing system administration and troubleshooting tools without the need of installing them in the host system.

Tools

• bash - GNU Bourne-Again SHell.
• bind-tools - The ISC DNS tools (dig, nslookup, host).
• curl - Tool to transfer data from or to a server.
• htop - A ncurses-based process viewer for Linux. (built from source, allows to watch the host's processes)
• iotop - Simple top-like I/O monitor.
• iptraf-ng - An IP Network Monitoring tool.
• jq - Commandline JSON processor.
• nano - Text Editor. GNU nano is designed to be a free replacement for the Pico text editor.
• netcat - Utility which reads and writes data across network connections using TCP or UDP protocol.
• net-tools - Includes network tools such as arp, ifconfig, netstat, rarp, nameif and route.
• openssh-client - OpenSSH SSH client.
• python 2 - An interpreted, interactive, object-oriented programming language.
• sysstat - System performance tools for the Linux operating system.
• tcpdump - Dump traffic on a network.
• tshark - network protoccol analyzer - console version.
• vim - Vi IMproved, a programmers text editor.

Running the container

Use --net=host allows tcpdump to access the host's network interfaces.

Use -v /proc:/proc_host allows htop to watch the host's processes. Note that htop is unable to kill any host's processes.

Optionally you can create a local directory and map it to the container like -v /tmp/data/:/tmp/data/:

mkdir /tmp/data

docker run \
    --rm \
    --name toolkit \
    --net=host \
    -v /proc:/proc_host \
    -v /tmp/data/:/tmp/data/ \
    -it \
    jonathadv/admin-toolkit \
    bash