To get started using Puppet, you must first complete the initial installation and setup process.
Puppet is distributed in
several packages. These include
puppetdb. Puppet Server controls the
configuration information for one or more managed agent nodes. PuppetDB is where the data
generated by Puppet is
Enabling the Puppet platform repository
Installing Puppet Server
Installing Puppet agent
- Installing PuppetDB (optional)
puppetservercomponent of the Puppet platform is available only for Linux. The
puppet-agentcomponent is available independently for over 30 platforms and architectures, including Windows and macOS. For more information on Puppet's packages, see Puppet platform lifecycle.
1. Enable the Puppet platform repository
Enabling the Puppet platform repository makes the components needed for installation available on your system. The process for enabling the repository varies based on your package management system.
|Package management system||URL naming convention||URL example|
(Used with Red Hat operating systems such as Red Hat Enterprise Linux (RHEL) and SUSE Linux Enterprise Server.)
(Used with Debian and Ubuntu.)
Tip: For Ubuntu releases, the code name is the adjective, not the animal.
Enable the Puppet platform on Yum
sudo rpm -U <PACKAGE_URL>
wget https://yum.puppet.com/puppet6-release-el-5.noarch.rpm sudo rpm -Uvh puppet6-release-el-5.noarch.rpm
sudo rpm -Uvh https://yum.puppet.com/puppet6-release-el-7.noarch.rpm
Enable the Puppet platform on Apt
Logged in as root, download the package and run
the dpkg tool in install mode:
wget <PACKAGE_URL> sudo dpkg -i <FILE_NAME>.debFor example, to enable the Ubuntu 18.04 Bionic repository:
wget https://apt.puppetlabs.com/puppet6-release-bionic.deb sudo dpkg -i puppet6-release-bionic.deb
sudo apt-get update
If you install from the Puppet Yum and Apt repositories, the release package that enables the repository also installs our release signing key. The Yum and Apt tools automatically verify the integrity of packages as you install them.
If you install a Windows agent using an .msi package, the Windows installer automatically verifies the signature before installing the package.If you need to manually verify packages, see Verify packages.
2. Install Puppet Server
Puppet Server is a required application that runs on the Java Virtual Machine (JVM) on the primary server.
In addition to hosting endpoints for the certificate authority service, Puppet Server also powers the catalog compiler, which compiles configuration catalogs for agent nodes, using Puppet code and various other data sources.
In this section, you will install the
package and start the service.
Follow the steps in install Puppet Server
3. Install Puppet agent
Puppet agents translates code into commands and then executes it on the systems you specify.
In this section, you will install agents on your chosen operating system, configure them, and sign their certificates. Follow the steps in install agents.
4. Install PuppetDB (optional)
All of the data generated by Puppet is stored in Puppet DB.
You can optionally install PuppetDB to enable extra features, including enhanced queries and reports about your infrastructure. In this section, you will assign PuppetDB module’s classes to your servers. Follow the steps in install PuppetDB.