Web site: https://bluebanquise.com

Devs infos:

💚 The main branch is now considered stable.

💚 Current core version: 3.2.2 .

💚 ansible-core 2.19 is now supported.

💛 documentation v3 is currently written, might take few weeks to complete.

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 8, RHEL 9, Debian 11, Debian 12, OpenSuse Leap 15, Ubuntu 20.04, 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).

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

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

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

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.

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 <(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.

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.

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.

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

In order to create a topology, you can use the variable slurm_topology. It takes into account the Swicth and Block options like in https://slurm.schedmd.com/topology.html

A sample of inventory for Blocks will be:

slurm_topology: topology/block
slurm_topology_blocksizes: 18
slurm_topology_file:
  rack1:
    section: BlockName
    subsection: Nodes
    nodeset: c[01-18]
  rack2:
    section: BlockName
    subsection: Nodes
    nodeset: c[19-36]

A sample for an inventory for Switches will be:

slurm_topology: topology/tree
slurm_topology_file:
  isw101:
    section: SwitchName
    subsection: Nodes
    nodeset: c[01-20]
  isw102:
     section: SwitchName
     subsection: Nodes
     nodeset: c[21-40]
  isw201:
     section: SwitchName
     subsection: Switches
     nodeset: isw[101-102]

The stack documentation is available on the BlueBanquise website, in documentation subfolder.

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

The stack packages are available in the repositories subfolder.

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:

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 systems (Centos 7, RHEL 7, etc.) is now considered best effort only as system is past EOL.
• Ubuntu 18.04 and Suse 12 are no more supported (too old, I miss the time to support them).
• RHEL 8 and OpenSuse Leap 15 need an ansible-core==2.16, 2.17+ is not compatible.

It is a revamping of the old stack Banquise, based on Salt.

You may wonder where this name comes from:

• BlueBanquise
• Blue Iceberg