Skip to content

voxpupuli/puppet-hdm

puppet-hdm

Build Status Release Puppet Forge Puppet Forge - downloads Puppet Forge - endorsement Puppet Forge - scores puppetmodule.info docs Apache-2 License By betadots

Table of Contents

Description

This module manages the betadots HDM installation.

HDM can be installed on Puppet Server or on any other system with PuppetDB access and Puppet code deployed.

This module allows you to either make use of the betadots HDM Docker container or to install HDM using RVM.

Major Update

As of version 1.0.0 and newer the HDM Docker container runs in production mode. Existing installations using HDM container prior version 1.0.0 must prepare this change by copying the development.sqlite3 file to production.sqlite3

cp /etc/hdm/development.sqlite3 /etc/hdm/production.sqlite3

Now Puppet can configure the system. Once HDM is up and running the database can be changed from development to production:

docker exec -ti hdm /hdm/bin/rails db:environment:set RAILS_ENV=production

After the update and checking functionality the development.sqlite3 file can be deleted.

Setup

Setup Requirements

The puppet-hdm module needs puppetlabs/stdlib as we use some of the stdlib data types.

If you want to make use of the docker container, you need the following module:

  • puppetlabs/docker - min version 4.4.0

If you want to install HDM using RVM, you need the following modules:

  • puppet/rvm - min version 2.0.0
  • golja/gnupg - min version 1.2.3
  • puppetlabs/vcsrepo - min version 5.2.0
  • puppet/systemd - min version 3.10.0

SLES and Docker module

The puppetlabs-docker Module lacks official SLES and SuSe support. Yet: the module is usable on SLES.

The installation of Docker can not be done using the module on SLES. Instead one must install Docker separately within a profile class.

But any other defined type like docker::image or docker::run is working.

One must set the acknowledge_unsupported_os parameter to true to prevent the Docker module from failing on SuSe systems.

Hiera:

---
# Allow Docker to work on SLES
docker::acknowledge_unsupported_os: true

Beginning with betadots HDM

The most simple approach is to just include the hdm class and provide the version parameter:

include hdm

You can find the released versions on HDM releases page

hdm::version: '1.0.1

Another option is to use class resource type declaration:

class { 'hdm':
  version => '1.0.1',
}

This will install HDM as docker container.

Reference

Please check the REFERENCE.md file.

Limitations

On SLES we can not use the puppetlabs/docker module. Instead set the manage_docker parameter to false and take care on docker package and service by yourself.

Transfer Notice

This Puppet module was originally authored by betadots GmbH. The maintainer preferred that Vox Pupuli take ownership of the module for future improvement and maintenance. Existing pull requests and issues were transferred over, please fork and continue to contribute here instead of github.com/betadots/puppet-hdm.

License

This module is licensed under the Apache-2 license.