Getting started on Windows
Welcome to Puppet Enterprise (PE) getting started for Windows users. These pages demonstrate some essential tasks to start using PE, either to help you set up an initial installation for actual deployment, or as a way for you to try out some fundamentals of configuration management.
This guide walks you through setting up a PE deployment.. The various sections of the getting started guide show you how to automate some basic tasks that sysadmins regularly perform.
The exercises build on each other to lay in some foundational configuration tasks. Work through them in the order presented. See the prerequisite sections in each page to ensure you have the correct setup to perform the steps as they're provided.
-
Start installing PE in a Windows environment
This getting started guide uses a web-based installer to walk you through a basic Puppet Enterprise (PE) installation, ideal for trying out PE with up to 10 nodes, or for managing up to 4000 nodes. -
Start installing Windows agents
When a node is managed by Puppet, it runs a Puppet agent application, commonly called an agent. In this section you install a Windows Puppet agent, which regularly pulls configuration catalogs from a Puppet master and applies them locally. These instructions include how to sign the agent certificate request in the console. -
Start installing modules
Modules are shareable, reusable units of Puppet code that extend Puppet across your infrastructure by automating tasks such as setting up a database, web server, or mail server. In this section, you install a module from the Puppet Forge. -
Start adding classes
In this section, you use the console to add a class to your Puppet agent. Classes are named chunks of Puppet code that are stored in modules. The class you assign in this exercise is derived from the module you installed previously. -
Start assigning user access
The console enables you to import users and groups, create user roles, and assign users to roles. In this exercise, you create a user role, and give the role view permissions on the node group you previously created. Then you create a local user, and assign a user role to that user. -
Start writing modules for Windows
In this section, learn about Puppet modules and module development by writing your own basic module. Create a site module and use the console to apply your new module's class to a group. -
Next Steps
After you've worked through the Puppet Enterprise (PE) getting started steps, you can now perform the core workflows of a Puppet user.