Project

r10k

1.3
A long-lived project that still receives updates
R10K provides a general purpose toolset for deploying Puppet environments and modules. It implements the Puppetfile format and provides a native implementation of Puppet dynamic environments.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Development

>= 0
~> 3.1
~> 0.9.11

Runtime

= 3.1.2
>= 1.1.0, < 3.0.0
>= 3.0.2, < 4.0.0
= 1.1.10
~> 1.10
>= 2.3.0
>= 2.15.10
~> 2.2.3
~> 0.9
 Project Readme

r10k

Puppet environment and module deployment

Build Status

R10k is supported and maintained by Puppet, but we consider it to be feature complete and currently have no plans for future feature development. We will keep it working with current code deployment standards and the Ruby ecosystem that ships with the puppet-agent package, but any new feature development will come from peer-reviewed community contributions, with the onus on the contributor and community for validation.

Description

R10k provides a general purpose toolset for deploying Puppet environments and modules. It implements the Puppetfile format and provides a native implementation of Puppet environments.

You might also consider g10k as a non-ruby based alternative.

Requirements

R10k supports the Ruby versions >= 2.4.0. It's tested on Ruby 2.4.0 up to Ruby 3.1.0 + Jruby.

R10k requires additional components, depending on how you plan on managing environments and modules.

  • Installing modules from the Puppet Forge requires Puppet 5.0.0+ or later. Puppet 3 or 4 may work, but is generally not recommended.
  • Git is required for creating environments and modules from Git
  • SVN is required for creating environments and modules from SVN

Installation

Rubygems

For general use, you should install r10k from Ruby gems:

gem install r10k
r10k help

Puppet Enterprise 3.x

Puppet Enterprise bundles a copy of Ruby, so if you do not want to use the system version of Ruby with r10k, you need to use the bundled PE gem command for installation:

/opt/puppet/bin/gem install r10k
r10k help

Puppet 4

Puppet 4 bundles a copy of Ruby, so if you do not want to use the system version of Ruby with r10k, you need to use the bundled puppet gem command for installation.

/opt/puppetlabs/puppet/bin/gem install r10k
/opt/puppetlabs/puppet/bin/r10k help

Bundler

If you have more specific needs or plan on modifying r10k you can run it out of a git repository using Bundler for dependencies:

git clone https://github.com/puppetlabs/r10k
cd r10k
bundle install
bundle exec r10k help

Arch Linux

Arch Linux provides a system package for r10k. This is built against the system Ruby (which is Ruby 3.0.2 as of 2021-08-03). This package is maintained by Tim Meusel.

Usage

R10k has two primary roles: installing Puppet modules using a standalone Puppetfile, and managing Git and SVN based dynamic environments. For more information see the topic specific documentation:

For more general questions, see the FAQ.

Development

i18n

R10k has now had all user-facing strings in error messages and log messages externalized. When adding new error or log messages please follow the instructions for writing translatable code.

l10n

When localizing the strings found in R10k, follow the prescribed translation workflow. The workflow describes the rake tasks provided to generate the .po files for each locale.

Releasing

To release a new version of the r10k gem, ensure the changelog is up to date and open a pull request updating the version file. When the PR is merged, a new release of the gem will be triggered.

By default, a patch (Z) release will be triggered. To release a new major (X) or minor (Y) version, include #major or #minor (respectively) in your commit message to trigger the appropriate release.

NOTE: This currently only works for the default branch. If you would like to release from a different branch, please contact the CODEOWNERS.

Getting help

  • IRC: r10k has a dedicated channel, #r10k, on Freenode where r10k questions can be directed. Questions about r10k can frequently be asked in #puppet as well.
  • Mailing lists: puppet-users
  • Q&A: Puppet Ask

Contributors

Please see the CHANGELOG for a listing of the (very awesome) contributors.

Maintenance

See CODEOWNERS for active repo maintainers.

Open issues directly in the r10k repo.