kwok-bench

This repository aims to help developers set up a large-scale, simulated Kubernetes cluster, to test and benchmark your applications, with ease using KWOK.

Usage

Prerequisites

• Python 3.6 or higher.
• Docker installed and running on your machine.

---

1. Install KWOK

   KWOK can be installed on Linux/MacOS systems via the Homebrew package manager:

   brew install kwok

   For other systems or installation methods, please refer to the official KWOK documentation.

2. Create a KWOK Cluster

   Create a new cluster named "demo" with the following command:

   kwokctl create cluster --name demo --config kwok.yaml

   Confirm that the cluster has been created successfully by running:

   kwokctl get clusters

3. Generate Resources

   Use the generate.py script to create fake resources in the new cluster. You can specify the number of resources per supported kind as arguments to the script:

   python generate.py apply --node 1 --daemonset 2

   This command will create 1 node and 2 daemonsets in the "demo" cluster.

   Removing resources can be achieved by running the script with the delete argument:

   python generate.py delete --node 3

   This command will delete 3 nodes

4. Deleting the Cluster

   After you have finished using the cluster, it is recommended to delete it to free up resources. You can easily do this with the following command:

   kwokctl delete cluster --name demo

Troubleshooting

If you encounter any issues or errors while using, please open an issue in this repository.

License

This project is licensed under the Apache-2.0 License.