Puppet Enterprise 2017.2

r10k basics

r10k is a code management tool that allows you to manage your environment configurations (such as production, testing, and development) in a source control repository. Based on the code in your control repo branches, r10k creates environments on your master and installs and updates the modules you want in each environment.

If you are running PE 2015.3 or later, we encourage you to use Code Manager, which uses r10k in the background to automate the deployment of your code. If you use Code Manager, you won’t need to manage or interact with r10k manually. Go to the Code Manager page to begin setup. However, if you’re already using r10k and aren’t ready to switch to Code Manager, you can continue using r10k alone.

Working with r10k

To set up r10k to manage your environments:

  1. Set up a control repository for your code.
  2. Create Puppetfiles for your environments.
  3. Configure r10k.
    • Optionally, customize r10k’s configuration by using Hiera.
  4. Run r10k to deploy your environments and modules.

We’ve also included a reference of r10k subcommands.

Back to top