What is kanku?
kanku is designed to give you a better integration of your kiwi images built by the Open Build Service (OBS) in your development and testing workflow.
It can be run in two modes
- The developer mode (e.g. on your laptop/workstation) while developing
- The server mode (e.g. a dedicated Server for QA) to run tasks/tests periodically
The developer mode
In a simple configuration file in YAML format you can specify the location of your kiwi image and actions to be executed after downloading the image and starting a Virtual Machine using the downloaded image. You can configure one or multiple jobs per project. These jobs consists of one or more tasks which use a handler module and the given options.
With the kanku command line tool you can easily
- create a new VM based on the configured image
- run commands on the VM via SSH or serial console
- use salt-ssh to configure your VM
- access the created VM via ssh
- share your project/source directory with the VM
The server mode
In server mode, a daemon process, the "kanku-scheduler", can run configured jobs peridocally or you can trigger a job manually. As the job configuration is very similar to the developer mode, you can easily adopt the configurations used in developer mode. The results can be shown via WebUI or with the kanku command line tool in a terminal
Overview and Concept
- use_module: Kanku::Handler::OBSCheck options: api_url: https://api.opensuse.org project: devel:kanku:images # package e.g. openSUSE-Leap-15.0-JeOS package: <package name> # e.g. images_leap_15_0 repository: <repository name>