To configure r10k in an existing Puppet Enterprise (PE) installation, set r10k parameters in the PE console. You can also use the console to adjust r10k settings.
In the PE console, go to , and locate the
r10k_remoteparameter, enter a string that is a valid SSH URL for your Git control repository, such as
git@<YOUR.GIT.SERVER.COM>:puppet/control.git.Important: Some Git providers have additional requirements for enabling SSH access. For example, BitBucket requires
ssh://at the beginning of the SSH URL (such as
ssh://git@<YOUR.GIT.SERVER.COM>:puppet/control.git). See your provider's documentation for this information.
r10k_private_keyparameter, enter a string specifying the path to the SSH private key you created when you set up your control repo, such as
"/etc/puppetlabs/puppetserver/ssh/id-control_repo.ed25519".This key permits the
pe-puppetuser to access your Git control repo. The private key file must be located on the primary server, owned by the
pe-puppetuser, and in a directory that the
pe-puppetuser has permission to view. We recommend
r10k_known_hostsparameter, enter an array of hashes, with each hash containing the following key-value pairs:
Structure the parameter as shown in the following example:
"name":"<HOSTNAME>": Specify the hostname of your control repository host.
"type":"<HOST_KEY_TYPE>": Specify the type of host key, such as
"key":"<HOST_PUBLIC_KEY>": Specify the SSH public key for your control repository host.
Optionally, each hash can accept values for
r10k_known_hostsparameter manages your
known_hostsfile to allow SSH host key verification, which is required when you use r10k.
- Run Puppet on your primary server and compilers.
You can customize your r10k configuration in Hiera, if needed.
To deploy environments with r10k, you must use the command line to manually trigger deployments. PE does not automatically run r10k after you configure it.