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. teams: Listing configured Teams
  6. set-team: Creating and updating Teams
  7. rename-team: Renaming Teams
  8. destroy-team: Removing Teams
  9. execute: Submitting Local Tasks
  10. pipelines: Listing configured pipelines
  11. rename-pipeline: Rename a pipeline
  12. pause-pipeline: Preventing new pipeline activity
  13. unpause-pipeline: Resuming pipeline activity
  14. expose-pipeline: Making a pipeline publicly viewable
  15. hide-pipeline: Hiding a pipeline from the public
  16. get-pipeline: Fetching a pipeline's configuration
  17. set-pipeline: Configuring Pipelines
  18. destroy-pipeline: Removing Pipelines
  19. validate-pipeline: Validate a pipeline config
  20. format-pipeline: Canonically format a pipeline config
  21. jobs: Listing configured jobs
  22. trigger-job: Triggering a new build of a job
  23. pause-job: Preventing new job activity
  24. unpause-job: Resuming job activity
  25. check-resource: Trigger discovery of new versions
  26. pause-resource: Prevent resource checks
  27. unpause-resource: Resume resource checks
  28. builds: Showing build history
  29. abort-build: Aborting a running build of a job
  30. containers: Listing active containers
  31. intercept: Accessing a running or recent build's steps
  32. watch: View logs of in-progress builds
  33. workers: Listing registered workers
  34. prune-worker: Reap a non-running worker
  35. volumes: Listing active volumes
  36. checklist: Generate Checkman definition files