Quickstart Guide

To create a Tarook cluster on top of OpenStack, follow the steps below. You need to be able to spawn at minimum 3 instances in your OpenStack project, by default this guide uses 10 instances (with typical flavors ca. 17 vCPUs and 32 GiB of RAM) and 4 floating IP adresses. Note that each instance of Tarook expects the OpenStack project to be solely dedicated to it (one Tarook instance per OpenStack project and nothing else), so better start with an empty project.

Alternatively setting up on bare metal requires additional preparations which are not covered by this guide.

Note

Commands are assumed to be executed at the top level of the cluster repository, if not stated otherwise.

1. Prepare your environment and initialize a cluster repository

2. Configure your Cluster

3. Configure the Vault Backend

4. Deploy the Cluster

5. Tear down the Cluster

If you run into issues have a look into our FAQ first.