Managing and deploying Puppet code
Puppet Enterprise (PE) includes built-in tools for managing and deploying your Puppet code. Code Manager and r10k are code management tools that automatically install modules, create and maintain environments, and deploy new code to your primary server and compilers, all based on version control of your Puppet code and data.
You can use either Code Manager or r10k to manage and deploy Puppet code. Both tools are built into PE and do not require separate installations.
Code Manager is the recommended tool for managing Puppet code in PE. Code Manager automates the deployment of your Puppet code and data. You make code and data changes on your workstation, push changes to your Git repository, and, from there, Code Manager creates environments, installs modules, and deploys the new code to your primary server and compilers, without interrupting agent runs.
If you are unable to use Code Manager, you can use r10k to manage your code.
-
Managing environments with a control repository
To manage your Puppet code and data with Code Manager or r10k, you need a Git version control repository. This control repository is where code management stores code and data to deploy your environments. -
Managing environment content with a Puppetfile
A Puppetfile specifies detailed information about each environment's Puppet code and data. -
Managing code with Code Manager
Code Manager automates the management and deployment of your Puppet code. When you push code updates to your source control repository, Code Manager syncs the code to your primary server and compilers. This allows all your servers to run the new code as soon as possible, without interrupting in-progress agent runs. -
Managing code with r10k
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. Unlike Code Manager's automated deployments, r10k requires you to manually deploy code changes from your control repository using the r10k command line tool on your primary server and all compilers.