Portal:Toolforge/Admin/Kubernetes/lima-kilo
This page contains information on Toolforge lima-kilo, a development and testing environment for Toolforge that reproduces most of the system components used in production.
The lima-kilo project is based on ansible and lima, light-weight linux VMs compatible with both linux and macOS (Intel and ARM) hosts.
Repository: https://gitlab.wikimedia.org/repos/cloud/toolforge/lima-kilo
Rationale
Developing some Toolforge kubernetes components can be challenging because Toolforge is not just a bare k8s deployment. It is Toolforge's kubernetes. There are custom admission webhooks, custom namespaces, a particular security model, some host files are expected to be present, etc.
The lima-kilo recreates most of this service context in a local environment in a way that, thanks to ansible and lima, is lightweight, robust, deterministic, idempotent and easy to use.
Lima-kilo uses kind for its kubernetes component. The lima guest VM runs Debian. So far, lima-kilo has been tested on various linux distributions and both Intel and ARM macOS. It should probably work on WSL2, but this is so far untested.
If you run into compatibility issues while trying to set up lima-kilo on your system, don't hesitate to ask for help.
The project was mildly inspired by MediaWiki-Vagrant.
Basic usage workflow
See the README file for some hints.