Forge Home

fusionforge

Install and configure Fusion Forge

1,028 downloads

1,028 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 1.1.0 (latest)
released May 25th 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
  • Puppet >= 5.5.0 < 7.0.0
  • ,

Start using this module

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

Add this module to your Puppetfile:

mod 'adullact-fusionforge', '1.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add adullact-fusionforge
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install adullact-fusionforge --version 1.1.0

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

adullact/fusionforge — version 1.1.0 May 25th 2021

fusionforge

Table of Contents

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

Description

This module automates the installation and configuration of a FusionForge instance. It creates the database, configures the Apache server, deploys configuration variables, and enables required plugins.

Setup

What fusionforge affects

Beyond the FusionForge configuration, the module installs a number of required packages and runs the FusionForge installer scripts (which in turn apply various configurations: they create a database and a set of Apache virtualhosts, they integrate the FusionForge database with PAM authentication, they install various cron jobs, and so on.

Beginning with fusionforge

The simplest use of the module is as follows:

    class { 'fusionforge':
      database_password     => 'nrstauie',
      database_password_mta => 'toto99',
    }

This will install FusionForge from its upstream Git repository, using the 6.1 branch. A different repository URL can be specified using the $repository parameter, and a different branch/tag name can be specified with $release.

Usage

Most of the configuration can be managed using the class parameters. For instance:

  • $forge_name allows configuring the site name/title;
  • $web_host allows changing the host name to be used (defaults to the host's FQDN);
  • $default_country_code, $default_language and $default_timezone allow configuring localisation parameters;
  • many $use_* parameters control whether to enable or disable some FusionForge features;
  • the $plugins parameters (an array of strings) is used to configure the plugins to enable. It defaults to installing only scmgit, but many others are available.

Limitations

No effort has been made to install multiple instances on the same host (that would be hard anyway because of the system users integrations).

Installing/enabling plugins is fine, but there is no code in the module to disable a plugin later on.

Development

Development of this module is hosted on Adullact's Gitlab instance, at https://gitlab.adullact.net/adullact/puppet-fusionforge Contributions are welcome and should keep with the coding standards.

Release Notes/Contributors

This module is currently (as of 2021-05) at the "minimal working code" stage. It does work, and it has a testsuite to show it does, but it can certainly be improved.

This module is developed by Roland Mas roland.mas@gnurandal.com and sponsored by Adullact