Skip to content

jlambert121/sharpie-r10k

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sharpie-r10k

Build Status

A Puppet module to install and configure r10k, the killer robot powered Puppet deployment tool.

There are two other r10k modules available on the module forge that pre-date this one:

Both have interesting features such as cron setup or MCollective integration. Compared to zack/r10k, this module aims for a minimal installation footprint with respect to adding system packages. Compared to ploperations/r10k, this module emphasizes configuration through Hiera data bindings rather than statically served files.

Caveats

This package has no stable releases yet. Specifically, there are no tests and all interfaces are subject to change. Use in production at your own risk.

This package is hard-wired to manage the system-wide r10k config file /etc/r10k.yaml which is owned by root. This restriction may be lifted in future versions.

Dependencies

This module should only be used to install and manage r10k versions 1.0.0 or newer.

This module was designed with Puppet 3.x in mind and makes extensive use of Hiera data bindings. The module may function on Puppet 2.7.x, but there are currently no tests or guarantees surrounding such functionality.

For r10k to be fully functional after installation and configuration, a git package should also be included on the managed node.

Examples

Currently this module provides two classes: r10k and r10k::config

The r10k class is pretty simple to use and only takes one parameter, ensure:

class {'r10k': ensure => '1.0.0'}

Installation is performed by a Package type using the gem provider. Thus, the ensure parameter can accept any value that is valid for the Package type.

The r10k::config class manages the contents of /etc/r10k.yaml and accepts three parameters:

  • cachedir: Path to a directory to be used by r10k for caching data. Default: /var/cache/r10k

  • sources: Hash containing data sources to be used by r10k to create dynamic Puppet environments. Default: {}

  • purgedirs: An Array of directory paths to purge of any subdirectories that do not correspond to a dynamic environment managed by r10k. Default: []

Detailed information on these parameters can be found in the r10k documentation.

The r10k::config class is designed to be used in conjunction with Hiera data:

---
# In a Hiera datasource
r10k::ensure: '1.0.0'
r10k::config::sources:
  somename:
    remote: 'ssh://git@github.com/someuser/somerepo.git'
    basedir: '%{::settings::confdir}/environments'
  someothername:
    remote: 'ssh://git@github.com/someuser/someotherrepo.git'
    basedir: '/some/other/basedir'

r10k::config::purgedirs:
  - '%{::settings::confdir}/environments'
  - '/some/other/basedir/
# In a Puppet manifest
class { 'r10k': }         # Ensured to be version 1.0.0
class { 'r10k::config': } # Magic!

The r10k::config class can also be used without Hiera data:

class { 'r10k::config':
  sources => {
    'somename' => {
      'remote'  => 'ssh://git@github.com/someuser/somerepo.git',
      'basedir' => "${::settings::confdir}/environments"
    },
    'someothername' => {
      'remote'  => 'ssh://git@github.com/someuser/someotherrepo.git',
      'basedir' => '/some/other/basedir'
    },
  },
  purgedirs => [
    "${::settings::confdir}/environments",
    '/some/other/basedir',
  ],
}

Support

Please log tickets and issues at: https://github.com/Sharpie/puppet-r10k/issues

About

A Puppet module to install and configure r10k, the killer robot powered Puppet deployment tool.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 53.1%
  • Puppet 46.9%