This repository provides a set of tools to deploy instances of Bitergia Analytics Platform on different cloud providers, using Terraform and Ansible for provisioning and installation.
The latest version of the toolkit supports the following cloud providers:
This toolkit is released under the terms of the GPL3 or later license.
The current version of the toolkit requires:
- Debian 11 (bullseye) or Ubuntu 20.04 (or later).
- Python 3.8 (or later)
- Terraform 1.3 (or later)
- Ansible 6.4 (or later)
Take into account that other Linux distributions might work but the ones listed in this README file are the ones that have been used to test this particular toolkit. For your convenience, this documentation contains also the steps necessary to install Terraform and Ansible.
The terraform directory stores the modules needed for the provisioning of our platform
on the cloud providers supported by this deployment toolkit. Inside, you can find an
environments directory where you can store different configurations
for the environments you would like to have the provisioning in.
The ansible directory contains all the Ansible roles and playbooks to install
and configure the platform. As the terraform dir, it has an environments
folder to store the Ansible configurations for all your environments.
The keys directory provides a central place to store all of your keys. It is
configured in .gitignore so that the keys are not included with any Git commit by default,
to avoid exposing credentials.
The docs directory provides the documentation files that will help you to
deploy and configure the platform.
- Architecture Overview
- Prerequisites
- Provisioning with Terraform
- Deploying and configuring with Ansible
This toolkit was inspired by the roles and recipes that Ángel Jara developed when he worked at Bitergia and by the amazing job the people of GitLab do with their GitLab Environment Toolkit.
This toolkit is released under the terms of the GPL3 or later license.