The Fly CLI

The fly tool is a command line interface to Concourse. It is used for a number of tasks from connecting to a shell in one of your build's containers to uploading new pipeline configuration into a running Concourse. Learning how to use fly will make using Concourse faster and more useful.

You can download fly from a Concourse. There are download links for common platforms in the bottom right hand corner of the main page.

Throughout this section we'll stick to the long-form name of every command and flag. Once you've learned what the commands do, you may want to consult fly -h to learn the short forms.

  1. login: Authenticating with and saving Concourse targets
  2. logout: Remove authentication and delete Concourse targets
  3. targets: List the current targets
  4. sync: Update your local copy of fly
  5. set-team: Creating and updating Teams
  6. destroy-team: Removing Teams
  7. execute: Submitting Local Tasks
  8. pipelines: Listing configured pipelines
  9. rename-pipeline: Rename a pipeline
  10. pause-pipeline: Preventing new pipeline activity
  11. unpause-pipeline: Resuming pipeline activity
  12. expose-pipeline: Making a pipeline publicly viewable
  13. hide-pipeline: Hiding a pipeline from the public
  14. get-pipeline: Fetching a pipeline's configuration
  15. set-pipeline: Configuring Pipelines
  16. validate-pipeline: Validate a pipeline's configuration
  17. destroy-pipeline: Removing Pipelines
  18. trigger-job: Triggering a new build of a job
  19. pause-job: Preventing new job activity
  20. unpause-job: Resuming job activity
  21. check-resource: Trigger discovery of new versions
  22. pause-resource: Prevent resource checks
  23. unpause-resource: Resume resource checks
  24. builds: Showing build history
  25. abort-build: Aborting a running build of a job
  26. containers: Listing active containers
  27. intercept: Accessing a running or recent build's steps
  28. watch: View logs of in-progress builds
  29. workers: Listing registered workers
  30. prune-worker: Reap a non-running worker
  31. volumes: Listing active volumes
  32. checklist: Generate Checkman definition files