Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bluebanquise/bluebanquise
A coherent Ansible roles collection to simply deploy clusters of nodes.
https://github.com/bluebanquise/bluebanquise
ansible baremetal clusters hpc linux pxe
Last synced: about 2 months ago
JSON representation
A coherent Ansible roles collection to simply deploy clusters of nodes.
- Host: GitHub
- URL: https://github.com/bluebanquise/bluebanquise
- Owner: bluebanquise
- License: mit
- Created: 2019-06-26T20:18:48.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-05-21T15:14:55.000Z (4 months ago)
- Last Synced: 2024-05-23T00:49:56.868Z (4 months ago)
- Topics: ansible, baremetal, clusters, hpc, linux, pxe
- Language: Jinja
- Homepage: https://bluebanquise.com
- Size: 19.6 MB
- Stars: 101
- Watchers: 11
- Forks: 45
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- awesome-high-performance-computing - Bluebanquise - An open-source cluster management tool. (Software / Trends)
- awesome-ansible - BlueBanquise - An ansible coherent roles collection to deploy clusters. (Playbooks, Roles and Collections / French)
README
[](https://ko-fi.com/oxedions)
# BlueBanquise
Web site: https://bluebanquise.com
:loudspeaker: The main branch is under active dev for now. Consider using a stable branch for production. :loudspeaker:
## What is BlueBanquise
**BlueBanquise** is group of coherent **Ansible** collections and tools, designed to deploy and manage large group of hosts (clusters of nodes).
The BlueBanquise collections are 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, collections and tools are called **BlueBanquise stack**.
## Collections
The following collections are available. **Please note that for now, only infrastructure collection of BlueBanquise is considered stable**.
* :globe_with_meridians: **[Infrastructure](collections/infrastructure):** the core of the stack, focused on providing roles and tools to deploy hosts and configure vital services.
* :globe_with_meridians: **[hardware](collections/hardware):** specific hardware support roles (GPU, interconnect, etc.).
* :globe_with_meridians: **[file system](collections/file_systems):** support for local or network FS roles.
* :globe_with_meridians: **[hpc](collections/hpc):** High Performance Computing related roles.
* :globe_with_meridians: **[containers](collections/containers):** containers related roles.
* :globe_with_meridians: **[high availability](collections/high_availability):** HA and load balancing related roles.
* :globe_with_meridians: **[logging](collections/logging):** system logging related roles (different from monitoring).
* :globe_with_meridians: **[monitoring](collections/monitoring):** cluster monitoring related roles.
* :globe_with_meridians: **[security](collections/security):** system security related roles.
Infrastructure collection should be compatible with all target Linux distributions (RHEL 8, RHEL 9, Debian 11, Debian 12, OpenSuse Leap 15, Ubuntu 20.04, Ubuntu 22.04). Other collections do not support all these distributions (support is added on demand).
Note that few features are still limited on Ubuntu and Debian (mainly network configuration), I am working on it.
## License
BlueBanquise repository is under **MIT license**, except Bluebanquise documentation which is under **Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License**.
## Quickstart
We will assume here you already have a recent Ansible setup and configured. If you are new to Ansible, you can use the [provided generic tutorial](http://bluebanquise.com/tutorials/sysadmin_ansible/).
### 1. Core variables and Jinja2 extensions
In order to use BlueBanquise collections, you need the core variables, that contain the logic (BlueBanquise relies on a centralized logic to easily impact all roles at once).
To install core variables, you can either:
* Copy file [bb_core.yml](resources/bb_core.yml) into your inventory at `group_vars/all/` level
* Or install [commons](collections/commons/) collection and invoke the vars plugin at ansible-playbook execution, using `ANSIBLE_VARS_ENABLED=ansible.builtin.host_group_vars,bluebanquise.commons.core`
* Or add it into your `ansible.cfg` file (see example at [ansible.cfg](./ansible.cfg)) by adding `jinja2_extensions = jinja2.ext.loopcontrols,jinja2.ext.do`
While first solution is simpler, second solution allows to use the galaxy update mechanism to ensure your core logic is always up to date (bug fixes mainly).
In both cases, you need to enable some Jinja2 extensions at run time. To do so, either:
* Add it into your `ansible.cfg` file (see example at [ansible.cfg](./ansible.cfg)) by adding `jinja2_extensions = jinja2.ext.loopcontrols,jinja2.ext.do`
* Or invoke the extensions at ansible-playbook execution, using `ANSIBLE_JINJA2_EXTENSIONS=jinja2.ext.loopcontrols,jinja2.ext.do`
Note that not all roles need this core logic, and that all logic variables are prefixed by `j2_`.
### 2. Install collections
To install BlueBanquise collections, you can use the ansible-galaxy command:
```
ansible-galaxy collection install git+https://github.com/bluebanquise/bluebanquise.git#/collections/commons,master -vvv --upgrade
ansible-galaxy collection install git+https://github.com/bluebanquise/bluebanquise.git#/collections/infrastructure,master -vvv --upgrade
```
### 3. Create inventory
To create your inventory, you can use the provided [datamodel](resources/data_model.md), and roles embed READMEs (for example, for pxe_stack role, you can rely on [README.md](collections/infrastructure/roles/pxe_stack/README.md), etc.).
### 4. 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.pxe_stack
tags: pxe_stack
```
If you are not running Ansible as root, remember to pass the `-b` (`--become`) argument to ansible-playbook command.
### 5. 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 | 7, 8, 9 | x86_64, aarch64 | √ |
| | Rocky Linux | 8, 9 | x86_64, aarch64 | √ |
| | CentOS | 7, 8 | x86_64, aarch64 | √ |
| | CentOS Stream | 8 | x86_64, aarch64 | √ |
| | Alma Linux | 8, 9 | x86_64, aarch64 | √ |
| Debian | | | | |
| | Ubuntu | 20.04, 22.04 | x86_64, arm64 | √. Diskless not supported for now. |
| | Debian | 11, 12 | x86_64, arm64 | √. Diskless not supported for now. |
| Suse | | | | |
| | SLES | 15 | x86_64, aarch64 | √. Diskless not supported for now. |
| | OpenSuse Leap | 15 | x86_64, aarch64 | √. Diskless not supported for now. |
Ansible >= 4.10.0 is mandatory for BlueBanquise to run properly.
Please note that EL 7 systems (Centos 7, RHEL 7, etc.) is now considered best effort only.
## The project
BlueBanquise is part of the [**Algoric**](https://algoric.org/) project from the [**Fabrique du Loch**](https://www.lafabriqueduloch.org/fr/accueil/) FabLab, located in Brittany - France.
It is a revamping of the old stack [Banquise](https://github.com/oxedions/banquise), based on Salt.
The BlueBanquise project is a 100% open source project, not managed by a company, and will stay MIT license.
## 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)