Forge Home

ganeti

Install and configure ganeti nodes

SMASH

smash

7,005 downloads

328 latest version

4.7 quality score

Version information

  • 1.0.5 (latest)
  • 1.0.4
  • 1.0.3
  • 1.0.2
  • 1.0.1
  • 1.0.0
released Sep 17th 2021
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.0.0 < 7.0.0
  • Debian

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'smash-ganeti', '1.0.5'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add smash-ganeti
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install smash-ganeti --version 1.0.5

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

smash/ganeti — version 1.0.5 Sep 17th 2021

Ganeti Puppet support

Description

The ganeti module installs and configures packages to configure a Ganeti cluster.

Setup

This module does not initialize a cluster or add nodes, which are expected to be pre-installed in the cluster. However, it will properly prepare nodes with the right software to do so. So normally, you should only have to run gnt-cluster init on the master and gnt-node add for each secondary node.

Requires the camptocamp/kmod module in order to load the right kernel modules when the module is configured with_drbd.

Usage

The main ganeti class handles most of the work:

include ganeti

It sets up ganeti packages and also deploys a few set of custom hooks to make gnt-instance-debootstrap work properly. Extra hooks can be deployed manually in /etc/ganeti/instance-debootstrap/hooks/ as needed. The debootstrap configuration can be modified through the bootstrap_defaults parameter. This, for example, will add extra pacakges to every install:

  class { ganeti :
    debootstrap_defaults => {
      extra_packages => ['linux-image-amd64', 'dbus', 'libpam-systemd'],
    }
  }

Creating a swap partition at instance creation

If you are using ganeti-instance-debootstrap to provision the base install for your instances, this module provides a hook that will help you setup a disk as a swap partition upon instance creation.

To achieve this, you need to label (name) one of the disk as "swap", as in the following example:

gnt-instance add -d -o debootstrap+bullseye -t plain \
 --disk 0:size=14G --disk 1:size=1G,name=swap
 instance1.example.com

Here, we have one disk of 1Gb that's named "swap": this will be used as swap space automatically. The other disk will be used as the main disk to install the system on.

Reference

See [REFERENCE.md][] for full reference documentation. Note that this file is generally only generated when a tag is added.

The full online reference documentation for this module may be found at on GitLab Pages. This online reference is generated automatically on each new commit.

Alternatively, you may build yourself the documentation using the puppet strings generate command. See the documentation for Puppet Strings for more information.

Limitations

Tested on Debian stretch, buster, and bullseye. Compatibility with other versions and distributions unknown.

Development

Developed and maintained by the shared puppet modules group.