README.md

iPerf3 Container

Purpose

I have created this container to either work as a server or as a client. It is a simple container based on alpine:3.17 with the iperf3 as a entrypoint.

Docker

As a server

$ docker run -it --rm -p 5201:5201 ghcr.io/michaeltrip/iperf3container:latest -s

As a client

$ docker run -it --rm -p ghcr.io/michaeltrip/iperf3container:latest -c <iperf3hostname> -p <targetport> -t <duration_in_seconds>

Podman

As a server

$ podman run -it --rm -p 5201:5201 ghcr.io/michaeltrip/iperf3container:latest -s

As a client

$ podman run -it --rm ghcr.io/michaeltrip/iperf3container:latest -c <iperf3hostname> -p <targetport> -t <duration_in_seconds>

Kubernetes

You can run both the server and the client in Kubernetes. In the examples directory are both examples for the server and the client. Note that the client is a job in this case.

Run as a one time pod:

$ kubectl run iperf3container-pod ghcr.io/michaeltrip/iperf3container:latest -- -c <iperf3hostname> -p <targetport> -t <duration_in_seconds>