Release notes

Open source Puppet documentation

Welcome to Puppet 6 documentation
- Puppet architecture
- The puppet-agent package and version numbers
- Puppet language and code
- Glossary
Release notes
- Puppet release notes
- Puppet known issues
Getting started with Puppet
- Managing NTP
- Managing DNS
- Managing sudo
- Manage firewall rules
Installing and upgrading
- System requirements
- Using the Puppet platform
- Installing Puppet
- Installing agents
- Upgrading
Configuring Puppet
- Puppet settings
- Key configuration settings
- Puppet's configuration files
- Configuring Puppet Server
- Adding file server mount points
- Checking the values of settings
- Editing settings on the command line
- Complete list of settings (configuration reference)
- Settings that differ under Puppet Server
Important directories and files
- Code and data directory (codedir)
- Config directory (confdir)
- Main manifest directory
- The modulepath
- SSL directory (ssldir)
- Cache directory (vardir)
Environments
- About environments
- Creating environments
- Environment isolation
Modules
- Module fundamentals
- Plug-ins in modules
- Module cheat sheet
- Installing and managing modules from the command line
- Beginner's guide to writing modules
- Module metadata
- Documenting modules
- Documenting modules with Puppet Strings
- Puppet Strings style guide
- Publishing modules
- Contributing to Puppet modules
Puppet services and tools
- Puppet commands
- Running Puppet commands on Windows
- Puppet master
  - Puppet Server
- Puppet agent on *nix systems
- Puppet agent on Windows
- Puppet apply
- Puppet device
Puppet Server
- Index
- About Puppet Server
- Release notes
- Deprecated features
- Compatibility with Puppet agent
- Installing Puppet Server
- Configuring Puppet Server
- Differing behavior in puppet.conf
- Using and extending Puppet Server
- Known issues and workarounds
  - Known issues
  - SSL problems with load-balanced PuppetDB servers (“Server Certificate Change” error)
- Administrative API endpoints
  - Environment cache
  - JRuby pool
- CA v1 API
- Server-specific Puppet API endpoints
- Status API endpoints
  - Status services
- Metrics API endpoints
  - v1 metrics
  - v2 (Jolokia) metrics
- Developer information
The Puppet language
- Language visual index
- The Puppet language style guide
- Files and paths on Windows
- Code comments
- Variables
- Resources
- Relationships and ordering
- Classes
- Defined resource types
- Bolt tasks
- Type aliases
- Expressions and operators
- Conditional statements and expressions
- Function calls
- Built-in functions
- Node definitions
- Facts and built-in variables
- Reserved words and acceptable names
- Custom resources
  - Develop types and providers with the Resource API
  - Resource API reference
  - Low-level method for developing types and providers
    - Type development
    - Provider development
- Values and data types
  - Strings
  - Numbers
  - Booleans
  - Arrays
  - Hashes
  - Regular expressions
  - Sensitive
  - Time-related data types
  - Undef
  - Default
  - Resource and class references
  - Resource types
  - Data type syntax
  - Abstract data types
- Templates
  - Using templates
  - Creating templates using Embedded Puppet
  - Creating templates using Embedded Ruby
- Advanced constructs
  - Iteration and loops
  - Lambdas
  - Resource default statements
  - Resource collectors
  - Virtual resources
  - Exported resources
  - Tags
  - Run stages
- Details of complex behaviors
  - Containment of resources
  - Scope
  - Namespaces and autoloading
Writing custom functions
- Custom functions
- Custom Puppet functions
- Writing custom functions in Ruby
- Secrets store integrations and agent-side data retrieval
- Write a Puppet function to store secrets
Hiera
- About Hiera
- Getting started with Hiera
- Configuring Hiera
- Creating and editing data
- Looking up data with Hiera
- Writing new data backends
- Upgrading to Hiera 5
Facter
- Facter release notes
- Core facts
- Custom facts
- Custom facts walkthrough
- External facts
- Configuring Facter with facter.conf
Resource types
- All resource types
- Core types cheat sheet
- Optional resource types for Windows
- exec
- Using exec on Windows
- file
- Using file on Windows
- filebucket
- group
- Using user and group on Windows
- index
- notify
- package
- Using package on Windows
- resources
- schedule
- service
- Using service
- stage
- tidy
- user
Tracking Puppet activity with reports
- Reporting
- Built-in report processors
- Writing custom report processors
- Report format
Writing external node classifiers
Misc. references (settings, functions, etc.)
- Settings (configuration reference)
- Functions
- Metaparameters
- Built-in report processors
- Indirections and termini
- Ruby API for developing extensions
Man pages
- Index
- Core tools
- Occasionally useful
- Niche
HTTP API
- Index
- PSON
- Puppet v4 API
  - Catalog
- Puppet v3 API
- CA v1 API
- Schemas (JSON)
Certificate authority and SSL
- Puppet Server CA commands
- Intermediate CA
- Autosigning certificate requests
- CSR attributes and certificate extensions
- Regenerating certificates in a Puppet deployment
- External CA
- External SSL termination with Puppet Server
Puppet's internals
- Agent-master HTTPS communications
- Catalog compilation
Experimental features
- Msgpack support

Expand menu Collapse menu

These release notes contain important information about Puppet® 6.4 and the Puppet agent.

This release incorporates new features, enhancements, and resolved issues from all previous releases. If you're upgrading from an earlier version of Puppet, check the release notes for any interim versions for details about additional improvements in this release over your current release.

Version numbers for Puppet and the agent use the format X.Y.Z, where:

X must increase for major, backward-incompatible changes.
Y can increase for backward-compatible new functionality or significant bug fixes.
Z can increase for bug fixes.

Refer to these release notes for information about the following separate components, keeping in mind what version of each you have installed:


Puppet Server	PuppetDB	Facter