KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

bluebanquise

★ 163 Open GitHub ↗

A coherent Ansible roles collection to simply deploy clusters of nodes.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# BlueBanquise
![BlueBanquise Logo](https://raw.githubusercontent.com/bluebanquise/bluebanquise/master/resources/pictures/BlueBanquise_logo_large.svg)

<p align="center">
  Web site: <a href="https://bluebanquise.com"><b>https://bluebanquise.com</b></a>
</p>

---
Devs infos:

:yellow_heart: The main branch is now considered unstable as a new major version is under development. Please use a release tag for production.

:yellow_heart: Current core version: 3.4.0, under development.

:green_heart: ansible-core 2.19 is now supported.

:yellow_heart: documentation v3 is currently written, doing my best.

---

## What is BlueBanquise

**BlueBanquise** is group of coherent **Ansible** roles and tools, designed to deploy and manage large group of hosts (clusters of nodes).

The BlueBanquise collection is generic and can adapt to any kind of architecture (High Performance Computing clusters, university or enterprise infrastructures, Blender render farm, K8S cluster, etc.).
A specific focus is made on scalability for very large clusters.

When "stacked" together, roles and tools are called the **BlueBanquise stack**.

The infrastructure collection should be compatible with most target Linux distributions (RHEL 9, RHEL 10, Debian 12, Debian 13, OpenSuse Leap 15, Ubuntu 22.04, Ubuntu 24.04). However, please note that some non core roles do not support all these distributions (support is added on demand).

## License

BlueBanquise repository is under **MIT license**, except Bluebanquise documentation which is under **Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License**.

:star: The BlueBanquise project is a **100% open source project, not managed by a company, and will stay MIT license**. :star:

## Donate

If you use and like BlueBanquise, please consider donating to the **UNICEF** (https://www.unicef.org/).

![UNICEF Logo](https://raw.githubusercontent.com/bluebanquise/bluebanquise/master/resources/pictures/UNICEF_Logo.png)

I have a decent job, I don't need money, but they do.
In the 21th century, it is a shame not all children live in peace.

## Quickstart

### 1. Bootstrap the stack

First step is to use the bootstrap script that will create the bluebanquise user on your system.
Make sure first you have both sudo and curl installed on the system.

```
sudo bash -c "$(curl -s https://raw.githubusercontent.com/bluebanquise/bluebanquise/refs/heads/master/bootstrap/online_bootstrap.sh)"
```

Read the warning message, and accept if you agree with it.

Once bootstrap is done, you can login as bluebanquise user:

```
sudo su - bluebanquise
```

Note that the ANSIBLE_CONFIG variable is set to `/var/lib/bluebanquise/bluebanquise/ansible.cfg` automatically, and a python virtual environment is auto activated and contains latest Ansible version available for your local system.

BlueBanquise Ansible's collections are also already installed for this bluebanquise user.

### 2. Use example inventory

An example inventory can be found inside this repository at resources/examples/simple_cluster. You can use that as a base, and use documentation at https://bluebanquise.com/documentation to tune it to your needs.

### 3. Create playbooks

You can invoke BlueBanquise roles using full name:

```
---
- name: managements playbook
  hosts: "fn_management"
  roles:
    - role: bluebanquise.infrastructure.dhcp_server
      tags: dhcp_server
    - role: bluebanquise.infrastructure.hosts_file
      tags: hosts_file
```

If you are not running Ansible as root, remember to pass the `-b` (`--become`) argument to ansible-playbook command.

### 4. Read documentation

It is advised to read the documentation at https://bluebanquise.com/documentation/ to understand stack basic concepts.

## Resources

### Documentation

The stack documentation is available on the BlueBanquise website, in [documentation subfolder](https://bluebanquise.com/documentation/).

Note that each role embeds its own README, with detailed usage description.

### Packages

The stack packages are available in the [repositories subfolder](https://bluebanquise.com/repository/releases/).

## Supported software environment

The stack aims at supporting a maximum range of hardware, CPU architectures, and Linux distributions.

Currently tested and supported distributions (other derivative could work) are:

| Operating System family | Operating System distribution | Tested versions    | Architectures    | Notes                                                       |
| ----------------------- | ----------------------------- | ------------------ | ---------------- | ----------------------------------------------------------- |
| Red Hat                 |                               |                    |                  |                                                             |
|                         | RHEL                          | 9, 10              | x86_64, aarch64  | √                                                           |
|                         | Rocky Linux                   | 9, 10              | x86_64, aarch64  | √                                                           |
|                         | Alma Linux                    | 9, 10              | x86_64, aarch64  | √                                                           |
| Debian                  |                               |                    |                  |                                                             |
|                         | Ubuntu                        | 22.04, 24.04       | x86_64, arm64    | √. Diskless not supported for now.                          |
|                         | Debian                        | 12, 13             | x86_64, arm64    | √. Diskless not supported for now.                          |

ansible-core >= 2.16 is mandatory for BlueBanquise to run properly (it might work with earlier versions, but not tested).

Please note that:

* EL 7 and 8 are now considered best effort only.
* Ubuntu 18.04 and 20.04 are now considered best effort only.
* Debian 11 is now considered best effort only.
* Suse 12 is no more supported at all (too old, I miss the time to support it).
* Suse 15.6 is now considered best effort. I supported OpenSuse Leap for years, but no users were reported. If you need Suse support back, please let me know.
* RHEL 8 and OpenSuse Leap 15 need an ansible-core==2.16, 2.17+ is not compatible.

## The project

It is a revamping of the old stack [Banquise](https://github.com/oxedions/banquise), based on Salt.

## The name

You may wonder where this name comes from:

* [BlueBanquise](https://en.wikipedia.org/wiki/File:Blue_iceberg_in_the_Ilulissat_icefjord.jpg)
* [Blue Iceberg](https://en.wikipedia.org/wiki/Blue_iceberg)

bluebanquise

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README