9.13. fabric:container-delete

Abstract

stops and deletes a Fuse Container

Synopsis

fabric:container-delete [ --help ] [ --user user ] [ --password password ] [ -f, --force ] [[ -r ] | [ --recursive ]] { GlobList }

Description

Deleting a Fuse Container deletes all of the files associated with the container from the host.
If the container has children, the default behavior of the command is to leave the children in place. You can force the deletion of the children using the -r option.
Note
If the container to be deleted is a Fabric Server, you must first remove it from the ensemble using fabric:ensemble-remove.

Arguments

Table 9.13, “fabric:container-delete Arguments” describes the command's arguments.

Table 9.13. fabric:container-delete Arguments

ArgumentInterpretation
--help Displays the online help for this command.
--user Specifies the username of the user performing this action.
--password Specifies the password of the user performing this action.
-f, --force Forces execution of the command, regardless of the known state of the container.
-r, --recursive Recursively stops and deletes all child containers.
GlobList(Required) Specifies the list of containers to delete, separated by spaces. Globbing is supported as follows: ?, matches zero or one characters; *, matches zero or more characters.

Using alternative credentials

Each time a container is created Fabric stores the credentials used to create the container and will reuse them for all life cycle operations (start, stop, delete). If the credentials have changed, the updated credentials need to be specified as options. Each container type (child, ssh, jclouds) uses different kind of credentials, as follows:
  • Child containers: Use the JMX credentials of the parent container.
  • SSH containers: Use the SSH credentials of the target host.
  • JClouds containers: Use the ssh credentials of the instance.
For example:
fabric:container-delete --user NewJmxUserOfParent --password NewJmxPasswordOfParent child1
fabric:container-delete --password NewSshPasswordOfTargetHost ssh1
fabric:container-delete --password NewSshPasswordOfTargetHost cloud1