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

Disassociate a Node from an AWS OpsWorks for Puppet Enterprise Server

This section describes how to disassociate, or remove, a managed node from management by an AWS OpsWorks for Puppet Enterprise server. This operation is performed on the command line or in the Puppet Enterprise console; you cannot disassociate nodes in the AWS OpsWorks for Puppet Enterprise management console. Currently, the AWS OpsWorks for Puppet Enterprise API does not allow for batch removal of multiple nodes. The command in this section disassociates one node at a time.

We recommend that you disassociate nodes from a Puppet master before you delete the server, so that the nodes continue to operate without trying to reconnect with the server. To do this, run the disassociate-node AWS CLI command. To completely remove a node from PE, you must disassociate the node and revoke its certificate, so that the node does not continuously attempt to check in with the Puppet master. You should also uninstall puppet-agent from nodes when you no longer want to manage them by using the Puppet master.

To disassociate nodes

  1. In the AWS CLI, run the following command to disassociate nodes. Node_name is the name of the node that you want to disassociate; for Amazon EC2 instances, this is the instance ID.Server_name is the name of the Puppet master from which you want to disassociate the node. Both parameters are required. The --region parameter is not required unless you want to disassociate a node from a Puppet master that is not in your default region.

    aws opsworks-cm --region Region_name disassociate-node --node-name Node_name --server-name Server_name

    The following command is an example.

    aws opsworks-cm --region us-west-2 disassociate-node --node-name i-0010zzz00d66zzz90 --server-name opsworkstest
  2. Wait until a response message indicates that the disassociation is finished.

For more information about how to delete an AWS OpsWorks for Puppet Enterprise server, see Delete an AWS OpsWorks for Puppet Enterprise Server.

See Also

On this page: