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.
As of PE 2015.3, we encourage you to use Code Manager, which works with r10k to automate the deployment of your code. If you use Code Manager, you won’t manage or interact with r10k manually. Instead, 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 manage environments with r10k:
- Set up a control repository for your code.
- Create Puppetfiles for your environments.
- Configure r10k.
- Optionally, customize r10k’s configuration by using Hiera.
- Run r10k to deploy your environments and modules.
We’ve also included a reference of r10k subcommands.