Applied Computing Research Labs Logo
Open source research and development in distributed systems

build status

simkube #

A collection of tools for simulating Kubernetes scheduling and autoscaling behaviour

Overview #

This package provides the following components:

Architecture Diagram #

architecture diagram of SimKube

Demo #

Watch the video

Installation #

  1. To install sk-tracer in your prod cluster: kubectl apply -k k8s/kustomize/prod
  2. To install sk-ctrl in your simulation cluster: kubectl apply -k k8s/kustomize/sim
  3. To install skctl on your dev machine: cargo install skctl

Documentation #

Full documentation for SimKube is available on Applied Computing's website. Here are some quick links to select topics:

Community #

We have a channel on the Kubernetes Slack instance! Come chat with us there. (You can sign up for the Kubernetes Slack instance for free)

Contributing #

We welcome any and all contributions to the SimKube project! Please open a pull request.

If you have a feature request, please start a discussion. Members of the SimKube team will determine whether the feature should become planned work and how it will be prioritized.

If you've found a bug or are working on a planned improvement, please open an issue!

Code of Conduct #

Applied Computing Research Labs has a strict code of conduct we expect all contributors to adhere to. Please read the full text so that you understand the expectations upon you as a contributor.

SimKube is licensed under the MIT License. Contributors to this project agree that they own the copyrights to all contributed material, and agree to license your contributions under the same terms. This is "inbound=outbound", and is the GitHub default.

Warning

Due to the uncertain nature of copyright and IP law, this repository does not accept contributions that have been all or partially generated with GitHub Copilot or other LLM-based code generation tools. Please disable any such tools before authoring changes to this project.