Forge Home


Puppet module to migrate Puppet Agents


708 latest version

5.0 quality score

Version information

  • 0.5.0 (latest)
  • 0.4.0 (deleted)
  • 0.3.0 (deleted)
  • 0.2.0 (deleted)
  • 0.1.0 (deleted)
released Aug 24th 2021
This version is compatible with:
  • Puppet Enterprise 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x
  • Puppet >= 6.21.0 < 8.0.0
  • , , , , , ,
  • migrate
  • upgrade_and_migrate

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'ffalor-migrate', '0.5.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add ffalor-migrate
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install ffalor-migrate --version 0.5.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



ffalor/migrate — version 0.5.0 Aug 24th 2021


A Puppet Task to migrate a Puppet Agent to a new Puppet Master.


This modules provides a Puppet Task to migrate a Puppet Agent to a new Puppet Master.

See references for more information about parameters and usage.

The module will perform the following actions:

  1. Verify the node can reach the new Puppet Master and CA Server.
  2. Get current setting for server and ca_server from puppet.conf.
  3. Backup $ssldir
  4. Set $server and $ca_server to new values.
  5. Run puppet agent using new settings.
  6. Restore $ssldir and original settings if error occurs.

This module also provide a Puppet plan to upgrade puppet before migration. See migrate::upgrade_and_migrate for more information.