phabricator
Version information
This version is compatible with:
- Puppet Enterprise 2017.2.x, 2017.1.x, 2016.4.x
- Puppet >= 4.9.0 < 5.0.0
Start using this module
Add this module to your Puppetfile:
mod 'joshuaspence-phabricator', '0.3.1'
Learn more about managing modules with a PuppetfileDocumentation
phabricator
Table of Contents
Description
This module installs, configures and manages Phabricator, a suite of web-based software development collaboration tools, including:
Phabricator is offered as a hosted service by Phacility, but can also be installed on-premise.
Usage
In order to utilize this module it is necessary to configure Phabricator using
the $config_hash
parameter. Specifically, the following settings are required:
mysql.host
: MySQL database hostname.mysql.user
: MySQL username to use when connecting to the database.mysql.pass
: MySQL password to use when connecting to the database.
There are many other settings that can be passed to the $config_hash
parameter, but the above settings should be the minimal configuration that is
required in order for Phabricator to be functional. The $config_hash
parameter is JSON-encoded and written to conf/local/local.json
. See
Advanced Configuration for further information on
configuring Phabricator.
class { 'phabricator':
config_hash => {
'mysql.host' => 'localhost',
'mysql.user' => 'user',
'mysql.pass' => 'password',
},
storage_upgrade => true,
storage_upgrade_user => 'admin',
storage_upgrade_password => 'password',
}
include phabricator::daemons
Reference
See the documentation.
Limitations
This module has been tested on:
- Ubuntu 16.04
Testing on other platforms has been minimal and cannot be guaranteed.
Development
Contributions to this module are welcome, but must be accompanied by
documentation, unit test coverage (with rspec-puppet
) and
acceptance test coverage (with beaker-rspec
). Refactoring
existing code and documentation changes do not require additional tests.
All pull requests must pass successfully through Travis CI before being accepted and merged. Each of the steps that is executed in Travis CI should be reproducible locally using the following commands:
Task | Command |
---|---|
Syntax Checks and Linting | bundle exec rake |
Unit tests | bundle exec rake spec |
Acceptance tests | bundle exec rake beaker |
Changelog
0.3.1
Summary
Features
- Added support for managing Phabricator daemons.
0.3.0
Summary
This is a major rewrite which involved completely throwing away the old code
and starting again from scratch. The rewritten module has comprehensive unit
tests (with rspec-puppet
) and acceptance tests
(with beaker-rspec
).
Dependencies
- puppetlabs/apt (>= 2.0.0 < 3.0.0)
- puppet/php (4.x)
- puppetlabs/stdlib (>= 4.2.0 < 5.0.0)
- camptocamp/systemd (>= 0.3.0 < 1.0.0)
- puppetlabs/vcsrepo (1.x)