Disassociate a Node from an OpsWorks for Puppet Enterprise Server - AWS OpsWorks

Disassociate a Node from an OpsWorks for Puppet Enterprise Server

Important

AWS OpsWorks for Puppet Enterprise is not accepting new customers. Existing customers will be unaffected until March 31, 2024 at which time the service will become unavailable. We recommend that existing customers migrate to other solutions as soon as possible. For more information, see AWS OpsWorks for Puppet Enterprise End of Life FAQs and How to migrate an OpsWorks for Puppet Enterprise server to Amazon Elastic Compute Cloud (Amazon EC2).

This section describes how to disassociate, or remove, a managed node from management by an 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 OpsWorks for Puppet Enterprise management console. Currently, the 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 OpsWorks for Puppet Enterprise server, see Delete an OpsWorks for Puppet Enterprise Server.

See Also