kqueen 0.11

Kubernetes cluster orchestrator

Overview

More information about KQueen Architecture and use cases is described in RATIONALE file.

Development

• Bootstrap kqueen environment

mkvirtualenv -p /usr/bin/python3 kqueen
pip3 install -e ".[dev]"
pip3 install --editable .
# start etcd in container
docker-compose up -d # start
kqueen

• Clean etcd storage and prepare examples

devenv.py will create few objects to provides basic developer environment. It will also try to download kubeconfig file for real cluster but it requires access to Mirantis VPN. However, it can be workarounded by creating file kubeconfig_remote in repository root and this file will be used instead of downloading it.

etcdctl rm --recursive /kqueen
./devenv.py

Demo environment

• Without local Kubernetes

docker-compose -f docker-compose.yml -f docker-compose.demo.yml up

• Including local Kubernetes (without kubelet)

docker-compose -f docker-compose.yml -f docker-compose.demo.yml -f docker-compose.kubernetes.yml up

• You can add some example data by running

docker-compose -f docker-compose.yml -f docker-compose.demo.yml exec kqueen ./devenv.py

It will add user admin with password default and few of testing objects.

Configuration

We load configuration from file config/dev.py by default and this can be configured by KQUEEN_CONFIG_FILE environment variable. Any environment variable matching name KQUEEN_* will be loaded and saved to configuration.

Documentation

For full documenation please refer to kqueen.readthedocs.io.

DEMOs

Generic KQueen Overview