{"id":13471373,"url":"https://github.com/kubernetes-sigs/kwok","last_synced_at":"2025-05-14T00:07:37.457Z","repository":{"id":50297531,"uuid":"518708142","full_name":"kubernetes-sigs/kwok","owner":"kubernetes-sigs","description":"Kubernetes WithOut Kubelet -  Simulates thousands of Nodes and Clusters.","archived":false,"fork":false,"pushed_at":"2025-05-08T03:19:19.000Z","size":5319,"stargazers_count":2800,"open_issues_count":24,"forks_count":222,"subscribers_count":20,"default_branch":"main","last_synced_at":"2025-05-08T03:24:05.281Z","etag":null,"topics":["docker","golang","k8s-sig-scheduling","kubernetes","mulit-cluster","nerdctl","simulator"],"latest_commit_sha":null,"homepage":"https://kwok.sigs.k8s.io","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/kubernetes-sigs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"supported_releases.txt","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-07-28T05:09:06.000Z","updated_at":"2025-05-08T03:19:24.000Z","dependencies_parsed_at":"2023-10-16T17:01:47.565Z","dependency_job_id":"559324bf-7085-4483-8c94-112f0cd5555d","html_url":"https://github.com/kubernetes-sigs/kwok","commit_stats":{"total_commits":583,"total_committers":57,"mean_commits":"10.228070175438596","dds":0.3259005145797599,"last_synced_commit":"d2519e46134d6d0ea0100c062ccbb7375a020c5f"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":"kubernetes/kubernetes-template-project","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fkwok","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fkwok/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fkwok/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fkwok/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubernetes-sigs","download_url":"https://codeload.github.com/kubernetes-sigs/kwok/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254043781,"owners_count":22005016,"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":["docker","golang","k8s-sig-scheduling","kubernetes","mulit-cluster","nerdctl","simulator"],"created_at":"2024-07-31T16:00:43.840Z","updated_at":"2025-05-14T00:07:37.441Z","avatar_url":"https://github.com/kubernetes-sigs.png","language":"Go","funding_links":[],"categories":["Go","Testing \u0026 Conformance","kubernetes","K8S-Tools","golang"],"sub_categories":[],"readme":"# `KWOK` (`K`ubernetes `W`ith`O`ut `K`ubelet)\n\n\u003cimg align=\"right\" width=\"180px\" src=\"./logo/kwok.svg\"/\u003e\n\n[KWOK] is pronounced as `/kwɔk/`.\n\n[KWOK] is a toolkit that enables setting up a cluster of thousands of Nodes in seconds.\nUnder the scene, all Nodes are simulated to behave like real ones, so the overall approach employs\na pretty low resource footprint that you can easily play around on your laptop.\n\n## What is KWOK?\n\nKWOK stands for Kubernetes WithOut Kubelet. So far, it provides two tools:\n\n- `kwok` is the cornerstone of this project, responsible for simulating the lifecycle of fake nodes, pods, and other Kubernetes API resources.\n- `kwokctl` is a CLI tool designed to streamline the creation and management of clusters, with nodes simulated by `kwok`.\n\nPlease see [our website] for more in-depth information.\n\n\u003cimg width=\"700px\" src=\"./demo/manage-clusters.svg\"\u003e\n\n## Why KWOK?\n\n- Lightweight: You can [simulate thousands of nodes] on your laptop without significant consumption of CPU or memory resources.\nCurrently, KWOK can reliably maintain 1k nodes and 100k pods easily.\n- Fast: You can create and delete clusters and nodes almost instantly, without waiting for boot or provisioning.\nCurrently, KWOK can create 20 nodes or pods per second.\n- Compatibility: KWOK works with any tools or clients that are compliant with Kubernetes APIs, such as kubectl, helm, kui, etc.\n- Portability: KWOK has no specific hardware or software requirements. You can [run it using pre-built images], once Docker or Nerdctl is installed. Alternatively, binaries are also available for all platforms and can be easily installed.\n- Flexibility: You can configure different node types, labels, taints, capacities, conditions, etc., and you can configure different pod behaviors, status, etc. to test different scenarios and edge cases.\n\n## Community\n\nSee our own [contributor guide] and the Kubernetes [community page].\n\n### Getting Involved\n\nIf you're interested in participating in future discussions or development related to KWOK, there are several ways to get involved:\n\n- Slack: [#kwok] for general usage discussion, [#kwok-dev] for development discussion. (visit [slack.k8s.io] for a workspace invitation)\n- Open Issues/PRs/Discussions in [sigs.k8s.io/kwok]\n\n### Code of conduct\n\nParticipation in the Kubernetes community is governed by the [Kubernetes Code of Conduct][code of conduct].\n\n[KWOK]: https://sigs.k8s.io/kwok\n[our website]: https://kwok.sigs.k8s.io\n[community page]: https://kubernetes.io/community/\n[contributor guide]: https://kwok.sigs.k8s.io/docs/contributing/getting-started\n[code of conduct]: https://github.com/kubernetes-sigs/kwok/blob/main/code-of-conduct.md\n[sigs.k8s.io/kwok]: https://sigs.k8s.io/kwok/\n[#kwok]: https://kubernetes.slack.com/messages/kwok/\n[#kwok-dev]: https://kubernetes.slack.com/messages/kwok-dev/\n[slack.k8s.io]: https://slack.k8s.io/\n[simulate thousands of nodes]: https://kwok.sigs.k8s.io/docs/user/kwok-manage-nodes-and-pods/\n[run it using pre-built images]: https://kwok.sigs.k8s.io/docs/user/all-in-one-image/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes-sigs%2Fkwok","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubernetes-sigs%2Fkwok","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes-sigs%2Fkwok/lists"}