README.md

kOVHernetes

kOVHernetes (kovh) is a command-line utility for managing Kubernetes clusters on the OVH Cloud platform.

It deploys cloud instances running the CoreOS Container Linux operating system with Kubernetes components pre-configured using Ignition, including a flannel overlay network for containers.

Contents

1. Prerequisites
2. Installation
3. Documentation
4. Disclaimer
5. Roadmap

Prerequisites

Runtime

Python interpreter (version 3.2 or above) with the setuptools package.

Additionally on Linux:

• cryptography package
  • provided by the python3-cryptography OS package
  • installed from source, see Building cryptography on Linux

Cloud provider

• At least one Cloud project must be created before resources can be provisioned by kOVHernetes.
• The Cloud project must be associated with a vRack in order to create Private Networks.
• At least one SSH public key must have been added to the project.

Installation

Run the following command inside the repository to install the project dependencies and the kovh executable:

❯ python3 setup.py install

Documentation

• Configuration
• Tutorial
• Cluster architecture
• Command reference

Disclaimer

kOVHernetes is a toy project written for testing purposes. It is not supported by OVH in any manner.

Although I strive to enforce a reasonably high level of security by default, no security audit has been performed on this software or the elements of infrastructure it helps to generate.

Use at your own risk.

Roadmap

• list command to display clusters
• Master HA