Skip to main content

In Rancher Openstack; Now Install Kubernetes (Ironik); Python CLI Tool for deploying Kubernetes on OpenStack via Rancher.

Project description

PyPI Python Version Read the documentation at pre-commit Black


  • Utilize OpenStack and Rancher APIs to automatically deploy Kubernetes cluster

  • Customize the configuration using templates

  • Install new Kubernetes versions including deploying the external cloud controller manager for OpenStack


You can install ironik via pip from PyPI:

$ pip install ironik

Alternatively, ironik can also be used as a container to avoid installing it:

$ docker run --rm -ti -v $(pwd):/app/tmp ironik --help

This can be abbreviated using an alias:

$ alias dironik='docker run --rm -ti -v $(pwd):/app/tmp ironik'
$ dironik --help


Please see the Usage Instructions for details.

Kubernetes can also be deployed manually on OpenStack and Rancher. See the Manual Deployment Instructions for a full guide.


  • Update Code documentation to use Google code doc style

  • Improve print messages during execution

  • Implement a template validator

  • Implement cluster validation

  • Set up test suite

  • Implement automatic config fetching

  • Add functionality for undoing deployments and other helpful commands


Contributions are very welcome. To learn more, see the Contributor Guide.

Setup Development Environment

We tested the developing environment with Ubuntu 22.04.

  1. Fork project

  2. Clone forked project on your working machine

  3. Install dependencies (needed to build wheel of netifaces in Step 4.)

sudo apt-get install build-essential libssl-dev libffi-dev python3-dev
  1. Install python packages

poetry install


This package was created with cookietemple using Cookiecutter based on Hypermodern_Python_Cookiecutter.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ironik-0.1.8.tar.gz (30.1 kB view hashes)

Uploaded Source

Built Distribution

ironik-0.1.8-py3-none-any.whl (35.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page