4.4. Disconnect Container from Fabric

Abstract

For containers that joined a Fabric using fabric:join, the only way to disconnect from the fabric is by using the fabric:leave command.
Note
This command is only available from R13 and later.

Overview

If you created a container using the fabric:container-create-child command, use the fabric:delete command as all of the details are stored within Zookeeper. However, for containers that joined a Fabric using fabric:join, the only way to disconnect from the fabric is by using the fabric:leave command.

Use the command

If you specify the container using the fabric:leave command, the specified container leaves the fabric. Otherwise, fabric:leave disconnects the current container from the fabric.
fabric:leave containerName
Container containerName will be disconnected from Fabric. This operation is not reversible.
Do you want to proceed? (yes/no): yes
Container containerName will leave Fabric and restart - cleanup will be done asynchronously.
Note
Once you see the above validation, you can create or join a container with the name (containerName) in the Fabric environment.

Validation

There are several reasons you may be unable to disconnect the container from the fabric. The table below helps guide you if you encounter these scenarios.

Table 4.1. fabric:leave Validation

Console ValidationAction
fabric:leave
Container is part of the ensemble. It can't be disconnected from fabric.
In this case, you will not be able to disconnect the container.
fabric:leave xyz
Container xyz does not exist.
Check your spelling of the container to be sure you put in the right container name.
fabric:leave child
Container was created using Fabric. Please use fabric:container-delete command instead.
As the container did not join the fabric using the join command, use the suggested method to disconnect the container.
fabric:leave joined
Container joined has dependent containers ([child]). Can't disconnect it. Please remove its child containers first.
Remove the child containers before attempting to disconnect the desired container.