Create a Puppetfile

The Puppetfile manages an environment's content. When you create a Puppetfile, use the mod directive to declare an environment's content.

These steps explain how to create an initial Puppetfile in your production environment (which is usually the default environment). This initial Puppetfile becomes a template for your other environments. When you Add an environment (by creating a branch based on the default branch), the new environment inherits a copy of the default environment's Puppetfile, which you can then modify on the new branch to declare the new environment's content.

1. On your production branch, in the root directory, create a text file named Puppetfile.
2. Open the new Puppetfile in a text editor, such as VS Code.
3. Declare the production environment's content in the Puppetfile.

   Use a mod directive to specify each module or repository. Additionally, you need to define the name of the content and any other information code management needs to correctly install and maintain the declared modules and data. For information and examples of Puppetfile declarations, refer to:

   • Declare Forge modules in the Puppetfile
   • Declare Git repositories in the Puppetfile
   Puppet has a VS Code extension that supports syntax highlighting for the Puppet language.
4. Optional: If you want code management to install modules somewhere other than the default directory (./modules), use the moduledir directive to Change the module installation directory.
5. Save and commit your changes.