Fugue Cheat Sheet

Download this page in PDF

Setup

Fugue only requires a few things to get started:

  1. Visit the Download Portal to get the Fugue Client Tools
  2. Configure your AWS credentials
  3. Initialize a project with fugue init <region> or with environment variables
  4. Issue a fugue install

For a more detailed walkthrough check out the Fugue Quick Setup. Wait, what if I already have AWS resources? - it’s ok, we built something for that.

Creating Compositions

Some high level basics for compositions:

  • Compositions are also known as Ludwig files and are denoted by the composition keyword. Read a bit about how they work.
  • Only a composition can be run by the fugue run command.
  • Imports allow you to import specific modules from the Fugue Standard Library, e.g. import Fugue.AWS.EC2 as EC2.
  • Compositions include bindings, which are like variables that follow the form of name: value.

To learn more check out Writing Compositions or Advanced Ludwig.

Using Fugue

The following commands can easily get you started:

  • fugue run <composition.lw> - Launch a process
  • fugue update <alias/FID> <composition.lw> - Update the process
  • fugue status - Check the status of a process or processes
  • fugue kill <alias/FID> - Kill the process

Check out the CLI Reference to see all of the available commands.

Verify Before You Deploy

These functions enable you to evaluate configurations before they’re implemented:

  • Use the --dry-run flag to see a preview of how AWS will provision your infrastructure with run, update, resume, or kill.
  • Check out Design-Time Validations by running either lwc <composition.lw> (with an imported validation module), or lwc <composition.lw> --validation-modules <validation.lw> (without an imported validation module).

Configuring Users

In Fugue, the credentials file is created during the install process and contains the user credentials necessary to operate Fugue.

The fugue policy command and subcommands allow you to manage role-based access control policy for Fugue.

  • fugue policy generate-secret - Generate a new secret for a specific user
  • fugue policy rbac-attach - Attach a policy to the Conductor
  • fugue policy rbac-detach - Remove the policy from the Conductor
  • fugue policy list-users - Display a list of all users

To learn more about validations, check out an example.

Other Useful Items