Modulesync configuration for OpenStack puppet modules
Go to file
Paul Belanger 38a9c30827
Add puppet dependencies to bindep.txt
Start to utilize bindep.txt more by include our ruby dependencies for
puppet. Also include bindep.txt into moduleroot so we can also sync
this to all our puppet modules.

Change-Id: I88229327038e13ab7471e53ae7f7bc84815511ea
Signed-off-by: Paul Belanger <>
2017-05-02 22:49:16 -04:00
moduleroot Add puppet dependencies to bindep.txt 2017-05-02 22:49:16 -04:00
tools Create script 2015-08-12 14:37:52 -04:00
.gitignore Create script 2015-08-12 14:37:52 -04:00
.gitreview Update .gitreview file for project rename 2015-06-12 23:12:30 +00:00
Gemfile Create script 2015-08-12 14:37:52 -04:00
LICENSE puppet-modulesync-configs: Initial commit 2015-04-20 16:31:57 +02:00 README: fix markdown syntax for code highlighting 2015-10-08 14:19:42 -07:00
bindep.txt Add puppet dependencies to bindep.txt 2017-05-02 22:49:16 -04:00
config_defaults.yml Update Gemfile for new modules 2016-04-18 16:22:04 -03:00
functions Add CI scripts 2016-07-29 11:22:11 -04:00
managed_modules.yml Update managed module list 2016-09-30 12:58:29 -06:00
modulesync.yml Add missing remote_branch and pre_commit_script 2015-07-29 10:46:02 +02:00
modulesync.yml.sample sample config (update namespace) 2015-08-04 17:27:18 +02:00 Add CI scripts 2016-07-29 11:22:11 -04:00 Add CI scripts 2016-07-29 11:22:11 -04:00 Add CI scripts 2016-07-29 11:22:11 -04:00 Add CI scripts 2016-07-29 11:22:11 -04:00


This repository contains default configuration for modulesync for OpenStack puppet modules. Changes to this repository should be synced with modulesync across all of the OpenStack puppet modules. It can also be used as an example for creating default configuration for other community modules.

A full description of ModuleSync can be found in ModuleSync's README. This README describes how the templates are rendered in the OpenStack puppet configuration.

Configuring ModuleSync


A key-value store of arguments to pass to ModuleSync. Each key is the name of a flag argument to the msync command. For example, namespace: myusername represents passing --namespace myusername to msync. This file does not appear in this repository because it only serves to override default configuration. To override the default configuration, take a look on modulesync.yml.sample provided file.


A YAML array containing the names of the modules to manage.

Defining Module Files


Each first-level key in this file is the name of a file in a module to manage. These files only appear here if there are templates in the moduleroot/ directory that need to be rendered with some default values that might be overridden. The files listed do not necessarily represent all the files that will be managed. The files in moduleroot/ represent all the files that will be managed, except for unmanaged and deleted files (see [#Special Options]).


This file should appear in the module itself if there are any values to override from the config_defaults.yml file or if there are any additional values to assign. A description of what optional values can be defined in .sync.yml follows in the description of each file in moduleroot/. .sync.yml will have the same format as config_defaults.yml.


Each template is rendered in slightly different ways. Your templates to not need to be identical to these, as long as your config_defaults.yml or .sync.yml files contain as first-level keys the exact names of the files you are managing and appropriately handle the data structures you use in your templates (arrays versus hashes versus single values).


The Gemfile contains a list of gems, optionally with versions, to install in the development and test groups. config_defaults.yml contains a list of "required" gems to install, in the form of an array where each element contains the names and versions of the gems. This section of config_defaults.yml might look like

  - gem: rake
    version: '~>1.2'
  - gem: rspec-puppet
  - gem: minitest
    version: '~> 4.7'
    require: 'minitest/unit'

The template also looks in .sync.yml for a group of optional gems to install, and merges this list with the list found in config_defaults.yml. This section of .sync.yml will look the same as the section of config_defaults.yml, but the name will be "optional" rather than "required".


The Rakefile gets most of its tasks from the puppetlabs_spec_helper. The variables in the template represent lint checks to disable. config_defaults.yml contains an array of checks to pass in to PuppetLint.configuration.send. The key for this array is called default_disabled_lint_checks. .sync.yml may contain an additional array of checks to disable, with the key extra_disabled_lint_checks.


Contains some standard files to ignore. You can pass in additional files as an array with the key "paths" in your .gitignore section in .sync.yml.


Flat file that simply requires the module_spec_helper from the puppetlabs_spec_helper.


Flat files containing default nodesets to run beaker-rspec on.

Special Options

Unmanaged Files

A file can be marked "unmanaged" in .sync.yml, in which case modulesync will not try to modify it. This is useful if, for example, the module has special Rake tasks in the Rakefile which is difficult to manage through a template.

To mark a file "unmanaged", list it in .sync.yml with the value unmanaged: true. For example,

  unmanaged: true

Deleted Files

Managing files may mean removing files. You can ensure a file is absent by marking it "delete". This is useful for purging nodesets.

To mark a file deleted, list it in .sync.yml with the value delete: true. For example,

  delete: true