Menu
AWS OpsWorks
User Guide (API Version 2013-02-18)

Add Nodes for the Puppet Master to Manage

The Puppet Enterprise master server hosts a repository that you use to install the Puppet agent software on nodes that you want to manage. Puppet agent software for some operating systems is installed on the AWS OpsWorks for Puppet Enterprise server as part of the launch process. The following table shows the operating system agents that are available on your AWS OpsWorks for Puppet Enterprise server at launch.

Preinstalled operating system agents

Supported operating system Versions
Ubuntu 14.04, 16.04
Red Hat Enterprise Linux (RHEL) 6
Windows 64-bit editions of all Puppet-supported Windows releases

You can add puppet-agent to your server for other operating systems. Be aware that system maintenance will delete agents that you have added to your server after launch. Although most existing attached nodes that are already running the deleted agent continue to check in, nodes running Debian operating systems can stop reporting. We recommend that you manually install puppet-agent on nodes that are running operating systems for which the agent software is not preinstalled on your AWS OpsWorks for Puppet Enterprise server. For detailed information about how to make puppet-agent available on your server for nodes with other operating systems, see Installing agents in the Puppet Enterprise documentation.

For information about how to associate nodes with your Puppet master automatically by populating EC2 instance user data, see Adding Nodes Automatically in AWS OpsWorks for Puppet Enterprise.

Supported Operating Systems

For the current list of supported operating systems for nodes, see the Puppet agent platforms in the Puppet Enterprise documentation.

Run associateNode() API calls

After you add nodes by installing puppet-agent, nodes send certificate signing requests (CSRs) to the AWS OpsWorks for Puppet Enterprise server. You can view the CSRs in the Puppet console; for more information about node CSRs, see Managing certificate signing requests in the Puppet Enterprise documentation. Running the AWS OpsWorks for Puppet Enterprise associateNode() API call processes node CSRs, and associates the node with your server. The following is an example of how to use this API call in the AWS CLI to associate a single node. You will need the PEM-formatted CSR that the node sends; you can get this from the Puppet console.

Copy
aws opsworks-cm associate-node --server-name "test-puppet-server" --node-name "node or instance ID" --engine-attributes "Name=PUPPET_NODE_CSR,Value='PEM_formatted_CSR_from_the_node'

For more information about how to add nodes automatically by using associateNode(), see Adding Nodes Automatically in AWS OpsWorks for Puppet Enterprise.

More Information

Visit the Learn Puppet tutorial site to learn more about using AWS OpsWorks for Puppet Enterprise servers and Puppet Enterprise console features.