Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/voxpupuli/puppet-hdm
Puppet Module to manage Hiera Data Manager (HDM)
https://github.com/voxpupuli/puppet-hdm
hdm hiera puppet
Last synced: 2 months ago
JSON representation
Puppet Module to manage Hiera Data Manager (HDM)
- Host: GitHub
- URL: https://github.com/voxpupuli/puppet-hdm
- Owner: voxpupuli
- License: apache-2.0
- Created: 2022-08-02T06:53:23.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-04-12T11:58:15.000Z (8 months ago)
- Last Synced: 2024-04-13T22:08:16.412Z (8 months ago)
- Topics: hdm, hiera, puppet
- Language: Puppet
- Homepage:
- Size: 167 KB
- Stars: 5
- Watchers: 35
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-puppet - puppet-hdm - Puppet module to install/manage Hiera Data Manager. (Puppet Tools / Modules Management)
- awesome-puppet - puppet-hdm - Puppet module to install/manage Hiera Data Manager. (Puppet Tools / Modules Management)
README
# puppet-hdm
[](https://github.com/voxpupuli/puppet-hdm/actions?query=workflow%3ACI)
[](https://github.com/voxpupuli/puppet-hdm/actions/workflows/release.yml)
[](https://forge.puppetlabs.com/puppet/hdm)
[](https://forge.puppetlabs.com/puppet/hdm)
[](https://forge.puppetlabs.com/puppet/hdm)
[](https://forge.puppetlabs.com/puppet/hdm)
[](http://www.puppetmodule.info/m/puppet-hdm)
[](LICENSE)
[](#transfer-notice)
## Table of Contents
- [puppet-hdm](#puppet-hdm)
- [Table of Contents](#table-of-contents)
- [Description](#description)
- [Major Update](#major-update)
- [Setup](#setup)
- [Setup Requirements](#setup-requirements)
- [SLES and Docker module](#sles-and-docker-module)
- [Beginning with betadots HDM](#beginning-with-betadots-hdm)
- [Reference](#reference)
- [Limitations](#limitations)
- [Transfer Notice](#transfer-notice)
- [License](#license)
## Description
This module manages the betadots [HDM](https://github.com/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
```shell
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:
```shell
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](https://forge.puppet.com/modules/puppetlabs/docker/readme) 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:
```yaml
---
# 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:
```puppet
include hdm
```
You can find the released versions on [HDM releases page](https://github.com/betadots/hdm/releases)
```yaml
hdm::version: '1.0.1
```
Another option is to use class resource type declaration:
```puppet
class { 'hdm':
version => '1.0.1',
}
```
This will install HDM as docker container.
## Reference
Please check the [REFERENCE.md](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](https://www.betadots.de).
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.