Bind Puppet Module

Configure and manage bind

  Copyright (c) 2026 UL HPC Team <hpc-sysadmins@uni.lu>

| Project Page | Sources | Issues |

Synopsis

Configure and manage bind.

This module implements the following elements:

• Puppet classes:

  • bind
  • bind::common
  • bind::common::debian
  • bind::common::redhat
  • bind::params

• Puppet definitions:

  • bind::resolver
  • bind::zone

All these components are configured through a set of variables you will find in manifests/params.pp.

Dependencies

See metadata.json. In particular, this module depends on

• puppetlabs/stdlib
• puppetlabs/concat
• puppet/selinux
• ULHPC/syslog

Overview and Usage

Class bind

This is the main class defined in this module. It accepts the following parameters:

• $ensure: default to 'present', can be 'absent'

Use it as follows:

    class { 'bind':
        ensure     => 'present',
        forwarders => [ '10.28.0.5' ]
    }

Definition bind::resolver

The definition bind::resolver provides ... This definition accepts the following parameters:

• $ensure: default to 'present', can be 'absent'
• $content: specify the contents of the directive as a string
• $source: copy a file as the content of the directive.

Example:

    bind::resolver { 'uni.lux':
        nameservers => '10.28.0.5',
        order       => 10
    }

Definition bind::zone

The definition bind::zone provides ... This definition accepts the following parameters:

• $ensure: default to 'present', can be 'absent'
• $content: specify the contents of the directive as a string
• $source: copy a file as the content of the directive.

Example:

    bind::zone { 'gaia-cluster.uni.lux':
        source => "puppet:///private/gaia-cluster/db.gaia-cluster.uni.lux",
        add_to_resolver => true
    }

Librarian-Puppet / R10K Setup

You can of course configure the bind module in your Puppetfile to make it available with Librarian puppet or r10k by adding the following entry:

 # Modules from the Puppet Forge
 mod "ULHPC/bind"

or, if you prefer to work on the git version:

 mod "ULHPC/bind",
     :git => 'https://github.com/ULHPC/puppet-bind',
     :ref => 'main'

Developments / Issues / Contributing to the code

This Puppet Module has been implemented in the context of the UL HPC Platform of the University of Luxembourg. It relies on Vox Pupuli modulesync for its organization.

You can submit bugs / issues / feature requests using the ULHPC/bind Puppet Module Tracker. You are more than welcome to contribute to its development by sending a pull request.

Licence

This project and the sources proposed within this repository are released under the terms of the GPL-3.0 licence.