challiwill / fly

local development cli

fly

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

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

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. Install direnv. Once installed you can cd in and out of the concourse directory to setup your environment.

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

cd src/github.com/concourse/fly
go build

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

go get github.com/onsi/ginkgo/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

mv ~/Downloads/fly /usr/bin

3. Make the fly file executable

chmod +x /usr/bin/fly

4. Confirm availability with which fly