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