aeciopires/nettools repository overview

⁠nettools

• nettools⁠
• About⁠
• Run this image⁠
  • In Docker container⁠
  • In Kubernetes cluster⁠
    • CLI⁠
    • Manifest⁠
• Contributing⁠
  • Updating and publishing this image⁠
  • Creating container⁠
• Maintainers⁠
• License⁠

⁠About

A simple and small Docker image with some handy networking tools installed.

References:

• https://github.com/pmietlicki/docker-nettools⁠
• https://github.com/travelping/docker-nettools⁠
• https://github.com/nicolaka/netshoot⁠
• https://hub.docker.com/r/pmietlicki/nettools⁠
• https://hub.docker.com/r/travelping/nettools⁠
• https://hub.docker.com/r/nicolaka/netshoot⁠
• https://gist.github.com/pythoninthegrass/d2cc2ef4ba6d5291f3f6d0c51fc3e099⁠

Repository in Docker Hub:

• hub.docker.com/r/aeciopires/nettools⁠
• https://hub.docker.com/r/aeciopires/nettools/tags⁠

Tools:

Consult the documentation about how use theese tools.

• apache2-utils
• bash
• bind-tools
• bird
• bridge-utils
• busybox-extras
• conntrack-tools
• coreutils
• curl
• dhcping
• drill
• elinks
• ethtool
• file
• fping
• git
• gnupg
• httpie
• iftop
• iperf
• iperf3
• iproute2
• ipset
• ip6tables
• iptables
• iputils
• iputils-tracepath
• iptraf-ng
• ipvsadm
• jq
• keepalived
• lshw
• lz4
• mtr
• nano
• net-tools
• netcat-openbsd
• net-snmp-tools
• nftables
• ngrep
• nmap
• nmap-nping
• nmap-scripts
• oh-my-zsh
• openssl
• openssh
• speedtest-cli
• socat
• strace
• swaks
• tcpdump
• tcptraceroute
• trippy
• vim
• websocat
• wget
• zsh
• zstd

Please see the Dockerfile⁠ for a complete list of tools.

⁠Run this image

⁠In Docker container

docker run -it --rm --name nettools aeciopires/nettools:latest zsh

⁠In Kubernetes cluster

⁠CLI

Access the Kubernetes cluster and run this command.

kubectl run --rm -it nettools-$(< /dev/urandom tr -dc a-z-0-9 | head -c${1:-4}) --image=aeciopires/nettools:latest -n NAMESPACE -- /bin/zsh

# or
kubectl run --rm -it nettools-$(< /dev/urandom tr -dc a-z-0-9 | head -c${1:-4}) --image=aeciopires/nettools:latest -n NAMESPACE -- /bin/bash

# or
kubectl run --rm -it nettools-$(< /dev/urandom tr -dc a-z-0-9 | head -c${1:-4}) --image=aeciopires/nettools:latest -n NAMESPACE -- /bin/sh

Creating alias nettools with this command:

echo "alias nettools='kubectl run --rm -it nettools-$(< /dev/urandom tr -dc a-z-0-9 | head -c${1:-4}) --image=aeciopires/nettools:latest -n NAMESPACE -- /bin/zsh'" >> $HOME/.bashrc
source $HOME/.bashrc

nettools

⁠Manifest

Access the Kubernetes cluster and run this command.

kubectl apply -f nettools.yaml -n NAMESPACE

kubectl exec -i -t deploy/nettools -n NAMESPACE -- zsh

⁠Contributing

• See the REQUIREMENTS.md⁠ file.
• See the CONTRIBUTING.md⁠ file.

⁠Updating and publishing this image

• Create or access your account in Docker Hub and create the repository for custom image. Example: https://hub.docker.com/r/DOCKER_HUB_ACCOUNT/nettools⁠.

• Change the Dockerfile.

• Change the value of the VERSION variable in nettools/Makefile file.

• Commands to build the image:

cd nettools

make image

⁠Creating container

Commands to run a container:

cd nettools

make container

⁠Maintainers

• Aécio dos Santos Pires (linkedin.com/in/aeciopires⁠)

⁠License

• See the LICENSE⁠ file.