{"id":19096537,"url":"https://github.com/sapcc/kube-detective","last_synced_at":"2025-04-15T11:13:08.985Z","repository":{"id":58164098,"uuid":"63958973","full_name":"sapcc/kube-detective","owner":"sapcc","description":"A Kubernetes Network Validation Tool","archived":false,"fork":false,"pushed_at":"2025-03-12T09:12:17.000Z","size":30718,"stargazers_count":30,"open_issues_count":8,"forks_count":6,"subscribers_count":51,"default_branch":"master","last_synced_at":"2025-04-15T11:12:44.680Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sapcc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-07-22T14:20:03.000Z","updated_at":"2024-04-21T11:10:51.000Z","dependencies_parsed_at":"2023-02-10T01:30:46.632Z","dependency_job_id":"f3cf8d1a-ae6b-4aba-82dd-e0e338493cfc","html_url":"https://github.com/sapcc/kube-detective","commit_stats":{"total_commits":27,"total_committers":5,"mean_commits":5.4,"dds":0.6666666666666667,"last_synced_commit":"da7206f62256f9d03c9dce02275078fb4e8f06f3"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sapcc%2Fkube-detective","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sapcc%2Fkube-detective/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sapcc%2Fkube-detective/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sapcc%2Fkube-detective/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sapcc","download_url":"https://codeload.github.com/sapcc/kube-detective/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249058384,"owners_count":21205911,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T03:37:00.932Z","updated_at":"2025-04-15T11:13:08.963Z","avatar_url":"https://github.com/sapcc.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kubernetes Network Detective\n\nThis tool is used to validate the network setup of a Kubernetes cluster. It\ngoes beyond the basic e2e tests and verifies each node of a cluster. This\nallows to find even the most arcane or temporary network problems.\n\n## Test Bed\n\nBefore any testing the following test bed is being created:\n\n  * Ephemeral Namespace\n  * Two pods per node. One with `hostNetwork` mode enabled, one without.\n  * For each pod a service is created. A unique external IP is assigned to\n      each.\n\n## Test Scenarios\n\nTo test connectivty the tool will call a `kubectl exec wget http://$IP:$PORT`.\nIt tests the following scenarios.\n\n  * Connectivity from Pod to Pod\n  * Connectivity from Pod to ClusterIP to Pod\n  * Connectivity from Pod to ExternalIP to Pod\n\nIt tests all possible permutations. This is not feasable for large clusters...\nOnly `schedulable` nodes are taken into account.\n\n## Running\n\nDefault load order for `.kubeconfig` applies. If you have a working `kubectl`\nit will just work\n\n```\nkube-detective -externalCIDR 10.44.11.32/27\n```\n\nAdditional logging can be enabled by setting `--v=2` or `--v=3`.\n\n## Docker image\n\nDocker image with latest binary is available at [sapcc/kube-detective](https://hub.docker.com/repository/docker/sapcc/kube-detective).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsapcc%2Fkube-detective","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsapcc%2Fkube-detective","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsapcc%2Fkube-detective/lists"}