sapcc / kube-detective

A Kubernetes Network Validation Tool

Kubernetes Network Detective

This tool is used to validate the network setup of a Kubernetes cluster. It goes beyond the basic e2e tests and verifies each node of a cluster. This allows to find even the most arcane or temporary network problems.

Test Bed

Before any testing the following test bed is being created:

• Ephemeral Namespace
• Two pods per node. One with hostNetwork mode enabled, one without.
• For each pod a service is created. A unique external IP is assigned to each.

Test Scenarios

To test connectivty the tool will call a kubectl exec wget http://$IP:$PORT. It tests the following scenarios.

• Connectivity from Pod to Pod
• Connectivity from Pod to ClusterIP to Pod
• Connectivity from Pod to ExternalIP to Pod

It tests all possible permutations. This is not feasable for large clusters... Only schedulable nodes are taken into account.

Running

Default load order for .kubeconfig applies. If you have a working kubectl it will just work

kube-detective -externalCIDR 10.44.11.32/27

Additional logging can be enabled by setting --v=2 or --v=3.

Docker image

Docker image with latest binary is available at sapcc/kube-detective.

kube-detective's Issues

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• Update gopkg.in/tomb.v2 digest to dd63297
• Update alpine Docker tag to v3.19
• Update golang Docker tag to v1.22
• Update kubernetes packages to v0.30.0 (k8s.io/api, k8s.io/apimachinery, k8s.io/client-go)
• Update module k8s.io/klog/v2 to v2.120.1
• Click on this checkbox to rebase all open PRs at once

Detected dependencies

dockerfile

Dockerfile

• golang 1.19
• alpine 3.16

gomod

go.mod

• github.com/hashicorp/go-multierror v1.1.1
• gopkg.in/tomb.v2 v2.0.0-20161208151619-d5d1b5820637@d5d1b5820637
• k8s.io/api v0.21.11
• k8s.io/apimachinery v0.21.11
• k8s.io/client-go v0.21.11
• k8s.io/klog/v2 v2.9.0
• go 1.18

---

• Check this box to trigger a request for Renovate to run again on this repository