concourse/fly

fly

A command line interface that runs a build in a container with ATC.

The documentation is hosted together with Concourse's docs.

A good place to start learning about Concourse is its documentation or its BOSH release.

Reporting Issues and Requesting Features

Please report all issues and feature requests in concourse/concourse.

Building

Fly is built using Go. Building and testing fly is most easily done from a checkout of concourse.

1. Check out concourse and update submodules:

git clone --recursive https://github.com/concourse/concourse.git
cd concourse

2. You can now build the fly binary with go build:

cd fly
go build

If you are using Go 1.10 and below, run go get ./... before go build.

3. You can also now run tests by installing and running ginkgo:

go get github.com/onsi/ginkgo/v2/ginkgo
ginkgo -r

Installing from the Concourse UI for Project Development

Fly is available for download in the lower right-hand corner of the concourse UI.

1. Navigate to your Concourse instance in the browser, and click the button corresponding to your OS

2. Move the downloaded file onto your PATH

install ~/Downloads/fly /usr/local/bin

1. Confirm availability with which fly

Upgrading Fly

Fly is not available for upgrade independently of Concourse. You can download the corresponding upgraded version of Fly via the following:

• using the Concourse UI
• running fly -t example sync if you already have fly locally