codimd

Table of Contents

1. Description
2. Setup - The basics of getting started with codimd
   • What codimd affects
   • Setup requirements
   • Beginning with codimd
3. Usage - Configuration options and additional functionality
4. Limitations - OS compatibility, etc.
5. Development - Guide for contributing to the module

Description

This module installs and configure CodiMD. It's inspired by the puppet-etherpad module.

Setup

What codimd affects

• This module depends on puppet-nodejs
• It also depends on puppetlabs-vcsrepo and hence git
• It will setup a service using systemd
• It will install all npm dependencies and keep them in sync on updates
• It will also run db migration automatically on updates

Setup Requirements

This module requires a database. Though it can use sqlite, it's recommend to use PostgreSQL or MySQL. See CodiMD offical documentation for further advice.

Beginning with codimd

Before to installation, a target database should exist. Please consult the documentation of puppetlabs-postgresql, or puppetlabs-mysql for how to create those.

Usage

The basic usage is:

class { 'codimd':
  config => {
    host   => 'localhost',
    domain => 'codimd.example.org',
    db     => {
      username => 'codimd',
      password => 'mySuperSecurePassword',
      database => 'codimd',
      host     => '127.0.0.1',
      port     => 3306,
      dialect  => 'mysql',
    },
  },
}

Pin the version if you don't like automatic updates

class { 'codimd':
  config  => {
  ...
  },
  version => '1.5.0',
}

Reference

For information on the classes and types, see the REFERENCE.md.

Limitations

• Only systemd is supported as Service provider.
• Most things are currently hardcoded.
• Module is only tested on Ubuntu 18.04

PRs are very welcome! :)

Development

This module is development with the help of pdk.

Please follow the standard Puppet development processes as lived by Puppetlabs/Vox Pupuli.