{"id":20592980,"url":"https://github.com/fusakla/k8s-service-broadcasting","last_synced_at":"2025-04-14T22:56:12.852Z","repository":{"id":57509292,"uuid":"236371283","full_name":"FUSAKLA/k8s-service-broadcasting","owner":"FUSAKLA","description":"Tool allowing to broadcast/mirror/duplicate HTTP requests to all ready endpoints of a Kubernetes service.","archived":false,"fork":false,"pushed_at":"2020-01-27T22:59:04.000Z","size":19505,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-14T22:56:06.925Z","etag":null,"topics":["broadcast","http","kubernetes","proxy","traffic-mirroring"],"latest_commit_sha":null,"homepage":"","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/FUSAKLA.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-01-26T20:24:32.000Z","updated_at":"2025-01-03T21:53:23.000Z","dependencies_parsed_at":"2022-09-12T21:41:14.034Z","dependency_job_id":null,"html_url":"https://github.com/FUSAKLA/k8s-service-broadcasting","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FUSAKLA%2Fk8s-service-broadcasting","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FUSAKLA%2Fk8s-service-broadcasting/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FUSAKLA%2Fk8s-service-broadcasting/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FUSAKLA%2Fk8s-service-broadcasting/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FUSAKLA","download_url":"https://codeload.github.com/FUSAKLA/k8s-service-broadcasting/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248975330,"owners_count":21192208,"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":["broadcast","http","kubernetes","proxy","traffic-mirroring"],"created_at":"2024-11-16T07:47:06.741Z","updated_at":"2025-04-14T22:56:12.828Z","avatar_url":"https://github.com/FUSAKLA.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# K8s service broadcasting\n\n[![CircleCI](https://img.shields.io/circleci/build/github/FUSAKLA/k8s-service-broadcasting/master?style=flat-square)](https://app.circleci.com/github/FUSAKLA/k8s-service-broadcasting/pipelines?branch=master)\n[![Docker Pulls](https://img.shields.io/docker/pulls/fusakla/k8s-service-broadcasting?style=flat-square)](https://hub.docker.com/repository/docker/fusakla/k8s-service-broadcasting)\n\nTool allowing to broadcast/mirror/duplicate HTTP requests to all ready endpoints of a Kubernetes service.\n\nIt supports two modes:\n - _Consistency_: Waits for response from all service endpoints and and response with one of erroneous response otherwise one of the succeeded. \n - _Availability_: Responses with first successful response if any, otherwise with one of the error messages.\n\nThis behaviour can be controlled by the `--all-must-succeed` flag. Defaults to `true`.\n\n## Usage\n\n```bash\n$ ./k8s-service-broadcasting --help\nTool allowing to broadcast/mirror/duplicate HTTP requests to all endpoints of Kubernetes service.\nWaits for all of them to end and reports back failed request if any. If not returns last successful.\n\nUsage:\n  k8s-service-broadcasting [flags]\n\nFlags:\n      --all-must-succeed           By default if any backend fails, the whole request fails. If disabled one succeeded response is enough. (default true)\n  -h, --help                       help for k8s-service-broadcasting\n  -i, --interface string           Interface to listen on. (default \"0.0.0.0:8080\")\n      --keepalive                  If keepalive should be enabled. (default true)\n  -k, --kubeconfig string          Location of the kubeconfig, default if in cluster config or value of KUBECONFIG env variable. (default \"/home/fusakla/.kube/conf/kubeconfig.yaml\")\n  -l, --log-level string           Log level (debug, info, warning, ...) default info. (default \"info\")\n  -m, --metrics-interface string   Interface for exposing metrics. (default \"0.0.0.0:8081\")\n  -n, --namespace string           Namespace to watch for.\n  -p, --port-name string           Name of service port to sed the requests to.\n  -s, --service string             Name of service to sed the requests to.\n  -t, --timeout duration           Timeout for mirrored requests. (default 10s)\n```\n\n## Instrumentation\nThere is second interface for exposing Prometheus metrics and providing lifecycle endpoints.\nThis interface is running by default on `0.0.0.0:8081`. The endpointa are:\n- `/metrics` Prometheus metrics\n- `/-/healthy` liveness probe\n- `/-/ready` readiness probe \n\n## Build\n**single binary**\n```bash\nmake build\n```\n\n## Deployment\nSee the [`kubernetes/`](./kubernetes) folder with example.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffusakla%2Fk8s-service-broadcasting","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffusakla%2Fk8s-service-broadcasting","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffusakla%2Fk8s-service-broadcasting/lists"}