Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mallozup/ceph-open-terrarium

ceph-open-terrarium: deploy with terraform-libvirt ceph cluster.. Configure with saltstack or ansible.
https://github.com/mallozup/ceph-open-terrarium

ansible c ceph ceph-deploy ceph-salt cephfs ci community go libvirt python saltstack terraform

Last synced: 18 days ago
JSON representation

ceph-open-terrarium: deploy with terraform-libvirt ceph cluster.. Configure with saltstack or ansible.

Awesome Lists containing this project

README

        

# Ceph-open-terrarium

[![Build Status](https://travis-ci.org/MalloZup/ceph-open-terrarium.svg?branch=master)](https://travis-ci.org/MalloZup/ceph-open-terrarium)
[![Gitter chat](https://badges.gitter.im/ceph-open-terrarium/Lobby.png)](https://gitter.im/ceph-open-terrarium/Lobby)
[![Code of Conduct](https://img.shields.io/badge/code%20of-conduct-lightgrey.svg)][coc]
[![Roadmap](https://img.shields.io/badge/Roadmap-%20-brightgreen.svg)](https://github.com/MalloZup/ceph-open-terrarium/projects/1)
___

## Table of Content

- [Install](#install)
- [Examples](#examples)
- [Design Architecture of Project](#design-architecture)
- [Deploy](#deploy)
- [Config Management](#config-management)
- [Contributing](#contributing)
- [Opensource Distros Supported](#opensource-distros-avaible)
___

# Motivation:

Deploy a ceph cluster with terraform `backends` and provisioning with config management tools.

Currently we support following terraform `backends`:
* `libvirt` terraform-plugin. (https://github.com/dmacvicar/terraform-provider-libvirt)

Currently we support following provisioning tools:

* saltstack.
* ansible.

# Install:

You need to install terraform https://www.terraform.io/ and https://github.com/dmacvicar/terraform-provider-libvirt.

For the config management you will need to have saltstack or ansible installed on the machine executing the states/playbook.

# Examples:

Have a look at [examples](https://github.com/MalloZup/ceph-open-terrarium/tree/master/examples)

# Design-Architecture:

For explanation, remarks about the current Architecture design, have a look here [architecture](ARCHITECTURE.md)

# Deploy:

Take an example.tf file and run `terraform apply`

Deployment will focus on libvirt-kvm.
ceph-open-terrarium will use https://github.com/dmacvicar/terraform-provider-libvirt for deploying via terraform and cloudinit.

( Due to the modular nature of terraform, we might add terraform for cloud or other providers but for the first releases is out of scope.)

# Config Management:

### The saltstack way:

Follow instruction here:
https://github.com/MalloZup/ceph-open-terrarium/tree/master/salt

### The ansible way:

Once you have the IPs adress of the virtual hosts, you can use ansible.
For ansible, have a look at upstream doc https://github.com/ceph/ceph-ansible

# Opensource distros avaible

You can use following OS-images.
Note: We are providing the OS-images, feel free to fix/expand the terraform files and relative modules.

**Requirements:** For adding an OS on the table we need a cloud-image avaible upstream.

| Operating System | Version | Avaible | To be supported | Providers |
| ---------------------------- | :--------: | :----------------: | :-------------: | :--------: |
| Arch | latest | :heavy_check_mark: | | libvirt |
| openSUSE | Leap 42.3 | :heavy_check_mark: | | libvirt |
| Ubuntu | 18.04 | :heavy_check_mark: | | libvirt |
| CentOS | 7.1 | :heavy_check_mark: | | libvirt |
| Debian | 9 | :heavy_check_mark: | | libvirt |
| Fedora | 28 | :heavy_check_mark: | | libvirt |
| Gentoo | | | :no_entry: | libvirt |

There are Linux Entreprise System however this images are not open to community.

# Contributing:

Take a look on [contributing](CONTRIBUTING.md)

# Authors:

- [Dario Maiocchi](https://github.com/MalloZup)

A big thank you to all [contributors](https://github.com/MalloZup/ceph-open-terrarium/graphs/contributors) who participated in this project.

[coc-badge]: https://img.shields.io/badge/code%20of-conduct-ff69b4.svg?style=for-the-badge

[coc]:https://github.com/MalloZup/ceph-open-terrarium/blob/master/CODE_OF_CONDUCT.md "Contributor Covenant Code of Conduct"