This page assumes that you have already set up a [control repo][control_repo] and a Puppetfile.
To configure r10k:
- During a clean PE installation, provide parameters to
- After installation or upgrade, set parameters in the master profile class in the PE console.
If you are upgrading from previous version of r10k, see Upgrading from previous versions of r10k, below.
Warning: Do not edit r10k’s configuration manually. Puppet manages this configuration file automatically and will undo any manual changes you make.
Configure during PE installation
During a fresh installation of Puppet Enterprise, you can provide parameters in
pe.conf that automatically configure r10k. Note that these can only be used with text-mode installation, not with the web-based installation.
You must add the following two parameters to
pe.conf before installation:
Accepts a string that is a valid SSH URL for your Git remote.
The local filesystem path on the Puppet master where the SSH private key can be found and used by r10k.
Accepts a string, such as:
With the two answers above, the installer configures r10k for you. You can change the values for the remote and the private key as needed in the master profile settings in the PE console.
Configure after PE installation
After a installing or upgrading PE, you can configure or adjust r10k settings in the master profile class in the PE console. The two parameters must be set for r10k to work. All other r10k settings use default values.
Accepts a string that is a valid URL for your Git remote, for example:
The local filesystem path on the Puppet master where the SSH private key can be found and used by r10k. Accepts a string, such as
Upgrading from previous versions of r10k
If you used r10k prior to PE 2015.3, you might have configured r10k in the PE console using the
pe_r10k class. If so, you aren’t required to change that.
However, we suggest configuring r10k in the master profile class, and then customizing your configuration as needed in Hiera. This simplifies configuration, and makes it easier if you want to move to Code Manager in the future.
Note: If you were using earlier versions of r10k with the zack-r10k module, switch to the master profile configuration as above.
If you need to customize your r10k configuration, you can do so via Hiera.
After r10k is configured, you can run r10k. PE does not automatically run r10k at the end of installation.