https://github.com/nikitamishagin/netutils
This project provides a Docker image based on Ubuntu 24.04 (codename "noble") with a collection of essential network utilities. These tools are useful for network diagnostics, testing, and troubleshooting.
https://github.com/nikitamishagin/netutils
docker kubernetes-debugging netutil
Last synced: 3 months ago
JSON representation
This project provides a Docker image based on Ubuntu 24.04 (codename "noble") with a collection of essential network utilities. These tools are useful for network diagnostics, testing, and troubleshooting.
- Host: GitHub
- URL: https://github.com/nikitamishagin/netutils
- Owner: nikitamishagin
- License: apache-2.0
- Created: 2024-11-28T16:41:02.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-12-03T11:03:11.000Z (7 months ago)
- Last Synced: 2025-01-30T09:41:50.233Z (5 months ago)
- Topics: docker, kubernetes-debugging, netutil
- Language: Dockerfile
- Homepage:
- Size: 9.77 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Network Utilities Docker Image
This project provides a Docker image based on Ubuntu 24.04 (codename "noble") with a collection of essential network
utilities. These tools are useful for network diagnostics, testing, and troubleshooting.
## Included Utilities
The Docker image includes the following packages:
- **curl**: Command-line tool for transferring data with URLs, supporting various protocols.
- **dnsutils**: A collection of utilities for managing DNS, including `dig` and `nslookup`.
- **iproute2**: Collection of utilities for network management, including `ip`.
- **iputils-ping**: Tools to send ICMP ECHO_REQUEST to network hosts using `ping`.
- **nmap**: Network exploration tool and security/port scanner.
- **telnet**: User interface to the TELNET protocol.
- **traceroute**: Print the route packets take to a network host.
- **wget**: Command-line utility for retrieving files from the web.
## Usage in Kubernetes
To deploy this image in a Kubernetes cluster, you can use the following deployment manifest. This setup allows you to
run the network utilities in a pod.
### Deployment Manifest
```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: netutils
spec:
replicas: 1
selector:
matchLabels:
app: netutils
template:
metadata:
labels:
app: netutils
spec:
containers:
- name: netutils
image: nikitamishagin/netutils:latest
command: ["/bin/sh", "-c", "sleep infinity"]
# Uncomment below to run as a privileged pod
# securityContext:
# privileged: true
# Uncomment and modify nodeSelector below for specific node assignment
# nodeSelector:
# kubernetes.io/hostname: specific-node
# Uncomment the line below to enable host networking
# hostNetwork: true
dnsPolicy: ClusterFirst # Default policy which uses cluster DNS first
# Available options:
# - ClusterFirst: Use cluster DNS service first, falling back to upstream DNS servers.
# - ClusterFirstWithHostNet: Similar to ClusterFirst, but used when host networking is enabled (hostNetwork: true).
# - Default: Use the default DNS resolver configured on the node.
# - None: No DNS settings will be provided by the cluster. Use dnsConfig for custom DNS.
# dnsConfig:
# nameservers:
# - 8.8.8.8
# - 8.8.4.4
# searches:
# - example.com
# options:
# - name: ndots
# value: "2"
```
### Example Usage
Once deployed, you can exec into the pod and use the network utilities:
```bash
kubectl exec -it deployments/netutils -- bash
```
Then, you can run any of the utilities as needed.
## CI/CD
This project includes a GitHub Actions workflow configured to automatically build and push the Docker image to Docker
Hub whenever a new tag is pushed to the repository. The image is tagged with both the specific Git tag and `latest`.
## Contributing
Contributions are welcome! If you have any suggestions for improvements or new features, feel free to open an issue or
submit a pull request.
## License
This project is licensed under the Apache License 2.0. See the [LICENSE](./LICENSE) file for details.