jonathadv/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.
• nmap - The Network Mapper - Free Security Scanner
• openssh-client - OpenSSH SSH client.
• python 3 - 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

docker-admin-toolkit's Issues

Make `top` to see host process

Despite of the fact the top inside a container is able to display CPU and memory real information, it still lacks the real process tree information. This issue is to try figure out how to make top inside a container to see all host process.

Evaluate the possibility of adding `dig`, `nano` and `iptraf`

Evaluate the possibility of adding dig, nano and iptraf.

Install iotop

"iotop is a top-like utility that monitors system input/output" [Gentoo Wiki] and it would be a good tool to add to this project.

Adds tshark

Make an analysis for adding tshark to the project.
https://www.wireshark.org/docs/man-pages/tshark.html