fugue [global options] suspend [options] (<alias> | <FID>)


<alias> | <FID>
FID or alias of the process to suspend


Global options are detailed here.

Emit output as JSON. The JSON flag displays command output in JSON format, which is useful for automation.
-y | --yes
Suppress confirmation dialogs. The yes flag suppresses confirmation dialogs and bypasses interactive prompts by providing input to aid scripting.
-h | --help
Show help text. The help flag is available throughout the CLI in both an application-level and command-level context. It enables a user to view help text for any command within the Fugue CLI.


The suspend command pauses automatic enforcement and maintenance of a running process. When a process is in Suspended state, Fugue stops actively managing the process’s resources.

Once a process is suspended, it may be resumed with resume or terminated with kill.

  • When a suspended process is resumed, Fugue resumes enforcing and maintaining its infrastructure.
  • When a suspended process is killed, Fugue terminates its infrastructure.


Pausing Enforcement Of A Running Process

Suppose Fugue is running a process but you need to reassess the configuration of its infrastructure, so you want to pause enforcement and maintenance of your infrastructure until you finish reassessing it. You can use the suspend command to temporarily stop Fugue from automatically managing your resources.

In this example, we’ve assigned the process an alias of staging.

$ fugue suspend staging

The Fugue CLI asks you to confirm that you want to suspend the specified process.

[ fugue suspend ] Suspending running process with Alias:staging

[ Help ] Are you sure you want to suspend the process with Alias:staging? [y/N]:

If y, the Fugue CLI sends a request to the Fugue Conductor asking it to suspend the process. When the request is accepted, the CLI displays a success message.

Requesting the Conductor to suspend running process Alias:staging...
[ Success ] Fugue is suspending process Alias:staging

[ HELP ] Run the 'fugue status' command to view details and status for all Fugue processes.

Using Suspend to Cancel a Kill

You may cancel a kill by first suspending the desired process and then resuming it.

To suspend the kill:

  1. Execute fugue suspend -y TARGET as soon as possible, where TARGET is the FID or alias of the desired process.
  2. Confirm that the process is in Suspended state by executing fugue status.

From here, you have two options:

  • To cancel the kill and return the process to Running state:

Execute fugue resume -y TARGET.

  • To continue the kill and return the process to Killing state:

Execute fugue kill -y TARGET.

Note: The -y flag is included in this example to save time by suppressing warnings.