Oracle Cloud Infrastructure Documentation

Detaching Instances from a Cluster Network with Instance Pools

Remove specific nodes from a cluster network by detaching instances from the cluster network's underlying instance pool. The instances that you detach are no longer managed as part of the cluster network.

If you want to remove instances from the cluster network by deleting instances, you can instead resize the cluster network.

When you detach an instance, you can choose whether to delete or retain the instance. You can also choose whether to replace the detached instance by creating a new instance in the cluster network. If you don't replace the detached instance, then the size of the cluster network decreases.

Note

For information about permissions and prerequisites, see Required IAM Policy and Before You Begin.
    1. Open the navigation menu and click Compute. Under Compute, click Cluster Networks.
    2. Under List scope, select the compartment that contains the cluster network.
    3. Click the name of the cluster network that you want to manage.
    4. On the Instance pools page, click the instance pool that you want to detach instances from.
    5. Under Resources, click Attached instances.
    6. For the instance that you want to detach, click the Actions menu (Actions Menu); and then select Detach instance.
    7. To delete the instance and its boot volume, select the Permanently terminate (delete) this instance and its attached boot volume check box.
      By default, the size of the underlying instance pool is reduced. If you want the cluster network to remain the same size after you detach the instance, then you can provision a replacement instance.
    8. (Optional) Select the Replace the instance with a new instance, using the pool's instance configuration as a template for the instance check box.
    9. Click Detach (or Detach and terminate, if you're also deleting the instance).
      To track the progress of the operation and troubleshoot errors that occur during instance creation, use the associated work request.

  • Use the instance-pool-instance detach command and required parameters to detach an instance from the underlying instance pool of a cluster network.

    oci compute-management instance-pool-instance detach [OPTIONS]

    For a complete list of flags and variable options for cluster network CLI commands, see the command line reference for compute management tasks.

  • To list the instances in a cluster network, use the ListClusterNetworkInstances operation.

    To detach instances from a cluster network's underlying instance pool, use the DetachInstancePoolInstance operation.